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

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 { ComponentRenderResult, 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.
@@ -15,19 +15,12 @@ export type IntegrationRouteRenderAdapterHost<C> = {
     }>;
     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>;
 };

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 {
@@ -10,13 +10,11 @@ function createIntegrationRouteRenderAdapter(host) {
       (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)

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>;
@@ -8,7 +8,6 @@ export type RouteHtmlFinalizationContext<C> = {
         renderOptions: IntegrationRendererRenderOptions<C>;
         partial: boolean;
     }) => HtmlDocumentContribution[] | undefined;
-    applyAttributesToFirstBodyElement: (html: string, attributes: Record<string, string>) => string;
     applyAttributesToHtmlElement: (html: string, attributes: Record<string, string>) => string;
 };
 /**

package/src/route-renderer/orchestration/route-pipeline/route-html-finalization.service.js

@@ -0,0 +1,21 @@
+function buildRouteHtmlFinalization(context) {
+  const { renderOptions } = context;
+  const documentAttributes = context.getDocumentAttributes(renderOptions);
+  const htmlContributions = context.getHtmlDocumentContributions({ renderOptions, partial: false });
+  const hasStructuralFinalization = documentAttributes && Object.keys(documentAttributes).length > 0;
+  if (!hasStructuralFinalization && (!htmlContributions || htmlContributions.length === 0)) {
+    return {};
+  }
+  return {
+    htmlContributions,
+    finalizeHtml: (html) => {
+      if (!documentAttributes || Object.keys(documentAttributes).length === 0) {
+        return html;
+      }
+      return context.applyAttributesToHtmlElement(html, documentAttributes);
+    }
+  };
+}
+export {
+  buildRouteHtmlFinalization
+};

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 { ComponentRenderResult, 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>;
@@ -20,7 +20,6 @@ export declare function buildPreparedRenderOptions<C = unknown>(input: {
     resolvedDependencies: ProcessedAsset[];
     allDependencies: ProcessedAsset[];
     pageBrowserGraph?: PageBrowserGraphResult;
-    componentRender?: ComponentRenderResult;
     appConfig: EcoPagesAppConfig;
 }): IntegrationRendererRenderOptions<C>;
 export {};

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

@@ -1,16 +1,8 @@
-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,
-    componentRender,
-    appConfig
-  } = input;
+  const { routeOptions, resolvedInputs, resolvedDependencies, allDependencies, pageBrowserGraph, appConfig } = input;
   const { Page, HtmlTemplate, Layouts, Layout, layoutEntries, props, metadata, integrationSpecificProps } = resolvedInputs;
   const dedupedDependencies = dedupeProcessedAssets(allDependencies);
   const pagePackage = createPagePackage(dedupedDependencies, { pageBrowserGraph });
@@ -29,7 +21,6 @@ function buildPreparedRenderOptions(input) {
     ...routeOptions,
     resolvedDependencies,
     pagePackage,
-    componentRender,
     HtmlTemplate,
     Layouts,
     Layout,

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 { ComponentRenderResult, 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>;
@@ -46,15 +46,6 @@ export interface RouteRenderOrchestratorAdapter<C> {
      * Collects declarative Page Browser Graph requirements for one route.
      */
     collectPageBrowserGraphContribution(routeFile: string): Promise<PageBrowserGraphContribution | undefined>;
-    /**
-     * Resolves the optional page-root render through the foreign-child-aware component contract.
-     */
-    resolveRoutePageComponentRender(input: {
-        Page: EcoComponent;
-        Layout?: EcoComponent;
-        props: Record<string, unknown>;
-        routeOptions: RouteRendererOptions;
-    }): Promise<ComponentRenderResult | undefined>;
     /**
      * Executes the Integration-specific route render.
      */
@@ -100,8 +91,8 @@ export declare class RouteRenderOrchestrator {
      * Builds normalized route render options before the integration render runs.
      *
      * This preparation step validates route-root ownership, resolves page data,
-     * collects processed assets, captures optional page-root render metadata, and
-     * produces the page package consumed by downstream HTML transformation.
+     * collects processed assets, and produces the page package consumed by downstream
+     * HTML transformation.
      */
     prepareRenderOptions<C = unknown>(routeOptions: RouteRendererOptions, adapter: RouteRenderOrchestratorAdapter<C>): Promise<IntegrationRendererRenderOptions<C>>;
     resolveDeclaredPageBrowserGraph(input: {

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;
@@ -23,12 +26,12 @@ class RouteRenderOrchestrator {
    * Builds normalized route render options before the integration render runs.
    *
    * This preparation step validates route-root ownership, resolves page data,
-   * collects processed assets, captures optional page-root render metadata, and
-   * produces the page package consumed by downstream HTML transformation.
+   * collects processed assets, and produces the page package consumed by downstream
+   * HTML transformation.
    */
   async prepareRenderOptions(routeOptions, adapter) {
     const resolvedInputs = await adapter.resolveRouteRenderInputs(routeOptions);
-    const { Page, HtmlTemplate, Layouts, Layout } = resolvedInputs;
+    const { Page, HtmlTemplate, Layouts } = resolvedInputs;
     const validationErrors = this.ownershipValidationService.validate({
       currentIntegrationName: adapter.name,
       roots: [
@@ -39,7 +42,7 @@ class RouteRenderOrchestrator {
     });
     throwIfOwnershipInvalid(validationErrors);
     const componentsToResolve = [HtmlTemplate, ...Layouts, Page];
-    const [{ resolvedDependencies }, pageBrowserGraph, componentRender] = await Promise.all([
+    const [{ resolvedDependencies }, pageBrowserGraph] = await Promise.all([
       adapter.resolveRouteDependencies({
         components: componentsToResolve
       }),
@@ -47,21 +50,12 @@ class RouteRenderOrchestrator {
         routeFile: routeOptions.file,
         integrationName: adapter.name,
         collectContribution: async (routeFile) => await adapter.collectPageBrowserGraphContribution(routeFile)
-      }),
-      adapter.resolveRoutePageComponentRender({
-        Page,
-        Layout,
-        props: resolvedInputs.props,
-        routeOptions
       })
     ]);
     const allDependencies = [
       ...resolvedDependencies,
       ...collectUsedIntegrationDependenciesFromGraph(this.appConfig, componentsToResolve, adapter.name)
     ];
-    if (componentRender?.assets?.length) {
-      allDependencies.push(...componentRender.assets);
-    }
     const triggers = collectResolvedLazyTriggersFromGraph(componentsToResolve, adapter.name);
     const [globalAssets, eagerSsrLazyAssets] = await Promise.all([
       triggers.length > 0 ? buildGlobalInjectorAssets(this.appConfig, this.assetProcessingService, triggers, adapter.name) : Promise.resolve([]),
@@ -74,7 +68,6 @@ class RouteRenderOrchestrator {
       resolvedDependencies,
       allDependencies,
       pageBrowserGraph,
-      componentRender,
       appConfig: this.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/assets/asset-processing-service/asset-processing.service.js

@@ -16,7 +16,7 @@ import { materializeContentScriptAsset } from "./materialize-content-script-asse
 import {
   getDevBrowserScriptCacheEntry,
   setDevBrowserScriptCacheEntry
-} from "../../../build/dev-browser-script-cache.js";
+} from "../../../build/cache/dev-browser-script-cache.js";
 import {
   ContentScriptProcessor,
   ContentStylesheetProcessor,

package/src/services/assets/asset-processing-service/assets.types.d.ts

@@ -1,4 +1,4 @@
-import type { EcoBuildPlugin } from '../../../build/build-types.js';
+import type { EcoBuildPlugin } from '../../../build/contracts/build-types.js';
 export type AssetSource = 'content' | 'file' | 'node-module';
 export type AssetKind = 'script' | 'stylesheet';
 export type AssetPosition = 'head' | 'body';

package/src/services/assets/asset-processing-service/browser-runtime-asset.factory.d.ts

@@ -1,4 +1,4 @@
-import type { EcoBuildPlugin } from '../../../build/build-types.js';
+import type { EcoBuildPlugin } from '../../../build/contracts/build-types.js';
 import type { AssetDefinition } from './assets.types.js';
 import { type BrowserRuntimeEntryModuleConfig } from './browser-runtime-entry.factory.js';
 export declare const BROWSER_RUNTIME_SCRIPT_ATTRIBUTES: {

package/src/services/assets/asset-processing-service/processors/base/base-script-processor.d.ts

@@ -1,5 +1,4 @@
 import type { EcoPagesAppConfig } from '../../../../../types/internal-types.js';
-import type { EcoBuildPlugin } from '../../../../../build/build-types.js';
 import type { ScriptAsset } from '../../assets.types.js';
 import { BaseProcessor } from './base-processor.js';
 import { type BrowserBundleGroupedEntry } from '../../../browser-bundle.service.js';
@@ -10,7 +9,6 @@ export declare abstract class BaseScriptProcessor<T extends ScriptAsset> extends
     });
     protected shouldBundle(dep: T): boolean;
     protected getBundlerOptions(dep: T): Record<string, any>;
-    protected collectBuildPlugins(excludePluginNames?: string[]): EcoBuildPlugin[];
     protected bundleScript({ entrypoint, outdir, excludeAppBuildPlugins, plugins: additionalPlugins, ...rest }: {
         entrypoint: string;
         outdir: string;

package/src/services/assets/asset-processing-service/processors/base/base-script-processor.js

@@ -1,5 +1,4 @@
 import { appLogger } from "../../../../../global/app-logger.js";
-import { getAppBrowserBuildPlugins } from "../../../../../build/build-adapter.js";
 import { fileSystem } from "@ecopages/file-system";
 import path from "node:path";
 import { BaseProcessor } from "./base-processor.js";
@@ -22,14 +21,6 @@ class BaseScriptProcessor extends BaseProcessor {
     }
     return dep.bundleOptions || {};
   }
-  collectBuildPlugins(excludePluginNames) {
-    const buildPlugins = getAppBrowserBuildPlugins(this.appConfig);
-    if (!excludePluginNames || excludePluginNames.length === 0) {
-      return buildPlugins;
-    }
-    const excluded = new Set(excludePluginNames);
-    return buildPlugins.filter((plugin) => !excluded.has(plugin.name));
-  }
   async bundleScript({
     entrypoint,
     outdir,
@@ -37,8 +28,6 @@ class BaseScriptProcessor extends BaseProcessor {
     plugins: additionalPlugins,
     ...rest
   }) {
-    const buildPlugins = this.collectBuildPlugins(excludeAppBuildPlugins);
-    const allPlugins = additionalPlugins ? [...additionalPlugins, ...buildPlugins] : buildPlugins;
     const buildResult = await this.browserBundleService.bundle({
       profile: "browser-script",
       entrypoints: [entrypoint],
@@ -47,7 +36,7 @@ class BaseScriptProcessor extends BaseProcessor {
       excludeAppBuildPlugins,
       splitting: true,
       naming: "[name]-[hash].[ext]",
-      plugins: allPlugins,
+      plugins: additionalPlugins,
       ...rest
     });
     if (!buildResult.success) {
@@ -86,8 +75,6 @@ class BaseScriptProcessor extends BaseProcessor {
     plugins: additionalPlugins,
     ...rest
   }) {
-    const buildPlugins = this.collectBuildPlugins(excludeAppBuildPlugins);
-    const allPlugins = additionalPlugins ? [...additionalPlugins, ...buildPlugins] : buildPlugins;
     const buildResult = await this.browserBundleService.bundleGroupedEntries(entries, {
       profile: "browser-script",
       outdir,
@@ -96,7 +83,7 @@ class BaseScriptProcessor extends BaseProcessor {
       ...rest,
       splitting: true,
       naming: "[name]-[hash].[ext]",
-      plugins: allPlugins
+      plugins: additionalPlugins
     });
     if (!buildResult.success) {
       for (const log of buildResult.logs) {

package/src/services/assets/asset-processing-service/processors/script/content-script.processor.js

@@ -1,7 +1,7 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
 import { resolveInlineContentScriptBody } from "../../inline-content-script-body.js";
-import { shouldUseDevBrowserScriptCache } from "../../../../../build/dev-browser-script-cache.js";
+import { shouldUseDevBrowserScriptCache } from "../../../../../build/cache/dev-browser-script-cache.js";
 import { BaseScriptProcessor } from "../base/base-script-processor.js";
 class ContentScriptProcessor extends BaseScriptProcessor {
   getContentScriptEntryDir() {

package/src/services/assets/browser-bundle.service.d.ts

@@ -1,6 +1,24 @@
-import type { BuildResult, BuildTranspileProfile } from '../../build/build-adapter.js';
-import type { EcoBuildPlugin } from '../../build/build-types.js';
+import type { BuildResult } from '../../build/build-adapter.js';
+import type { BuildTranspileProfile } from '../../build/build-adapter.js';
+import type { EcoBuildPlugin } from '../../build/contracts/build-types.js';
 import type { EcoPagesAppConfig } from '../../types/internal-types.js';
+/**
+ * Browser-oriented build request accepted by {@link BrowserBundleService}.
+ *
+ * @remarks
+ * `profile` is a {@link BuildTranspileProfile} (transpile settings only).
+ * `executor` selects the {@link BuildRuntime} concurrency slot:
+ * - `'hmr'` + (`hmr-entrypoint` | `hmr-runtime`) → `'browser-hmr'`
+ * - everything else (including `browser-script`, and `'build'`) → `'route-module'`
+ *
+ * Defaults `executor` to `'hmr'`. Request options are always assembled with
+ * browser-hmr *defaults* via {@link createBrowserBuildRequest}; only the
+ * concurrency/dedupe wrapper differs.
+ *
+ * Uses request-scope {@link requestBuildDedupe} plus in-flight
+ * {@link DedupingBuildExecutor} coalescing; both key on
+ * {@link createBuildRequestIdentity}.
+ */
 export type BrowserBundleOptions = {
     entrypoints: string[] | Record<string, string>;
     outdir?: string;
@@ -17,28 +35,10 @@ export type BrowserBundleOptions = {
     external?: string[];
     plugins?: EcoBuildPlugin[];
     executor?: 'build' | 'hmr';
-    [key: string]: unknown;
-    profile: BuildTranspileProfile;
-    excludeAppBuildPlugins?: string[];
-};
-type BrowserBundleGroupedOptions = {
-    outdir?: string;
-    outbase?: string;
-    naming?: string;
-    conditions?: string[];
-    define?: Record<string, string>;
-    minify?: boolean;
-    treeshaking?: boolean;
-    splitting?: boolean;
-    root?: string;
-    bundle?: boolean;
-    externalPackages?: boolean;
-    external?: string[];
-    plugins?: EcoBuildPlugin[];
-    [key: string]: unknown;
     profile: BuildTranspileProfile;
     excludeAppBuildPlugins?: string[];
 };
+type BrowserBundleGroupedOptions = Omit<BrowserBundleOptions, 'entrypoints'>;
 export interface BrowserBundleExecutor {
     bundle(options: BrowserBundleOptions): Promise<BuildResult>;
 }
@@ -50,24 +50,20 @@ export type BrowserBundleGroupedEntry = {
  * App-owned boundary for browser-oriented bundle work.
  *
  * @remarks
- * This service owns the shared browser transpile defaults and ensures browser
- * builds always run through the app-owned executor rather than direct backend
- * calls scattered across HMR and asset processing paths.
+ * Owns shared browser transpile defaults and ensures browser builds run through
+ * the app-owned executor rather than direct backend calls. Assembles a complete
+ * request via {@link createBrowserBuildRequest} before scheduling.
  */
 export declare class BrowserBundleService implements BrowserBundleExecutor {
     private readonly appConfig;
-    /**
-     * Creates the browser bundle boundary for one finalized app instance.
-     */
     constructor(appConfig: EcoPagesAppConfig);
     /**
      * Runs one browser-targeted build through the app-owned executor.
      *
      * @remarks
-     * Browser defaults and app-owned browser build plugins are applied here so HMR
-     * and runtime asset generation do not have to recreate that policy at each call
-     * site. Also forwards {@link getAppSourceTransforms | app source transforms} so
-     * metadata injection runs after boundary/runtime `onLoad` rewrites.
+     * Browser defaults, app-owned browser plugins, and
+     * {@link getAppSourceTransforms | app source transforms} are applied here
+     * so HMR and asset generation do not recreate that policy at each call site.
      */
     bundle(options: BrowserBundleOptions): Promise<BuildResult>;
     bundleGroupedEntries(entries: BrowserBundleGroupedEntry[], options: BrowserBundleGroupedOptions): Promise<BuildResult>;

package/src/services/assets/browser-bundle.service.js

@@ -1,10 +1,8 @@
-import { getAppBrowserBuildPlugins, getAppTranspileOptions } from "../../build/build-adapter.js";
-import { requireBuildRuntime } from "../../build/build-runtime.js";
-import { mergeEcoBuildPlugins } from "../../build/build-manifest.js";
-import { getAppSourceTransforms } from "../../plugins/source-transform.js";
+import { createBrowserBuildRequest } from "../../build/runtime/build-request-policy.js";
+import { requireBuildRuntime } from "../../build/runtime/build-runtime.js";
 import { startupTrace } from "../../diagnostics/startup-trace.js";
 import { requestBuildDedupe } from "../../diagnostics/request-build-dedupe.js";
-import { createBuildOptionsDedupeKey } from "../../build/deduping-build-executor.js";
+import { createBuildRequestIdentity } from "../../build/runtime/build-request-identity.js";
 function resolveBrowserBundleExecutor(appConfig, profile, executor) {
   const buildRuntime = requireBuildRuntime(appConfig);
   if (executor === "hmr" && (profile === "hmr-entrypoint" || profile === "hmr-runtime")) {
@@ -14,9 +12,6 @@ function resolveBrowserBundleExecutor(appConfig, profile, executor) {
 }
 class BrowserBundleService {
   appConfig;
-  /**
-   * Creates the browser bundle boundary for one finalized app instance.
-   */
   constructor(appConfig) {
     this.appConfig = appConfig;
   }
@@ -24,24 +19,18 @@ class BrowserBundleService {
    * Runs one browser-targeted build through the app-owned executor.
    *
    * @remarks
-   * Browser defaults and app-owned browser build plugins are applied here so HMR
-   * and runtime asset generation do not have to recreate that policy at each call
-   * site. Also forwards {@link getAppSourceTransforms | app source transforms} so
-   * metadata injection runs after boundary/runtime `onLoad` rewrites.
+   * Browser defaults, app-owned browser plugins, and
+   * {@link getAppSourceTransforms | app source transforms} are applied here
+   * so HMR and asset generation do not recreate that policy at each call site.
    */
   async bundle(options) {
-    const { profile, excludeAppBuildPlugins, plugins, executor = "hmr", ...rawBuildOptions } = options;
-    const appBrowserPlugins = getAppBrowserBuildPlugins(this.appConfig);
-    const filteredAppBrowserPlugins = excludeAppBuildPlugins && excludeAppBuildPlugins.length > 0 ? appBrowserPlugins.filter((plugin) => !excludeAppBuildPlugins.includes(plugin.name)) : appBrowserPlugins;
-    const request = {
-      ...rawBuildOptions,
-      entrypoints: options.entrypoints,
-      ...getAppTranspileOptions(this.appConfig, profile),
-      plugins: mergeEcoBuildPlugins(plugins, filteredAppBrowserPlugins),
-      sourceTransforms: getAppSourceTransforms(this.appConfig)
-    };
+    const { profile, executor = "hmr", ...requestInput } = options;
+    const request = createBrowserBuildRequest(this.appConfig, {
+      ...requestInput,
+      profile
+    });
     const buildExecutor = resolveBrowserBundleExecutor(this.appConfig, profile, executor);
-    const dedupeKey = createBuildOptionsDedupeKey(request);
+    const dedupeKey = createBuildRequestIdentity(request);
     return requestBuildDedupe.dedupeBuild(dedupeKey, async () => {
       const result = await buildExecutor.build(request);
       startupTrace.recordBrowserBundle(result.outputs);

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/services/module-loading/app-server-module-transpiler.service.d.ts

@@ -5,6 +5,14 @@ import { ServerModuleTranspiler } from './server-module-transpiler.service.js';
 export declare function shouldAppUseHostModuleLoader(appConfig: EcoPagesAppConfig, filePath: string): boolean;
 export declare function getAppHostModuleLoader(appConfig: EcoPagesAppConfig): SourceModuleLoader | undefined;
 export declare function setAppHostModuleLoader(appConfig: EcoPagesAppConfig, hostModuleLoader?: SourceModuleLoader): void;
+/**
+ * Creates the app module loader that imports route modules through the build pipeline.
+ *
+ * @remarks
+ * Caller `plugins` are treated as contributions only.
+ * {@link PageModuleImportService} assembles the complete server request via
+ * {@link createServerBuildRequest}; this loader does not merge app plugins.
+ */
 export declare function createAppModuleLoader(appConfig: EcoPagesAppConfig): AppModuleLoader;
 export declare function getAppModuleLoader(appConfig: EcoPagesAppConfig): AppModuleLoader;
 export declare function setAppModuleLoader(appConfig: EcoPagesAppConfig, appModuleLoader: AppModuleLoader): void;