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

package/src/route-renderer/orchestration/render-preparation.service.js

@@ -5,9 +5,6 @@ import {
   AssetFactory
 } from "../../services/assets/asset-processing-service/index.js";
 import { buildGlobalInjectorBootstrapContent, buildGlobalInjectorMapScript } from "../../eco/global-injector-map.js";
-import {
-  runWithComponentRenderContext
-} from "./component-render-context.js";
 class RenderPreparationService {
   appConfig;
   assetProcessingService;
@@ -38,7 +35,7 @@ class RenderPreparationService {
    */
   async prepare(routeOptions, currentIntegrationName, callbacks) {
     const pageModule = await callbacks.resolvePageModule(routeOptions.file);
-    const { Page, integrationSpecificProps, componentGraphContext: explicitComponentGraphContext } = pageModule;
+    const { Page, integrationSpecificProps } = pageModule;
     const HtmlTemplate = await callbacks.getHtmlTemplate();
     const { props, metadata } = await callbacks.resolvePageData(pageModule, routeOptions);
     const Layout = Page.config?.layout;
@@ -51,20 +48,14 @@ class RenderPreparationService {
     const pageDeps = await callbacks.buildRouteRenderAssets(routeOptions.file) || [];
     const allDependencies = [...resolvedDependencies, ...usedIntegrationDependencies, ...pageDeps];
     let componentRender;
-    let componentGraphContext = explicitComponentGraphContext;
     if (callbacks.shouldRenderPageComponent({ Page, Layout, options: routeOptions })) {
       const pageRootRender = await this.renderPageRoot({
-        currentIntegrationName,
         Page,
         props,
         routeOptions,
         callbacks
       });
       componentRender = pageRootRender.componentRender;
-      componentGraphContext = this.mergeGraphContext(
-        pageRootRender.componentGraphContext,
-        explicitComponentGraphContext
-      );
       if (componentRender.assets?.length) {
         allDependencies.push(...componentRender.assets);
       }
@@ -94,7 +85,6 @@ class RenderPreparationService {
       ...routeOptions,
       resolvedDependencies,
       componentRender,
-      componentGraphContext,
       HtmlTemplate,
       Layout,
       props,
@@ -112,18 +102,6 @@ class RenderPreparationService {
       ...preparedOptions
     };
   }
-  mergeGraphContext(capturedGraphContext, explicitGraphContext) {
-    return {
-      propsByRef: {
-        ...capturedGraphContext.propsByRef ?? {},
-        ...explicitGraphContext?.propsByRef ?? {}
-      },
-      slotChildrenByRef: {
-        ...capturedGraphContext.slotChildrenByRef ?? {},
-        ...explicitGraphContext?.slotChildrenByRef ?? {}
-      }
-    };
-  }
   /**
    * Collects resolved lazy trigger metadata from the component tree.
    *
@@ -215,13 +193,8 @@ class RenderPreparationService {
    * @returns Structured component render result.
    */
   async renderPageRoot(input) {
-    const execution = await runWithComponentRenderContext(
-      {
-        currentIntegration: input.currentIntegrationName,
-        boundaryContext: input.callbacks.getComponentRenderBoundaryContext(),
-        serializeDeferredValue: input.callbacks.serializeDeferredValue
-      },
-      async () => input.callbacks.renderPageComponent({
+    return {
+      componentRender: await input.callbacks.renderPageComponent({
         component: input.Page,
         props: {
           ...input.props,
@@ -229,10 +202,6 @@ class RenderPreparationService {
           query: input.routeOptions.query || {}
         }
       })
-    );
-    return {
-      componentRender: execution.value,
-      componentGraphContext: execution.graphContext
     };
   }
   /**

package/src/route-renderer/page-loading/dependency-resolver.js

@@ -34,7 +34,12 @@ function extractEcopagesVirtualImports(file) {
     const namedImports = [];
     for (const spec of node.specifiers ?? []) {
       if (spec.type === "ImportSpecifier") {
-        const importedName = spec.imported?.type === "Identifier" ? spec.imported.name : spec.imported?.type === "Literal" ? spec.imported.value : spec.local?.name;
+        let importedName = spec.local?.name;
+        if (spec.imported?.type === "Identifier") {
+          importedName = spec.imported.name;
+        } else if (spec.imported?.type === "Literal") {
+          importedName = spec.imported.value;
+        }
         namedImports.push(importedName);
       }
     }

package/src/route-renderer/page-loading/page-module-loader.d.ts

@@ -1,4 +1,4 @@
-import type { ComponentGraphContext, EcoPageFile, GetMetadata, GetMetadataContext, GetStaticProps, PageMetadataProps, RouteRendererOptions, EcoPageComponent } from '../../types/public-types.js';
+import type { EcoPageFile, GetMetadata, GetMetadataContext, GetStaticProps, PageMetadataProps, RouteRendererOptions, EcoPageComponent } from '../../types/public-types.js';
 import type { EcoPagesAppConfig } from '../../types/internal-types.js';
 /**
  * Loads route page modules and normalizes their data hooks for rendering.
@@ -66,7 +66,6 @@ export declare class PageModuleLoaderService {
         Page: EcoPageFile['default'] | EcoPageComponent<any>;
         getStaticProps?: GetStaticProps<Record<string, unknown>>;
         getMetadata?: GetMetadata;
-        componentGraphContext?: ComponentGraphContext;
         integrationSpecificProps: Record<string, unknown>;
     }>;
     /**

package/src/route-renderer/page-loading/page-module-loader.js

@@ -88,14 +88,12 @@ class PageModuleLoaderService {
       default: Page,
       getStaticProps: moduleGetStaticProps,
       getMetadata: moduleGetMetadata,
-      componentGraphContext,
       ...integrationSpecificProps
     } = module;
     return {
       Page,
       getStaticProps: Page.staticProps ?? moduleGetStaticProps,
       getMetadata: Page.metadata ?? moduleGetMetadata,
-      componentGraphContext,
       integrationSpecificProps
     };
   }

package/src/router/client/navigation-coordinator.js

@@ -16,7 +16,7 @@ function getCandidateOwners(currentOwner, registrations, excludedOwner) {
   }
   return owners;
 }
-function createEcoNavigationRuntime(_windowObject) {
+function createEcoNavigationRuntime() {
   const registrations = /* @__PURE__ */ new Map();
   const listeners = /* @__PURE__ */ new Set();
   let owner = "none";
@@ -204,7 +204,7 @@ function getEcoNavigationRuntime(windowObject = window) {
   const runtimeWindow = windowObject;
   runtimeWindow.__ECO_PAGES__ = runtimeWindow.__ECO_PAGES__ || {};
   if (!runtimeWindow.__ECO_PAGES__.navigation) {
-    runtimeWindow.__ECO_PAGES__.navigation = createEcoNavigationRuntime(runtimeWindow);
+    runtimeWindow.__ECO_PAGES__.navigation = createEcoNavigationRuntime();
   }
   return runtimeWindow.__ECO_PAGES__.navigation;
 }

package/src/router/server/fs-router-scanner.js

@@ -113,7 +113,12 @@ class FSRouterScanner {
     const filePath = path.join(this.dir, file);
     const isCatchAll = filePath.includes("[...");
     const isDynamic = !isCatchAll && filePath.includes("[") && filePath.includes("]");
-    const kind = isCatchAll ? "catch-all" : isDynamic ? "dynamic" : "exact";
+    let kind = "exact";
+    if (isCatchAll) {
+      kind = "catch-all";
+    } else if (isDynamic) {
+      kind = "dynamic";
+    }
     return { route, routePath, filePath, kind };
   }
   async scan() {

package/src/services/runtime-state/dev-graph.service.d.ts

@@ -32,7 +32,7 @@ export declare class NoopDevGraphService implements DevGraphService {
     /**
      * Invalidates all server-side module state by incrementing the shared version.
      */
-    invalidateServerModules(_changedFiles?: string[]): void;
+    invalidateServerModules(changedFiles?: string[]): void;
     /**
      * Indicates that this graph cannot target invalidation to one entrypoint set.
      */
@@ -41,19 +41,19 @@ export declare class NoopDevGraphService implements DevGraphService {
      * Returns an empty entrypoint set because this implementation stores no
      * dependency graph metadata.
      */
-    getDependencyEntrypoints(_filePath: string): Set<string>;
+    getDependencyEntrypoints(filePath: string): Set<string>;
     /**
      * Accepts dependency updates to preserve interface compatibility, but stores no
      * graph state in the noop implementation.
      */
-    setEntrypointDependencies(_entrypointPath: string, _dependencies: string[]): void;
+    setEntrypointDependencies(entrypointPath: string, dependencies: string[]): void;
     /**
      * Clears one entrypoint from the graph.
      *
      * @remarks
      * There is no stored graph state in this implementation, so this is a no-op.
      */
-    clearEntrypointDependencies(_entrypointPath: string): void;
+    clearEntrypointDependencies(entrypointPath: string): void;
     /**
      * Resets graph-owned state for a fresh runtime cycle.
      */
@@ -82,7 +82,7 @@ export declare class InMemoryDevGraphService implements DevGraphService {
      * modules. Selective dependency lookups are used by callers that need to limit
      * browser rebuild work.
      */
-    invalidateServerModules(_changedFiles?: string[]): void;
+    invalidateServerModules(changedFiles?: string[]): void;
     /**
      * Indicates that this graph can answer dependency-to-entrypoint lookups.
      */

package/src/services/runtime-state/dev-graph.service.js

@@ -21,8 +21,8 @@ class NoopDevGraphService {
   /**
    * Invalidates all server-side module state by incrementing the shared version.
    */
-  invalidateServerModules(_changedFiles) {
-    this.invalidationState.invalidateServerModules(_changedFiles);
+  invalidateServerModules(changedFiles) {
+    this.invalidationState.invalidateServerModules(changedFiles);
   }
   /**
    * Indicates that this graph cannot target invalidation to one entrypoint set.
@@ -34,15 +34,15 @@ class NoopDevGraphService {
    * Returns an empty entrypoint set because this implementation stores no
    * dependency graph metadata.
    */
-  getDependencyEntrypoints(_filePath) {
-    return this.dependencyGraph.getDependencyEntrypoints(_filePath);
+  getDependencyEntrypoints(filePath) {
+    return this.dependencyGraph.getDependencyEntrypoints(filePath);
   }
   /**
    * Accepts dependency updates to preserve interface compatibility, but stores no
    * graph state in the noop implementation.
    */
-  setEntrypointDependencies(_entrypointPath, _dependencies) {
-    this.dependencyGraph.setEntrypointDependencies(_entrypointPath, _dependencies);
+  setEntrypointDependencies(entrypointPath, dependencies) {
+    this.dependencyGraph.setEntrypointDependencies(entrypointPath, dependencies);
   }
   /**
    * Clears one entrypoint from the graph.
@@ -50,8 +50,8 @@ class NoopDevGraphService {
    * @remarks
    * There is no stored graph state in this implementation, so this is a no-op.
    */
-  clearEntrypointDependencies(_entrypointPath) {
-    this.dependencyGraph.clearEntrypointDependencies(_entrypointPath);
+  clearEntrypointDependencies(entrypointPath) {
+    this.dependencyGraph.clearEntrypointDependencies(entrypointPath);
   }
   /**
    * Resets graph-owned state for a fresh runtime cycle.
@@ -78,8 +78,8 @@ class InMemoryDevGraphService {
    * modules. Selective dependency lookups are used by callers that need to limit
    * browser rebuild work.
    */
-  invalidateServerModules(_changedFiles) {
-    this.invalidationState.invalidateServerModules(_changedFiles);
+  invalidateServerModules(changedFiles) {
+    this.invalidationState.invalidateServerModules(changedFiles);
   }
   /**
    * Indicates that this graph can answer dependency-to-entrypoint lookups.

package/src/types/public-types.d.ts

@@ -2,7 +2,7 @@ import type { Readable } from 'node:stream';
 import type { ApiResponseBuilder } from '../adapters/shared/api-response.js';
 import type { BuildExecutor } from '../build/build-adapter.js';
 import type { EcoBuildPlugin } from '../build/build-types.js';
-import type { ComponentGraphContext } from '../route-renderer/orchestration/component-render-context.js';
+import type { ComponentBoundaryRuntime } from '../route-renderer/orchestration/component-render-context.js';
 import type { EcoPageComponent } from '../eco/eco.types.js';
 import type { EcoPagesAppConfig } from './internal-types.js';
 import type { HmrStrategy } from '../hmr/hmr-strategy.js';
@@ -12,10 +12,9 @@ import type { CacheStats, CacheStrategy } from '../services/cache/cache.types.js
 import type { InteractionEventsString as ScriptsInjectorInteractionEventsString } from '@ecopages/scripts-injector/types';
 export type { EcoPagesAppConfig } from './internal-types.js';
 export type { EcoPageComponent } from '../eco/eco.types.js';
-export type { MarkerGraphContext } from '../route-renderer/component-graph/marker-graph-resolver.js';
 export type { ProcessedAsset } from '../services/assets/asset-processing-service/assets.types.js';
 import type { StandardSchema, StandardSchemaResult, StandardSchemaSuccessResult, StandardSchemaFailureResult, StandardSchemaIssue, InferOutput } from '../services/validation/standard-schema.types.js';
-export type { StandardSchema, StandardSchemaResult, StandardSchemaSuccessResult, StandardSchemaFailureResult, StandardSchemaIssue, InferOutput, ComponentGraphContext, };
+export type { StandardSchema, StandardSchemaResult, StandardSchemaSuccessResult, StandardSchemaFailureResult, StandardSchemaIssue, InferOutput, ComponentBoundaryRuntime, };
 export type InteractionEventsString = ScriptsInjectorInteractionEventsString;
 export type DependencyLazyTrigger = {
     'on:idle': true;
@@ -573,7 +572,6 @@ export type EcoPageFile<T = unknown> = T & {
     getStaticPaths?: GetStaticPaths;
     getStaticProps?: GetStaticProps<Record<string, unknown>>;
     getMetadata?: GetMetadata;
-    componentGraphContext?: ComponentGraphContext;
     cache?: CacheStrategy;
 };
 /**
@@ -677,7 +675,6 @@ export type IntegrationRendererRenderOptions<C = EcoPagesElement> = RouteRendere
     dependencies?: EcoComponentDependencies;
     resolvedDependencies: ProcessedAsset[];
     componentRender?: ComponentRenderResult;
-    componentGraphContext?: ComponentGraphContext;
     pageProps?: Record<string, unknown>;
     cacheStrategy?: CacheStrategy;
     pageLocals?: RequestLocals;

package/src/eco/component-render-context.d.ts

@@ -1,2 +0,0 @@
-export { finalizeComponentRender, getComponentRenderContext, runWithComponentRenderContext, tryRenderDeferredBoundary, } from '../route-renderer/orchestration/component-render-context.js';
-export type { BoundaryRenderDecisionInput, BoundaryRenderMode, ComponentGraphContext, ComponentRenderBoundaryContext, ComponentRenderContext, } from '../route-renderer/orchestration/component-render-context.js';

package/src/eco/component-render-context.js

@@ -1,12 +0,0 @@
-import {
-  finalizeComponentRender,
-  getComponentRenderContext,
-  runWithComponentRenderContext,
-  tryRenderDeferredBoundary
-} from "../route-renderer/orchestration/component-render-context.js";
-export {
-  finalizeComponentRender,
-  getComponentRenderContext,
-  runWithComponentRenderContext,
-  tryRenderDeferredBoundary
-};

package/src/route-renderer/component-graph/component-graph-executor.d.ts

@@ -1,33 +0,0 @@
-import type { ComponentMarker } from './component-marker.js';
-import type { ComponentGraph } from './component-graph.js';
-/**
- * Render result returned by a graph node resolver.
- *
- * `html` is inserted in place of the corresponding marker token.
- */
-export type GraphNodeRenderResult = {
-    html: string;
-};
-/**
- * Callback used to render one marker node during graph execution.
- *
- * Resolver implementations may call integration-specific `renderComponent`
- * and can use closure state to wire child output into parent render calls.
- */
-export type GraphNodeResolver = (marker: ComponentMarker) => Promise<GraphNodeRenderResult>;
-/**
- * Resolves all markers in bottom-up order based on computed graph levels.
- *
- * Child nodes are resolved first so parent slot content can consume already
- * resolved child HTML in subsequent resolver invocations.
- *
- * Nodes discovered from serialized props may not exist as literal marker tokens in
- * `inputHtml`. They still resolve so parent nodes can consume their resolved child
- * HTML, while replacement in the outer HTML buffer remains a no-op.
- *
- * @param inputHtml HTML containing marker tokens.
- * @param graph Precomputed marker graph with topological levels.
- * @param resolver Async callback that renders each marker node.
- * @returns HTML with resolved markers replaced.
- */
-export declare function resolveComponentGraph(inputHtml: string, graph: ComponentGraph, resolver: GraphNodeResolver): Promise<string>;

package/src/route-renderer/component-graph/component-graph-executor.js

@@ -1,30 +0,0 @@
-function escapeRegex(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function replaceMarkerByNodeId(html, nodeId, replacement) {
-  const pattern = `<eco-marker[^>]*data-eco-node-id="${escapeRegex(nodeId)}"[^>]*><\\/eco-marker>`;
-  const markerRegex = new RegExp(pattern);
-  return html.replace(markerRegex, replacement);
-}
-async function resolveComponentGraph(inputHtml, graph, resolver) {
-  let html = inputHtml;
-  const markersById = /* @__PURE__ */ new Map();
-  for (const node of graph.nodes.values()) {
-    markersById.set(node.nodeId, node);
-  }
-  const levels = [...graph.levels].reverse();
-  for (const level of levels) {
-    for (const nodeId of level) {
-      const marker = markersById.get(nodeId);
-      if (!marker) {
-        continue;
-      }
-      const result = await resolver(marker);
-      html = replaceMarkerByNodeId(html, nodeId, result.html);
-    }
-  }
-  return html;
-}
-export {
-  resolveComponentGraph
-};

package/src/route-renderer/component-graph/component-graph.d.ts

@@ -1,53 +0,0 @@
-import type { ComponentMarker, MarkerNodeId } from './component-marker.js';
-/**
- * Maps a parent slot reference to child marker node ids discovered in that slot.
- *
- * Keys are `slotRef` values emitted in marker payloads.
- */
-export type SlotChildrenRegistry = Record<string, MarkerNodeId[]>;
-/**
- * Serializable props captured for deferred marker nodes.
- *
- * The graph builder reads this registry to discover child markers that were not
- * emitted into the outer HTML stream because they were captured inside a
- * deferred parent's serialized `children` prop.
- */
-export type PropsRegistry = Record<string, Record<string, unknown>>;
-/**
- * Graph node enriched with source-order information for deterministic traversal.
- */
-export type ComponentGraphNode = ComponentMarker & {
-    order: number;
-};
-/**
- * Directed acyclic graph representation for component marker orchestration.
- *
- * `levels` are topological layers from roots to leaves.
- */
-export type ComponentGraph = {
-    nodes: Map<MarkerNodeId, ComponentGraphNode>;
-    edges: Map<MarkerNodeId, Set<MarkerNodeId>>;
-    reverseEdges: Map<MarkerNodeId, Set<MarkerNodeId>>;
-    levels: MarkerNodeId[][];
-};
-/**
- * Extracts marker graph metadata from rendered HTML and slot linkage data.
- *
- * This is the canonical graph builder used by marker execution.
- *
- * Algorithm summary:
- * 1. Parse markers from HTML in source order.
- * 2. Discover nested child markers captured inside serialized `children` props.
- * 3. Create nodes and derive edges from `slotChildrenRegistry`.
- * 3. Compute deterministic topological levels.
- *
- * Unknown child node ids in `slotChildrenRegistry` are ignored to keep the
- * extractor tolerant to stale references.
- *
- * @param html Rendered HTML containing `eco-marker` tokens.
- * @param slotChildrenRegistry Optional slot -> child linkage map.
- * @param propsRegistry Optional props registry used to discover nested markers
- * captured inside deferred parent `children` props.
- * @returns Component graph structure with levels ready for execution.
- */
-export declare function extractComponentGraph(html: string, slotChildrenRegistry?: SlotChildrenRegistry, propsRegistry?: PropsRegistry): ComponentGraph;

package/src/route-renderer/component-graph/component-graph.js

@@ -1,94 +0,0 @@
-import { parseComponentMarkers } from "./component-marker.js";
-function readNestedChildMarkers(marker, propsRegistry) {
-  const children = propsRegistry[marker.propsRef]?.children;
-  if (typeof children !== "string" || !children.includes("<eco-marker")) {
-    return [];
-  }
-  return parseComponentMarkers(children);
-}
-function ensureEdgeMaps(edges, reverseEdges, from, to) {
-  if (!edges.has(from)) {
-    edges.set(from, /* @__PURE__ */ new Set());
-  }
-  if (!reverseEdges.has(to)) {
-    reverseEdges.set(to, /* @__PURE__ */ new Set());
-  }
-  edges.get(from)?.add(to);
-  reverseEdges.get(to)?.add(from);
-}
-function computeLevels(nodes, edges, reverseEdges) {
-  const indegree = /* @__PURE__ */ new Map();
-  for (const nodeId of nodes.keys()) {
-    indegree.set(nodeId, reverseEdges.get(nodeId)?.size ?? 0);
-  }
-  const levels = [];
-  let frontier = [...nodes.values()].filter((node) => (indegree.get(node.nodeId) ?? 0) === 0).sort((a, b) => a.order - b.order).map((node) => node.nodeId);
-  const visited = /* @__PURE__ */ new Set();
-  while (frontier.length > 0) {
-    levels.push(frontier);
-    const next = [];
-    for (const current of frontier) {
-      visited.add(current);
-      for (const child of edges.get(current) ?? []) {
-        const nextInDegree = (indegree.get(child) ?? 0) - 1;
-        indegree.set(child, nextInDegree);
-        if (nextInDegree === 0) {
-          next.push(child);
-        }
-      }
-    }
-    frontier = next.filter((nodeId, index) => next.indexOf(nodeId) === index).sort((a, b) => {
-      const orderA = nodes.get(a)?.order ?? 0;
-      const orderB = nodes.get(b)?.order ?? 0;
-      return orderA - orderB;
-    });
-  }
-  if (visited.size !== nodes.size) {
-    throw new Error("[ecopages] Component marker graph contains a cycle or unresolved dependency links.");
-  }
-  return levels;
-}
-function extractComponentGraph(html, slotChildrenRegistry = {}, propsRegistry = {}) {
-  const markers = parseComponentMarkers(html);
-  const nodes = /* @__PURE__ */ new Map();
-  const edges = /* @__PURE__ */ new Map();
-  const reverseEdges = /* @__PURE__ */ new Map();
-  const discoveredMarkers = [];
-  const registerMarker = (marker) => {
-    if (nodes.has(marker.nodeId)) {
-      return false;
-    }
-    discoveredMarkers.push(marker);
-    nodes.set(marker.nodeId, {
-      ...marker,
-      order: discoveredMarkers.length - 1
-    });
-    return true;
-  };
-  for (const marker of markers) {
-    registerMarker(marker);
-  }
-  for (let index = 0; index < discoveredMarkers.length; index += 1) {
-    const marker = discoveredMarkers[index];
-    for (const nestedMarker of readNestedChildMarkers(marker, propsRegistry)) {
-      registerMarker(nestedMarker);
-    }
-  }
-  for (const marker of discoveredMarkers) {
-    if (!marker.slotRef) {
-      continue;
-    }
-    const linkedChildren = slotChildrenRegistry[marker.slotRef] ?? [];
-    for (const childNodeId of linkedChildren) {
-      if (!nodes.has(childNodeId)) {
-        continue;
-      }
-      ensureEdgeMaps(edges, reverseEdges, marker.nodeId, childNodeId);
-    }
-  }
-  const levels = computeLevels(nodes, edges, reverseEdges);
-  return { nodes, edges, reverseEdges, levels };
-}
-export {
-  extractComponentGraph
-};

package/src/route-renderer/component-graph/component-marker.d.ts

@@ -1,52 +0,0 @@
-/**
- * Stable marker node identifier used during one render graph resolution pass.
- *
- * @example
- * `n_12`
- */
-export type MarkerNodeId = `n_${string}`;
-/**
- * Marker payload used by graph extraction and execution.
- *
- * Each marker references:
- * - the owning integration renderer (`integration`)
- * - a component definition key (`componentRef`)
- * - a serialized props key (`propsRef`)
- * - optional child-slot linkage (`slotRef`)
- */
-export type ComponentMarker = {
-    nodeId: MarkerNodeId;
-    integration: string;
-    componentRef: string;
-    propsRef: string;
-    slotRef?: string;
-};
-/**
- * Input contract for marker emission.
- *
- * This shape is intentionally close to `ComponentMarker` to keep emission and
- * parsing symmetric.
- */
-export type MarkerRenderInput = {
-    nodeId: MarkerNodeId;
-    integration: string;
-    componentRef: string;
-    propsRef: string;
-    slotRef?: string;
-};
-/**
- * Creates the canonical `<eco-marker>` token used for deferred component rendering.
- *
- * @param input Marker payload fields.
- * @returns Serialized marker HTML token.
- */
-export declare function createComponentMarker(input: MarkerRenderInput): string;
-/**
- * Parses all valid `<eco-marker>` tokens from HTML output.
- *
- * Invalid markers (missing required attributes) are ignored by design.
- *
- * @param html Rendered HTML fragment or document.
- * @returns Parsed marker payloads in source order.
- */
-export declare function parseComponentMarkers(html: string): ComponentMarker[];

package/src/route-renderer/component-graph/component-marker.js

@@ -1,44 +0,0 @@
-import { escapeHtmlAttribute } from "../../utils/html-escaping.js";
-function readAttribute(tag, name) {
-  const match = tag.match(new RegExp(`${name}="([^"]*)"`));
-  return match?.[1];
-}
-function createComponentMarker(input) {
-  const attributes = [
-    `data-eco-node-id="${escapeHtmlAttribute(input.nodeId)}"`,
-    `data-eco-integration="${escapeHtmlAttribute(input.integration)}"`,
-    `data-eco-component-ref="${escapeHtmlAttribute(input.componentRef)}"`,
-    `data-eco-props-ref="${escapeHtmlAttribute(input.propsRef)}"`
-  ];
-  if (input.slotRef) {
-    attributes.push(`data-eco-slot-ref="${escapeHtmlAttribute(input.slotRef)}"`);
-  }
-  return `<eco-marker ${attributes.join(" ")}></eco-marker>`;
-}
-function parseComponentMarkers(html) {
-  const markerRegex = /<eco-marker\b[^>]*><\/eco-marker>/g;
-  const results = [];
-  for (let match = markerRegex.exec(html); match; match = markerRegex.exec(html)) {
-    const tag = match[0];
-    const nodeId = readAttribute(tag, "data-eco-node-id");
-    const integration = readAttribute(tag, "data-eco-integration");
-    const componentRef = readAttribute(tag, "data-eco-component-ref");
-    const propsRef = readAttribute(tag, "data-eco-props-ref");
-    const slotRef = readAttribute(tag, "data-eco-slot-ref");
-    if (!nodeId || !integration || !componentRef || !propsRef) {
-      continue;
-    }
-    results.push({
-      nodeId,
-      integration,
-      componentRef,
-      propsRef,
-      slotRef
-    });
-  }
-  return results;
-}
-export {
-  createComponentMarker,
-  parseComponentMarkers
-};

package/src/route-renderer/component-graph/component-reference.d.ts

@@ -1,10 +0,0 @@
-import type { EcoComponent } from '../../types/public-types.js';
-/**
- * Resolves a stable component reference for marker emission and lookup.
- *
- * Build-time metadata remains the preferred source. When a component is
- * imported directly from source on the server and metadata has not been
- * injected, fall back to a process-local stable runtime reference so explicit
- * request-time rendering can still resolve deferred boundaries.
- */
-export declare function getComponentReference(component: EcoComponent): string;