@ecopages/core 0.2.0-alpha.11 → 0.2.0-alpha.13

package/CHANGELOG.md

@@ -8,21 +8,18 @@ All notable changes to `@ecopages/core` are documented here.
 
 ### Features
 
-- Added a shared runtime boundary around `createApp()`, host module loading, and explicit build ownership for Bun-native execution, Node fallback support, and Vite or Nitro hosts.
-- Added the browser-safe `eco` export, semantic `eco.html()` and `eco.layout()` helpers, and the internal `.eco` work directory.
-- Added the public `EcoPagesAppConfig` export for published integration packages.
+- 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.
 
 ### Refactoring
 
 - Consolidated runtime state around shared module-loading services, app-owned build execution, and the universal `createApp()` boundary.
-- Removed the deprecated `@ecopages/core/node*` public escape hatches and the old thin-host bootstrap internals from core.
+- Simplified route-renderer orchestration around renderer-owned boundary runtimes, shared string-boundary queue helpers, and a smaller component render context.
+- 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 request-time module loading, host-runner interop, and include or layout HMR across Bun, Vite, and Nitro development flows.
-- Fixed preview, static-generation, and browser bundle stability for esbuild-backed production paths.
-- Fixed deep marker-graph resolution, watch-mode route refreshes, and duplicate-core fallback references in mixed-runtime rendering.
-- Fixed npm package output to rewrite workspace dependency versions and publish built JavaScript and declaration artifacts.
+- 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.
 
 ### Documentation
 
@@ -30,12 +27,12 @@ All notable changes to `@ecopages/core` are documented here.
 
 ### Tests
 
-- Added regression coverage for Node fallback paths, shared runtime services, and cross-runtime invalidation behavior.
+- Added regression coverage for app-owned runtime services, Node fallback paths, and cross-runtime invalidation behavior.
 
 ---
 
 ## Migration Notes
 
-- `createApp` is now the recommended entrypoint. Import it from `@ecopages/core`.
+- `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/README.md

@@ -134,7 +134,7 @@ export default config;
 Start the application using `createApp`. It will choose the Bun adapter when Bun is available and fall back to Node otherwise.
 
 ```typescript
-import { createApp } from '@ecopages/core';
+import { createApp } from '@ecopages/core/create-app';
 import appConfig from './eco.config';
 
 const app = await createApp({ appConfig });
@@ -198,7 +198,7 @@ Attach the handler in your `app.ts` entry:
 
 ```typescript
 // app.ts
-import { createApp } from '@ecopages/core';
+import { createApp } from '@ecopages/core/create-app';
 import { helloWorld } from './handlers/hello';
 import appConfig from './eco.config';
 
@@ -213,10 +213,11 @@ See the [official documentation](https://ecopages.app) for advanced usage, API h
 
 ## Import Structure
 
-Use the root package exports for standard authoring in Bun-native flows:
+Use the `create-app` subpath for runtime startup and the root package for standard authoring helpers:
 
 ```ts
-import { createApp, defineApiHandler, defineGroupHandler, eco } from '@ecopages/core';
+import { createApp } from '@ecopages/core/create-app';
+import { defineApiHandler, defineGroupHandler, eco } from '@ecopages/core';
 ```
 
 > [!NOTE]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/core",
-  "version": "0.2.0-alpha.11",
+  "version": "0.2.0-alpha.13",
   "description": "Core package for Ecopages",
   "keywords": [
     "ecopages",
@@ -17,14 +17,14 @@
     "directory": "packages/core"
   },
   "dependencies": {
-    "@ecopages/file-system": "0.2.0-alpha.11",
-    "@ecopages/logger": "latest",
+    "@ecopages/file-system": "0.2.0-alpha.13",
+    "@ecopages/logger": "^0.2.3",
     "@ecopages/scripts-injector": "^0.1.3",
     "@worker-tools/html-rewriter": "0.1.0-pre.19",
-    "chokidar": "^4.0.3",
-    "esbuild": "^0.27.3",
+    "chokidar": "^5.0.0",
+    "esbuild": "^0.28.0",
     "ghtml": "^4.0.2",
-    "oxc-parser": "^0.110.0",
+    "oxc-parser": "^0.124.0",
     "ws": "^8.18.0"
   },
   "exports": {
@@ -64,6 +64,10 @@
       "types": "./src/eco/eco.d.ts",
       "default": "./src/eco/eco.js"
     },
+    "./route-renderer/template-serialization": {
+      "types": "./src/route-renderer/orchestration/template-serialization.d.ts",
+      "default": "./src/route-renderer/orchestration/template-serialization.js"
+    },
     "./declarations": {
       "types": "./src/declarations.d.ts"
     },
@@ -145,6 +149,14 @@
       "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.d.ts",
+      "default": "./src/build/runtime-specifier-aliases.js"
+    },
+    "./plugins/foreign-jsx-override-plugin": {
+      "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.d.ts",
       "default": "./src/adapters/bun/client-bridge.js"
@@ -197,6 +209,10 @@
       "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"
     },
@@ -278,6 +294,14 @@
       "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"

package/src/adapters/bun/hmr-manager.js

@@ -251,7 +251,7 @@ class HmrManager {
    */
   async registerEntrypoint(entrypointPath) {
     return await this.entrypointRegistrar.registerEntrypoint(entrypointPath, {
-      emit: async (normalizedEntrypoint, outputPath) => await this.emitStrictEntrypoint(normalizedEntrypoint, outputPath),
+      emit: async (normalizedEntrypoint) => await this.emitStrictEntrypoint(normalizedEntrypoint),
       getMissingOutputError: (normalizedEntrypoint, outputPath) => new Error(
         `[HMR] Integration failed to emit entrypoint ${normalizedEntrypoint} to ${outputPath}. Page entrypoints must be produced by their owning integration.`
       )
@@ -278,7 +278,7 @@ class HmrManager {
    * strategy processing without broadcasting, and then verifies that the owning
    * integration emitted the expected file.
    */
-  async emitStrictEntrypoint(entrypointPath, _outputPath) {
+  async emitStrictEntrypoint(entrypointPath) {
     await this.handleFileChange(entrypointPath, { broadcast: false });
   }
   /**

package/src/adapters/node/node-hmr-manager.js

@@ -225,7 +225,7 @@ class NodeHmrManager {
    */
   async registerEntrypoint(entrypointPath) {
     return await this.entrypointRegistrar.registerEntrypoint(entrypointPath, {
-      emit: async (normalizedEntrypoint, outputPath) => await this.emitStrictEntrypoint(normalizedEntrypoint, outputPath),
+      emit: async (normalizedEntrypoint) => await this.emitStrictEntrypoint(normalizedEntrypoint),
       getMissingOutputError: (normalizedEntrypoint, outputPath) => new Error(
         `[HMR] Integration failed to emit entrypoint ${normalizedEntrypoint} to ${outputPath}. Page entrypoints must be produced by their owning integration.`
       )
@@ -255,7 +255,7 @@ class NodeHmrManager {
    * 3. Let the strategy chain try to emit the entrypoint without broadcasting.
    * 4. Fail if the owning integration did not emit the expected output.
    */
-  async emitStrictEntrypoint(entrypointPath, _outputPath) {
+  async emitStrictEntrypoint(entrypointPath) {
     await this.handleFileChange(entrypointPath, { broadcast: false });
   }
   /**

package/src/adapters/node/server-adapter.d.ts

@@ -132,7 +132,7 @@ export declare class NodeServerAdapter extends SharedServerAdapter<NodeServerAda
      * underlying socket closes early — into a 499 response so it does not
      * incorrectly surface as a 500 in application logs.
      */
-    handleRequest(_request: Request): Promise<Response>;
+    handleRequest(request: Request): Promise<Response>;
     /**
      * Called once the HTTP server is bound and listening.
      *
@@ -149,7 +149,7 @@ export declare class NodeServerAdapter extends SharedServerAdapter<NodeServerAda
      * WebSocket upgrade requests that do not target `/_hmr` are rejected with an
      * immediate socket destroy to prevent unhandled upgrade leaks.
      */
-    completeInitialization(_server: NodeServerInstance): Promise<void>;
+    completeInitialization(server: NodeServerInstance): Promise<void>;
 }
 /**
  * Factory function that creates and fully initialises a `NodeServerAdapter`.

package/src/adapters/node/server-adapter.js

@@ -269,12 +269,12 @@ class NodeServerAdapter extends SharedServerAdapter {
    * underlying socket closes early — into a 499 response so it does not
    * incorrectly surface as a 500 in application logs.
    */
-  async handleRequest(_request) {
+  async handleRequest(request) {
     if (!this.initialized) {
       throw new Error("Node server adapter is not initialized. Call createAdapter() first.");
     }
     try {
-      return await this.handleSharedRequest(_request, {
+      return await this.handleSharedRequest(request, {
         apiHandlers: this.apiHandlers,
         errorHandler: this.errorHandler,
         serverInstance: this.serverInstance,
@@ -303,8 +303,8 @@ class NodeServerAdapter extends SharedServerAdapter {
    * WebSocket upgrade requests that do not target `/_hmr` are rejected with an
    * immediate socket destroy to prevent unhandled upgrade leaks.
    */
-  async completeInitialization(_server) {
-    this.serverInstance = _server;
+  async completeInitialization(server) {
+    this.serverInstance = server;
     if (this.options?.watch) {
       const { NodeHmrManager } = await import("./node-hmr-manager.js");
       const { WebSocketServer } = await import("ws");
@@ -313,7 +313,7 @@ class NodeServerAdapter extends SharedServerAdapter {
       this.hmrManager = new NodeHmrManager({ appConfig: this.appConfig, bridge: this.bridge });
       this.hmrManager.setEnabled(true);
       await this.hmrManager.buildRuntime();
-      _server.on("upgrade", (req, socket, head) => {
+      server.on("upgrade", (req, socket, head) => {
         const url = new URL(req.url ?? "/", this.runtimeOrigin);
         if (url.pathname === "/_hmr") {
           wss.handleUpgrade(req, socket, head, (ws) => {

package/src/build/build-adapter.d.ts

@@ -107,6 +107,7 @@ export declare class BunBuildAdapter implements BuildAdapter {
     private mapBunTarget;
     private mapBunFormat;
     private getOutputExtension;
+    private resolveConcreteOutputPath;
     private resolveTemplatedOutputPath;
     private relocateOutputFile;
     private normalizeBunOutputs;
@@ -129,9 +130,10 @@ export declare function createBuildAdapter(options?: {
 export declare const defaultBunBuildAdapter: BuildAdapter;
 export declare const defaultViteHostBuildAdapter: BuildAdapter;
 /**
- * @deprecated Prefer app-owned build state via `getAppBuildAdapter()`.
- * This Bun-native fallback remains only for compatibility with older helpers
- * and tests that do not yet thread app runtime state explicitly.
+ * Bun-native fallback export for callsites that still resolve build state
+ * globally.
+ *
+ * New app-aware code should prefer `getAppBuildAdapter()`.
  */
 export declare const defaultBuildAdapter: BuildAdapter;
 export declare function getDefaultBuildAdapter(ownership?: BuildOwnership): BuildAdapter;
@@ -223,9 +225,9 @@ export declare function setAppBuildExecutor(appConfig: EcoPagesAppConfig, buildE
  */
 export declare function build(options: BuildOptions, executor?: BuildExecutor): Promise<BuildResult>;
 /**
- * @deprecated Prefer `getAppTranspileOptions()` for finalized app/runtime work.
- * This helper exists only for compatibility with Bun-native callsites that do
- * not yet have app context available.
+ * Bun-native fallback helper for callsites without app runtime context.
+ *
+ * New app-aware code should prefer `getAppTranspileOptions()`.
  */
 export declare function getTranspileOptions(profile: BuildTranspileProfile): BuildTranspileOptions;
 export declare function getAppTranspileOptions(appConfig: EcoPagesAppConfig, profile: BuildTranspileProfile): BuildTranspileOptions;

package/src/build/build-adapter.js

@@ -215,7 +215,26 @@ class BunBuildAdapter {
     }
     return options.format === "cjs" || options.format === "esm" ? ".js" : ".js";
   }
-  resolveTemplatedOutputPath(options, entrypointPath) {
+  resolveConcreteOutputPath(outputPath) {
+    if (fs.existsSync(outputPath)) {
+      return outputPath;
+    }
+    if (!outputPath.includes("[hash]")) {
+      return outputPath;
+    }
+    const directory = path.dirname(outputPath);
+    if (!fs.existsSync(directory)) {
+      return void 0;
+    }
+    const basenamePattern = path.basename(outputPath);
+    const matcher = new RegExp(`^${this.escapeRegExp(basenamePattern).replace(/\\\[hash\\\]/g, "(.+)")}$`);
+    const matches = fs.readdirSync(directory).filter((candidate) => matcher.test(candidate)).sort();
+    if (matches.length === 0) {
+      return void 0;
+    }
+    return path.join(directory, matches[0]);
+  }
+  resolveTemplatedOutputPath(options, entrypointPath, concreteOutputPath) {
     if (!options.outdir) {
       return void 0;
     }
@@ -233,6 +252,18 @@ class BunBuildAdapter {
       resolvedPath += outputExtension;
     }
     resolvedPath = resolvedPath.replace(/^\.\//, "");
+    if (resolvedPath.includes("[hash]")) {
+      if (!concreteOutputPath) {
+        return path.join(outdir, resolvedPath);
+      }
+      const concreteRelativePath = path.relative(outdir, concreteOutputPath).split(path.sep).join("/");
+      const matcher = new RegExp(`^${this.escapeRegExp(resolvedPath).replace(/\\\[hash\\\]/g, "(.+)")}$`);
+      const match = concreteRelativePath.match(matcher);
+      if (!match?.[1]) {
+        return concreteOutputPath;
+      }
+      resolvedPath = resolvedPath.replaceAll("[hash]", match[1]);
+    }
     return path.join(outdir, resolvedPath);
   }
   relocateOutputFile(currentPath, targetPath) {
@@ -252,12 +283,16 @@ class BunBuildAdapter {
     const canMapEntrypointsByIndex = options.entrypoints.length === normalizedOutputs.length;
     if (canMapEntrypointsByIndex) {
       for (const [index, entrypointPath] of options.entrypoints.entries()) {
-        const expectedOutputPath = this.resolveTemplatedOutputPath(options, entrypointPath);
+        const concreteOutputPath = this.resolveConcreteOutputPath(normalizedOutputs[index].path);
+        const expectedOutputPath = this.resolveTemplatedOutputPath(options, entrypointPath, concreteOutputPath);
         if (!expectedOutputPath) {
           continue;
         }
         normalizedOutputs[index] = {
-          path: this.relocateOutputFile(normalizedOutputs[index].path, expectedOutputPath)
+          path: this.relocateOutputFile(
+            concreteOutputPath ?? normalizedOutputs[index].path,
+            expectedOutputPath
+          )
         };
       }
       return {
@@ -268,12 +303,13 @@ class BunBuildAdapter {
     return {
       ...result,
       outputs: normalizedOutputs.map((output) => {
-        if (path.extname(output.path) !== "") {
+        const concreteOutputPath = this.resolveConcreteOutputPath(output.path) ?? output.path;
+        if (path.extname(concreteOutputPath) !== "") {
           return output;
         }
-        const normalizedPath = `${output.path}.js`;
+        const normalizedPath = `${concreteOutputPath}.js`;
         return {
-          path: this.relocateOutputFile(output.path, normalizedPath)
+          path: this.relocateOutputFile(concreteOutputPath, normalizedPath)
         };
       })
     };
@@ -448,7 +484,8 @@ async function collectConfiguredAppBuildManifestContributions(appConfig) {
   for (const integration of appConfig.integrations) {
     integration.setConfig(appConfig);
     await integration.prepareBuildContributions();
-    runtimePlugins.push(...integration.plugins);
+    runtimePlugins.push(...integration.plugins ?? []);
+    browserBundlePlugins.push(...integration.browserBuildPlugins ?? []);
   }
   return {
     runtimePlugins,

package/src/eco/eco.js

@@ -1,133 +1,33 @@
-import { createNodeId, createPropsRef, createSlotRef, getComponentRenderContext } from "./component-render-context.js";
-import { createComponentMarker, parseComponentMarkers } from "../route-renderer/component-graph/component-marker.js";
 import {
-  getComponentReference,
-  registerRuntimeComponentHint
-} from "../route-renderer/component-graph/component-reference.js";
-import { addTriggerAttribute, isThenable, wrapWithScriptsInjector } from "./eco.utils.js";
-function isMarkerSerializableTemplateLike(value) {
-  return typeof value === "object" && value !== null && Array.isArray(value.strings) && (value.values === void 0 || Array.isArray(value.values));
-}
-function serializeDeferredChildren(value, seen = /* @__PURE__ */ new Set()) {
-  if (typeof value === "string") {
-    return value;
-  }
-  if (typeof value === "number" || typeof value === "bigint") {
-    return String(value);
-  }
-  if (typeof value === "boolean" || value == null) {
-    return "";
-  }
-  if (Array.isArray(value)) {
-    return value.map((item) => serializeDeferredChildren(item, seen) ?? "").join("");
-  }
-  if (isMarkerSerializableTemplateLike(value)) {
-    const values = value.values ?? [];
-    let html2 = "";
-    for (let index = 0; index < value.strings.length; index += 1) {
-      html2 += value.strings[index] ?? "";
-      if (index < values.length) {
-        html2 += serializeDeferredChildren(values[index], seen) ?? "";
-      }
-    }
-    return html2;
-  }
-  if (typeof value === "object" && value !== null) {
-    if (seen.has(value)) {
-      return "";
-    }
-    seen.add(value);
-    const serialized = Object.values(value).map((entry) => serializeDeferredChildren(entry, seen) ?? "").join("");
-    seen.delete(value);
-    return serialized.length > 0 ? serialized : void 0;
-  }
-  return void 0;
-}
-function getRuntimeComponentHint(render, options) {
-  const stack = new Error().stack;
-  if (stack) {
-    for (const line of stack.split("\n").slice(1)) {
-      const trimmed = line.trim();
-      if (trimmed.includes("/packages/core/src/eco/eco.ts") || trimmed.includes("createComponentFactory") || trimmed.includes("component (") || trimmed.includes("layout (") || trimmed.includes("html (") || trimmed.includes("page (")) {
-        continue;
-      }
-      const match = trimmed.match(/(?:at\s+.*?\()?(.+?:\d+:\d+)\)?$/);
-      if (match?.[1]) {
-        return match[1];
-      }
-    }
-  }
-  const renderSignature = typeof render === "function" ? render.toString() : void 0;
-  if (!renderSignature) {
-    return void 0;
-  }
-  return JSON.stringify({
-    integration: options.integration,
-    render: renderSignature,
-    stylesheets: options.dependencies?.stylesheets,
-    scripts: options.dependencies?.scripts
-  });
-}
+  finalizeComponentRender,
+  interceptComponentBoundary
+} from "../route-renderer/orchestration/component-render-context.js";
+import { isThenable } from "../route-renderer/orchestration/render-output.utils.js";
 function createComponentFactory(options) {
   const integrationName = options.integration ?? options.__eco?.integration;
   const comp = ((props) => {
-    const renderContext = getComponentRenderContext();
-    const shouldEmitMarker = renderContext !== void 0 && renderContext.boundaryContext.decideBoundaryRender({
-      currentIntegration: renderContext.currentIntegration,
-      targetIntegration: integrationName,
-      component: comp
-    }) === "defer";
-    if (shouldEmitMarker && renderContext) {
-      const nodeId = createNodeId(renderContext);
-      const propsRef = createPropsRef(renderContext);
-      const componentRef = getComponentReference(comp);
-      const componentProps = props ?? {};
-      const storedProps = { ...componentProps };
-      const serializedChildren = serializeDeferredChildren(componentProps.children);
-      renderContext.propsByRef[propsRef] = serializedChildren === void 0 ? storedProps : { ...storedProps, children: serializedChildren };
-      let slotRef;
-      if (typeof serializedChildren === "string" && serializedChildren.includes("<eco-marker")) {
-        const childMarkers = parseComponentMarkers(serializedChildren);
-        if (childMarkers.length > 0) {
-          slotRef = createSlotRef(renderContext);
-          renderContext.slotChildrenByRef[slotRef] = childMarkers.map((marker) => marker.nodeId);
-        }
-      }
-      return createComponentMarker({
-        nodeId,
-        integration: integrationName,
-        componentRef,
-        propsRef,
-        slotRef
-      });
+    const componentProps = props ?? {};
+    const renderInline = () => finalizeComponentRender(comp, options.render(props));
+    const boundaryRender = interceptComponentBoundary({
+      component: comp,
+      props: componentProps,
+      targetIntegration: integrationName
+    });
+    if (isThenable(boundaryRender)) {
+      return boundaryRender.then(
+        (resolvedBoundaryRender) => resolvedBoundaryRender !== void 0 ? resolvedBoundaryRender : renderInline()
+      );
     }
-    const content = options.render(props);
-    const lazyTriggers = comp.config?._resolvedLazyTriggers;
-    if (lazyTriggers && lazyTriggers.length > 0) {
-      const triggerId = lazyTriggers[0].triggerId;
-      if (isThenable(content)) {
-        return content.then((resolvedContent) => addTriggerAttribute(resolvedContent, triggerId));
-      }
-      return addTriggerAttribute(content, triggerId);
+    if (boundaryRender !== void 0) {
+      return boundaryRender;
     }
-    const lazyGroups = comp.config?._resolvedLazyScripts;
-    if (lazyGroups && lazyGroups.length > 0) {
-      if (isThenable(content)) {
-        return content.then((resolvedContent) => wrapWithScriptsInjector(resolvedContent, lazyGroups));
-      }
-      return wrapWithScriptsInjector(content, lazyGroups);
-    }
-    return content;
+    return renderInline();
   });
   comp.config = {
     __eco: options.__eco,
     integration: options.integration,
     dependencies: options.dependencies
   };
-  const runtimeHint = getRuntimeComponentHint(options.render, options);
-  if (runtimeHint) {
-    registerRuntimeComponentHint(comp, runtimeHint);
-  }
   return comp;
 }
 function component(options) {

package/src/eco/eco.utils.d.ts

@@ -1,40 +1 @@
-import type { EcoComponent } from '../types/public-types.js';
-/**
- * Returns `true` when `value` is a thenable (Promise-like) object.
- *
- * Used to transparently handle both synchronous and asynchronous component
- * render results without requiring every caller to branch on `instanceof Promise`.
- *
- * @typeParam T Expected resolved type of the thenable.
- */
-export declare function isThenable<T>(value: unknown): value is PromiseLike<T>;
-/**
- * Injects `data-eco-trigger` into the first real HTML element opening tag of
- * a component's rendered output string.
- *
- * The scan skips over leading whitespace, HTML comments (`<!-- -->`), CDATA
- * sections, and doctype declarations so that the attribute is always placed on
- * the first actual element — not spurious markup that can precede it.
- *
- * The insertion point is the end of the element's tag name, before any existing
- * attributes or the closing `>`, which produces output like:
- *
- * ```html
- * <my-element data-eco-trigger="eco-trigger-abc123" class="foo">…</my-element>
- * ```
- *
- * When no eligible opening tag is found the original string is returned
- * unchanged so callers never receive a broken fragment.
- *
- * @param content Rendered HTML string (or any value coercible to string).
- * @param triggerId Stable trigger identifier produced by `buildResolvedLazyTriggers`.
- */
-export declare function addTriggerAttribute(content: unknown, triggerId: string): string;
-/**
- * Wraps rendered component output in a `<scripts-injector>` element that
- * carries an inline injector map for the legacy (non-global-injector) path.
- *
- * @param content Rendered component HTML.
- * @param lazyGroups Resolved lazy script groups attached to the component config.
- */
-export declare function wrapWithScriptsInjector(content: unknown, lazyGroups: NonNullable<EcoComponent['config']>['_resolvedLazyScripts']): string;
+export { addTriggerAttribute, isThenable, wrapWithScriptsInjector, } from '../route-renderer/orchestration/render-output.utils.js';

package/src/eco/eco.utils.js

@@ -1,38 +1,8 @@
-import { buildInjectorMapScript } from "./lazy-injector-map.js";
-function isThenable(value) {
-  return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
-}
-function addTriggerAttribute(content, triggerId) {
-  const str = String(content);
-  let i = 0;
-  while (i < str.length) {
-    if (str[i] !== "<") {
-      i++;
-      continue;
-    }
-    const next = str[i + 1];
-    if (next === "!" || next === "?") {
-      const end = str.indexOf(">", i);
-      if (end === -1) break;
-      i = end + 1;
-      continue;
-    }
-    if (next && /[a-zA-Z]/.test(next)) {
-      const tagSlice = str.slice(i + 1);
-      const nameEnd = tagSlice.search(/[\s/>]/);
-      if (nameEnd === -1) break;
-      const insertAt = i + 1 + nameEnd;
-      return `${str.slice(0, insertAt)} data-eco-trigger="${triggerId}"${str.slice(insertAt)}`;
-    }
-    break;
-  }
-  return str;
-}
-function wrapWithScriptsInjector(content, lazyGroups) {
-  const wrappedContent = String(content);
-  const injectorMapScript = buildInjectorMapScript(lazyGroups ?? []);
-  return `<scripts-injector><script type="ecopages/injector-map">${injectorMapScript}<\/script>${wrappedContent}<\/scripts-injector>`;
-}
+import {
+  addTriggerAttribute,
+  isThenable,
+  wrapWithScriptsInjector
+} from "../route-renderer/orchestration/render-output.utils.js";
 export {
   addTriggerAttribute,
   isThenable,

package/src/hmr/hmr-strategy.d.ts

@@ -18,11 +18,13 @@ import type { ClientBridgeEvent } from '../types/public-types.js';
  *   async process(filePath: string): Promise<HmrAction> {
  *     return {
  *       type: 'broadcast',
- *       events: [{ type: 'update', path: filePath, timestamp: Date.now() }]
+ *       events: [{ type: 'update', path: filePath, timestamp: Date.now() }],
  *     };
  *   }
  * }
-
+ * ```
+ */
+/**
  * Defines the category of an HMR strategy, which determines its execution priority.
  * Strategies are evaluated in descending order: INTEGRATION → ASSET → SCRIPT → FALLBACK.
  *
@@ -63,7 +65,7 @@ export interface HmrAction {
     type: 'broadcast' | 'none';
     /**
      * The HMR events to broadcast, if type is 'broadcast'.
-     * capable of broadcasting multiple events at once.
+     * Multiple events may be broadcast in one action.
      */
     events?: ClientBridgeEvent[];
 }
@@ -75,8 +77,8 @@ export interface HmrAction {
  * whether they match the changed file path.
  *
  * @remarks
- * Strategies should be stateless and idempotent. The same file change should always
- * produce the same result when processed by the same strategy.
+ * Strategies are expected to be stateless and idempotent. The same file change
+ * should produce the same result when processed by the same strategy.
  *
  * @example
  * ```typescript
@@ -121,7 +123,7 @@ export declare abstract class HmrStrategy {
      * Determines if this strategy can handle the given file path.
      *
      * @param filePath - Absolute path to the changed file
-     * @returns True if this strategy should process the file
+     * @returns `true` when this strategy should process the file
      *
      * @example
      * ```typescript