@ecopages/core 0.2.0-beta.27 → 0.2.0-beta.28

package/src/route-renderer/orchestration/{component-graph.d.ts → ownership-graph/component-graph.d.ts}

@@ -1,4 +1,4 @@
-import type { EcoComponent, OwnershipPlanNodeSource } from '../../types/public-types.js';
+import type { EcoComponent, OwnershipPlanNodeSource } from '../../../types/public-types.js';
 export type DeclaredOwnershipRoot = {
     component: EcoComponent;
     source: Extract<OwnershipPlanNodeSource, 'page' | 'layout' | 'html-template'>;
@@ -32,5 +32,3 @@ export declare function mapComponentGraph<T>(input: {
     currentIntegrationName: string;
     mapNode: (node: DeclaredOwnershipNodeInput, children: T[]) => T;
 }): T[];
-/** @deprecated Use `mapComponentGraph` from `component-graph.ts`. */
-export declare const mapDeclaredOwnershipGraph: typeof mapComponentGraph;

package/src/route-renderer/orchestration/{component-graph.js → ownership-graph/component-graph.js}

@@ -90,9 +90,7 @@ function mapComponentGraph(input) {
     ({ component, source }) => mapComponent(component, source, input.currentIntegrationName, /* @__PURE__ */ new Set())
   );
 }
-const mapDeclaredOwnershipGraph = mapComponentGraph;
 export {
   mapComponentGraph,
-  mapDeclaredOwnershipGraph,
   walkComponentGraph
 };

package/src/route-renderer/orchestration/{ownership-validation.service.d.ts → ownership-graph/ownership-validation.service.d.ts}

@@ -1,5 +1,5 @@
-import type { EcoPagesAppConfig } from '../../types/internal-types.js';
-import type { OwnershipPlanNodeSource, OwnershipValidationError, EcoComponent } from '../../types/public-types.js';
+import type { EcoPagesAppConfig } from '../../../types/internal-types.js';
+import type { OwnershipPlanNodeSource, OwnershipValidationError, EcoComponent } from '../../../types/public-types.js';
 type OwnershipValidationInput = {
     currentIntegrationName: string;
     roots: Array<{

package/src/route-renderer/orchestration/{ownership-validation.service.js → ownership-graph/ownership-validation.service.js}

@@ -1,6 +1,5 @@
-import { assertEcoDeclaredComponent } from "../../eco/eco-declared-component.js";
-import { mapDeclaredOwnershipGraph } from "./declared-ownership-graph.js";
-import { walkComponentGraph } from "./component-graph.js";
+import { assertEcoDeclaredComponent } from "../../../eco/eco-declared-component.js";
+import { mapComponentGraph, walkComponentGraph } from "./component-graph.js";
 class OwnershipValidationService {
   appConfig;
   /**
@@ -14,7 +13,7 @@ class OwnershipValidationService {
    */
   validate(input) {
     this.assertDeclaredComponentDependencies(input);
-    return mapDeclaredOwnershipGraph({
+    return mapComponentGraph({
       roots: input.roots,
       currentIntegrationName: input.currentIntegrationName,
       mapNode: ({ component, integrationName, componentId, isForeignToParent }, children) => {

package/src/route-renderer/orchestration/{global-injector-assets.service.d.ts → page-browser-graph/global-injector-assets.service.d.ts}

@@ -1,6 +1,6 @@
-import type { EcoPagesAppConfig } from '../../types/internal-types.js';
-import type { ResolvedLazyTrigger } from '../../types/public-types.js';
-import { type AssetProcessingService, type ProcessedAsset } from '../../services/assets/asset-processing-service/index.js';
+import type { EcoPagesAppConfig } from '../../../types/internal-types.js';
+import type { ResolvedLazyTrigger } from '../../../types/public-types.js';
+import { type AssetProcessingService, type ProcessedAsset } from '../../../services/assets/asset-processing-service/index.js';
 /**
  * Builds processed global-injector map and bootstrap assets for resolved lazy triggers.
  */

package/src/route-renderer/orchestration/{global-injector-assets.service.js → page-browser-graph/global-injector-assets.service.js}

@@ -2,8 +2,8 @@ import { createRequire } from "node:module";
 import path from "node:path";
 import {
   AssetFactory
-} from "../../services/assets/asset-processing-service/index.js";
-import { buildGlobalInjectorBootstrapContent, buildGlobalInjectorMapScript } from "../../eco/global-injector-map.js";
+} from "../../../services/assets/asset-processing-service/index.js";
+import { buildGlobalInjectorBootstrapContent, buildGlobalInjectorMapScript } from "../../../eco/global-injector-map.js";
 async function buildGlobalInjectorAssets(appConfig, assetProcessingService, triggers, currentIntegrationName) {
   const appProjectDir = appConfig.rootDir ?? appConfig.absolutePaths?.projectDir ?? process.cwd();
   const appPackageRequire = createRequire(path.join(appProjectDir, "package.json"));

package/src/route-renderer/orchestration/{page-browser-graph-contribution.loader.d.ts → page-browser-graph/page-browser-graph-contribution.loader.d.ts}

@@ -1,4 +1,4 @@
-import type { EcoPageFile, PageBrowserGraphContribution, PageBrowserGraphContributionContext } from '../../types/public-types.js';
+import type { EcoPageFile, PageBrowserGraphContribution, PageBrowserGraphContributionContext } from '../../../types/public-types.js';
 /**
  * Loads a page module once and collects declarative browser-graph requirements.
  *

package/src/route-renderer/orchestration/page-browser-graph/page-browser-graph-merge.utils.d.ts

@@ -0,0 +1,12 @@
+import { type ProcessedAsset } from '../../../services/assets/asset-processing-service/index.js';
+import type { PageBrowserGraphResult, PagePackageResult } from '../../../types/public-types.js';
+/**
+ * Merges a page browser graph into an existing page package (or processed dependencies).
+ *
+ * Deduplicates entry/chunk assets against the existing package and rebuilds the
+ * package so downstream HTML finalization sees one canonical graph.
+ */
+export declare function mergePageBrowserGraph(currentPagePackage: PagePackageResult | undefined, processedDependencies: ProcessedAsset[], pageBrowserGraph: PageBrowserGraphResult): {
+    pagePackage: PagePackageResult;
+    mergedGraph: PageBrowserGraphResult;
+};

package/src/route-renderer/orchestration/page-browser-graph/page-browser-graph-merge.utils.js

@@ -0,0 +1,29 @@
+import { createPagePackage } from "../../../services/assets/asset-processing-service/index.js";
+import { buildProcessedAssetDedupeKey, dedupeProcessedAssets } from "./processed-asset-dedupe.js";
+function mergePageBrowserGraph(currentPagePackage, processedDependencies, pageBrowserGraph) {
+  const mergedGraph = currentPagePackage?.pageBrowserGraph ? {
+    entryAssets: dedupeProcessedAssets([
+      ...currentPagePackage.pageBrowserGraph.entryAssets,
+      ...pageBrowserGraph.entryAssets
+    ]),
+    chunkAssets: dedupeProcessedAssets([
+      ...currentPagePackage.pageBrowserGraph.chunkAssets,
+      ...pageBrowserGraph.chunkAssets
+    ])
+  } : pageBrowserGraph;
+  const pageBrowserGraphAssetKeys = new Set(
+    [...mergedGraph.entryAssets, ...mergedGraph.chunkAssets].map((asset) => buildProcessedAssetDedupeKey(asset))
+  );
+  const baseAssets = currentPagePackage ? currentPagePackage.assets.filter(
+    (asset) => !pageBrowserGraphAssetKeys.has(buildProcessedAssetDedupeKey(asset))
+  ) : processedDependencies;
+  return {
+    pagePackage: createPagePackage(dedupeProcessedAssets(baseAssets), {
+      pageBrowserGraph: mergedGraph
+    }),
+    mergedGraph
+  };
+}
+export {
+  mergePageBrowserGraph
+};

package/src/route-renderer/orchestration/{page-browser-graph-session.d.ts → page-browser-graph/page-browser-graph-session.d.ts}

@@ -1,6 +1,6 @@
-import type { EcoPagesAppConfig } from '../../types/internal-types.js';
-import type { PageBrowserGraphContribution, PageBrowserGraphResult } from '../../types/public-types.js';
-import type { ProcessedAsset } from '../../services/assets/asset-processing-service/assets.types.js';
+import type { EcoPagesAppConfig } from '../../../types/internal-types.js';
+import type { PageBrowserGraphContribution, PageBrowserGraphResult } from '../../../types/public-types.js';
+import type { ProcessedAsset } from '../../../services/assets/asset-processing-service/assets.types.js';
 export type GraphPolicy = 'development' | 'production';
 export type GraphKey = {
     integrationName: string;

package/src/route-renderer/orchestration/{page-browser-graph-session.js → page-browser-graph/page-browser-graph-session.js}

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { createHash } from "node:crypto";
-import { appLogger } from "../../global/app-logger.js";
+import { appLogger } from "../../../global/app-logger.js";
 function isSkipCacheGroupedOutcome(outcome) {
   return "skipCache" in outcome;
 }

package/src/route-renderer/orchestration/{page-browser-graph.service.d.ts → page-browser-graph/page-browser-graph.service.d.ts}

@@ -1,6 +1,6 @@
-import type { EcoPagesAppConfig } from '../../types/internal-types.js';
-import type { PageBrowserGraphContribution, PageBrowserGraphResult } from '../../types/public-types.js';
-import { type AssetProcessingService } from '../../services/assets/asset-processing-service/index.js';
+import type { EcoPagesAppConfig } from '../../../types/internal-types.js';
+import type { PageBrowserGraphContribution, PageBrowserGraphResult } from '../../../types/public-types.js';
+import { type AssetProcessingService } from '../../../services/assets/asset-processing-service/index.js';
 import { type GraphPolicy } from './page-browser-graph-session.js';
 export type PageBrowserGraphResolveInput = {
     routeFile: string;

package/src/route-renderer/orchestration/{page-browser-graph.service.js → page-browser-graph/page-browser-graph.service.js}

@@ -1,9 +1,9 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
 import {
-} from "../../services/assets/asset-processing-service/index.js";
-import { appLogger } from "../../global/app-logger.js";
-import { startupTrace } from "../../diagnostics/startup-trace.js";
+} from "../../../services/assets/asset-processing-service/index.js";
+import { appLogger } from "../../../global/app-logger.js";
+import { startupTrace } from "../../../diagnostics/startup-trace.js";
 import {
   collectPageBrowserGraphDependencyPaths,
   createPageBrowserGraphEntryFingerprint,

package/src/route-renderer/orchestration/{processed-asset-dedupe.d.ts → page-browser-graph/processed-asset-dedupe.d.ts}

@@ -1,3 +1,3 @@
-import type { ProcessedAsset } from '../../services/assets/asset-processing-service/index.js';
+import type { ProcessedAsset } from '../../../services/assets/asset-processing-service/index.js';
 export declare function buildProcessedAssetDedupeKey(asset: ProcessedAsset): string;
 export declare function dedupeProcessedAssets(assets: ProcessedAsset[]): ProcessedAsset[];

package/src/route-renderer/orchestration/{integration-route-render-adapter.d.ts → route-pipeline/integration-route-render-adapter.d.ts}

@@ -1,6 +1,6 @@
-import type { ProcessedAsset } from '../../services/assets/asset-processing-service/index.js';
-import type { HtmlDocumentContribution } from '../../services/html/html-transformer.service.js';
-import type { EcoComponent, EcoPageFile, IntegrationRendererRenderOptions, PageBrowserGraphContribution, PageBrowserGraphContributionContext, PagePackageResult, RouteRendererBody, RouteRendererOptions } from '../../types/public-types.js';
+import type { ProcessedAsset } from '../../../services/assets/asset-processing-service/index.js';
+import type { HtmlDocumentContribution } from '../../../services/html/html-transformer.service.js';
+import type { EcoComponent, EcoPageFile, IntegrationRendererRenderOptions, PageBrowserGraphContribution, PageBrowserGraphContributionContext, PagePackageResult, RouteRendererBody, RouteRendererOptions } from '../../../types/public-types.js';
 import type { RouteHtmlFinalization, RouteRenderOrchestratorAdapter, RouteRenderOrchestratorResolvedInputs } from './route-render-orchestrator.js';
 /**
  * Host surface required to build the orchestrator adapter for one integration renderer.

package/src/route-renderer/orchestration/{integration-route-render-adapter.js → route-pipeline/integration-route-render-adapter.js}

@@ -1,4 +1,4 @@
-import { loadPageBrowserGraphContribution } from "./page-browser-graph-contribution.loader.js";
+import { loadPageBrowserGraphContribution } from "../page-browser-graph/page-browser-graph-contribution.loader.js";
 import { buildRouteHtmlFinalization } from "./route-html-finalization.service.js";
 function createIntegrationRouteRenderAdapter(host) {
   return {

package/src/route-renderer/orchestration/route-pipeline/marker-artifact.utils.d.ts

@@ -0,0 +1,6 @@
+export declare function decodeHtmlEntities(value: string): string;
+export declare function normalizeUnresolvedMarkerArtifactHtml(html: string): string;
+export declare function inspectUnresolvedMarkerArtifactHtml(html: string): {
+    hasUnresolvedMarkerArtifacts: boolean;
+    normalizedHtml: string;
+};

package/src/route-renderer/orchestration/route-pipeline/marker-artifact.utils.js

@@ -0,0 +1,27 @@
+function decodeHtmlEntities(value) {
+  let decoded = value;
+  let previous;
+  do {
+    previous = decoded;
+    decoded = decoded.replaceAll("&quot;", '"').replaceAll("&#39;", "'").replaceAll("&#x27;", "'").replaceAll("&lt;", "<").replaceAll("&gt;", ">").replaceAll("&amp;", "&");
+  } while (decoded !== previous);
+  return decoded;
+}
+function normalizeUnresolvedMarkerArtifactHtml(html) {
+  return html.replace(
+    /&(?:amp;)?lt;eco-marker\b[\s\S]*?&(?:amp;)?gt;&(?:amp;)?lt;\/eco-marker&(?:amp;)?gt;/g,
+    (marker) => decodeHtmlEntities(marker)
+  );
+}
+function inspectUnresolvedMarkerArtifactHtml(html) {
+  const normalizedHtml = normalizeUnresolvedMarkerArtifactHtml(html);
+  return {
+    normalizedHtml,
+    hasUnresolvedMarkerArtifacts: normalizedHtml.includes("<eco-marker")
+  };
+}
+export {
+  decodeHtmlEntities,
+  inspectUnresolvedMarkerArtifactHtml,
+  normalizeUnresolvedMarkerArtifactHtml
+};

package/src/route-renderer/orchestration/{route-html-finalization.service.d.ts → route-pipeline/route-html-finalization.service.d.ts}

@@ -1,5 +1,5 @@
-import type { HtmlDocumentContribution } from '../../services/html/html-transformer.service.js';
-import type { IntegrationRendererRenderOptions } from '../../types/public-types.js';
+import type { HtmlDocumentContribution } from '../../../services/html/html-transformer.service.js';
+import type { IntegrationRendererRenderOptions } from '../../../types/public-types.js';
 import type { RouteHtmlFinalization } from './route-render-orchestrator.js';
 export type RouteHtmlFinalizationContext<C> = {
     renderOptions: IntegrationRendererRenderOptions<C>;

package/src/route-renderer/orchestration/{route-prepared-options.builder.d.ts → route-pipeline/route-prepared-options.builder.d.ts}

@@ -1,6 +1,6 @@
-import type { EcoPagesAppConfig } from '../../types/internal-types.js';
-import type { EcoComponent, EcoPageComponent, EcoPageFile, HtmlTemplateProps, IntegrationRendererRenderOptions, PageBrowserGraphResult, PageMetadataProps, EcoPageLayoutEntry, RouteRendererOptions } from '../../types/public-types.js';
-import { type ProcessedAsset } from '../../services/assets/asset-processing-service/index.js';
+import type { EcoPagesAppConfig } from '../../../types/internal-types.js';
+import type { EcoComponent, EcoPageComponent, EcoPageFile, HtmlTemplateProps, IntegrationRendererRenderOptions, PageBrowserGraphResult, PageMetadataProps, EcoPageLayoutEntry, RouteRendererOptions } from '../../../types/public-types.js';
+import { type ProcessedAsset } from '../../../services/assets/asset-processing-service/index.js';
 type PreparedRenderInputs = {
     Page: EcoPageFile['default'] | EcoPageComponent<any>;
     HtmlTemplate: EcoComponent<HtmlTemplateProps>;

package/src/route-renderer/orchestration/{route-prepared-options.builder.js → route-pipeline/route-prepared-options.builder.js}

@@ -1,5 +1,5 @@
-import { createPagePackage } from "../../services/assets/asset-processing-service/index.js";
-import { dedupeProcessedAssets } from "./processed-asset-dedupe.js";
+import { createPagePackage } from "../../../services/assets/asset-processing-service/index.js";
+import { dedupeProcessedAssets } from "../page-browser-graph/processed-asset-dedupe.js";
 import { createPageLocalsProxy } from "./route-prepared-options.utils.js";
 function buildPreparedRenderOptions(input) {
   const { routeOptions, resolvedInputs, resolvedDependencies, allDependencies, pageBrowserGraph, appConfig } = input;

package/src/route-renderer/orchestration/{route-prepared-options.utils.js → route-pipeline/route-prepared-options.utils.js}

@@ -1,4 +1,4 @@
-import { LocalsAccessError } from "../../errors/locals-access-error.js";
+import { LocalsAccessError } from "../../../errors/locals-access-error.js";
 function createPageLocalsProxy(filePath) {
   const errorMessage = `[ecopages] Request locals are only available during request-time rendering with cache: 'dynamic'. Page: ${filePath}. If you meant to use locals here, set cache: 'dynamic' and provide locals from route middleware/handlers.`;
   return new Proxy(

package/src/route-renderer/orchestration/{route-render-orchestrator.d.ts → route-pipeline/route-render-orchestrator.d.ts}

@@ -1,9 +1,9 @@
-import type { EcoPagesAppConfig } from '../../types/internal-types.js';
-import type { EcoComponent, EcoPageComponent, EcoPageFile, HtmlTemplateProps, IntegrationRendererRenderOptions, PageBrowserGraphContribution, PageBrowserGraphResult, PageMetadataProps, RouteRendererBody, RouteRendererOptions, RouteRenderResult, EcoPageLayoutEntry } from '../../types/public-types.js';
-import type { AssetProcessingService, ProcessedAsset } from '../../services/assets/asset-processing-service/index.js';
-import type { HtmlDocumentContribution } from '../../services/html/html-transformer.service.js';
-import { OwnershipValidationService } from './ownership-validation.service.js';
-import { PageBrowserGraphService } from './page-browser-graph.service.js';
+import type { EcoPagesAppConfig } from '../../../types/internal-types.js';
+import type { EcoComponent, EcoPageComponent, EcoPageFile, HtmlTemplateProps, IntegrationRendererRenderOptions, PageBrowserGraphContribution, PageBrowserGraphResult, PageMetadataProps, RouteRendererBody, RouteRendererOptions, RouteRenderResult, EcoPageLayoutEntry } from '../../../types/public-types.js';
+import type { AssetProcessingService, ProcessedAsset } from '../../../services/assets/asset-processing-service/index.js';
+import type { HtmlDocumentContribution } from '../../../services/html/html-transformer.service.js';
+import { OwnershipValidationService } from '../ownership-graph/ownership-validation.service.js';
+import { PageBrowserGraphService } from '../page-browser-graph/page-browser-graph.service.js';
 export type RouteRenderOrchestratorResolvedInputs = {
     Page: EcoPageFile['default'] | EcoPageComponent<any>;
     HtmlTemplate: EcoComponent<HtmlTemplateProps>;

package/src/route-renderer/orchestration/{route-render-orchestrator.js → route-pipeline/route-render-orchestrator.js}

@@ -1,12 +1,15 @@
-import { inspectUnresolvedMarkerArtifactHtml } from "./render-output.utils.js";
-import { OwnershipValidationService, throwIfOwnershipInvalid } from "./ownership-validation.service.js";
+import { inspectUnresolvedMarkerArtifactHtml } from "./marker-artifact.utils.js";
+import {
+  OwnershipValidationService,
+  throwIfOwnershipInvalid
+} from "../ownership-graph/ownership-validation.service.js";
 import {
   buildEagerSsrLazyAssetsFromGraph,
   collectResolvedLazyTriggersFromGraph,
   collectUsedIntegrationDependenciesFromGraph
-} from "./component-graph-collectors.js";
-import { buildGlobalInjectorAssets } from "./global-injector-assets.service.js";
-import { PageBrowserGraphService } from "./page-browser-graph.service.js";
+} from "../ownership-graph/component-graph-collectors.js";
+import { buildGlobalInjectorAssets } from "../page-browser-graph/global-injector-assets.service.js";
+import { PageBrowserGraphService } from "../page-browser-graph/page-browser-graph.service.js";
 import { buildPreparedRenderOptions } from "./route-prepared-options.builder.js";
 class RouteRenderOrchestrator {
   appConfig;

package/src/route-renderer/orchestration/string-markup-renderer.js

@@ -1,5 +1,5 @@
 import { IntegrationRenderer } from "./integration-renderer.js";
-import { resolveInnermostPageLayout } from "./layout-shell-props.service.js";
+import { resolveInnermostPageLayout } from "./document-shell/layout-shell-props.service.js";
 class StringMarkupRenderer extends IntegrationRenderer {
   async renderComponent(input) {
     if (typeof input.component !== "function") {

package/src/services/html/html-transformer.service.js

@@ -4,7 +4,7 @@ import {
 import {
   buildProcessedAssetDedupeKey,
   dedupeProcessedAssets
-} from "../../route-renderer/orchestration/processed-asset-dedupe.js";
+} from "../../route-renderer/orchestration/page-browser-graph/processed-asset-dedupe.js";
 class HtmlTransformerService {
   processedDependencies = [];
   pagePackage;

package/src/services/invalidation/development-invalidation.service.d.ts

@@ -87,6 +87,11 @@ export declare class DevelopmentInvalidationService {
     isServerModuleSourceFile(filePath: string): boolean;
     /**
      * Returns whether a processor owns the changed file as an asset input.
+     *
+     * @remarks
+     * Watch config drives processor notifications only. Asset ownership requires
+     * declared capabilities so dependency-only watches (for example content
+     * collection MDX scans) do not skip server invalidation and HMR.
      */
     isProcessorOwnedAsset(filePath: string): boolean;
 }

package/src/services/invalidation/development-invalidation.service.js

@@ -218,21 +218,20 @@ class DevelopmentInvalidationService {
   }
   /**
    * Returns whether a processor owns the changed file as an asset input.
+   *
+   * @remarks
+   * Watch config drives processor notifications only. Asset ownership requires
+   * declared capabilities so dependency-only watches (for example content
+   * collection MDX scans) do not skip server invalidation and HMR.
    */
   isProcessorOwnedAsset(filePath) {
     for (const processor of this.appConfig.processors.values()) {
       const capabilities = processor.getAssetCapabilities?.() ?? [];
-      if (capabilities.length > 0) {
-        const matchesConfiguredAsset = typeof processor.matchesFileFilter !== "function" || processor.matchesFileFilter(filePath);
-        if (matchesConfiguredAsset && capabilities.some((capability) => processor.canProcessAsset?.(capability.kind, filePath))) {
-          return true;
-        }
+      if (capabilities.length === 0) {
         continue;
       }
-      const watchConfig = processor.getWatchConfig();
-      if (!watchConfig) continue;
-      const { extensions = [] } = watchConfig;
-      if (extensions.length && extensions.some((ext) => filePath.endsWith(ext))) {
+      const matchesConfiguredAsset = typeof processor.matchesFileFilter !== "function" || processor.matchesFileFilter(filePath);
+      if (matchesConfiguredAsset && capabilities.some((capability) => processor.canProcessAsset?.(capability.kind, filePath))) {
         return true;
       }
     }

package/src/static-site-generator/production-page-browser-graph-prebuild.js

@@ -1,5 +1,5 @@
 import path from "node:path";
-import { getAppPageBrowserGraphSession } from "../route-renderer/orchestration/page-browser-graph-session.js";
+import { getAppPageBrowserGraphSession } from "../route-renderer/orchestration/page-browser-graph/page-browser-graph-session.js";
 function shouldPrebuildProductionPageBrowserGraphs() {
   return process.env.NODE_ENV === "production";
 }

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

@@ -12,7 +12,7 @@ import type { DevGraphService } from '../services/runtime-state/dev-graph.servic
 import type { AppModuleLoader } from '../services/module-loading/app-module-loader.service.js';
 import type { SourceModuleLoader } from '../services/module-loading/module-loading-types.js';
 import type { EntrypointDependencyGraph } from '../services/runtime-state/entrypoint-dependency-graph.service.js';
-import type { SessionPageBrowserGraphCache } from '../route-renderer/orchestration/page-browser-graph-session.js';
+import type { SessionPageBrowserGraphCache } from '../route-renderer/orchestration/page-browser-graph/page-browser-graph-session.js';
 import type { ServerInvalidationState } from '../services/runtime-state/server-invalidation-state.service.js';
 import type { ServerModuleTranspiler } from '../services/module-loading/server-module-transpiler.service.js';
 import type { RouteModuleBuildCache } from '../services/module-loading/route-module-build-cache.store.js';

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

@@ -1,7 +1,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 { ForeignChildRuntime } from '../route-renderer/orchestration/component-render-context.js';
+import type { ForeignChildRuntime } from '../route-renderer/orchestration/foreign-child/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';

package/src/watchers/project-watcher.d.ts

@@ -116,9 +116,9 @@ export declare class ProjectWatcher {
      */
     private matchesAdditionalWatchPaths;
     /**
-     * Checks if a file is handled by a processor.
-     * Processors that declare asset capabilities own those file types.
-     * Processors without capabilities fall back to checking watch extensions.
+     * Checks if a file is owned by a processor as an asset input.
+     * Ownership requires declared asset capabilities; watch config only drives
+     * {@link notifyProcessors} notifications.
      */
     private isHandledByProcessor;
     /**

package/src/watchers/project-watcher.js

@@ -6,7 +6,7 @@ import {
   DevelopmentInvalidationService
 } from "../services/invalidation/development-invalidation.service.js";
 import { prepareHmrFileChange } from "../hmr/hmr-file-change-prep.js";
-import { getAppPageBrowserGraphSession } from "../route-renderer/orchestration/page-browser-graph-session.js";
+import { getAppPageBrowserGraphSession } from "../route-renderer/orchestration/page-browser-graph/page-browser-graph-session.js";
 import { isRegisteredScriptEntrypoint } from "../hmr/hmr-entrypoint-output.js";
 import { resolveInternalExecutionDir } from "../utils/resolve-work-dir.js";
 import { createProjectWatcherIgnorePredicate } from "./project-watcher-ignore.js";
@@ -275,9 +275,9 @@ class ProjectWatcher {
     return this.invalidationService.matchesAdditionalWatchPaths(filePath);
   }
   /**
-   * Checks if a file is handled by a processor.
-   * Processors that declare asset capabilities own those file types.
-   * Processors without capabilities fall back to checking watch extensions.
+   * Checks if a file is owned by a processor as an asset input.
+   * Ownership requires declared asset capabilities; watch config only drives
+   * {@link notifyProcessors} notifications.
    */
   isHandledByProcessor(filePath) {
     return this.invalidationService.isProcessorOwnedAsset(filePath);

package/src/route-renderer/orchestration/declared-ownership-graph.d.ts

@@ -1 +0,0 @@
-export { mapComponentGraph, mapDeclaredOwnershipGraph, type ComponentGraphRoot, type ComponentGraphWalkInput, type DeclaredOwnershipNodeInput, type DeclaredOwnershipRoot, } from './component-graph.js';

package/src/route-renderer/orchestration/declared-ownership-graph.js

@@ -1,8 +0,0 @@
-import {
-  mapComponentGraph,
-  mapDeclaredOwnershipGraph
-} from "./component-graph.js";
-export {
-  mapComponentGraph,
-  mapDeclaredOwnershipGraph
-};

package/src/route-renderer/orchestration/template-serialization.d.ts

@@ -1,38 +0,0 @@
-/**
- * Minimal template-result shape that core can serialize generically.
- *
- * @remarks
- * Core intentionally models only the transport shape used during deferred
- * cross-integration child passing: alternating static string segments plus
- * interpolated runtime values. Concrete runtime markers that identify a given
- * framework's template payload must stay outside core and be registered by the
- * owning integration package.
- */
-export type SerializableTemplateShape = {
-    strings: readonly string[];
-    values?: readonly unknown[];
-};
-/**
- * Integration-owned adapter that teaches core how to serialize one deferred
- * template payload shape.
- *
- * @remarks
- * The separation here is intentional: core owns the HTML serialization logic,
- * but integrations own runtime-shape detection. That keeps package-specific
- * markers such as framework template sentinels out of core while still letting
- * deferred children round-trip through mixed renderer boundaries.
- */
-export type DeferredTemplateSerializer<TTemplate extends SerializableTemplateShape = SerializableTemplateShape> = {
-    matches(value: unknown): value is TTemplate;
-    serialize(template: TTemplate, serializeValue: (value: unknown) => string | undefined): string;
-};
-/**
- * Serializes a generic template shape into HTML.
- *
- * @remarks
- * This handles only HTML reconstruction semantics: quoted attribute values,
- * boolean attributes, and omission of client-only event or property bindings.
- * It does not decide whether an arbitrary value belongs to a framework-specific
- * template runtime; integrations must make that decision before delegating here.
- */
-export declare function serializeTemplateShape(template: SerializableTemplateShape, serializeValue: (value: unknown) => string | undefined): string;

package/src/route-renderer/orchestration/template-serialization.js

@@ -1,45 +0,0 @@
-import { escapeHtmlAttribute } from "../../utils/html-escaping.js";
-const ATTRIBUTE_TAIL_PATTERN = /(\s+)([@.?!]?)([^\s"'<>/=`@.?!]+)=$/;
-function getSerializableTemplateAttribute(stringPart) {
-  const match = ATTRIBUTE_TAIL_PATTERN.exec(stringPart);
-  if (!match) return void 0;
-  return {
-    leading: stringPart.slice(0, match.index),
-    whitespace: match[1],
-    prefix: match[2],
-    name: match[3]
-  };
-}
-function serializeTemplateShape(template, serializeValue) {
-  const values = template.values ?? [];
-  let html = "";
-  for (let index = 0; index < values.length; index += 1) {
-    const stringPart = template.strings[index] ?? "";
-    const serializedValue = serializeValue(values[index]);
-    const attribute = getSerializableTemplateAttribute(stringPart);
-    if (!attribute) {
-      html += stringPart;
-      html += serializedValue ?? "";
-      continue;
-    }
-    html += attribute.leading;
-    if (attribute.prefix === "@" || attribute.prefix === "!" || attribute.prefix === ".") {
-      continue;
-    }
-    if (attribute.prefix === "?") {
-      if (serializedValue) {
-        html += `${attribute.whitespace}${attribute.name}`;
-      }
-      continue;
-    }
-    if (serializedValue === void 0) {
-      continue;
-    }
-    html += `${attribute.whitespace}${attribute.name}="${escapeHtmlAttribute(serializedValue)}"`;
-  }
-  html += template.strings[values.length] ?? "";
-  return html;
-}
-export {
-  serializeTemplateShape
-};