npm - @ecopages/core - Versions diffs - 0.2.0-beta.2 → 0.2.0-beta.20 - Mend

@ecopages/core 0.2.0-beta.2 → 0.2.0-beta.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (273) hide show

package/src/route-renderer/orchestration/integration-renderer.js CHANGED Viewed

@@ -7,18 +7,23 @@ import { HttpError } from "../../errors/http-error.js";
 import { DependencyResolverService } from "../page-loading/dependency-resolver.js";
 import { PageModuleLoaderService } from "../page-loading/page-module-loader.js";
 import { OwnershipValidationService } from "./ownership-validation.service.js";
+import { hasForeignChildDescendantsInGraph } from "./component-graph-collectors.js";
 import {
   RouteRenderOrchestrator
 } from "./route-render-orchestrator.js";
-import { normalizeUnresolvedMarkerArtifactHtml } from "./render-output.utils.js";
+import { createIntegrationRouteRenderAdapter } from "./integration-route-render-adapter.js";
+import { loadPageBrowserGraphContribution } from "./page-browser-graph-contribution.loader.js";
+import { normalizeUnresolvedMarkerArtifactHtml, isMarkupNodeLike } from "./render-output.utils.js";
 import {
   ForeignSubtreeExecutionService
 } from "./foreign-subtree-execution.service.js";
-import {} from "./queued-foreign-subtree-resolution.service.js";
 import { buildProcessedAssetDedupeKey } from "./processed-asset-dedupe.js";
-function isMarkupNodeLike(value) {
-  return typeof value === "object" && value !== null && "nodeType" in value && typeof value.nodeType === "number" && "outerHTML" in value && typeof value.outerHTML === "string";
-}
+import {
+  applyDocumentShellAttributeStamping,
+  composeDocumentShell,
+  renderPageDocumentShell
+} from "./document-shell-render.service.js";
+import { resolveInnermostPageLayout, resolvePageLayoutComponents } from "./layout-shell-props.service.js";
 class IntegrationRenderer {
   appConfig;
   assetProcessingService;
@@ -31,7 +36,22 @@ class IntegrationRenderer {
   pageModuleLoaderService;
   routeRenderOrchestrator;
   foreignSubtreeExecutionService = new ForeignSubtreeExecutionService();
+  /**
+   * Serializes route and view renders that mutate `htmlTransformer` state.
+   *
+   * Integration renderers are cached per integration, so concurrent static builds
+   * and overlapping SSR requests must not share one transformer page package.
+   */
+  renderExclusiveChain = Promise.resolve();
   DOC_TYPE = "<!DOCTYPE html>";
+  runRenderExclusive(operation) {
+    const run = this.renderExclusiveChain.then(operation, operation);
+    this.renderExclusiveChain = run.then(
+      () => void 0,
+      () => void 0
+    );
+    return run;
+  }
   /**
    * Loads one route module through the owning renderer's import path.
    *
@@ -43,52 +63,6 @@ class IntegrationRenderer {
   async loadPageModule(file, options) {
     return this.importPageFile(file, options);
   }
-  /**
-   * Reads the execution-scoped owning-renderer cache from one render input.
-   *
-   * Shared page/layout/document shell helpers pass one cache through
-   * `integrationContext` so repeated delegation to the same foreign integration
-   * can reuse a single initialized renderer instance during one render flow.
-   * The cache is deliberately scoped to the current render execution rather than
-   * stored on the renderer, which avoids leaking mutable integration state across
-   * requests while still preventing redundant renderer initialization.
-   *
-   * @param integrationContext - Optional render context carried with one render input.
-   * @returns The current execution cache when present.
-   */
-  getOwningRendererCache(integrationContext) {
-    if (integrationContext?.rendererCache instanceof Map) {
-      return integrationContext.rendererCache;
-    }
-    return void 0;
-  }
-  getForeignOwnerIntegrationName(component) {
-    const integrationName = component.config?.integration ?? component.config?.__eco?.integration;
-    if (!integrationName || integrationName === this.name) {
-      return void 0;
-    }
-    return this.appConfig.integrations.some((integration) => integration.name === integrationName) ? integrationName : void 0;
-  }
-  /**
-   * Attaches an execution-scoped owning-renderer cache to one render input.
-   *
-   * Foreign-owned page, layout, or document shells may delegate several times in
-   * the same render flow. Threading the cache through `integrationContext`
-   * preserves renderer reuse without changing the public render input contract.
-   * Existing integration-specific context is preserved and augmented.
-   *
-   * @param input - Original render input.
-   * @param rendererCache - Execution-scoped renderer cache to propagate.
-   * @returns Render input augmented with the shared renderer cache.
-   */
-  withOwningRendererCache(input, rendererCache) {
-    const integrationContext = input.integrationContext;
-    const sharedRendererCache = rendererCache;
-    return {
-      ...input,
-      integrationContext: integrationContext ? { ...integrationContext, rendererCache: sharedRendererCache } : { rendererCache: sharedRendererCache }
-    };
-  }
   getRendererModuleValue(key) {
     if (!this.rendererModules || typeof this.rendererModules !== "object") {
       return void 0;
@@ -184,10 +158,11 @@ class IntegrationRenderer {
     return await this.routeRenderOrchestrator.resolveDeclaredPageBrowserGraph({
       routeFile: filePath,
       integrationName: this.name,
-      collectContribution: async (routeFile) => {
-        const pageModule = await this.importPageFile(routeFile);
-        return await this.collectPageBrowserGraphContribution({ file: routeFile, pageModule });
-      }
+      collectContribution: (routeFile) => loadPageBrowserGraphContribution(
+        routeFile,
+        (targetFile) => this.importPageFile(targetFile),
+        (context) => this.collectPageBrowserGraphContribution(context)
+      )
     });
   }
   mergePageBrowserGraphIntoPagePackage(pageBrowserGraph) {
@@ -313,19 +288,25 @@ class IntegrationRenderer {
     await this.prepareViewDependencies(input.view, input.layout);
     const HtmlTemplate = await this.getHtmlTemplate();
     const metadata = await this.resolveViewMetadata(input.view, input.props);
-    const { documentHtml } = await this.composeDocumentShell({
-      primaryComponent: input.view,
-      primaryProps: normalizedProps,
-      layout: input.layout ? {
-        component: input.layout,
-        props: {}
-      } : void 0,
-      htmlTemplate: HtmlTemplate,
-      documentProps: {
-        metadata,
-        pageProps: normalizedProps
+    const { documentHtml } = await composeDocumentShell(
+      {
+        renderComponentWithForeignChildren: (renderInput) => this.renderComponentWithForeignChildren(renderInput),
+        appendProcessedDependencies: (...assetGroups) => this.appendProcessedDependencies(...assetGroups)
+      },
+      {
+        primaryComponent: input.view,
+        primaryProps: normalizedProps,
+        layout: input.layout ? {
+          component: input.layout,
+          props: {}
+        } : void 0,
+        htmlTemplate: HtmlTemplate,
+        documentProps: {
+          metadata,
+          pageProps: normalizedProps
+        }
       }
-    });
+    );
     const html = await this.finalizeResolvedHtml({
       html: `${this.DOC_TYPE}${documentHtml}`,
       partial: false
@@ -345,59 +326,17 @@ class IntegrationRenderer {
    * @returns Final serialized document HTML including the doctype prefix.
    */
   async renderPageWithDocumentShell(input) {
-    const { documentHtml: composedDocumentHtml } = await this.composeDocumentShell({
-      primaryComponent: input.page.component,
-      primaryProps: input.page.props,
-      layout: input.layout,
-      htmlTemplate: input.htmlTemplate,
-      documentProps: {
-        metadata: input.metadata,
-        pageProps: input.pageProps,
-        ...input.documentProps ?? {}
-      }
-    });
-    const documentHtml = input.transformDocumentHtml ? input.transformDocumentHtml(composedDocumentHtml) : composedDocumentHtml;
-    return `${this.DOC_TYPE}${documentHtml}`;
-  }
-  async composeDocumentShell(input) {
-    const rendererCache = /* @__PURE__ */ new Map();
-    const primaryRender = await this.renderComponentWithForeignChildren({
-      component: input.primaryComponent,
-      props: input.primaryProps,
-      integrationContext: { rendererCache }
-    });
-    const layoutRender = input.layout ? await this.renderComponentWithForeignChildren({
-      component: input.layout.component,
-      props: input.layout.props ?? {},
-      children: primaryRender.html,
-      integrationContext: { rendererCache }
-    }) : void 0;
-    const documentRender = await this.renderComponentWithForeignChildren({
-      component: input.htmlTemplate,
-      props: input.documentProps,
-      children: layoutRender?.html ?? primaryRender.html,
-      integrationContext: { rendererCache }
-    });
-    this.appendProcessedDependencies(primaryRender.assets, layoutRender?.assets, documentRender.assets);
-    return {
-      documentHtml: documentRender.html
-    };
+    return renderPageDocumentShell(
+      {
+        renderComponentWithForeignChildren: (renderInput) => this.renderComponentWithForeignChildren(renderInput),
+        appendProcessedDependencies: (...assetGroups) => this.appendProcessedDependencies(...assetGroups)
+      },
+      input,
+      this.DOC_TYPE
+    );
   }
-  /**
-   * Renders one string-first component with serialized children and collects its assets.
-   *
-   * String-oriented integrations frequently share the same component contract:
-   * pass serialized children through props, coerce the render result to HTML, and
-   * attach any component-scoped dependencies. This helper centralizes that flow
-   * so integrations can opt into shared orchestration without repeating the same
-   * string-render boilerplate.
-   *
-   * @param input - Component render input.
-   * @param component - String-oriented component implementation to execute.
-   * @returns Structured component render result for orchestration paths.
-   */
   async renderStringComponentWithSerializedChildren(input, component) {
-    const serializedChildren = input.children === void 0 ? void 0 : typeof input.children === "string" ? input.children : isMarkupNodeLike(input.children) ? input.children.outerHTML : void 0;
+    const serializedChildren = input.children === void 0 ? void 0 : typeof input.children === "string" ? input.children : isMarkupNodeLike(input.children) && typeof input.children.outerHTML === "string" ? input.children.outerHTML : void 0;
     if (input.children !== void 0 && serializedChildren === void 0) {
       const componentFile = input.component.config?.__eco?.file ?? "unknown component";
       const childTag = Object.prototype.toString.call(input.children);
@@ -438,6 +377,18 @@ class IntegrationRenderer {
       this.getForeignSubtreeResolutionContextKey()
     );
   }
+  async resolveQueuedForeignSubtreeHtml(html, runtimeContext, renderQueuedChildren, queueLabel = this.name) {
+    return this.foreignSubtreeExecutionService.resolveQueuedHtml({
+      currentIntegrationName: this.name,
+      html,
+      runtimeContext,
+      queueLabel,
+      getOwningRenderer: (integrationName, rendererCache) => this.getIntegrationRendererForName(integrationName, rendererCache),
+      applyAttributesToFirstElement: (resolvedHtml, attributes) => this.htmlTransformer.applyAttributesToFirstElement(resolvedHtml, attributes),
+      dedupeProcessedAssets: (assets) => this.htmlTransformer.dedupeProcessedAssets(assets),
+      renderQueuedChildren
+    });
+  }
   /**
    * Renders a string-first component, then resolves any queued foreign
    * boundaries before returning final component HTML.
@@ -533,7 +484,7 @@ class IntegrationRenderer {
    * @returns The imported module.
    */
   async importPageFile(file, options) {
-    const bypassCache = options?.bypassCache ?? (typeof Bun !== "undefined" && process.env.NODE_ENV === "development");
+    const bypassCache = options?.bypassCache ?? false;
     const pageModule = this.usesIntegrationPageImporter(file) ? await this.importIntegrationPageFile(file, {
       bypassCache,
       cacheScope: options?.cacheScope
@@ -622,19 +573,20 @@ class IntegrationRenderer {
    * subclasses continue to override protected renderer behavior directly.
    */
   createRouteRenderOrchestratorAdapter() {
-    return {
+    return createIntegrationRouteRenderAdapter({
       name: this.name,
       resolveRouteRenderInputs: (routeOptions) => this.resolveRouteRenderInputs(routeOptions),
       resolveRouteDependencies: (input) => this.resolveRouteDependencies(input),
-      collectPageBrowserGraphContribution: async (routeFile) => {
-        const pageModule = await this.importPageFile(routeFile);
-        return await this.collectPageBrowserGraphContribution({ file: routeFile, pageModule });
-      },
+      importPageFile: (file) => this.importPageFile(file),
+      collectPageBrowserGraphContribution: (context) => this.collectPageBrowserGraphContribution(context),
       resolveRoutePageComponentRender: (input) => this.resolveRoutePageComponentRender(input),
       renderRouteBody: (renderOptions) => this.renderRouteBody(renderOptions),
-      getRouteHtmlFinalization: (renderOptions) => this.getRouteHtmlFinalization(renderOptions),
-      transformRouteResponse: (response, htmlContributions) => this.transformRouteResponse(response, htmlContributions)
-    };
+      getDocumentAttributes: (renderOptions) => this.getDocumentAttributes(renderOptions),
+      getHtmlDocumentContributions: (options) => this.getHtmlDocumentContributions(options),
+      applyAttributesToFirstBodyElement: (html, attributes) => this.applyAttributesToFirstBodyElement(html, attributes),
+      applyAttributesToHtmlElement: (html, attributes) => this.applyAttributesToHtmlElement(html, attributes),
+      transformRouteResponse: (response, htmlContributions, pagePackage) => this.transformRouteResponse(response, htmlContributions, pagePackage)
+    });
   }
   async resolveRouteRenderInputs(routeOptions) {
     const pageModule = await this.pageModuleLoaderService.resolvePageModule({
@@ -643,7 +595,8 @@ class IntegrationRenderer {
     });
     const { Page, integrationSpecificProps } = pageModule;
     const HtmlTemplate = await this.getHtmlTemplate();
-    const Layout = Page.config?.layout;
+    const Layouts = resolvePageLayoutComponents(Page.config?.layouts);
+    const Layout = resolveInnermostPageLayout(Layouts);
     const { props, metadata } = await this.pageModuleLoaderService.resolvePageData({
       pageModule,
       routeOptions
@@ -651,7 +604,9 @@ class IntegrationRenderer {
     return {
       Page,
       HtmlTemplate,
+      Layouts,
       Layout,
+      layoutEntries: Page.config?.layoutEntries,
       props,
       metadata,
       integrationSpecificProps
@@ -681,33 +636,13 @@ class IntegrationRenderer {
   async renderRouteBody(renderOptions) {
     return this.render(renderOptions);
   }
-  getRouteHtmlFinalization(renderOptions) {
-    const componentRootAttributes = renderOptions.componentRender?.canAttachAttributes && renderOptions.componentRender.rootAttributes && Object.keys(renderOptions.componentRender.rootAttributes).length > 0 ? renderOptions.componentRender.rootAttributes : void 0;
-    const documentAttributes = this.getDocumentAttributes(renderOptions);
-    const htmlContributions = this.getHtmlDocumentContributions({ renderOptions, partial: false });
-    const hasStructuralFinalization = componentRootAttributes && Object.keys(componentRootAttributes).length > 0 || documentAttributes && Object.keys(documentAttributes).length > 0;
-    if (!hasStructuralFinalization && (!htmlContributions || htmlContributions.length === 0)) {
-      return {};
-    }
-    return {
+  async transformRouteResponse(response, htmlContributions, pagePackage) {
+    const resolvedPagePackage = this.htmlTransformer.getPagePackage() ?? pagePackage;
+    const transformedResponse = await this.htmlTransformer.transform(
+      response,
       htmlContributions,
-      finalizeHtml: (html) => {
-        let renderedHtml = html;
-        if (componentRootAttributes) {
-          renderedHtml = this.htmlTransformer.applyAttributesToFirstBodyElement(
-            renderedHtml,
-            componentRootAttributes
-          );
-        }
-        if (documentAttributes) {
-          renderedHtml = this.htmlTransformer.applyAttributesToHtmlElement(renderedHtml, documentAttributes);
-        }
-        return renderedHtml;
-      }
-    };
-  }
-  async transformRouteResponse(response, htmlContributions) {
-    const transformedResponse = await this.htmlTransformer.transform(response, htmlContributions);
+      resolvedPagePackage
+    );
     return transformedResponse.body ?? await transformedResponse.text();
   }
   /**
@@ -752,9 +687,12 @@ class IntegrationRenderer {
    * @returns Rendered route body plus effective cache strategy.
    */
   async execute(options) {
-    const adapter = this.createRouteRenderOrchestratorAdapter();
-    const renderOptions = await this.prepareRenderOptions(options, adapter);
-    return this.routeRenderOrchestrator.executePrepared(renderOptions, adapter);
+    return this.runRenderExclusive(async () => {
+      this.htmlTransformer.setProcessedDependencies([]);
+      const adapter = this.createRouteRenderOrchestratorAdapter();
+      const renderOptions = await this.prepareRenderOptions(options, adapter);
+      return this.routeRenderOrchestrator.executePrepared(renderOptions, adapter);
+    });
   }
   /**
    * Finalizes already-resolved HTML for explicit renderer-owned paths.
@@ -766,13 +704,17 @@ class IntegrationRenderer {
   async finalizeResolvedHtml(options) {
     const rendererBootstrapDependencies = this.getRendererBootstrapDependencies(options.partial);
     this.appendProcessedDependencies(rendererBootstrapDependencies);
-    let html = options.html;
-    if (options.componentRootAttributes && Object.keys(options.componentRootAttributes).length > 0) {
-      html = this.htmlTransformer.applyAttributesToFirstBodyElement(html, options.componentRootAttributes);
-    }
-    if (options.documentAttributes && Object.keys(options.documentAttributes).length > 0) {
-      html = this.htmlTransformer.applyAttributesToHtmlElement(html, options.documentAttributes);
-    }
+    let html = applyDocumentShellAttributeStamping(
+      options.html,
+      {
+        applyAttributesToFirstBodyElement: (nextHtml, attributes) => this.htmlTransformer.applyAttributesToFirstBodyElement(nextHtml, attributes),
+        applyAttributesToHtmlElement: (nextHtml, attributes) => this.htmlTransformer.applyAttributesToHtmlElement(nextHtml, attributes)
+      },
+      {
+        componentRootAttributes: options.componentRootAttributes,
+        documentAttributes: options.documentAttributes
+      }
+    );
     const shouldTransform = options.transformHtml ?? !options.partial;
     if (!shouldTransform) {
       return html;
@@ -797,6 +739,12 @@ class IntegrationRenderer {
   getDocumentAttributes(_renderOptions) {
     return void 0;
   }
+  applyAttributesToFirstBodyElement(html, attributes) {
+    return this.htmlTransformer.applyAttributesToFirstBodyElement(html, attributes);
+  }
+  applyAttributesToHtmlElement(html, attributes) {
+    return this.htmlTransformer.applyAttributesToHtmlElement(html, attributes);
+  }
   /**
    * Returns declarative HTML fragments that core should inject into the final document.
    *
@@ -859,22 +807,6 @@ class IntegrationRenderer {
       getOwningRenderer: (integrationName, rendererCache) => this.getIntegrationRendererForName(integrationName, rendererCache)
     });
   }
-  /**
-   * Compatibility foreign-subtree contract that exposes a narrower payload shape for
-   * future route-composition work while preserving the current
-   * `renderComponentWithForeignChildren()` runtime semantics.
-   */
-  async renderForeignSubtree(input) {
-    const result = await this.renderComponentWithForeignChildren(input);
-    return {
-      html: result.html,
-      assets: result.assets ?? [],
-      rootTag: result.rootTag,
-      rootAttributes: result.rootAttributes,
-      attachmentPolicy: result.canAttachAttributes ? { kind: "first-element" } : { kind: "none" },
-      integrationName: result.integrationName
-    };
-  }
   normalizeComponentRenderOutput(result) {
     const normalizedHtml = this.normalizeUnresolvedMarkerArtifactHtml(result.html);
     return normalizedHtml === result.html ? result : {
@@ -893,21 +825,7 @@ class IntegrationRenderer {
    * directly without paying the queue orchestration cost.
    */
   hasForeignChildDescendants(component) {
-    const stack = [component];
-    const seen = /* @__PURE__ */ new Set();
-    while (stack.length > 0) {
-      const current = stack.pop();
-      if (!current || seen.has(current)) {
-        continue;
-      }
-      seen.add(current);
-      const integrationName = current.config?.integration ?? current.config?.__eco?.integration;
-      if (integrationName && integrationName !== this.name) {
-        return true;
-      }
-      stack.push(...current.config?.dependencies?.components ?? []);
-    }
-    return false;
+    return hasForeignChildDescendantsInGraph(component, this.name);
   }
   /**
    * Render a single component and return structured output for orchestration paths.

package/src/route-renderer/orchestration/integration-route-render-adapter.d.ts ADDED Viewed

@@ -0,0 +1,38 @@
+import type { ProcessedAsset } from '../../services/assets/asset-processing-service/index.js';
+import type { HtmlDocumentContribution } from '../../services/html/html-transformer.service.js';
+import type { ComponentRenderResult, 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.
+ */
+export type IntegrationRouteRenderAdapterHost<C> = {
+    readonly name: string;
+    resolveRouteRenderInputs(routeOptions: RouteRendererOptions): Promise<RouteRenderOrchestratorResolvedInputs>;
+    resolveRouteDependencies(input: {
+        components: (EcoComponent | Partial<EcoComponent>)[];
+    }): Promise<{
+        resolvedDependencies: ProcessedAsset[];
+    }>;
+    importPageFile(file: string): Promise<EcoPageFile>;
+    collectPageBrowserGraphContribution(context: PageBrowserGraphContributionContext): Promise<PageBrowserGraphContribution | undefined>;
+    resolveRoutePageComponentRender(input: {
+        Page: EcoComponent;
+        Layout?: EcoComponent;
+        props: Record<string, unknown>;
+        routeOptions: RouteRendererOptions;
+    }): Promise<ComponentRenderResult | undefined>;
+    renderRouteBody(renderOptions: IntegrationRendererRenderOptions<C>): Promise<RouteRendererBody>;
+    getDocumentAttributes(renderOptions: IntegrationRendererRenderOptions<C>): Record<string, string> | undefined;
+    getHtmlDocumentContributions(options: {
+        renderOptions: IntegrationRendererRenderOptions<C>;
+        partial: boolean;
+    }): HtmlDocumentContribution[] | undefined;
+    applyAttributesToFirstBodyElement(html: string, attributes: Record<string, string>): string;
+    applyAttributesToHtmlElement(html: string, attributes: Record<string, string>): string;
+    transformRouteResponse(response: Response, htmlContributions?: HtmlDocumentContribution[], pagePackage?: PagePackageResult): Promise<RouteRendererBody>;
+};
+/**
+ * Builds the internal route-render adapter consumed by `RouteRenderOrchestrator`.
+ */
+export declare function createIntegrationRouteRenderAdapter<C>(host: IntegrationRouteRenderAdapterHost<C>): RouteRenderOrchestratorAdapter<C>;
+export type { RouteHtmlFinalization };

package/src/route-renderer/orchestration/integration-route-render-adapter.js ADDED Viewed

@@ -0,0 +1,27 @@
+import { loadPageBrowserGraphContribution } from "./page-browser-graph-contribution.loader.js";
+import { buildRouteHtmlFinalization } from "./route-html-finalization.service.js";
+function createIntegrationRouteRenderAdapter(host) {
+  return {
+    name: host.name,
+    resolveRouteRenderInputs: (routeOptions) => host.resolveRouteRenderInputs(routeOptions),
+    resolveRouteDependencies: (input) => host.resolveRouteDependencies(input),
+    collectPageBrowserGraphContribution: (routeFile) => loadPageBrowserGraphContribution(
+      routeFile,
+      (file) => host.importPageFile(file),
+      (context) => host.collectPageBrowserGraphContribution(context)
+    ),
+    resolveRoutePageComponentRender: (input) => host.resolveRoutePageComponentRender(input),
+    renderRouteBody: (renderOptions) => host.renderRouteBody(renderOptions),
+    getRouteHtmlFinalization: (renderOptions) => buildRouteHtmlFinalization({
+      renderOptions,
+      getDocumentAttributes: (options) => host.getDocumentAttributes(options),
+      getHtmlDocumentContributions: (options) => host.getHtmlDocumentContributions(options),
+      applyAttributesToFirstBodyElement: (html, attributes) => host.applyAttributesToFirstBodyElement(html, attributes),
+      applyAttributesToHtmlElement: (html, attributes) => host.applyAttributesToHtmlElement(html, attributes)
+    }),
+    transformRouteResponse: (response, htmlContributions, pagePackage) => host.transformRouteResponse(response, htmlContributions, pagePackage)
+  };
+}
+export {
+  createIntegrationRouteRenderAdapter
+};

package/src/route-renderer/orchestration/layout-shell-props.service.d.ts ADDED Viewed

@@ -0,0 +1,20 @@
+import type { EcoPageLayoutEntry, LayoutPropsContext } from '../../types/public-types.js';
+export type LayoutShellPropsContext = LayoutPropsContext & {
+    pageProps?: Record<string, unknown>;
+};
+/**
+ * Resolves the default shell props passed to a layout tier during route render.
+ */
+export declare function resolveLayoutShellProps(context: LayoutShellPropsContext): Record<string, unknown>;
+/**
+ * Resolves props for one layout entry, merging shell props with an optional factory.
+ */
+export declare function resolveLayoutEntryProps(entry: EcoPageLayoutEntry, context: LayoutShellPropsContext): Record<string, unknown>;
+/**
+ * Reads the normalized layout stack from a page component config.
+ */
+export declare function resolvePageLayoutComponents(layouts?: EcoPageLayoutEntry['component'][]): EcoPageLayoutEntry['component'][];
+/**
+ * Returns the innermost layout component from a normalized page layout stack.
+ */
+export declare function resolveInnermostPageLayout(layouts?: EcoPageLayoutEntry['component'][]): EcoPageLayoutEntry['component'] | undefined;

package/src/route-renderer/orchestration/layout-shell-props.service.js ADDED Viewed

@@ -0,0 +1,31 @@
+function resolveLayoutShellProps(context) {
+  return context.locals ? { locals: context.locals } : {};
+}
+function resolveLayoutEntryProps(entry, context) {
+  const shellProps = resolveLayoutShellProps(context);
+  if (!entry.props) {
+    return shellProps;
+  }
+  const layoutPropsContext = {
+    params: context.params,
+    query: context.query,
+    locals: context.locals
+  };
+  return {
+    ...shellProps,
+    ...entry.props(layoutPropsContext)
+  };
+}
+function resolvePageLayoutComponents(layouts) {
+  return layouts && layouts.length > 0 ? layouts : [];
+}
+function resolveInnermostPageLayout(layouts) {
+  const stack = resolvePageLayoutComponents(layouts);
+  return stack[stack.length - 1];
+}
+export {
+  resolveInnermostPageLayout,
+  resolveLayoutEntryProps,
+  resolveLayoutShellProps,
+  resolvePageLayoutComponents
+};

package/src/route-renderer/orchestration/ownership-validation.service.d.ts CHANGED Viewed

@@ -24,6 +24,11 @@ export declare class OwnershipValidationService {
      * Validates foreign ownership edges reachable from the supplied route roots.
      */
     validate(input: OwnershipValidationInput): OwnershipValidationError[];
+    private assertDeclaredComponentDependencies;
     private isRegisteredIntegration;
 }
+/**
+ * Throws when declared ownership validation collected one or more errors.
+ */
+export declare function throwIfOwnershipInvalid(validationErrors: OwnershipValidationError[]): void;
 export {};

package/src/route-renderer/orchestration/ownership-validation.service.js CHANGED Viewed

@@ -1,4 +1,6 @@
+import { assertEcoDeclaredComponent } from "../../eco/eco-declared-component.js";
 import { mapDeclaredOwnershipGraph } from "./declared-ownership-graph.js";
+import { walkComponentGraph } from "./component-graph.js";
 class OwnershipValidationService {
   appConfig;
   /**
@@ -11,6 +13,7 @@ class OwnershipValidationService {
    * Validates foreign ownership edges reachable from the supplied route roots.
    */
   validate(input) {
+    this.assertDeclaredComponentDependencies(input);
     return mapDeclaredOwnershipGraph({
       roots: input.roots,
       currentIntegrationName: input.currentIntegrationName,
@@ -20,6 +23,9 @@ class OwnershipValidationService {
         if (!isForeignToParent) {
           return errors;
         }
+        if (integrationName === "html") {
+          return errors;
+        }
         if (!componentMeta) {
           errors.push({
             code: "MISSING_COMPONENT_METADATA",
@@ -41,6 +47,21 @@ class OwnershipValidationService {
       }
     }).flat();
   }
+  assertDeclaredComponentDependencies(input) {
+    walkComponentGraph({
+      roots: input.roots,
+      currentIntegrationName: input.currentIntegrationName,
+      onComponent: ({ component }) => {
+        const parentFile = component.config?.__eco?.file;
+        for (const child of component.config?.dependencies?.components ?? []) {
+          if (!child) {
+            continue;
+          }
+          assertEcoDeclaredComponent(child, { parentComponentFile: parentFile });
+        }
+      }
+    });
+  }
   isRegisteredIntegration(integrationName, currentIntegrationName) {
     if (integrationName === currentIntegrationName) {
       return true;
@@ -48,6 +69,13 @@ class OwnershipValidationService {
     return this.appConfig.integrations.some((integration) => integration.name === integrationName);
   }
 }
+function throwIfOwnershipInvalid(validationErrors) {
+  if (validationErrors.length === 0) {
+    return;
+  }
+  throw new Error(validationErrors.map((error) => error.message).join("\n"));
+}
 export {
-  OwnershipValidationService
+  OwnershipValidationService,
+  throwIfOwnershipInvalid
 };

package/src/route-renderer/orchestration/page-browser-graph-contribution.loader.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import type { EcoPageFile, PageBrowserGraphContribution, PageBrowserGraphContributionContext } from '../../types/public-types.js';
+/**
+ * Loads a page module once and collects declarative browser-graph requirements.
+ *
+ * @remarks
+ * Shared by route orchestration prep and the integration route-render adapter so
+ * page imports are not duplicated when both paths need the same contribution.
+ */
+export declare function loadPageBrowserGraphContribution(routeFile: string, importPageFile: (file: string) => Promise<EcoPageFile>, collectContribution: (context: PageBrowserGraphContributionContext) => Promise<PageBrowserGraphContribution | undefined>): Promise<PageBrowserGraphContribution | undefined>;

package/src/route-renderer/orchestration/page-browser-graph-contribution.loader.js ADDED Viewed

@@ -0,0 +1,7 @@
+async function loadPageBrowserGraphContribution(routeFile, importPageFile, collectContribution) {
+  const pageModule = await importPageFile(routeFile);
+  return collectContribution({ file: routeFile, pageModule });
+}
+export {
+  loadPageBrowserGraphContribution
+};