@ecopages/core 0.2.0-beta.23 → 0.2.0-beta.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/core",
-  "version": "0.2.0-beta.23",
+  "version": "0.2.0-beta.24",
   "description": "Core package for Ecopages",
   "keywords": [
     "ecopages",
@@ -17,7 +17,7 @@
     "directory": "packages/core"
   },
   "dependencies": {
-    "@ecopages/file-system": "0.2.0-beta.23",
+    "@ecopages/file-system": "0.2.0-beta.24",
     "@ecopages/logger": "^0.2.3",
     "@ecopages/scripts-injector": "^0.1.5",
     "@oxc-project/runtime": "0.134.0",
@@ -207,6 +207,10 @@
       "types": "./src/build/jsx-ownership-plugins.d.ts",
       "default": "./src/build/jsx-ownership-plugins.js"
     },
+    "./build/lit-static-render-worker-context": {
+      "types": "./src/build/lit-static-render-worker-context.d.ts",
+      "default": "./src/build/lit-static-render-worker-context.js"
+    },
     "./cache": {
       "types": "./src/cache/index.d.ts",
       "default": "./src/cache/index.js"
@@ -416,6 +420,10 @@
       "types": "./src/build/jsx-ownership-plugins.d.ts",
       "default": "./src/build/jsx-ownership-plugins.js"
     },
+    "./build/lit-static-render-worker-context.ts": {
+      "types": "./src/build/lit-static-render-worker-context.d.ts",
+      "default": "./src/build/lit-static-render-worker-context.js"
+    },
     "./cache.ts": {
       "types": "./src/cache/index.d.ts",
       "default": "./src/cache/index.js"

package/src/adapters/abstract/application-adapter.js

@@ -10,6 +10,7 @@ import {
   formatRuntimeServerStartedMessage
 } from "../../dev/runtime-server-started-message.js";
 import { parseCliArgs } from "../../utils/parse-cli-args.js";
+import { startupTrace } from "../../diagnostics/startup-trace.js";
 class AbstractApplicationAdapter {
   appConfig;
   serverOptions;
@@ -42,6 +43,7 @@ class AbstractApplicationAdapter {
       setAppHostModuleLoader(this.appConfig, hostModuleLoader);
     }
     getAppModuleLoader(this.appConfig);
+    startupTrace.markConfigReady();
     if (options.clearOutput) {
       this.clearDistFolder().catch((error) => {
         appLogger.error("Error clearing dist folder", error);
@@ -221,6 +223,7 @@ class AbstractApplicationAdapter {
   }
   notifyListening(origin) {
     const normalizedOrigin = origin.replace(/\/$/, "");
+    startupTrace.markServerListening();
     if (!this.onAppStartCallback) {
       this.logServerStarted(normalizedOrigin);
     }

package/src/adapters/bun/create-app.js

@@ -1,6 +1,7 @@
 import { appLogger } from "../../global/app-logger.js";
 import { SharedApplicationAdapter } from "../shared/application-adapter.js";
 import { resolveRuntimeBinding, resolveStaticRuntimeMode } from "../shared/runtime-app-bootstrap.js";
+import { startupTrace } from "../../diagnostics/startup-trace.js";
 import { createBunServerAdapter } from "./server-adapter.js";
 import { BunRuntimeHost } from "./runtime-host.js";
 import { hostOwnsDevClient } from "../../dev/dev-client-ownership.js";
@@ -101,6 +102,7 @@ class BunEcopagesApp extends SharedApplicationAdapter {
     const enableHmr = dev || !preview && !build;
     const serverOptions = this.serverAdapter.getServerOptions({ enableHmr });
     const runtimeServerOptions = serverOptions;
+    startupTrace.beginServerListen();
     this.server = await this.runtimeHost.start({
       serveOptions: runtimeServerOptions,
       handleRequest: async () => new Response(null, { status: 500 }),

package/src/adapters/node/create-app.js

@@ -5,6 +5,7 @@ import { createNodeServerAdapter } from "./server-adapter.js";
 import { NodeHttpRequestBridge } from "./http-request-bridge.js";
 import { NodeRuntimeHost } from "./runtime-host.js";
 import { hostOwnsDevClient } from "../../dev/dev-client-ownership.js";
+import { startupTrace } from "../../diagnostics/startup-trace.js";
 class NodeEcopagesApp extends SharedApplicationAdapter {
   serverAdapter;
   server = null;
@@ -87,6 +88,7 @@ class NodeEcopagesApp extends SharedApplicationAdapter {
       return;
     }
     const serveOptions = this.serverAdapter.getServerOptions();
+    startupTrace.beginServerListen();
     this.server = await this.runtimeHost.start({
       serveOptions,
       handleRequest: async (request) => await this.serverAdapter.handleRequest(request),

package/src/adapters/shared/server-adapter.js

@@ -2,6 +2,8 @@ import path from "node:path";
 import { AbstractServerAdapter } from "../abstract/server-adapter.js";
 import { RouteRendererFactory } from "../../route-renderer/route-renderer.js";
 import { RouteRegistry } from "../../router/server/route-registry.js";
+import { startupTrace } from "../../diagnostics/startup-trace.js";
+import { requestBuildDedupe } from "../../diagnostics/request-build-dedupe.js";
 import { MemoryCacheStore } from "../../services/cache/memory-cache-store.js";
 import { PageCacheService } from "../../services/cache/page-cache-service.js";
 import { SchemaValidationService } from "../../services/validation/schema-validation-service.js";
@@ -71,6 +73,7 @@ class SharedServerAdapter extends AbstractServerAdapter {
    * Web Requests (`Request`) to their corresponding internal execution paths.
    */
   async initSharedRouter() {
+    startupTrace.markPhaseStart("route-registry");
     this.router = new RouteRegistry({
       pagesDir: path.join(this.appConfig.rootDir, this.appConfig.srcDir, this.appConfig.pagesDir),
       appConfig: this.appConfig,
@@ -80,6 +83,7 @@ class SharedServerAdapter extends AbstractServerAdapter {
       pageModuleAdapter: this.createRouteRegistryPageModuleAdapter()
     });
     await this.router.init();
+    startupTrace.markPhaseEnd("route-registry");
   }
   createRouteRegistryPageModuleAdapter() {
     this.ensureRouteRendererFactory();
@@ -428,15 +432,19 @@ class SharedServerAdapter extends AbstractServerAdapter {
    * native HTTP objects into Web Standard Requests.
    */
   async handleSharedRequest(request, context) {
-    const hmrResponse = this.tryHandleSharedHmrRequest(request, context);
-    if (hmrResponse) {
-      return hmrResponse;
-    }
-    const apiResponse = await this.tryHandleSharedApiRequest(request, context);
-    if (apiResponse) {
-      return apiResponse;
-    }
-    return this.routeHandler.handleResponse(request);
+    return requestBuildDedupe.run(
+      () => startupTrace.traceFirstRequest(request, async () => {
+        const hmrResponse = this.tryHandleSharedHmrRequest(request, context);
+        if (hmrResponse) {
+          return hmrResponse;
+        }
+        const apiResponse = await this.tryHandleSharedApiRequest(request, context);
+        if (apiResponse) {
+          return apiResponse;
+        }
+        return this.routeHandler.handleResponse(request);
+      })
+    );
   }
 }
 export {

package/src/build/app-build-manifest-runtime.js

@@ -1,5 +1,7 @@
 import { mergeBrowserRuntimeManifests } from "./browser-runtime-manifest.js";
 import { appLogger } from "../global/app-logger.js";
+import { startupTrace } from "../diagnostics/startup-trace.js";
+import { isLitStaticRenderWorkerThread } from "./lit-static-render-worker-context.js";
 function patchAppRuntime(appConfig, patch) {
   appConfig.runtime = {
     ...appConfig.runtime ?? {},
@@ -50,18 +52,26 @@ async function collectConfiguredAppBuildManifestContributions(appConfig) {
   };
 }
 async function setupAppRuntimePlugins(options) {
+  startupTrace.markPhaseStart("setupAppRuntimePlugins");
   if (options.appConfig.runtime?.runtimeAssetsPrepared) {
     appLogger.debug("Skipped setupAppRuntimePlugins: runtime assets already prepared");
     registerRuntimePlugins(options.appConfig, options.onRuntimePlugin);
+    startupTrace.markPhaseEnd("setupAppRuntimePlugins");
     return;
   }
+  if (isLitStaticRenderWorkerThread()) {
+    appLogger.debug("Lit static-render worker: skipping processor setup (main thread already prepared artifacts)");
+  }
   appLogger.debugTime("setupAppRuntimePlugins");
   try {
     for (const loader of options.appConfig.loaders.values()) {
       options.onRuntimePlugin?.(loader);
     }
+    const skipProcessorSetup = isLitStaticRenderWorkerThread();
     for (const processor of options.appConfig.processors.values()) {
-      await processor.setup();
+      if (!skipProcessorSetup) {
+        await processor.setup();
+      }
       if (processor.plugins) {
         for (const plugin of processor.plugins) {
           options.onRuntimePlugin?.(plugin);
@@ -79,6 +89,7 @@ async function setupAppRuntimePlugins(options) {
     patchAppRuntime(options.appConfig, { runtimeAssetsPrepared: true });
   } finally {
     appLogger.debugTimeEnd("setupAppRuntimePlugins");
+    startupTrace.markPhaseEnd("setupAppRuntimePlugins");
   }
 }
 export {

package/src/build/dev-browser-script-cache.d.ts

@@ -0,0 +1,34 @@
+import type { EcoPagesAppConfig } from '../types/internal-types.js';
+import type { ProcessedAsset } from '../services/assets/asset-processing-service/assets.types.js';
+export declare const DEV_BROWSER_SCRIPT_CACHE_DIR = ".browser-script-bundles";
+export declare const DEV_BROWSER_SCRIPT_CACHE_FILENAME = ".build-cache.json";
+/** Output path restored from the dev disk cache before dependency metadata is merged. */
+export type DevBrowserScriptCacheHit = {
+    filepath: string;
+};
+/**
+ * @remarks
+ * Dev asset caching spans three scopes that should not be conflated:
+ * - request dedupe (`request-build-dedupe.ts`) — one in-flight build per request key
+ * - in-memory service cache (`AssetProcessingService`) — per-process reuse within one dev server
+ * - this disk manifest (`.eco/.browser-script-bundles`) — cross-request reuse of content-script bundles
+ *
+ * Disk entries intentionally store only output file paths. Declarative fields such as
+ * `groupedBundle`, `attributes`, and `packageRole` live on the originating
+ * `ContentScriptAsset` and are merged via `materializeContentScriptAsset()` on lookup.
+ */
+export interface DevBrowserScriptCacheEntry {
+    filepath: string;
+    builtAt: number;
+}
+export interface DevBrowserScriptCacheManifest {
+    invalidationVersion: string;
+    buildInputsFingerprint: string;
+    entries: Record<string, DevBrowserScriptCacheEntry>;
+}
+/** Returns whether dev-only cross-request content-script bundle cache is active. */
+export declare function shouldUseDevBrowserScriptCache(): boolean;
+/** Looks up one persisted dev content-script output path by dependency cache key. */
+export declare function getDevBrowserScriptCacheEntry(appConfig: EcoPagesAppConfig, depKey: string): DevBrowserScriptCacheHit | null;
+/** Persists one dev content-script bundle output for cross-request reuse. */
+export declare function setDevBrowserScriptCacheEntry(appConfig: EcoPagesAppConfig, depKey: string, asset: ProcessedAsset): void;

package/src/build/dev-browser-script-cache.js

@@ -0,0 +1,90 @@
+import path from "node:path";
+import { fileSystem } from "@ecopages/file-system";
+import { getAppBrowserBuildPlugins } from "./build-adapter.js";
+import { createBuildInputsFingerprint, hashAppConfigFile } from "./build-input-fingerprint.js";
+import {
+  readProductionCacheManifest,
+  writeProductionCacheManifest,
+  isProductionCacheManifestCurrent,
+  matchesProductionCacheFingerprint
+} from "./production-build-cache.js";
+import { getCorePackageVersion } from "../services/module-loading/route-module-build-manifest.js";
+import { resolveInternalExecutionDir } from "../utils/resolve-work-dir.js";
+import { isDevelopmentRuntime } from "../utils/runtime.js";
+const DEV_BROWSER_SCRIPT_CACHE_DIR = ".browser-script-bundles";
+const DEV_BROWSER_SCRIPT_CACHE_FILENAME = ".build-cache.json";
+function getDevBrowserScriptCacheDir(appConfig) {
+  return path.join(resolveInternalExecutionDir(appConfig), DEV_BROWSER_SCRIPT_CACHE_DIR);
+}
+function getDevBrowserScriptCacheManifestPath(appConfig) {
+  return path.join(getDevBrowserScriptCacheDir(appConfig), DEV_BROWSER_SCRIPT_CACHE_FILENAME);
+}
+function createBrowserBuildKey(appConfig) {
+  try {
+    const pluginNames = getAppBrowserBuildPlugins(appConfig).map((plugin) => plugin.name).sort().join("|");
+    return pluginNames || "default";
+  } catch {
+    return "default";
+  }
+}
+function createDevBrowserScriptCacheInvalidationVersion(appConfig) {
+  return [getCorePackageVersion(), hashAppConfigFile(appConfig), createBrowserBuildKey(appConfig)].join("::");
+}
+function readManifest(appConfig) {
+  const manifest = readProductionCacheManifest(
+    getDevBrowserScriptCacheManifestPath(appConfig)
+  );
+  if (!manifest) {
+    return void 0;
+  }
+  const invalidationVersion = createDevBrowserScriptCacheInvalidationVersion(appConfig);
+  const buildInputsFingerprint = createBuildInputsFingerprint(appConfig);
+  if (!isProductionCacheManifestCurrent(manifest, invalidationVersion) || !matchesProductionCacheFingerprint(manifest, buildInputsFingerprint)) {
+    return void 0;
+  }
+  return manifest;
+}
+function writeManifest(appConfig, manifest) {
+  writeProductionCacheManifest(getDevBrowserScriptCacheManifestPath(appConfig), manifest);
+}
+function shouldUseDevBrowserScriptCache() {
+  return isDevelopmentRuntime();
+}
+function getDevBrowserScriptCacheEntry(appConfig, depKey) {
+  if (!shouldUseDevBrowserScriptCache()) {
+    return null;
+  }
+  const manifest = readManifest(appConfig);
+  const entry = manifest?.entries[depKey];
+  if (!entry?.filepath || !fileSystem.exists(entry.filepath)) {
+    return null;
+  }
+  return { filepath: entry.filepath };
+}
+function setDevBrowserScriptCacheEntry(appConfig, depKey, asset) {
+  if (!shouldUseDevBrowserScriptCache() || !asset.filepath) {
+    return;
+  }
+  const invalidationVersion = createDevBrowserScriptCacheInvalidationVersion(appConfig);
+  const buildInputsFingerprint = createBuildInputsFingerprint(appConfig);
+  const existing = readManifest(appConfig);
+  const manifest = existing ?? {
+    invalidationVersion,
+    buildInputsFingerprint,
+    entries: {}
+  };
+  manifest.invalidationVersion = invalidationVersion;
+  manifest.buildInputsFingerprint = buildInputsFingerprint;
+  manifest.entries[depKey] = {
+    filepath: asset.filepath,
+    builtAt: Date.now()
+  };
+  writeManifest(appConfig, manifest);
+}
+export {
+  DEV_BROWSER_SCRIPT_CACHE_DIR,
+  DEV_BROWSER_SCRIPT_CACHE_FILENAME,
+  getDevBrowserScriptCacheEntry,
+  setDevBrowserScriptCacheEntry,
+  shouldUseDevBrowserScriptCache
+};

package/src/build/lit-static-render-worker-context.d.ts

@@ -0,0 +1,2 @@
+/** Returns whether the current thread is the Lit static-render worker. */
+export declare function isLitStaticRenderWorkerThread(): boolean;

package/src/build/lit-static-render-worker-context.js

@@ -0,0 +1,6 @@
+function isLitStaticRenderWorkerThread() {
+  return process.env.ECOPAGES_LIT_STATIC_RENDER_WORKER === "true";
+}
+export {
+  isLitStaticRenderWorkerThread
+};

package/src/diagnostics/request-build-dedupe.d.ts

@@ -0,0 +1,18 @@
+import type { BuildResult } from '../build/build-adapter.js';
+/**
+ * Per-request browser build dedupe cache.
+ *
+ * @remarks
+ * `DedupingBuildExecutor` only coalesces concurrent identical builds. Asset
+ * processing can call the same logical bundle several times in one request
+ * (page graph, HMR, content scripts) after the first build settles. This cache
+ * reuses the settled result until the request scope ends.
+ */
+declare class RequestBuildDedupe {
+    private readonly storage;
+    run<T>(fn: () => Promise<T>): Promise<T>;
+    dedupeBuild(key: string, build: () => Promise<BuildResult>): Promise<BuildResult>;
+    getCachedCountForTests(): number;
+}
+export declare const requestBuildDedupe: RequestBuildDedupe;
+export {};

package/src/diagnostics/request-build-dedupe.js

@@ -0,0 +1,33 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+class RequestBuildDedupe {
+  storage = new AsyncLocalStorage();
+  run(fn) {
+    if (this.storage.getStore()) {
+      return fn();
+    }
+    return this.storage.run(/* @__PURE__ */ new Map(), fn);
+  }
+  dedupeBuild(key, build) {
+    const store = this.storage.getStore();
+    if (!store) {
+      return build();
+    }
+    const existing = store.get(key);
+    if (existing) {
+      return existing;
+    }
+    const buildPromise = build().catch((error) => {
+      store.delete(key);
+      throw error;
+    });
+    store.set(key, buildPromise);
+    return buildPromise;
+  }
+  getCachedCountForTests() {
+    return this.storage.getStore()?.size ?? 0;
+  }
+}
+const requestBuildDedupe = new RequestBuildDedupe();
+export {
+  requestBuildDedupe
+};

package/src/diagnostics/startup-trace.d.ts

@@ -0,0 +1,25 @@
+export type StartupTracePhase = 'config-ready' | 'setupAppRuntimePlugins' | 'route-registry' | 'server-listen' | 'first-request-ssr';
+declare class StartupTrace {
+    private readonly phaseStarts;
+    private readonly phases;
+    private firstRequestPending;
+    private firstRequestPath;
+    private firstRequestBundleCount;
+    private firstRequestClientBytes;
+    private summaryEmitted;
+    isEnabled(): boolean;
+    markPhaseStart(phase: StartupTracePhase): void;
+    markPhaseEnd(phase: StartupTracePhase): void;
+    markConfigReady(): void;
+    markServerListening(): void;
+    beginServerListen(): void;
+    recordBrowserBundle(outputs: Array<{
+        path: string;
+    }>): void;
+    traceFirstRequest<T>(request: Request, handler: () => Promise<T>): Promise<T>;
+    private emitFirstRequestSummary;
+    /** Resets mutable trace state for unit tests. */
+    resetForTests(): void;
+}
+export declare const startupTrace: StartupTrace;
+export {};

package/src/diagnostics/startup-trace.js

@@ -0,0 +1,121 @@
+import { statSync } from "node:fs";
+import { fileSystem } from "@ecopages/file-system";
+const LOG_PREFIX = "[ecopages:startup-trace]";
+function isStartupTraceEnabled() {
+  return process.env.ECOPAGES_STARTUP_TRACE === "true" || process.env.ECOPAGES_LOGGER_DEBUG === "true";
+}
+function wallMsSinceProcessStart() {
+  return Math.round(process.uptime() * 1e3);
+}
+function writeTraceLine(message) {
+  process.stderr.write(`${LOG_PREFIX} ${message}
+`);
+}
+class StartupTrace {
+  phaseStarts = /* @__PURE__ */ new Map();
+  phases = /* @__PURE__ */ new Map();
+  firstRequestPending = true;
+  firstRequestPath;
+  firstRequestBundleCount = 0;
+  firstRequestClientBytes = 0;
+  summaryEmitted = false;
+  isEnabled() {
+    return isStartupTraceEnabled();
+  }
+  markPhaseStart(phase) {
+    if (!isStartupTraceEnabled() || this.phases.has(phase)) {
+      return;
+    }
+    this.phaseStarts.set(phase, performance.now());
+  }
+  markPhaseEnd(phase) {
+    if (!isStartupTraceEnabled() || this.phases.has(phase)) {
+      return;
+    }
+    const startedAt = this.phaseStarts.get(phase);
+    if (startedAt === void 0) {
+      return;
+    }
+    const durationMs = Math.round(performance.now() - startedAt);
+    const record = {
+      durationMs,
+      wallMs: wallMsSinceProcessStart()
+    };
+    this.phases.set(phase, record);
+    writeTraceLine(`phase=${phase} durationMs=${durationMs} wallMs=${record.wallMs}`);
+  }
+  markConfigReady() {
+    if (!isStartupTraceEnabled() || this.phases.has("config-ready")) {
+      return;
+    }
+    const record = {
+      durationMs: 0,
+      wallMs: wallMsSinceProcessStart()
+    };
+    this.phases.set("config-ready", record);
+    writeTraceLine(`phase=config-ready wallMs=${record.wallMs}`);
+  }
+  markServerListening() {
+    this.markPhaseEnd("server-listen");
+  }
+  beginServerListen() {
+    this.markPhaseStart("server-listen");
+  }
+  recordBrowserBundle(outputs) {
+    if (!isStartupTraceEnabled() || !this.firstRequestPending) {
+      return;
+    }
+    this.firstRequestBundleCount += 1;
+    for (const output of outputs) {
+      try {
+        if (fileSystem.exists(output.path)) {
+          this.firstRequestClientBytes += statSync(output.path).size;
+        }
+      } catch {
+      }
+    }
+  }
+  async traceFirstRequest(request, handler) {
+    if (!isStartupTraceEnabled() || !this.firstRequestPending) {
+      return handler();
+    }
+    this.firstRequestPath = new URL(request.url).pathname;
+    this.markPhaseStart("first-request-ssr");
+    try {
+      return await handler();
+    } finally {
+      this.markPhaseEnd("first-request-ssr");
+      this.emitFirstRequestSummary();
+      this.firstRequestPending = false;
+    }
+  }
+  emitFirstRequestSummary() {
+    if (!isStartupTraceEnabled() || this.summaryEmitted) {
+      return;
+    }
+    this.summaryEmitted = true;
+    writeTraceLine(
+      [
+        "summary",
+        `path=${this.firstRequestPath ?? "unknown"}`,
+        `bundleCount=${this.firstRequestBundleCount}`,
+        `clientBundleBytes=${this.firstRequestClientBytes}`,
+        `wallMs=${wallMsSinceProcessStart()}`
+      ].join(" ")
+    );
+  }
+  /** Resets mutable trace state for unit tests. */
+  resetForTests() {
+    this.phaseStarts.clear();
+    this.phases.clear();
+    this.firstRequestPending = true;
+    this.firstRequestPath = void 0;
+    this.firstRequestBundleCount = 0;
+    this.firstRequestClientBytes = 0;
+    this.summaryEmitted = false;
+  }
+}
+const startupTrace = new StartupTrace();
+export {
+  startupTrace
+};

package/src/env.d.ts

@@ -3,6 +3,8 @@ interface EcopagesEnv {
 	ECOPAGES_HOSTNAME: string;
 	ECOPAGES_PORT: string;
 	ECOPAGES_LOGGER_DEBUG: 'true' | 'false';
+	/** When `true`, emits startup phase timings to stderr. Also enabled when `ECOPAGES_LOGGER_DEBUG=true`. */
+	ECOPAGES_STARTUP_TRACE?: 'true' | 'false';
 }
 
 declare global {

package/src/plugins/integration-plugin.d.ts

@@ -197,6 +197,14 @@ export declare abstract class IntegrationPlugin<C = EcoPagesElement> {
     initializeRenderer(options?: {
         rendererModules?: unknown;
     }): IntegrationRenderer<C>;
+    /**
+     * Shapes one dependency batch before core asset processing runs.
+     *
+     * @remarks
+     * Integrations use this to assign grouped-build metadata or other batch-level
+     * policy without teaching core about integration-specific asset graphs.
+     */
+    prepareAssetDependencies?(dependencies: AssetDefinition[]): AssetDefinition[];
     /**
      * Prepares build-facing contributions before the app build manifest is sealed.
      *

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

@@ -103,6 +103,9 @@ class PageBrowserGraphService {
         );
         continue;
       }
+      if (this.isHmrEnabled()) {
+        continue;
+      }
       if (!contribution?.dependencies?.length) {
         continue;
       }
@@ -130,15 +133,18 @@ class PageBrowserGraphService {
     );
     const groupedAssetsByRoute = /* @__PURE__ */ new Map();
     for (const [routeFile, groupedAssetKeys] of groupedAssetKeysByRoute) {
-      groupedAssetsByRoute.set(
-        routeFile,
-        processedGroupedDependencies.filter((asset) => {
-          if (!asset.groupedBundle) {
-            return false;
-          }
-          return groupedAssetKeys.has(getGroupedBundleAssetKey(asset.groupedBundle));
-        })
-      );
+      const matchedAssets = processedGroupedDependencies.filter((asset) => {
+        if (!asset.groupedBundle) {
+          return false;
+        }
+        return groupedAssetKeys.has(getGroupedBundleAssetKey(asset.groupedBundle));
+      });
+      if (groupedAssetKeys.size > 0 && matchedAssets.length === 0) {
+        appLogger.warn(
+          `Grouped page-browser assets for ${routeFile} are missing groupedBundle metadata after processing. Hydration scripts may be omitted from HTML.`
+        );
+      }
+      groupedAssetsByRoute.set(routeFile, matchedAssets);
     }
     return {
       assetsByRoute: groupedAssetsByRoute,

package/src/route-renderer/page-loading/ecopages-virtual-imports.d.ts

@@ -2,6 +2,12 @@ export type EcopagesVirtualImport = {
     from: string;
     imports: string[] | undefined;
 };
+/**
+ * @remarks
+ * Content server modules static-import every MDX entry. They must never become
+ * browser module-script dependencies discovered from page or component sources.
+ */
+export declare function isBrowserEcopagesVirtualImport(specifier: string): boolean;
 /**
  * Extracts runtime `ecopages:` virtual-module imports from a component source file.
  *

package/src/route-renderer/page-loading/ecopages-virtual-imports.js

@@ -1,5 +1,9 @@
 import { readFileSync } from "node:fs";
 import { parseSync } from "oxc-parser";
+const CONTENT_SERVER_VIRTUAL_MODULE_PATTERN = /^ecopages:content\/[a-z][a-z0-9-]+\/server$/;
+function isBrowserEcopagesVirtualImport(specifier) {
+  return specifier.startsWith("ecopages:") && !CONTENT_SERVER_VIRTUAL_MODULE_PATTERN.test(specifier);
+}
 function extractEcopagesVirtualImports(file) {
   let source;
   try {
@@ -18,7 +22,7 @@ function extractEcopagesVirtualImports(file) {
     if (node.type !== "ImportDeclaration") continue;
     if (node.importKind === "type") continue;
     const specifier = node.source?.value ?? "";
-    if (!specifier.startsWith("ecopages:")) continue;
+    if (!isBrowserEcopagesVirtualImport(specifier)) continue;
     if (found.get(specifier) === null) {
       continue;
     }
@@ -53,5 +57,6 @@ function extractEcopagesVirtualImports(file) {
   }));
 }
 export {
-  extractEcopagesVirtualImports
+  extractEcopagesVirtualImports,
+  isBrowserEcopagesVirtualImport
 };

package/src/route-renderer/page-loading/module-declaration-aggregation.js

@@ -1,4 +1,5 @@
 import { normalizeModuleDeclarations } from "../../eco/module-dependencies.js";
+import { isBrowserEcopagesVirtualImport } from "./ecopages-virtual-imports.js";
 function getDeclaredModules(value) {
   if (!Array.isArray(value)) {
     return void 0;
@@ -22,6 +23,9 @@ function mergeModuleDeclaration(modulesMap, declaration) {
 }
 function collectModuleDeclarations(modulesMap, declaredModules, autoVirtualImports) {
   for (const declaration of normalizeModuleDeclarations(getDeclaredModules(declaredModules))) {
+    if (declaration.from.startsWith("ecopages:") && !isBrowserEcopagesVirtualImport(declaration.from)) {
+      continue;
+    }
     mergeModuleDeclaration(modulesMap, declaration);
   }
   for (const declaration of autoVirtualImports) {

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

@@ -42,6 +42,7 @@ export declare class AssetProcessingService {
      * entries.
      */
     processDependencies(deps: AssetDefinition[], key: string): Promise<ProcessedAsset[]>;
+    private prepareDependenciesForProcessing;
     /**
      * Processes deduplicated dependencies grouped by processor type.
      *
@@ -80,6 +81,8 @@ export declare class AssetProcessingService {
      * Returns the cached processed asset for a dependency key when available.
      */
     private getCachedAsset;
+    private getCachedContentScriptAsset;
+    private resolveCachedContentScriptFilepath;
     /**
      * Stores one processed asset in the dependency cache.
      */

package/src/services/assets/asset-processing-service/asset-processing.service.js

@@ -4,12 +4,19 @@ import { appLogger } from "../../../global/app-logger.js";
 import { fileSystem } from "@ecopages/file-system";
 import { deduplicateAssetDependencies, getAssetDependencyKey } from "./asset-dependency-keys.js";
 import {
+  ensureGroupedContentScriptsBundle,
   partitionGroupedContentScriptDependencies,
   processGroupedDependencyBundles
 } from "./grouped-content-bundles.js";
+import { resolveIntegrationPluginForProcessingKey } from "./resolve-integration-plugin.js";
 import { isHmrAware } from "./processor.interface.js";
 import { ProcessorRegistry } from "./processor.registry.js";
 import { processUngroupedDependency } from "./ungrouped-dependency-processing.js";
+import { materializeContentScriptAsset } from "./materialize-content-script-asset.js";
+import {
+  getDevBrowserScriptCacheEntry,
+  setDevBrowserScriptCacheEntry
+} from "../../../build/dev-browser-script-cache.js";
 import {
   ContentScriptProcessor,
   ContentStylesheetProcessor,
@@ -68,10 +75,16 @@ class AssetProcessingService {
     const depsDir = path.join(this.config.absolutePaths.distDir, RESOLVED_ASSETS_DIR);
     fileSystem.ensureDir(depsDir);
     const dedupedDeps = deduplicateAssetDependencies(deps);
-    const results = await this.processDependenciesParallel(dedupedDeps, key);
+    const preparedDeps = this.prepareDependenciesForProcessing(dedupedDeps, key);
+    ensureGroupedContentScriptsBundle(preparedDeps);
+    const results = await this.processDependenciesParallel(preparedDeps);
     await this.optimizeDependencies(results);
     return results;
   }
+  prepareDependenciesForProcessing(deps, processingKey) {
+    const plugin = resolveIntegrationPluginForProcessingKey(this.config, processingKey);
+    return plugin?.prepareAssetDependencies?.(deps) ?? deps;
+  }
   /**
    * Processes deduplicated dependencies grouped by processor type.
    *
@@ -80,14 +93,13 @@ class AssetProcessingService {
    * pair, while still allowing the overall dependency set to resolve in
    * parallel.
    */
-  async processDependenciesParallel(deps, key) {
+  async processDependenciesParallel(deps) {
     const grouped = this.groupDependenciesByType(deps);
     const groupPromises = Object.entries(grouped).map(async ([, typeDeps]) => {
       const { groupedBundleDeps, ungroupedDeps } = partitionGroupedContentScriptDependencies(typeDeps);
       const typePromises = ungroupedDeps.map(
         (dep) => processUngroupedDependency({
           dep,
-          key,
           depKey: getAssetDependencyKey(dep),
           getCachedAsset: (assetDep, depKey) => this.getCachedAsset(assetDep, depKey),
           getProcessor: (assetDep) => this.registry.getProcessor(assetDep.kind, assetDep.source),
@@ -109,7 +121,6 @@ class AssetProcessingService {
       );
       const groupedResults = await processGroupedDependencyBundles({
         bundles: Array.from(groupedBundleDeps.values()),
-        key,
         getCachedAsset: (dep, depKey) => this.getCachedAsset(dep, depKey),
         getDependencyKey: getAssetDependencyKey,
         getGroupedProcessor: () => this.registry.getProcessor("script", "content"),
@@ -229,6 +240,9 @@ class AssetProcessingService {
     if (process.env.NODE_ENV !== "production" && dep.source === "file" && dep.kind === "stylesheet") {
       return null;
     }
+    if (dep.kind === "script" && dep.source === "content") {
+      return this.getCachedContentScriptAsset(dep, depKey);
+    }
     const cached = this.cache.get(depKey);
     if (!cached) {
       return null;
@@ -239,11 +253,34 @@ class AssetProcessingService {
     }
     return cached.asset;
   }
+  getCachedContentScriptAsset(dep, depKey) {
+    const filepath = this.resolveCachedContentScriptFilepath(depKey) ?? getDevBrowserScriptCacheEntry(this.config, depKey)?.filepath;
+    if (!filepath) {
+      return null;
+    }
+    const materialized = materializeContentScriptAsset(dep, filepath);
+    this.cache.set(depKey, { asset: materialized });
+    return materialized;
+  }
+  resolveCachedContentScriptFilepath(depKey) {
+    const cached = this.cache.get(depKey);
+    if (!cached?.asset.filepath) {
+      return void 0;
+    }
+    if (!fileSystem.exists(cached.asset.filepath)) {
+      this.cache.delete(depKey);
+      return void 0;
+    }
+    return cached.asset.filepath;
+  }
   /**
    * Stores one processed asset in the dependency cache.
    */
   setCachedAsset(dep, depKey, asset) {
     this.cache.set(depKey, { asset });
+    if (dep.kind === "script" && dep.source === "content") {
+      setDevBrowserScriptCacheEntry(this.config, depKey, asset);
+    }
   }
   /**
    * Clears all cached processed assets.

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

@@ -0,0 +1,3 @@
+import type { ProcessedAsset } from './assets.types.js';
+/** Applies the public source URL to one processed asset when available. */
+export declare function finalizeProcessedAsset(processed: ProcessedAsset, resolveProcessedAssetSrcUrl: (processed: ProcessedAsset) => string | undefined): ProcessedAsset;

package/src/services/assets/asset-processing-service/finalize-processed-asset.js

@@ -0,0 +1,7 @@
+function finalizeProcessedAsset(processed, resolveProcessedAssetSrcUrl) {
+  const srcUrl = resolveProcessedAssetSrcUrl(processed);
+  return srcUrl ? { ...processed, srcUrl } : processed;
+}
+export {
+  finalizeProcessedAsset
+};

package/src/services/assets/asset-processing-service/grouped-content-bundles.d.ts

@@ -1,4 +1,6 @@
 import type { AssetDefinition, ProcessedAsset } from './assets.types.js';
+/** Forces grouped content scripts to run through the bundler in production builds. */
+export declare function ensureGroupedContentScriptsBundle(dependencies: AssetDefinition[]): void;
 /**
  * Splits grouped content-script dependencies from ordinary dependencies so callers can
  * route them through `processGrouped` without changing ordering for the remaining assets.
@@ -12,7 +14,6 @@ type GroupedBundleProcessor = {
 };
 type ProcessGroupedDependencyBundlesOptions = {
     bundles: AssetDefinition[][];
-    key: string;
     getCachedAsset: (dep: AssetDefinition, depKey: string) => ProcessedAsset | null;
     getDependencyKey: (dep: AssetDefinition) => string;
     getGroupedProcessor: () => GroupedBundleProcessor | undefined;

package/src/services/assets/asset-processing-service/grouped-content-bundles.js

@@ -1,3 +1,18 @@
+import { isDevelopmentRuntime } from "../../../utils/runtime.js";
+import { finalizeProcessedAsset } from "./finalize-processed-asset.js";
+function ensureGroupedContentScriptsBundle(dependencies) {
+  if (isDevelopmentRuntime()) {
+    return;
+  }
+  for (const dependency of dependencies) {
+    if (dependency.kind !== "script" || dependency.source !== "content" || !dependency.groupedBundle?.id) {
+      continue;
+    }
+    if (dependency.bundle === false) {
+      dependency.bundle = true;
+    }
+  }
+}
 function partitionGroupedContentScriptDependencies(typeDeps) {
   const groupedBundleDeps = /* @__PURE__ */ new Map();
   const ungroupedDeps = [];
@@ -18,7 +33,6 @@ function partitionGroupedContentScriptDependencies(typeDeps) {
 async function processGroupedDependencyBundles(options) {
   const {
     bundles,
-    key,
     getCachedAsset,
     getDependencyKey,
     getGroupedProcessor,
@@ -29,7 +43,7 @@ async function processGroupedDependencyBundles(options) {
   const groupedPromises = bundles.map(async (bundleDeps) => {
     const cachedResults = bundleDeps.map((dep) => {
       const cached = getCachedAsset(dep, getDependencyKey(dep));
-      return cached ? { key, ...cached } : null;
+      return cached ? finalizeProcessedAsset(cached, resolveProcessedAssetSrcUrl) : null;
     });
     if (cachedResults.every((result) => result !== null)) {
       return cachedResults.filter((result) => result !== null);
@@ -43,14 +57,9 @@ async function processGroupedDependencyBundles(options) {
       return processedResults.map((processed, index) => {
         const dep = bundleDeps[index];
         const depKey = getDependencyKey(dep);
-        const srcUrl = resolveProcessedAssetSrcUrl(processed);
-        const processedWithKey = {
-          key,
-          ...processed,
-          srcUrl
-        };
-        setCachedAsset(dep, depKey, processedWithKey);
-        return processedWithKey;
+        const finalized = finalizeProcessedAsset(processed, resolveProcessedAssetSrcUrl);
+        setCachedAsset(dep, depKey, finalized);
+        return finalized;
       });
     } catch (error) {
       logError(error);
@@ -60,6 +69,7 @@ async function processGroupedDependencyBundles(options) {
   return (await Promise.all(groupedPromises)).flat();
 }
 export {
+  ensureGroupedContentScriptsBundle,
   partitionGroupedContentScriptDependencies,
   processGroupedDependencyBundles
 };

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

@@ -1,4 +1,5 @@
 export * from './asset.factory.js';
+export * from './grouped-content-bundles.js';
 export * from './page-package.js';
 export * from './asset-processing.service.js';
 export * from './assets.types.js';

package/src/services/assets/asset-processing-service/index.js

@@ -1,4 +1,5 @@
 export * from "./asset.factory.js";
+export * from "./grouped-content-bundles.js";
 export * from "./page-package.js";
 export * from "./asset-processing.service.js";
 export * from "./assets.types.js";

package/src/services/assets/asset-processing-service/materialize-content-script-asset.d.ts

@@ -0,0 +1,11 @@
+import type { ContentScriptAsset, ProcessedAsset } from './assets.types.js';
+/**
+ * Builds a processed content-script asset from one dependency declaration and a
+ * previously emitted output file.
+ *
+ * @remarks
+ * Dev disk cache entries store only output paths. Callers must materialize the
+ * full processed asset from the originating dependency so HTML and page-browser
+ * graph assembly receive grouped-bundle metadata and script attributes.
+ */
+export declare function materializeContentScriptAsset(dep: ContentScriptAsset, filepath: string): ProcessedAsset;

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

@@ -0,0 +1,17 @@
+function materializeContentScriptAsset(dep, filepath) {
+  return {
+    filepath,
+    kind: "script",
+    inline: dep.inline ?? false,
+    content: dep.inline ? dep.content : void 0,
+    position: dep.position,
+    attributes: dep.attributes,
+    excludeFromHtml: dep.excludeFromHtml,
+    packageRole: dep.packageRole,
+    groupedBundle: dep.groupedBundle,
+    bundledSourceFilepaths: dep.bundledSourceFilepaths
+  };
+}
+export {
+  materializeContentScriptAsset
+};

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

@@ -1,6 +1,13 @@
 import type { ContentScriptAsset, ProcessedAsset } from '../../assets.types.js';
 import { BaseScriptProcessor } from '../base/base-script-processor.js';
 export declare class ContentScriptProcessor extends BaseScriptProcessor<ContentScriptAsset> {
+    private getContentScriptEntryDir;
+    private getContentScriptEntryPath;
+    private createBundleConfigHash;
+    private createContentScriptCacheKey;
+    private toProcessedAsset;
+    private removeContentScriptEntry;
     processGrouped(deps: ContentScriptAsset[]): Promise<ProcessedAsset[]>;
+    private getGroupedBundlerOptions;
     process(dep: ContentScriptAsset): Promise<ProcessedAsset>;
 }

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

@@ -1,7 +1,50 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
+import { shouldUseDevBrowserScriptCache } from "../../../../../build/dev-browser-script-cache.js";
 import { BaseScriptProcessor } from "../base/base-script-processor.js";
 class ContentScriptProcessor extends BaseScriptProcessor {
+  getContentScriptEntryDir() {
+    const dir = path.join(this.appConfig.absolutePaths.workDir, "content-script-entries");
+    fileSystem.ensureDir(dir);
+    return dir;
+  }
+  getContentScriptEntryPath(contentHash) {
+    return path.join(this.getContentScriptEntryDir(), `${contentHash}.js`);
+  }
+  createBundleConfigHash(dep, shouldBundle) {
+    return this.generateHash(
+      JSON.stringify({
+        bundle: shouldBundle,
+        minify: shouldBundle && this.isProduction,
+        opts: dep.bundleOptions
+      })
+    );
+  }
+  createContentScriptCacheKey(dep, shouldBundle) {
+    const contentHash = this.generateHash(dep.content);
+    const configHash = this.createBundleConfigHash(dep, shouldBundle);
+    return `${this.buildCacheKey(`content-script:${contentHash}`, contentHash, dep)}:${configHash}`;
+  }
+  toProcessedAsset(dep, filepath, inlineContent) {
+    return {
+      filepath,
+      content: dep.inline ? inlineContent : void 0,
+      kind: "script",
+      position: dep.position,
+      attributes: dep.attributes,
+      inline: dep.inline,
+      excludeFromHtml: dep.excludeFromHtml,
+      packageRole: dep.packageRole,
+      groupedBundle: dep.groupedBundle,
+      bundledSourceFilepaths: dep.bundledSourceFilepaths
+    };
+  }
+  removeContentScriptEntry(contentHash) {
+    if (shouldUseDevBrowserScriptCache()) {
+      return;
+    }
+    fileSystem.remove(this.getContentScriptEntryPath(contentHash));
+  }
   async processGrouped(deps) {
     if (deps.length === 0) {
       return [];
@@ -10,109 +53,92 @@ class ContentScriptProcessor extends BaseScriptProcessor {
     if (!shouldBundle || deps.some((dep) => dep.inline)) {
       return Promise.all(deps.map((dep) => this.process(dep)));
     }
-    const tempDir = path.join(
-      this.appConfig.absolutePaths.distDir,
-      `grouped-script-entries-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`
-    );
-    fileSystem.ensureDir(tempDir);
+    let tempEntries = [];
     try {
-      const tempEntries = deps.map((dep, index) => {
-        const entryName = dep.groupedBundle?.entryName ?? dep.name ?? `grouped-script-${index}`;
-        const tempFilepath = path.join(tempDir, `${entryName}.js`);
+      tempEntries = deps.map((dep) => {
+        const contentHash = this.generateHash(dep.content);
+        const tempFilepath = this.getContentScriptEntryPath(contentHash);
         fileSystem.write(tempFilepath, dep.content);
         return {
           dep,
-          entryName,
+          contentHash,
           tempFilepath
         };
       });
-      const primaryDep = deps[0];
       const outputPaths = await this.bundleScripts({
-        ...this.getBundlerOptions(primaryDep),
-        entries: tempEntries.map(({ entryName, tempFilepath }) => ({
-          entryName,
+        ...this.getGroupedBundlerOptions(deps),
+        entries: tempEntries.map(({ dep, contentHash, tempFilepath }) => ({
+          entryName: dep.groupedBundle?.entryName ?? dep.name ?? contentHash,
           entrypoint: tempFilepath
         })),
         outdir: this.getAssetsDir(),
         minify: this.isProduction,
         naming: "[name]-[hash].[ext]"
       });
-      return tempEntries.map(({ dep, entryName }) => {
+      return tempEntries.map(({ dep, contentHash }) => {
+        const entryName = dep.groupedBundle?.entryName ?? dep.name ?? contentHash;
         const bundledFilePath = outputPaths.get(entryName);
         if (!bundledFilePath) {
           throw new Error(`Missing grouped bundle output for ${entryName}`);
         }
-        return {
-          filepath: bundledFilePath,
-          content: dep.inline ? fileSystem.readFileSync(bundledFilePath).toString() : void 0,
-          kind: "script",
-          position: dep.position,
-          attributes: dep.attributes,
-          inline: dep.inline,
-          excludeFromHtml: dep.excludeFromHtml,
-          packageRole: dep.packageRole,
-          groupedBundle: dep.groupedBundle,
-          bundledSourceFilepaths: dep.bundledSourceFilepaths
-        };
+        return this.toProcessedAsset(
+          dep,
+          bundledFilePath,
+          dep.inline ? fileSystem.readFileSync(bundledFilePath).toString() : void 0
+        );
       });
     } finally {
-      fileSystem.remove(tempDir);
+      for (const { contentHash } of tempEntries) {
+        this.removeContentScriptEntry(contentHash);
+      }
     }
   }
-  async process(dep) {
-    const hash = this.generateHash(dep.content);
-    const filename = dep.name ? `${dep.name}.js` : `script-${hash}.js`;
-    const shouldBundle = this.shouldBundle(dep);
-    const filepath = path.join(this.getAssetsDir(), "scripts", filename);
-    if (!shouldBundle) {
-      if (!dep.inline) fileSystem.write(filepath, dep.content);
-      const unbundledProcessedAsset = {
-        filepath,
-        content: dep.inline ? dep.content : void 0,
-        kind: "script",
-        position: dep.position,
-        attributes: dep.attributes,
-        inline: dep.inline,
-        excludeFromHtml: dep.excludeFromHtml,
-        packageRole: dep.packageRole,
-        groupedBundle: dep.groupedBundle,
-        bundledSourceFilepaths: dep.bundledSourceFilepaths
-      };
-      this.writeCacheFile(filename, unbundledProcessedAsset);
-      return unbundledProcessedAsset;
-    }
-    if (dep.content) {
-      const tempDir = this.appConfig.absolutePaths.distDir;
-      fileSystem.ensureDir(tempDir);
-      const tempFileName = path.join(
-        tempDir,
-        `${path.parse(filename).name}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp.js`
-      );
-      fileSystem.write(tempFileName, dep.content);
-      const bundledFilePath = await this.bundleScript({
-        entrypoint: tempFileName,
-        outdir: this.getAssetsDir(),
-        minify: this.isProduction,
-        naming: `${path.parse(filename).name}-[hash].[ext]`,
-        ...this.getBundlerOptions(dep)
-      });
-      const processedAsset = {
-        filepath: bundledFilePath,
-        content: dep.inline ? fileSystem.readFileSync(bundledFilePath).toString() : void 0,
-        kind: "script",
-        position: dep.position,
-        attributes: dep.attributes,
-        inline: dep.inline,
-        excludeFromHtml: dep.excludeFromHtml,
-        packageRole: dep.packageRole,
-        groupedBundle: dep.groupedBundle,
-        bundledSourceFilepaths: dep.bundledSourceFilepaths
+  getGroupedBundlerOptions(deps) {
+    const primaryDep = deps[0];
+    const options = this.getBundlerOptions(primaryDep);
+    if (deps.some((dep) => dep.bundleOptions?.splitting === false)) {
+      return {
+        ...options,
+        splitting: false
       };
-      fileSystem.remove(tempFileName);
-      this.writeCacheFile(filename, processedAsset);
-      return processedAsset;
     }
-    throw new Error("No content found for script asset");
+    return options;
+  }
+  async process(dep) {
+    const shouldBundle = this.shouldBundle(dep);
+    const cacheKey = this.createContentScriptCacheKey(dep, shouldBundle);
+    return this.getOrProcess(cacheKey, async () => {
+      const hash = this.generateHash(dep.content);
+      const filename = dep.name ? `${dep.name}.js` : `script-${hash}.js`;
+      const filepath = path.join(this.getAssetsDir(), "scripts", filename);
+      if (!shouldBundle) {
+        if (!dep.inline) {
+          fileSystem.write(filepath, dep.content);
+        }
+        return this.toProcessedAsset(dep, filepath, dep.inline ? dep.content : void 0);
+      }
+      if (!dep.content) {
+        throw new Error("No content found for script asset");
+      }
+      const entryPath = this.getContentScriptEntryPath(hash);
+      fileSystem.write(entryPath, dep.content);
+      try {
+        const bundledFilePath = await this.bundleScript({
+          entrypoint: entryPath,
+          outdir: this.getAssetsDir(),
+          minify: this.isProduction,
+          naming: `${path.parse(filename).name}-[hash].[ext]`,
+          ...this.getBundlerOptions(dep)
+        });
+        return this.toProcessedAsset(
+          dep,
+          bundledFilePath,
+          dep.inline ? fileSystem.readFileSync(bundledFilePath).toString() : void 0
+        );
+      } finally {
+        this.removeContentScriptEntry(hash);
+      }
+    });
   }
 }
 export {

package/src/services/assets/asset-processing-service/resolve-integration-plugin.d.ts

@@ -0,0 +1,4 @@
+import type { AnyIntegrationPlugin } from '../../../plugins/integration-plugin.js';
+import type { EcoPagesAppConfig } from '../../../types/internal-types.js';
+/** Resolves the integration plugin that owns one asset-processing batch key. */
+export declare function resolveIntegrationPluginForProcessingKey(appConfig: EcoPagesAppConfig, processingKey: string): AnyIntegrationPlugin | undefined;

package/src/services/assets/asset-processing-service/resolve-integration-plugin.js

@@ -0,0 +1,17 @@
+function resolveIntegrationPluginForProcessingKey(appConfig, processingKey) {
+  if (!appConfig.integrations?.length) {
+    return void 0;
+  }
+  const exactMatch = appConfig.integrations.find((integration) => integration.name === processingKey);
+  if (exactMatch) {
+    return exactMatch;
+  }
+  const baseName = processingKey.split(":")[0];
+  if (!baseName || baseName === processingKey) {
+    return void 0;
+  }
+  return appConfig.integrations.find((integration) => integration.name === baseName);
+}
+export {
+  resolveIntegrationPluginForProcessingKey
+};

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

@@ -2,7 +2,6 @@ import type { AssetProcessor } from './processor.interface.js';
 import type { AssetDefinition, ProcessedAsset } from './assets.types.js';
 type ProcessUngroupedDependencyOptions = {
     dep: AssetDefinition;
-    key: string;
     depKey: string;
     getCachedAsset: (dep: AssetDefinition, depKey: string) => ProcessedAsset | null;
     getProcessor: (dep: AssetDefinition) => AssetProcessor | undefined;

package/src/services/assets/asset-processing-service/ungrouped-dependency-processing.js

@@ -1,8 +1,8 @@
 import { fileSystem } from "@ecopages/file-system";
+import { finalizeProcessedAsset } from "./finalize-processed-asset.js";
 async function processUngroupedDependency(options) {
   const {
     dep,
-    key,
     depKey,
     getCachedAsset,
     getProcessor,
@@ -14,7 +14,7 @@ async function processUngroupedDependency(options) {
   } = options;
   const cached = getCachedAsset(dep, depKey);
   if (cached) {
-    return { key, ...cached };
+    return finalizeProcessedAsset(cached, resolveProcessedAssetSrcUrl);
   }
   const processor = getProcessor(dep);
   if (!processor) {
@@ -27,14 +27,9 @@ async function processUngroupedDependency(options) {
   }
   try {
     const processed = await processor.process(dep);
-    const srcUrl = resolveProcessedAssetSrcUrl(processed);
-    const processedWithKey = {
-      key,
-      ...processed,
-      srcUrl
-    };
-    setCachedAsset(dep, depKey, processedWithKey);
-    return processedWithKey;
+    const finalized = finalizeProcessedAsset(processed, resolveProcessedAssetSrcUrl);
+    setCachedAsset(dep, depKey, finalized);
+    return finalized;
   } catch (error) {
     logProcessingError(dep, error);
     return null;

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

@@ -2,6 +2,9 @@ import { getAppBrowserBuildPlugins, getAppTranspileOptions } from "../../build/b
 import { requireBuildRuntime } from "../../build/build-runtime.js";
 import { mergeEcoBuildPlugins } from "../../build/build-manifest.js";
 import { getAppSourceTransforms } from "../../plugins/source-transform.js";
+import { startupTrace } from "../../diagnostics/startup-trace.js";
+import { requestBuildDedupe } from "../../diagnostics/request-build-dedupe.js";
+import { createBuildOptionsDedupeKey } from "../../build/deduping-build-executor.js";
 function resolveBrowserBundleExecutor(appConfig, profile, executor) {
   const buildRuntime = requireBuildRuntime(appConfig);
   if (executor === "hmr" && (profile === "hmr-entrypoint" || profile === "hmr-runtime")) {
@@ -38,12 +41,17 @@ class BrowserBundleService {
       sourceTransforms: getAppSourceTransforms(this.appConfig)
     };
     const buildExecutor = resolveBrowserBundleExecutor(this.appConfig, profile, executor);
-    return await buildExecutor.build(request);
+    const dedupeKey = createBuildOptionsDedupeKey(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);
   }