Changelog

Highlights

Comprehensive v1.0 hardening across five waves. See MIGRATION-1.0.md in the repo for the full breaking-changes guide with copy-paste fixes.

Workspace consolidation (Waves 2a/2b/2c)

• Workspace consolidated from 21+ packages to 12 published packages (plus the standalone VS Code extension).
• Framework integrations (express, fastify, koa, nextjs, adapters/*) → subpath exports of @coherent.js/integrations.
• Build tools (vite, webpack, rollup, loader) → subpath exports of @coherent.js/cli/build-tools.
• Performance utilities (cache, code-splitting, lazy-loading) → subpath exports of @coherent.js/devtools/performance.
• LSP + testing + language-service merged into @coherent.js/tooling.
• Dropped: @coherent.js/runtime, @coherent.js/web-components, @coherent.js/profiler (138 lines of placeholder).

Removed APIs (Wave 1)

• Client: legacyHydrate, hydrateAll, hydrateBySelector, enableClientEvents, makeHydratable, autoHydrate, registerEventHandler — use hydrate() instead.
• Client: direct imports of @coherent.js/client/src/hmr.js throw a migration error. Use { hmrClient } from @coherent.js/client.
• Forms: createForm, formValidators, enhancedForm removed. Use createFormBuilder + hydrateForm.

New in 1.0

• Built-in HMR dev server (`coherent dev --coherent`): HTTP + WebSocket + chokidar, no vite/webpack required for static-served projects.
• API surface lockdown: every public export is snapshotted to packages/<name>/api-surface.txt; CI gates accidental drift.
• Per-package bundle-size gates: each dist/index.js raw + gzipped size baselined to packages/<name>/bundle-size.json; CI fails on >±5% drift.
• Playwright E2E suite: six audit-item browser flows automated in CI (Chromium).
• VS Code extension publish-readiness check + dedicated CI job + PUBLISHING.md runbook.

README claims cleaned up

• Dropped: "42.7% improvement over OOP" (required maintaining an OOP-equivalent fixture).
• Dropped: "95%+ cache hit rate" (workload-dependent, dishonest as a framework property).
• Dropped: aggregate "80.7KB gzipped bundle" claim (replaced with per-package CI gates).
• Dropped: "79.5% tree-shake reduction" (no gate existed to defend the number).
• Retained: "247 renders/sec" (defensible from benchmarks/benchmark.js).

Next

Release candidate — 1-2 week soak before promoting to 1.0.0 stable. Install with `pnpm add @coherent.js/core@rc` to try it.

Added

• Major website UI/UX overhaul with search, animations, and examples improvements
• Dynamic docs route and sidebar navigation for the dev server
• Island() hydration, performance monitoring, and perf API in the website
• Website restructured as a proper Coherent.js project using framework features

Improved

• Consistent full-width layout, page structure, and background styling
• Hero section: improved orb animation, cleaner CTA buttons, code highlighting
• Unified website build script with component composition

Fixed

• CJS build: hardcoded VERSION to avoid import.meta.url warning
• WebSocket.OPEN reference guarded for Node.js environments
• CI/CD: release-drafter, shellcheck warnings, and GitHub Actions cleanup
• Pinned @vitest/coverage-v8 to match vitest version

Dependencies

• Bumped esbuild, next, codecov, upload-artifact, deploy-pages, pnpm/action-setup, release-drafter, and more

Added

• Islands Architecture with Island() wrapper and client-side discovery for selective hydration
• Selective Hydration via selectiveHydrate() and hydratable SSR flag
• Functional Programming support with hoc, compose, and fp namespaces
• VS Code extension with language client and LSP server
• Hot Module Replacement (HMR) with state preservation and error overlay
• Key-based reconciliation for efficient updates
• HTML nesting validation for valid DOM structures

Improved

• Streaming Renderer with full component and feature parity
• Cache performance: MurmurHash3-based object hashing for 50x faster cache keys
• Defensive rendering with improved circular reference detection

Added

• Docker scaffolding support in the CLI for easy containerization

Improved

• Production readiness checklist for deployment
• LRU cache for compiled routes in @coherent.js/api
• Optimized security header configurations
• Smart route matching performance in the API router

Fixed

• Return type issue in API validation functions

Fixed

• CI/CD build and test workflows for fresh artifacts
• Several moderate and high-severity security vulnerabilities
• Timing tolerance issues in profiler tests

Fixed

• Critical API router bugs: double slash generation and character class escaping
• Comprehensive documentation refactor and reorganization
• Added missing README files for forms, koa, nextjs, performance, and seo packages

Changed

• Major package reorganization for better separation of concerns
• New @coherent.js/state package for reactive state management
• Client-side router moved to @coherent.js/client

Added

• Reactive state with observables, computed properties, and persistence
• Enhanced client routing with prefetching, transitions, and code splitting
• New lifecycle hooks and object factory exports from @coherent.js/core

First beta release of Coherent.js with a complete version reset and clean npm registry.

Highlights

• Pure object components with optimized SSR and streaming support
• Client-side hydration with progressive enhancement
• Extensible plugin system with 7 built-in plugins and 10+ lifecycle hooks
• Framework integrations for Express, Fastify, Koa, and Next.js
• Full-featured packages for i18n, forms, SEO, database, and API
• All 20 packages synchronized and released