@ecopages/core 0.2.0-beta.3 → 0.2.0-beta.31

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;
@@ -16,28 +34,11 @@ export type BrowserBundleOptions = {
     externalPackages?: boolean;
     external?: string[];
     plugins?: EcoBuildPlugin[];
-    [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;
+    executor?: 'build' | 'hmr';
     profile: BuildTranspileProfile;
     excludeAppBuildPlugins?: string[];
 };
+type BrowserBundleGroupedOptions = Omit<BrowserBundleOptions, 'entrypoints'>;
 export interface BrowserBundleExecutor {
     bundle(options: BrowserBundleOptions): Promise<BuildResult>;
 }
@@ -49,23 +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.
+     * 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,17 @@
-import { getAppBrowserBuildPlugins, getAppBuildExecutor, getAppTranspileOptions } from "../../build/build-adapter.js";
-import { mergeEcoBuildPlugins } from "../../build/build-manifest.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 { 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")) {
+    return buildRuntime.getProfile("browser-hmr");
+  }
+  return buildRuntime.getProfile("route-module");
+}
 class BrowserBundleService {
   appConfig;
-  /**
-   * Creates the browser bundle boundary for one finalized app instance.
-   */
   constructor(appConfig) {
     this.appConfig = appConfig;
   }
@@ -12,26 +19,28 @@ 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.
+   * 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, ...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)
-    };
-    return await getAppBuildExecutor(this.appConfig).build(request);
+    const { profile, executor = "hmr", ...requestInput } = options;
+    const request = createBrowserBuildRequest(this.appConfig, {
+      ...requestInput,
+      profile
+    });
+    const buildExecutor = resolveBrowserBundleExecutor(this.appConfig, profile, executor);
+    const dedupeKey = createBuildRequestIdentity(request);
+    return requestBuildDedupe.dedupeBuild(dedupeKey, async () => {
+      const result = await buildExecutor.build(request);
+      startupTrace.recordBrowserBundle(result.outputs);
+      return result;
+    });
   }
   async bundleGroupedEntries(entries, options) {
     const request = {
       ...options,
-      entrypoints: entries.map((entry) => entry.entrypoint)
+      entrypoints: Object.fromEntries(entries.map((entry) => [entry.entryName, entry.entrypoint]))
     };
     return this.bundle(request);
   }

package/src/services/html/html-transformer.service.d.ts

@@ -83,7 +83,7 @@ export declare class HtmlTransformerService {
      * string-based fallback remains in place for runtimes that cannot provide one
      * of those rewriter implementations.
      */
-    transform(res: Response, contributions?: HtmlDocumentContribution[]): Promise<Response>;
+    transform(res: Response, contributions?: HtmlDocumentContribution[], pagePackage?: PagePackageResult): Promise<Response>;
     /**
      * Splits processed assets into head and body injection groups.
      */

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;
@@ -188,8 +188,8 @@ class HtmlTransformerService {
    * string-based fallback remains in place for runtimes that cannot provide one
    * of those rewriter implementations.
    */
-  async transform(res, contributions = []) {
-    const { head, body } = this.groupDependenciesByPosition();
+  async transform(res, contributions = [], pagePackage) {
+    const { head, body } = this.groupDependenciesByPosition(pagePackage);
     const { headPrepend, headAppend, bodyPrepend, bodyAppend } = this.groupContributionsByPlacement(contributions);
     const htmlRewriter = await this.htmlRewriterProvider.createHtmlRewriter();
     if (htmlRewriter) {
@@ -239,8 +239,8 @@ class HtmlTransformerService {
   /**
    * Splits processed assets into head and body injection groups.
    */
-  groupDependenciesByPosition() {
-    const dependencies = this.pagePackage ? this.resolvePagePackageHtmlDependencies(this.pagePackage) : this.processedDependencies;
+  groupDependenciesByPosition(pagePackageOverride) {
+    const dependencies = pagePackageOverride ? this.resolvePagePackageHtmlDependencies(pagePackageOverride) : this.pagePackage ? this.resolvePagePackageHtmlDependencies(this.pagePackage) : this.processedDependencies;
     return dependencies.reduce(
       (acc, dep) => {
         if (dep.kind === "script") {

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

@@ -1,5 +1,6 @@
-import type { EcoPagesAppConfig } from '../../types/internal-types.js';
-export type DevelopmentInvalidationCategory = 'public-asset' | 'additional-watch' | 'include-source' | 'route-source' | 'processor-owned-asset' | 'server-source' | 'other';
+import type { EcoPagesAppConfig, RegisteredScriptEntrypointChangeHandler } from '../../types/internal-types.js';
+export type { RegisteredScriptEntrypointChangeHandler };
+export type DevelopmentInvalidationCategory = 'public-asset' | 'additional-watch' | 'include-source' | 'explicit-server-view' | 'route-source' | 'processor-owned-asset' | 'server-source' | 'other';
 /**
  * Framework-owned invalidation plan for one changed file.
  *
@@ -38,6 +39,14 @@ export declare class DevelopmentInvalidationService {
      * Invalidates the app-owned server-module graph.
      */
     invalidateServerModules(changedFiles?: string[]): void;
+    /**
+     * Registers an integration-owned handler for registered script entrypoint edits.
+     */
+    registerRegisteredScriptEntrypointChangeHandler(handler: RegisteredScriptEntrypointChangeHandler): void;
+    /**
+     * Notifies integration handlers that a registered script entrypoint changed.
+     */
+    notifyRegisteredScriptEntrypointChange(filePath: string): Promise<void>;
     /**
      * Resets runtime-owned graph state and invalidates server modules.
      */
@@ -62,6 +71,15 @@ export declare class DevelopmentInvalidationService {
      * Returns whether the file is an include/template source file.
      */
     isIncludeSourceFile(filePath: string): boolean;
+    /**
+     * Returns whether the file is an explicit server-rendered view module.
+     *
+     * @remarks
+     * These modules are typically registered through `renderServerModule` in
+     * `app.ts` rather than the filesystem router. They need a full browser reload
+     * because their HTML is produced on the server, not through client HMR entrypoints.
+     */
+    isExplicitServerViewFile(filePath: string): boolean;
     /**
      * Returns whether the file is a server-executed source module outside the
      * special route/include buckets.
@@ -69,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

@@ -1,5 +1,6 @@
 import path from "node:path";
 import { getAppServerInvalidationState } from "../runtime-state/server-invalidation-state.service.js";
+import { appLogger } from "../../global/app-logger.js";
 class DevelopmentInvalidationService {
   appConfig;
   constructor(appConfig) {
@@ -18,6 +19,30 @@ class DevelopmentInvalidationService {
     getAppServerInvalidationState(this.appConfig).invalidateServerModules(changedFiles);
     this.appConfig.runtime?.appModuleLoader?.invalidateDevelopmentGraph();
   }
+  /**
+   * Registers an integration-owned handler for registered script entrypoint edits.
+   */
+  registerRegisteredScriptEntrypointChangeHandler(handler) {
+    const runtime = this.appConfig.runtime ?? {};
+    this.appConfig.runtime = runtime;
+    runtime.registeredScriptEntrypointChangeHandlers ??= [];
+    runtime.registeredScriptEntrypointChangeHandlers.push(handler);
+  }
+  /**
+   * Notifies integration handlers that a registered script entrypoint changed.
+   */
+  async notifyRegisteredScriptEntrypointChange(filePath) {
+    const handlers = this.appConfig.runtime?.registeredScriptEntrypointChangeHandlers ?? [];
+    for (const handler of handlers) {
+      try {
+        await handler(filePath);
+      } catch (error) {
+        appLogger.error(
+          `Failed to handle registered script entrypoint change for ${filePath}: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  }
   /**
    * Resets runtime-owned graph state and invalidates server modules.
    */
@@ -55,8 +80,18 @@ class DevelopmentInvalidationService {
         category: "include-source",
         invalidateServerModules: true,
         refreshRoutes: false,
-        reloadBrowser: true,
-        delegateToHmr: false,
+        reloadBrowser: false,
+        delegateToHmr: true,
+        processorHandledAsset: false
+      };
+    }
+    if (this.isExplicitServerViewFile(filePath)) {
+      return {
+        category: "explicit-server-view",
+        invalidateServerModules: true,
+        refreshRoutes: false,
+        reloadBrowser: false,
+        delegateToHmr: true,
         processorHandledAsset: false
       };
     }
@@ -148,6 +183,25 @@ class DevelopmentInvalidationService {
     }
     return /\.(?:[cm]?ts|[jt]sx?|mdx)$/u.test(resolvedPath);
   }
+  /**
+   * Returns whether the file is an explicit server-rendered view module.
+   *
+   * @remarks
+   * These modules are typically registered through `renderServerModule` in
+   * `app.ts` rather than the filesystem router. They need a full browser reload
+   * because their HTML is produced on the server, not through client HMR entrypoints.
+   */
+  isExplicitServerViewFile(filePath) {
+    const resolvedPath = path.resolve(filePath);
+    const viewsDir = path.join(this.appConfig.absolutePaths.srcDir, "views");
+    if (resolvedPath !== viewsDir && !resolvedPath.startsWith(`${viewsDir}${path.sep}`)) {
+      return false;
+    }
+    if (this.appConfig.templatesExt.some((extension) => resolvedPath.endsWith(extension))) {
+      return true;
+    }
+    return /\.(?:[cm]?ts|[jt]sx?|mdx)$/u.test(resolvedPath);
+  }
   /**
    * Returns whether the file is a server-executed source module outside the
    * special route/include buckets.
@@ -164,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/README.md

@@ -0,0 +1,49 @@
+# Module Loading
+
+Server-side source loading for framework-owned page modules, includes, and related templates.
+
+## Import stack
+
+```
+Call site (route scan, renderer, SSG, API)
+  └─ AppModuleLoader.importModule()          app-server-module-transpiler.service.ts
+       ├─ merges server build plugins + JSX ownership plugins
+       ├─ resolves route-module BuildExecutor
+       └─ PageModuleImportService.importModule()
+            ├─ dev + host loader → host runtime (Node only, when configured)
+            ├─ production disk cache → route-module build cache
+            ├─ unified pages graph → prebuilt chunk import
+            └─ Rolldown per-page build → dynamic import of transpiled output
+```
+
+`ServerModuleTranspiler` is a thin wrapper that injects `rootDir`, optional default plugins, and invalidation version into the same `PageModuleImportService` path. App code should prefer `getAppModuleLoader(appConfig)` or `getAppServerModuleTranspiler(appConfig)`.
+
+## Host vs app ownership
+
+| Path                    | When                                                                                         |
+| ----------------------- | -------------------------------------------------------------------------------------------- |
+| Host loader             | `appConfig.runtime.hostModuleLoader` set (Vite host) and file supports direct source loading |
+| Ecopages build pipeline | Framework-owned template files under `pages/`, `includes/`, etc.                             |
+
+`shouldAppUseHostModuleLoader()` encodes the directory + extension rules. Bun always uses the build pipeline today.
+
+## Caching layers
+
+1. **In-memory promise cache** (`PageModuleImportService.importCache`) — keyed by file path, resolved `outdir`, JSX/plugin inputs, file hash, and invalidation version. Cleared by `invalidateDevelopmentGraph()`.
+2. **Disk transpile cache** (`.eco/.server-modules/.build-cache.json`) — production only; see route-module build cache slice.
+3. **Unified graph manifest** — production static export fast path; see build layer docs.
+
+## Files
+
+| File                                      | Role                                                      |
+| ----------------------------------------- | --------------------------------------------------------- |
+| `page-module-import.service.ts`           | Core import/cache/build orchestration                     |
+| `app-module-loader.service.ts`            | App-facing loader interface                               |
+| `app-server-module-transpiler.service.ts` | Factory for app-scoped loader + transpiler                |
+| `server-module-transpiler.service.ts`     | Injectable transpiler boundary for tests and bootstrap    |
+| `host-module-loader-registry.ts`          | Process-global host loader fallback for embedded runtimes |
+| `source-module-support.ts`                | Extension allowlist for host direct loading               |
+
+## Development invalidation
+
+`DevelopmentInvalidationService.invalidateServerModules()` bumps the app-owned invalidation version and calls `appModuleLoader.invalidateDevelopmentGraph()`, which clears the in-memory import cache and increments the per-service invalidation counter used in cache keys and dev `?update=` query params.

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;

package/src/services/module-loading/app-server-module-transpiler.service.js

@@ -1,5 +1,4 @@
-import { getAppBuildExecutor, getAppServerBuildPlugins } from "../../build/build-adapter.js";
-import { createForeignJsxOverridePlugin } from "../../plugins/foreign-jsx-override-plugin.js";
+import { requireBuildRuntime } from "../../build/runtime/build-runtime.js";
 import path from "node:path";
 import { DevelopmentInvalidationService } from "../invalidation/development-invalidation.service.js";
 import {} from "./app-module-loader.service.js";
@@ -37,27 +36,12 @@ function setAppHostModuleLoader(appConfig, hostModuleLoader) {
     hostModuleLoader
   };
 }
-function getJsxOwnershipPlugins(appConfig) {
-  const jsxExtensions = (appConfig.integrations ?? []).filter((integration) => integration.jsxImportSource).flatMap(
-    (integration) => integration.extensions.filter((extension) => extension.endsWith(".tsx") || extension.endsWith(".jsx")).map((extension) => ({ integration, extension }))
-  ).sort((left, right) => right.extension.length - left.extension.length);
-  return jsxExtensions.map(
-    ({ integration, extension }) => createForeignJsxOverridePlugin({
-      hostJsxImportSource: integration.jsxImportSource,
-      foreignExtensions: [extension],
-      excludeExtensions: jsxExtensions.filter((candidate) => candidate.extension.length > extension.length).filter((candidate) => candidate.extension.endsWith(extension)).map((candidate) => candidate.extension),
-      name: `ecopages-jsx-ownership-${integration.name}-${extension.replace(/[^a-zA-Z0-9]+/g, "-")}`
-    })
-  );
-}
 function createAppModuleLoader(appConfig) {
   const invalidationService = new DevelopmentInvalidationService(appConfig);
-  const pageModuleImportService = new PageModuleImportService({
+  const pageModuleImportService = new PageModuleImportService(appConfig, {
     canLoadSourceModuleFromHost: (filePath) => shouldAppUseHostModuleLoader(appConfig, filePath),
     getHostModuleLoader: () => getAppHostModuleLoader(appConfig)
   });
-  const appServerBuildPlugins = appConfig.runtime?.buildManifest ? getAppServerBuildPlugins(appConfig) : Array.from(appConfig.loaders?.values() ?? []);
-  const jsxOwnershipPlugins = getJsxOwnershipPlugins(appConfig);
   const appModuleLoader = {
     get owner() {
       return getAppModuleLoaderOwner(appConfig);
@@ -65,11 +49,9 @@ function createAppModuleLoader(appConfig) {
     pageModuleImportService,
     async importModule(options) {
       const invalidationVersion = options.invalidationVersion ?? invalidationService.getServerModuleInvalidationVersion();
-      const mergedPlugins = [...appServerBuildPlugins, ...jsxOwnershipPlugins, ...options.plugins ?? []];
       return await pageModuleImportService.importModule({
         ...options,
-        ...mergedPlugins.length > 0 ? { plugins: mergedPlugins } : {},
-        buildExecutor: options.buildExecutor ?? getAppBuildExecutor(appConfig),
+        buildExecutor: options.buildExecutor ?? requireBuildRuntime(appConfig).getProfile("route-module"),
         invalidationVersion
       });
     },

package/src/services/module-loading/page-module-import.service.d.ts

@@ -1,5 +1,6 @@
 import { build, type BuildExecutor, type BuildResult } from '../../build/build-adapter.js';
-import type { EcoBuildPlugin } from '../../build/build-types.js';
+import type { EcoBuildPlugin } from '../../build/contracts/build-types.js';
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
 import type { SourceModuleLoaderFactory } from './module-loading-types.js';
 interface PageModuleImportBaseOptions {
     filePath: string;
@@ -59,10 +60,12 @@ export interface PageModuleImportDependencies {
  * transpilation settings, and error semantics across the different callers.
  */
 export declare class PageModuleImportService {
+    private readonly appConfig?;
     private readonly dependencies;
+    private readonly dependencyHasher;
     private readonly importCache;
     private developmentInvalidationVersion;
-    constructor(dependencies?: Partial<PageModuleImportDependencies>);
+    constructor(appConfig?: EcoPagesAppConfig, dependencies?: Partial<PageModuleImportDependencies>);
     /**
      * Clears the shared import cache used by framework-owned page-module loads.
      */
@@ -91,5 +94,6 @@ export declare class PageModuleImportService {
      */
     importModule<T = unknown>(options: PageModuleBuildImportOptions): Promise<T>;
     private loadModule;
+    private getRouteModuleBuildCache;
 }
 export {};