@ecopages/core 0.2.0-alpha.25 → 0.2.0-alpha.26

package/CHANGELOG.md

@@ -0,0 +1,66 @@
+# Changelog
+
+All notable changes to `@ecopages/core` are documented here.
+
+> **Note:** Changelog tracking begins at version `0.2.0`. Changes prior to this release are not recorded here but are available in the git history.
+
+## [UNRELEASED] — TBD
+
+### Features
+
+- Added app-owned runtime and build ownership around `createApp()`, host module loading, the browser-safe `eco` export, `eco.html()`, `eco.layout()`, and the published `EcoPagesAppConfig` surface.
+- Added boundary-plan metadata and a compatibility `renderBoundary()` payload contract for mixed-renderer orchestration.
+
+### Refactoring
+
+- Bundled page-local component stylesheets and standard file scripts into page-owned assets before processing, reducing per-page asset fan-out in emitted HTML.
+- Grouped Ecopages JSX page and lazy dependency entries into one multi-entry browser build so shared chunks can be emitted once without relying on the runtime alias vendor path.
+- Removed the transitional flat dependency write from render preparation so final HTML injection now follows the structured page-package path only.
+- Consolidated runtime state around shared module-loading services, app-owned build execution, and the universal `createApp()` boundary.
+- Simplified route-renderer orchestration around renderer-owned boundary runtimes, shared string-boundary queue helpers, and a smaller component render context.
+- Centralized shared integration renderer bootstrapping so package integrations only append renderer-specific config instead of duplicating core lifecycle wiring.
+- Moved shared queued boundary resolution to attachment-policy payloads and constructor-injectable planning services.
+- Extracted shared page, layout, and document-shell composition into a narrow `RouteShellComposer` while keeping renderer-owned boundary handoff in `IntegrationRenderer`.
+- Removed marker-era compatibility capture, the shared route-level fallback resolver, deprecated `@ecopages/core/node*` escape hatches, and other dead route-renderer internals.
+
+### Bug Fixes
+
+- Fixed router-owned HMR current-page reloads to clear persisted layout caches so active shared layouts pick up updated implementations during development.
+- Fixed router-owned HMR layout refreshes to reuse the active HMR page entry instead of stale static bootstrap assets during persisted-layout reloads.
+- Fixed fetch-mode static generation to normalize absolute routes onto the active build runtime origin, restoring preview prerendering for routes discovered from absolute router entries.
+- Fixed global lazy-trigger bootstrap emission to inline the full bootstrap runtime in final HTML, removing separate initial injector bootstrap and runtime requests.
+- Fixed Ecopages JSX lazy-trigger finalization to preserve SSR custom-element markup nodes instead of coercing them to `[object Object]` inside parent renders.
+- Fixed legacy scripts-injector wrapping and grouped content-script bundling cleanup so non-string JSX SSR output stays intact and failed grouped builds do not leak temporary entries.
+- Fixed Ecopages JSX dependency resolution so page bundling now follows only declared `dependencies.scripts` entries, preventing SSR-only imports and lazy-declared scripts from being promoted into the page bundle.
+- Fixed Ecopages JSX lazy dependency bundling to keep page and lazy entries separate, preventing lazy scripts from forcing extra shared chunk requests into the page bundle.
+- Fixed Ecopages JSX dependency emission to collapse bundleable component CSS and module scripts into page-owned assets while preserving lazy trigger scripts.
+- Fixed Ecopages JSX page-owned dependency bundles to keep using the shared JSX and Radiant vendor runtimes so lazy chunks do not trigger duplicate runtime downloads.
+- Fixed Ecopages JSX page-owned browser bundles to keep intrinsic custom-element scripts out of final HTML when the current component tree already imports them, reducing docs home page script fan-out to one page bundle.
+- Fixed Node static builds so `ecopages build` no longer fails when the configured serve port is already in use.
+- Fixed mixed-integration page, layout, document, and component rendering to resolve foreign boundaries inside their owning renderer across the built-in integrations.
+- Fixed host/runtime module loading, published build-helper exports, asset output normalization, explicit render flows, and static or preview build stability across Bun, Node, Vite, and Nitro.
+- Fixed development project watcher setup to register chokidar paths and handlers only once per app runtime.
+- Fixed development script-entry registration to build only the requested HMR entrypoint instead of fanning out across all watched script entrypoints during startup.
+- Fixed Node bootstrap runtime package linking to refresh dangling `.eco/node_modules` symlinks instead of failing with `EEXIST` during page transpilation.
+- Fixed request-time and static-generation page inspection to preserve integration-specific page loading without reusing the normal render module identity.
+- Fixed Node preview and static-generation React runtime resolution so app-owned page modules and server rendering share one React module identity.
+- Fixed Bun browser output normalization so batched multi-entrypoint HMR rebuilds match emitted files to their expected served paths instead of Bun output order.
+- Fixed render-preparation graph traversal so sparse component dependency arrays do not break custom 404 rendering or file-system response fallback flows.
+
+### Documentation
+
+- Added architecture and API documentation for config, plugins, services, adapters, HMR, routing, and rendering.
+
+### Tests
+
+- Added regression coverage for app-owned runtime services, Node fallback paths, and cross-runtime invalidation behavior.
+- Strengthened the core ghtml integration tests so route and explicit render paths await real outcomes and cover `renderToResponse` behavior.
+- Added core regression coverage for boundary plans, payload contracts, and typed mixed-boundary context flow.
+
+---
+
+## Migration Notes
+
+- `createApp` is now the recommended entrypoint. Import it from `@ecopages/core/create-app`.
+- `defineApiHandler` keeps the same call shape, but the handler context is now explicitly runtime-agnostic.
+- The old explicit `renderingMode` config option has been removed and full orchestration is always active.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/core",
-  "version": "0.2.0-alpha.25",
+  "version": "0.2.0-alpha.26",
   "description": "Core package for Ecopages",
   "keywords": [
     "ecopages",
@@ -8,23 +8,16 @@
     "ssg"
   ],
   "license": "MIT",
-  "main": "./src/index.ts",
+  "main": "./src/index.js",
   "type": "module",
-  "files": [
-    "src"
-  ],
   "sideEffects": false,
   "repository": {
     "type": "git",
     "url": "https://github.com/ecopages/ecopages.git",
     "directory": "packages/core"
   },
-  "scripts": {
-    "typecheck": "bunx tsc --noEmit",
-    "release:jsr": "bunx jsr publish"
-  },
   "dependencies": {
-    "@ecopages/file-system": "workspace:*",
+    "@ecopages/file-system": "0.2.0-alpha.26",
     "@ecopages/logger": "^0.2.3",
     "@ecopages/scripts-injector": "^0.1.3",
     "@worker-tools/html-rewriter": "0.1.0-pre.19",
@@ -34,54 +27,46 @@
     "oxc-parser": "^0.124.0",
     "ws": "^8.18.0"
   },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "@types/ws": "^8.5.14",
-    "arktype": "^2.1.29",
-    "tailwindcss": "^3.4.19",
-    "valibot": "^1.2.0",
-    "zod": "^4.3.6"
-  },
   "exports": {
     ".": {
-      "browser": "./src/index.browser.ts",
-      "import": "./src/index.ts",
-      "require": "./src/index.ts",
-      "types": "./src/index.ts"
+      "browser": "./src/index.browser.js",
+      "import": "./src/index.js",
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
     },
     "./create-app": {
-      "import": "./src/adapters/create-app.ts",
-      "types": "./src/adapters/create-app.ts",
-      "default": "./src/adapters/create-app.ts"
+      "import": "./src/adapters/create-app.js",
+      "types": "./src/adapters/create-app.d.ts",
+      "default": "./src/adapters/create-app.js"
     },
     "./route-renderer/integration-renderer": {
-      "types": "./src/route-renderer/orchestration/integration-renderer.ts",
-      "default": "./src/route-renderer/orchestration/integration-renderer.ts"
+      "types": "./src/route-renderer/orchestration/integration-renderer.d.ts",
+      "default": "./src/route-renderer/orchestration/integration-renderer.js"
     },
     "./router/navigation-coordinator": {
-      "types": "./src/router/client/navigation-coordinator.ts",
-      "default": "./src/router/client/navigation-coordinator.ts"
+      "types": "./src/router/client/navigation-coordinator.d.ts",
+      "default": "./src/router/client/navigation-coordinator.js"
     },
     "./router/link-intent": {
-      "types": "./src/router/client/link-intent.ts",
-      "default": "./src/router/client/link-intent.ts"
+      "types": "./src/router/client/link-intent.d.ts",
+      "default": "./src/router/client/link-intent.js"
     },
     "./router/client/navigation-coordinator": {
-      "types": "./src/router/client/navigation-coordinator.ts",
-      "default": "./src/router/client/navigation-coordinator.ts"
+      "types": "./src/router/client/navigation-coordinator.d.ts",
+      "default": "./src/router/client/navigation-coordinator.js"
     },
     "./errors/locals-access-error": {
-      "types": "./src/errors/locals-access-error.ts",
-      "default": "./src/errors/locals-access-error.ts"
+      "types": "./src/errors/locals-access-error.d.ts",
+      "default": "./src/errors/locals-access-error.js"
     },
     "./eco": {
-      "browser": "./src/eco/eco.browser.ts",
-      "types": "./src/eco/eco.ts",
-      "default": "./src/eco/eco.ts"
+      "browser": "./src/eco/eco.browser.js",
+      "types": "./src/eco/eco.d.ts",
+      "default": "./src/eco/eco.js"
     },
     "./route-renderer/template-serialization": {
-      "types": "./src/route-renderer/orchestration/template-serialization.ts",
-      "default": "./src/route-renderer/orchestration/template-serialization.ts"
+      "types": "./src/route-renderer/orchestration/template-serialization.d.ts",
+      "default": "./src/route-renderer/orchestration/template-serialization.js"
     },
     "./declarations": {
       "types": "./src/declarations.d.ts"
@@ -90,107 +75,255 @@
       "types": "./src/env.d.ts"
     },
     "./config-builder": {
-      "types": "./src/config/config-builder.ts",
-      "default": "./src/config/config-builder.ts"
+      "types": "./src/config/config-builder.d.ts",
+      "default": "./src/config/config-builder.js"
     },
     "./constants": {
-      "types": "./src/config/constants.ts",
-      "default": "./src/config/constants.ts"
+      "types": "./src/config/constants.d.ts",
+      "default": "./src/config/constants.js"
     },
     "./bun": {
-      "types": "./src/adapters/bun/index.ts",
-      "default": "./src/adapters/bun/index.ts"
+      "types": "./src/adapters/bun/index.d.ts",
+      "default": "./src/adapters/bun/index.js"
     },
     "./bun/create-app": {
-      "types": "./src/adapters/bun/create-app.ts",
-      "default": "./src/adapters/bun/create-app.ts"
+      "types": "./src/adapters/bun/create-app.d.ts",
+      "default": "./src/adapters/bun/create-app.js"
     },
     "./hmr/hmr-strategy": {
-      "types": "./src/hmr/hmr-strategy.ts",
-      "default": "./src/hmr/hmr-strategy.ts"
+      "types": "./src/hmr/hmr-strategy.d.ts",
+      "default": "./src/hmr/hmr-strategy.js"
     },
     "./internal-types": {
-      "types": "./src/types/internal-types.ts"
+      "types": "./src/types/internal-types.d.ts"
     },
     "./services/asset-processing-service": {
-      "types": "./src/services/assets/asset-processing-service/index.ts",
-      "default": "./src/services/assets/asset-processing-service/index.ts"
+      "types": "./src/services/assets/asset-processing-service/index.d.ts",
+      "default": "./src/services/assets/asset-processing-service/index.js"
     },
     "./services/invalidation/development-invalidation.service": {
-      "types": "./src/services/invalidation/development-invalidation.service.ts",
-      "default": "./src/services/invalidation/development-invalidation.service.ts"
+      "types": "./src/services/invalidation/development-invalidation.service.d.ts",
+      "default": "./src/services/invalidation/development-invalidation.service.js"
     },
     "./services/module-loading/app-server-module-transpiler.service": {
-      "types": "./src/services/module-loading/app-server-module-transpiler.service.ts",
-      "default": "./src/services/module-loading/app-server-module-transpiler.service.ts"
+      "types": "./src/services/module-loading/app-server-module-transpiler.service.d.ts",
+      "default": "./src/services/module-loading/app-server-module-transpiler.service.js"
     },
     "./host-module-loader": {
-      "types": "./src/services/module-loading/host-module-loader-registry.ts",
-      "default": "./src/services/module-loading/host-module-loader-registry.ts"
+      "types": "./src/services/module-loading/host-module-loader-registry.d.ts",
+      "default": "./src/services/module-loading/host-module-loader-registry.js"
     },
     "./utils/deep-merge": {
-      "types": "./src/utils/deep-merge.ts",
-      "default": "./src/utils/deep-merge.ts"
+      "types": "./src/utils/deep-merge.d.ts",
+      "default": "./src/utils/deep-merge.js"
     },
     "./utils/invariant": {
-      "types": "./src/utils/invariant.ts",
-      "default": "./src/utils/invariant.ts"
+      "types": "./src/utils/invariant.d.ts",
+      "default": "./src/utils/invariant.js"
     },
     "./utils/parse-cli-args": {
-      "types": "./src/utils/parse-cli-args.ts",
-      "default": "./src/utils/parse-cli-args.ts"
+      "types": "./src/utils/parse-cli-args.d.ts",
+      "default": "./src/utils/parse-cli-args.js"
     },
     "./plugins/processor": {
-      "types": "./src/plugins/processor.ts",
-      "default": "./src/plugins/processor.ts"
+      "types": "./src/plugins/processor.d.ts",
+      "default": "./src/plugins/processor.js"
     },
     "./plugins/integration-plugin": {
-      "types": "./src/plugins/integration-plugin.ts",
-      "default": "./src/plugins/integration-plugin.ts"
+      "types": "./src/plugins/integration-plugin.d.ts",
+      "default": "./src/plugins/integration-plugin.js"
     },
     "./plugins/source-transform": {
-      "types": "./src/plugins/source-transform.ts",
-      "default": "./src/plugins/source-transform.ts"
+      "types": "./src/plugins/source-transform.d.ts",
+      "default": "./src/plugins/source-transform.js"
     },
     "./build/build-types": {
-      "types": "./src/build/build-types.ts",
-      "default": "./src/build/build-types.ts"
+      "types": "./src/build/build-types.d.ts",
+      "default": "./src/build/build-types.js"
     },
     "./build/build-adapter": {
-      "types": "./src/build/build-adapter.ts",
-      "default": "./src/build/build-adapter.ts"
+      "types": "./src/build/build-adapter.d.ts",
+      "default": "./src/build/build-adapter.js"
     },
     "./build/runtime-specifier-alias-plugin": {
-      "types": "./src/build/runtime-specifier-alias-plugin.ts",
-      "default": "./src/build/runtime-specifier-alias-plugin.ts"
+      "types": "./src/build/runtime-specifier-alias-plugin.d.ts",
+      "default": "./src/build/runtime-specifier-alias-plugin.js"
     },
     "./build/runtime-specifier-aliases": {
-      "types": "./src/build/runtime-specifier-aliases.ts",
-      "default": "./src/build/runtime-specifier-aliases.ts"
+      "types": "./src/build/runtime-specifier-aliases.d.ts",
+      "default": "./src/build/runtime-specifier-aliases.js"
     },
     "./plugins/foreign-jsx-override-plugin": {
-      "types": "./src/plugins/foreign-jsx-override-plugin.ts",
-      "default": "./src/plugins/foreign-jsx-override-plugin.ts"
+      "types": "./src/plugins/foreign-jsx-override-plugin.d.ts",
+      "default": "./src/plugins/foreign-jsx-override-plugin.js"
     },
     "./adapters/bun/client-bridge": {
-      "types": "./src/adapters/bun/client-bridge.ts",
-      "default": "./src/adapters/bun/client-bridge.ts"
+      "types": "./src/adapters/bun/client-bridge.d.ts",
+      "default": "./src/adapters/bun/client-bridge.js"
     },
     "./html": {
-      "import": "./src/utils/html.ts",
-      "require": "./src/utils/html.ts"
+      "import": "./src/utils/html.js",
+      "default": "./src/utils/html.js",
+      "types": "./src/utils/html.d.ts"
     },
     "./hash": {
-      "import": "./src/utils/hash.ts",
-      "require": "./src/utils/hash.ts"
+      "import": "./src/utils/hash.js",
+      "default": "./src/utils/hash.js",
+      "types": "./src/utils/hash.d.ts"
     },
     "./errors": {
-      "types": "./src/errors/index.ts",
-      "default": "./src/errors/index.ts"
+      "types": "./src/errors/index.d.ts",
+      "default": "./src/errors/index.js"
     },
     "./integrations/ghtml": {
-      "types": "./src/integrations/ghtml/ghtml.plugin.ts",
-      "default": "./src/integrations/ghtml/ghtml.plugin.ts"
+      "types": "./src/integrations/ghtml/ghtml.plugin.d.ts",
+      "default": "./src/integrations/ghtml/ghtml.plugin.js"
+    },
+    "./create-app.ts": {
+      "import": "./src/adapters/create-app.js",
+      "types": "./src/adapters/create-app.d.ts",
+      "default": "./src/adapters/create-app.js"
+    },
+    "./route-renderer/integration-renderer.ts": {
+      "types": "./src/route-renderer/orchestration/integration-renderer.d.ts",
+      "default": "./src/route-renderer/orchestration/integration-renderer.js"
+    },
+    "./router/navigation-coordinator.ts": {
+      "types": "./src/router/client/navigation-coordinator.d.ts",
+      "default": "./src/router/client/navigation-coordinator.js"
+    },
+    "./router/link-intent.ts": {
+      "types": "./src/router/client/link-intent.d.ts",
+      "default": "./src/router/client/link-intent.js"
+    },
+    "./router/client/navigation-coordinator.ts": {
+      "types": "./src/router/client/navigation-coordinator.d.ts",
+      "default": "./src/router/client/navigation-coordinator.js"
+    },
+    "./errors/locals-access-error.ts": {
+      "types": "./src/errors/locals-access-error.d.ts",
+      "default": "./src/errors/locals-access-error.js"
+    },
+    "./eco.ts": {
+      "browser": "./src/eco/eco.browser.js",
+      "types": "./src/eco/eco.d.ts",
+      "default": "./src/eco/eco.js"
+    },
+    "./route-renderer/template-serialization.ts": {
+      "types": "./src/route-renderer/orchestration/template-serialization.d.ts",
+      "default": "./src/route-renderer/orchestration/template-serialization.js"
+    },
+    "./declarations.ts": {
+      "types": "./src/declarations.d.ts"
+    },
+    "./env.ts": {
+      "types": "./src/env.d.ts"
+    },
+    "./config-builder.ts": {
+      "types": "./src/config/config-builder.d.ts",
+      "default": "./src/config/config-builder.js"
+    },
+    "./constants.ts": {
+      "types": "./src/config/constants.d.ts",
+      "default": "./src/config/constants.js"
+    },
+    "./bun.ts": {
+      "types": "./src/adapters/bun/index.d.ts",
+      "default": "./src/adapters/bun/index.js"
+    },
+    "./bun/create-app.ts": {
+      "types": "./src/adapters/bun/create-app.d.ts",
+      "default": "./src/adapters/bun/create-app.js"
+    },
+    "./hmr/hmr-strategy.ts": {
+      "types": "./src/hmr/hmr-strategy.d.ts",
+      "default": "./src/hmr/hmr-strategy.js"
+    },
+    "./internal-types.ts": {
+      "types": "./src/types/internal-types.d.ts"
+    },
+    "./services/asset-processing-service.ts": {
+      "types": "./src/services/assets/asset-processing-service/index.d.ts",
+      "default": "./src/services/assets/asset-processing-service/index.js"
+    },
+    "./services/invalidation/development-invalidation.service.ts": {
+      "types": "./src/services/invalidation/development-invalidation.service.d.ts",
+      "default": "./src/services/invalidation/development-invalidation.service.js"
+    },
+    "./services/module-loading/app-server-module-transpiler.service.ts": {
+      "types": "./src/services/module-loading/app-server-module-transpiler.service.d.ts",
+      "default": "./src/services/module-loading/app-server-module-transpiler.service.js"
+    },
+    "./host-module-loader.ts": {
+      "types": "./src/services/module-loading/host-module-loader-registry.d.ts",
+      "default": "./src/services/module-loading/host-module-loader-registry.js"
+    },
+    "./utils/deep-merge.ts": {
+      "types": "./src/utils/deep-merge.d.ts",
+      "default": "./src/utils/deep-merge.js"
+    },
+    "./utils/invariant.ts": {
+      "types": "./src/utils/invariant.d.ts",
+      "default": "./src/utils/invariant.js"
+    },
+    "./utils/parse-cli-args.ts": {
+      "types": "./src/utils/parse-cli-args.d.ts",
+      "default": "./src/utils/parse-cli-args.js"
+    },
+    "./plugins/processor.ts": {
+      "types": "./src/plugins/processor.d.ts",
+      "default": "./src/plugins/processor.js"
+    },
+    "./plugins/integration-plugin.ts": {
+      "types": "./src/plugins/integration-plugin.d.ts",
+      "default": "./src/plugins/integration-plugin.js"
+    },
+    "./plugins/source-transform.ts": {
+      "types": "./src/plugins/source-transform.d.ts",
+      "default": "./src/plugins/source-transform.js"
+    },
+    "./build/build-types.ts": {
+      "types": "./src/build/build-types.d.ts",
+      "default": "./src/build/build-types.js"
+    },
+    "./build/build-adapter.ts": {
+      "types": "./src/build/build-adapter.d.ts",
+      "default": "./src/build/build-adapter.js"
+    },
+    "./build/runtime-specifier-alias-plugin.ts": {
+      "types": "./src/build/runtime-specifier-alias-plugin.d.ts",
+      "default": "./src/build/runtime-specifier-alias-plugin.js"
+    },
+    "./build/runtime-specifier-aliases.ts": {
+      "types": "./src/build/runtime-specifier-aliases.d.ts",
+      "default": "./src/build/runtime-specifier-aliases.js"
+    },
+    "./plugins/foreign-jsx-override-plugin.ts": {
+      "types": "./src/plugins/foreign-jsx-override-plugin.d.ts",
+      "default": "./src/plugins/foreign-jsx-override-plugin.js"
+    },
+    "./adapters/bun/client-bridge.ts": {
+      "types": "./src/adapters/bun/client-bridge.d.ts",
+      "default": "./src/adapters/bun/client-bridge.js"
+    },
+    "./html.ts": {
+      "import": "./src/utils/html.js",
+      "default": "./src/utils/html.js",
+      "types": "./src/utils/html.d.ts"
+    },
+    "./hash.ts": {
+      "import": "./src/utils/hash.js",
+      "default": "./src/utils/hash.js",
+      "types": "./src/utils/hash.d.ts"
+    },
+    "./errors.ts": {
+      "types": "./src/errors/index.d.ts",
+      "default": "./src/errors/index.js"
+    },
+    "./integrations/ghtml.ts": {
+      "types": "./src/integrations/ghtml/ghtml.plugin.d.ts",
+      "default": "./src/integrations/ghtml/ghtml.plugin.js"
     }
-  }
-}
+  },
+  "types": "./src/index.d.ts"
+}