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

package/src/build/{dev-browser-script-cache.js → cache/dev-browser-script-cache.js}

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
-import { getAppBrowserBuildPlugins } from "./build-adapter.js";
+import { getAppBrowserBuildPlugins } from "../build-adapter.js";
 import { createBuildInputsFingerprint, hashAppConfigFile } from "./build-input-fingerprint.js";
 import {
   readProductionCacheManifest,
@@ -8,9 +8,9 @@ import {
   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";
+import { getCorePackageVersion } from "./cache-keys.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) {

package/src/build/{pages-unified-graph-build.d.ts → cache/pages-unified-graph-build.d.ts}

@@ -5,7 +5,7 @@
  * `ECOPAGES_UNIFIED_PAGES_GRAPH=0`. Covers all static page template extensions
  * registered on the app config.
  */
-import type { EcoPagesAppConfig } from '../types/internal-types.js';
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
 export declare const PAGES_UNIFIED_GRAPH_CACHE_DIR = ".server-pages-graph";
 export declare const PAGES_UNIFIED_GRAPH_CACHE_FILENAME = ".build-cache.json";
 export interface PagesUnifiedGraphCacheManifest {

package/src/build/{pages-unified-graph-build.js → cache/pages-unified-graph-build.js}

@@ -1,10 +1,10 @@
 import path from "node:path";
 import { pathToFileURL } from "node:url";
 import { fileSystem } from "@ecopages/file-system";
-import { appLogger } from "../global/app-logger.js";
-import { build, getAppServerBuildPlugins } from "./build-adapter.js";
-import { requireBuildRuntime } from "./build-runtime.js";
-import { resolveBuildProfileOptions } from "./build-profile-options.js";
+import { appLogger } from "../../global/app-logger.js";
+import { build } from "../build-adapter.js";
+import { requireBuildRuntime } from "../runtime/build-runtime.js";
+import { createServerBuildRequest, resolveServerAppBuildPlugins } from "../runtime/build-request-policy.js";
 import { createBuildInputsFingerprint, hashAppConfigFile } from "./build-input-fingerprint.js";
 import {
   isProductionCacheManifestCurrent,
@@ -13,12 +13,10 @@ import {
   readProductionCacheManifest,
   writeProductionCacheManifest
 } 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 { getSharedRouteModuleBuildCache } from "../services/module-loading/route-module-build-cache-registry.js";
-import { normalizeNodeRuntimeBuildOutputFile } from "./runtime-build-output-normalizer.js";
-import { resolveRouteModuleDependencyPaths } from "../services/module-loading/route-module-dependency-hasher.js";
-import { getJsxOwnershipPlugins } from "./jsx-ownership-plugins.js";
+import { getCorePackageVersion } from "./cache-keys.js";
+import { resolveInternalExecutionDir } from "../../utils/resolve-work-dir.js";
+import { getSharedRouteModuleBuildCache } from "../../services/module-loading/route-module-build-cache-registry.js";
+import { resolveRouteModuleDependencyPaths } from "../../services/module-loading/route-module-dependency-hasher.js";
 const PAGES_UNIFIED_GRAPH_CACHE_DIR = ".server-pages-graph";
 const PAGES_UNIFIED_GRAPH_CACHE_FILENAME = ".build-cache.json";
 function isPagesUnifiedGraphEnabled() {
@@ -45,8 +43,7 @@ function getPagesUnifiedGraphCachePath(appConfig) {
   );
 }
 function createPagesUnifiedGraphBuildKey(appConfig, outdir) {
-  const plugins = appConfig.runtime?.buildManifest ? getAppServerBuildPlugins(appConfig) : [];
-  const pluginNames = [...plugins, ...getJsxOwnershipPlugins(appConfig)].map((plugin) => plugin.name).sort().join("|");
+  const pluginNames = resolveServerAppBuildPlugins(appConfig).map((plugin) => plugin.name).sort().join("|");
   const templateExtensions = [...appConfig.templatesExt].sort().join("|");
   return [
     path.resolve(outdir),
@@ -121,8 +118,6 @@ async function ensurePagesUnifiedGraphBuilt(options) {
     appLogger.debug("Reusing pages unified graph cache");
     return existingManifest;
   }
-  const plugins = options.appConfig.runtime?.buildManifest ? getAppServerBuildPlugins(options.appConfig) : [];
-  const mergedPlugins = [...plugins, ...getJsxOwnershipPlugins(options.appConfig)];
   const routeModuleBuildCache = getSharedRouteModuleBuildCache(outdir, options.appConfig);
   const entryRecord = {};
   const entryKeysByPath = /* @__PURE__ */ new Map();
@@ -132,16 +127,14 @@ async function ensurePagesUnifiedGraphBuilt(options) {
     entryKeysByPath.set(entryPath, entryKey);
   }
   appLogger.debugTime("pagesUnifiedGraphBuild");
-  const buildOptions = {
-    ...resolveBuildProfileOptions("route-module", options.appConfig, {
-      entrypoints: entryRecord,
-      outdir,
-      splitting: true,
-      naming: "[name]-[hash].[ext]",
-      plugins: mergedPlugins.length > 0 ? mergedPlugins : void 0
-    }),
-    entrypoints: entryRecord
-  };
+  const buildOptions = createServerBuildRequest(options.appConfig, {
+    profile: "route-module",
+    entrypoints: entryRecord,
+    outdir,
+    splitting: true,
+    naming: "[name]-[hash].[ext]"
+  });
+  const plugins = buildOptions.plugins ?? [];
   const buildResult = await build(buildOptions, requireBuildRuntime(options.appConfig).getProfile("route-module"));
   appLogger.debugTimeEnd("pagesUnifiedGraphBuild");
   if (!buildResult.success) {
@@ -156,7 +149,6 @@ async function ensurePagesUnifiedGraphBuilt(options) {
     if (!compiledOutput) {
       throw new Error(`Pages unified graph build produced no output for ${entryPath}`);
     }
-    normalizeNodeRuntimeBuildOutputFile(compiledOutput, options.appConfig.rootDir);
     outputs[entryPath] = compiledOutput;
     routeModuleBuildCache.recordBuild({
       filePath: entryPath,
@@ -166,7 +158,7 @@ async function ensurePagesUnifiedGraphBuilt(options) {
       outputPath: compiledOutput,
       dependencyModulePaths: resolveRouteModuleDependencyPaths(buildResult, entryPath, options.appConfig.rootDir),
       externalPackages: true,
-      plugins: mergedPlugins
+      plugins
     });
   }
   const manifest = {

package/src/build/{production-build-cache.d.ts → cache/production-build-cache.d.ts}

@@ -1,4 +1,4 @@
-import type { EcoPagesAppConfig } from '../types/internal-types.js';
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
 /**
  * Shared manifest fields for persisted production build caches.
  */

package/src/build/{production-build-cache.js → cache/production-build-cache.js}

@@ -1,7 +1,7 @@
 import { fileSystem } from "@ecopages/file-system";
 import path from "node:path";
-import { ROUTE_MODULE_BUILD_CACHE_FILENAME } from "../services/module-loading/route-module-build-manifest.js";
-import { resolveInternalExecutionDir } from "../utils/resolve-work-dir.js";
+import { ROUTE_MODULE_BUILD_CACHE_FILENAME } from "./cache-constants.js";
+import { resolveInternalExecutionDir } from "../../utils/resolve-work-dir.js";
 const ROUTE_MODULE_CACHE_OUTDIRS = [".server-modules", ".server-route-modules"];
 const PAGES_GRAPH_CACHE_DIR = ".server-pages-graph";
 function getProductionBuildCacheManifestPaths(appConfig) {

package/src/build/{server-entry-build-cache.d.ts → cache/server-entry-build-cache.d.ts}

@@ -1,7 +1,6 @@
-import type { BuildResult } from './build-adapter.js';
-import type { EcoPagesAppConfig } from '../types/internal-types.js';
-/** @deprecated Use {@link ROUTE_MODULE_BUILD_CACHE_FILENAME}; both caches share the same manifest filename. */
-export declare const SERVER_ENTRY_BUILD_CACHE_FILENAME = ".build-cache.json";
+import type { BuildResult } from '../build-adapter.js';
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
+export { SERVER_ENTRY_BUILD_CACHE_FILENAME } from './cache-constants.js';
 export declare const SERVER_BUNDLE_MANIFEST_FILENAME = "manifest.json";
 export interface ServerBundleDeployManifest {
     serverEntry: string;

package/src/build/{server-entry-build-cache.js → cache/server-entry-build-cache.js}

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
-import { getAppServerBuildPlugins } from "./build-adapter.js";
+import { resolveServerAppBuildPlugins } from "../runtime/build-request-policy.js";
 import { createBuildInputsFingerprint } from "./build-input-fingerprint.js";
 import {
   isProductionCacheManifestCurrent,
@@ -9,15 +9,15 @@ import {
   readProductionCacheManifest,
   writeProductionCacheManifest
 } from "./production-build-cache.js";
-import { getCorePackageVersion } from "../services/module-loading/route-module-build-manifest.js";
+import { createPluginCacheKey, getCorePackageVersion } from "./cache-keys.js";
 import {
   RouteModuleDependencyHasher,
   createRouteModuleDependencyHashes
-} from "../services/module-loading/route-module-dependency-hasher.js";
-import { resolveInternalExecutionDir } from "../utils/resolve-work-dir.js";
-import { SERVER_BUNDLE_DIR, SERVER_BUNDLE_FILENAME } from "../utils/resolve-entry-file.js";
-import { ROUTE_MODULE_BUILD_CACHE_FILENAME } from "../services/module-loading/route-module-build-manifest.js";
-const SERVER_ENTRY_BUILD_CACHE_FILENAME = ROUTE_MODULE_BUILD_CACHE_FILENAME;
+} from "../../services/module-loading/route-module-dependency-hasher.js";
+import { resolveInternalExecutionDir } from "../../utils/resolve-work-dir.js";
+import { SERVER_BUNDLE_DIR, SERVER_BUNDLE_FILENAME } from "../../utils/resolve-entry-file.js";
+import { SERVER_ENTRY_BUILD_CACHE_FILENAME } from "./cache-constants.js";
+import { SERVER_ENTRY_BUILD_CACHE_FILENAME as SERVER_ENTRY_BUILD_CACHE_FILENAME2 } from "./cache-constants.js";
 const SERVER_BUNDLE_MANIFEST_FILENAME = "manifest.json";
 function getServerEntryCacheDir(appConfig) {
   return path.join(resolveInternalExecutionDir(appConfig), ".server-entry");
@@ -33,11 +33,15 @@ function hashDependencyGraph(entryPath, dependencyGraph, hasher, rootDir) {
 }
 function createServerEntryBuildKey(appConfig) {
   try {
-    const plugins = getAppServerBuildPlugins(appConfig);
-    const pluginNames = plugins.map((plugin) => plugin.name).sort().join("|");
-    return ["node", "esm", "external-packages", pluginNames].join("::");
+    return [
+      "server-entry-request-v2",
+      "node",
+      "esm",
+      "external-packages",
+      createPluginCacheKey(resolveServerAppBuildPlugins(appConfig))
+    ].join("::");
   } catch {
-    return "node::esm::external-packages";
+    return "server-entry-request-v2::node::esm::external-packages";
   }
 }
 function getServerBundleOutputPaths(appConfig) {
@@ -151,7 +155,7 @@ function resolveProductionServerEntry(cwd = process.cwd()) {
 }
 export {
   SERVER_BUNDLE_MANIFEST_FILENAME,
-  SERVER_ENTRY_BUILD_CACHE_FILENAME,
+  SERVER_ENTRY_BUILD_CACHE_FILENAME2 as SERVER_ENTRY_BUILD_CACHE_FILENAME,
   getServerBundleOutputPaths,
   lookupServerEntryBuildCache,
   readServerEntryBuildCacheManifest,

package/src/build/{build-contracts.d.ts → contracts/build-contracts.d.ts}

@@ -1,4 +1,4 @@
-import type { EcoSourceTransform } from '../plugins/source-transform.js';
+import type { EcoSourceTransform } from '../../plugins/source-transform.js';
 import type { EcoBuildPlugin } from './build-types.js';
 /**
  * Which backend owns the app's build pipeline.
@@ -74,7 +74,6 @@ export interface BuildOptions {
     };
     plugins?: EcoBuildPlugin[];
     sourceTransforms?: EcoSourceTransform[];
-    [key: string]: unknown;
 }
 /** Stable profile identifiers for `BuildAdapter.getTranspileOptions`. */
 export type BuildTranspileProfile = 'browser-script' | 'hmr-runtime' | 'hmr-entrypoint';

package/src/build/contracts/build-manifest.d.ts

@@ -0,0 +1,90 @@
+import type { EcoBuildPlugin } from './build-types.js';
+import { type BrowserRuntimeManifest } from '../browser/browser-runtime-manifest.js';
+/**
+ * Sealed, app-owned registry of build plugins and browser runtime assets.
+ *
+ * @remarks
+ * Core assembles one manifest during {@link ConfigBuilder.build} and stores it on
+ * `appConfig.runtime.buildManifest`. Request policy reads from this manifest when
+ * constructing server and browser {@link BuildOptions}; profiles do not inject
+ * plugins themselves.
+ *
+ * Contributor naming differs by layer but maps to the same buckets:
+ *
+ * | Integration getter | Processor getter | Manifest bucket |
+ * | --- | --- | --- |
+ * | `plugins` | `plugins` | `runtimePlugins` |
+ * | `browserBuildPlugins` | `buildPlugins` | `browserBundlePlugins` |
+ * | `browserRuntimeManifest` | — | `browserRuntimeManifest` |
+ * | — (file loaders on config) | — | `loaderPlugins` |
+ *
+ * Use {@link getServerBuildPlugins} and {@link getBrowserBuildPlugins} to turn
+ * buckets into the plugin lists passed to Rolldown. App-aware call sites should
+ * prefer {@link getAppServerBuildPlugins} and {@link getAppBrowserBuildPlugins},
+ * which add alias resolution, JSX ownership, and browser source-transform
+ * deduplication on top of the manifest lists.
+ */
+export interface AppBuildManifest {
+    /** File-extension loaders registered on the app config (for example `.mdx`). */
+    loaderPlugins: EcoBuildPlugin[];
+    /**
+     * Shared plugins for server-oriented and browser-oriented builds.
+     *
+     * @remarks
+     * Sourced from integration `plugins` and processor `plugins`. Virtual-module
+     * loaders and transforms that must run during route-module transpile belong
+     * here.
+     */
+    runtimePlugins: EcoBuildPlugin[];
+    /**
+     * Browser-bundle-only plugins.
+     *
+     * @remarks
+     * Sourced from integration `browserBuildPlugins` and processor `buildPlugins`.
+     * Do not register server route or static-page transforms here.
+     */
+    browserBundlePlugins: EcoBuildPlugin[];
+    /**
+     * Specifier → public URL map for client bundles.
+     *
+     * @remarks
+     * Not a plugin list. {@link getBrowserBuildPlugins} synthesizes
+     * `browser-runtime-plugin` from this map to rewrite manifest-owned imports.
+     */
+    browserRuntimeManifest: BrowserRuntimeManifest;
+}
+/**
+ * Merges plugin lists while preserving first-registration precedence by name.
+ *
+ * @remarks
+ * Build manifests treat plugin names as stable identities. The first plugin
+ * with a given name wins so config-time assembly stays deterministic across
+ * loader, runtime, and browser buckets.
+ */
+export declare function mergeEcoBuildPlugins(...pluginLists: Array<EcoBuildPlugin[] | undefined>): EcoBuildPlugin[];
+/**
+ * Creates one app-owned build manifest from the supplied plugin buckets.
+ */
+export declare function createAppBuildManifest(input?: Partial<AppBuildManifest>): AppBuildManifest;
+/**
+ * Returns the shared browser runtime asset manifest sealed into the app build manifest.
+ */
+export declare function getBrowserRuntimeManifest(manifest: AppBuildManifest): BrowserRuntimeManifest;
+/**
+ * Returns the plugin list used for server-oriented builds.
+ *
+ * @remarks
+ * Merges `loaderPlugins` then `runtimePlugins`. Browser-only buckets and the
+ * synthesized browser-runtime rewrite plugin are excluded.
+ */
+export declare function getServerBuildPlugins(manifest: AppBuildManifest): EcoBuildPlugin[];
+/**
+ * Returns the plugin list used for browser-oriented builds.
+ *
+ * @remarks
+ * Merges, in order: `loaderPlugins`, `runtimePlugins`, a synthesized
+ * `browser-runtime-plugin` when `browserRuntimeManifest` has entries, then
+ * `browserBundlePlugins`. Plugin names dedupe with first-registration wins via
+ * {@link mergeEcoBuildPlugins}.
+ */
+export declare function getBrowserBuildPlugins(manifest: AppBuildManifest): EcoBuildPlugin[];

package/src/build/{build-manifest.js → contracts/build-manifest.js}

@@ -1,8 +1,8 @@
-import { createBrowserRuntimePlugin, DEFAULT_BROWSER_RUNTIME_PLUGIN_NAME } from "./browser-runtime-plugin.js";
+import { createBrowserRuntimePlugin, DEFAULT_BROWSER_RUNTIME_PLUGIN_NAME } from "../browser/browser-runtime-plugin.js";
 import {
   createBrowserRuntimeManifest,
   mergeBrowserRuntimeManifests
-} from "./browser-runtime-manifest.js";
+} from "../browser/browser-runtime-manifest.js";
 function mergeEcoBuildPlugins(...pluginLists) {
   const byName = /* @__PURE__ */ new Map();
   for (const plugins of pluginLists) {

package/src/build/{rolldown-adapter-helpers.d.ts → rolldown/rolldown-adapter-helpers.d.ts}

@@ -8,10 +8,27 @@
  *
  * @module
  */
-import type { InputOptions, OutputOptions } from 'rolldown';
-import type { EcoBuildPlugin } from './build-types.js';
-import type { BuildDependencyGraph, BuildLog, BuildOptions, BuildResult, BuildTranspileOptions, BuildTranspileProfile } from './build-adapter.js';
+import type { InputOptions, OutputOptions, RolldownPlugin } from 'rolldown';
+import type { EcoBuildPlugin } from '../contracts/build-types.js';
+import type { BuildDependencyGraph, BuildLog, BuildOptions, BuildResult, BuildTranspileOptions, BuildTranspileProfile } from '../build-adapter.js';
 export declare function transpileProfileToOptions(profile: BuildTranspileProfile): BuildTranspileOptions;
+/**
+ * Resolves Node builtins as external before Rolldown falls back to file resolution.
+ *
+ * @remarks
+ * Rolldown documents two first-class externalization points: its `external`
+ * option is checked before resolution, and a plugin `resolveId` hook can return
+ * `{ id, external: true }`. Core uses the latter to keep Node-builtin ownership
+ * explicit in the Node-target plugin pipeline.
+ *
+ * The hook runs before Rolldown's internal filesystem resolver, leaving imports
+ * such as `node:fs` intact for the Node runtime. It is installed only for
+ * Node-target builds, so browser bundles still surface accidental Node builtin
+ * imports as resolver failures.
+ *
+ * See {@link https://rolldown.rs/in-depth/external-modules | Rolldown external modules}.
+ */
+export declare function createNodeBuiltinExternalPlugin(): RolldownPlugin;
 export declare function extractDependencyGraph(chunks: Array<{
     facadeModuleId: string | null;
     moduleIds: string[];

package/src/build/{rolldown-adapter-helpers.js → rolldown/rolldown-adapter-helpers.js}

@@ -1,8 +1,11 @@
-import { createRequire } from "node:module";
+import { builtinModules, createRequire } from "node:module";
 import { readFileSync } from "node:fs";
 import path from "node:path";
-import { isBarePackageImportSpecifier } from "../plugins/tsconfig-import-resolver.js";
-import { collectBrowserRuntimeImportRewriteMap, rewriteBrowserRuntimeImports } from "./browser-runtime-plugin.js";
+import { isBarePackageImportSpecifier } from "../../plugins/tsconfig-import-resolver.js";
+import {
+  collectBrowserRuntimeImportRewriteMap,
+  rewriteBrowserRuntimeImports
+} from "../browser/browser-runtime-plugin.js";
 import { createServerSideCssShimPlugin } from "./server-side-css-shim-plugin.js";
 import { createRolldownPluginBridge } from "./rolldown-plugin-bridge.js";
 import {
@@ -10,13 +13,14 @@ import {
   isWorkspacePackageImport,
   normalizeNodeRuntimeBuildOutputs
 } from "./runtime-build-output-normalizer.js";
-const corePackageRequire = createRequire(new URL("../../package.json", import.meta.url));
+const corePackageRequire = createRequire(new URL("../../../package.json", import.meta.url));
+const nodeBuiltinSpecifiers = new Set(builtinModules);
 let corePackageNames;
 function getCorePackageNames() {
   if (corePackageNames) {
     return corePackageNames;
   }
-  const packageJsonPath = new URL("../../package.json", import.meta.url);
+  const packageJsonPath = new URL("../../../package.json", import.meta.url);
   corePackageNames = /* @__PURE__ */ new Set();
   try {
     const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
@@ -99,6 +103,17 @@ function createExternalMatcher(options, appRootRequireCache) {
     return !shouldBundlePackageImport(id, contextRoot, appRootRequireCache);
   };
 }
+function isNodeBuiltinSpecifier(id) {
+  return id.startsWith("node:") || nodeBuiltinSpecifiers.has(id);
+}
+function createNodeBuiltinExternalPlugin() {
+  return {
+    name: "ecopages-node-builtin-external",
+    resolveId(id) {
+      return isNodeBuiltinSpecifier(id) ? { id, external: true } : null;
+    }
+  };
+}
 function mapRolldownFormat(value) {
   switch (value) {
     case "cjs":
@@ -204,7 +219,11 @@ function resolveRolldownOptions(options, contextRoot, outdir, appRootRequireCach
   const bundlePlugins = options.plugins ?? [];
   const sourceTransforms = options.target === "browser" ? options.sourceTransforms ?? [] : [];
   const appPlugins = createRolldownPluginBridge(bundlePlugins, contextRoot, sourceTransforms);
-  const allPlugins = [...options.target !== "browser" ? [createServerSideCssShimPlugin()] : [], ...appPlugins];
+  const allPlugins = [
+    ...mapRolldownPlatform(options.target) === "node" ? [createNodeBuiltinExternalPlugin()] : [],
+    ...options.target !== "browser" ? [createServerSideCssShimPlugin()] : [],
+    ...appPlugins
+  ];
   const inputOptions = {
     input: options.entrypoints,
     cwd: contextRoot,
@@ -322,6 +341,7 @@ function buildResultFromRolldownOutput(output, outdir, contextRoot) {
 export {
   buildResultFromRolldownOutput,
   clearRewriteCacheForTests,
+  createNodeBuiltinExternalPlugin,
   extractDependencyGraph,
   resolveRolldownOptions,
   rewriteBrowserRuntimeImportsInOutputs,

package/src/build/{rolldown-build-adapter.d.ts → rolldown/rolldown-build-adapter.d.ts}

@@ -8,7 +8,7 @@
  *
  * Each `build()` creates a fresh `rolldown()` bundler.
  */
-import type { BuildAdapter, BuildOptions, BuildResult, BuildTranspileOptions, BuildTranspileProfile } from './build-adapter.js';
+import type { BuildAdapter, BuildOptions, BuildResult, BuildTranspileOptions, BuildTranspileProfile } from '../build-adapter.js';
 export declare class RolldownBuildAdapter implements BuildAdapter {
     readonly ownership: "rolldown";
     /** Per-adapter require cache, keyed on resolved context root. */

package/src/build/{rolldown-plugin-bridge.d.ts → rolldown/rolldown-plugin-bridge.d.ts}

@@ -40,8 +40,8 @@
  * on every source file.
  */
 import type { Plugin } from 'rolldown';
-import type { EcoSourceTransform } from '../plugins/source-transform.js';
-import type { EcoBuildPlugin } from './build-types.js';
+import type { EcoSourceTransform } from '../../plugins/source-transform.js';
+import type { EcoBuildPlugin } from '../contracts/build-types.js';
 /**
  * Creates a Rolldown `Plugin` array that drives the supplied
  * `EcoBuildPlugin` instances.

package/src/build/{rolldown-plugin-bridge.js → rolldown/rolldown-plugin-bridge.js}

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { finalizeLoadResultWithSourceTransforms } from "./rolldown-source-transform-pass.js";
-import { escapeRegExp } from "./browser-runtime-plugin-helpers.js";
+import { escapeRegExp } from "../browser/browser-runtime-plugin-helpers.js";
 const NAMESPACE_SEPARATOR = ":";
 function joinNamespace(namespace, value) {
   return namespace ? `${namespace}${NAMESPACE_SEPARATOR}${value}` : value;

package/src/build/{rolldown-source-transform-pass.d.ts → rolldown/rolldown-source-transform-pass.d.ts}

@@ -1,5 +1,5 @@
 import type { LoadResult, SourceDescription } from 'rolldown';
-import { type EcoSourceTransform } from '../plugins/source-transform.js';
+import { type EcoSourceTransform } from '../../plugins/source-transform.js';
 /**
  * Runs app-owned source transforms after first-wins `onLoad` plugins produce
  * module contents for one Rolldown load request.

package/src/build/{rolldown-source-transform-pass.js → rolldown/rolldown-source-transform-pass.js}

@@ -1,6 +1,9 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
-import { applySourceTransforms, normalizeTransformId } from "../plugins/source-transform.js";
+import {
+  applySourceTransforms,
+  normalizeTransformId
+} from "../../plugins/source-transform.js";
 const TRANSFORMABLE_SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mdx"]);
 function shouldApplySourceTransforms(namespace, sourcePath) {
   if (namespace !== void 0) {

package/src/build/{runtime-build-output-normalizer.js → rolldown/runtime-build-output-normalizer.js}

@@ -2,8 +2,8 @@ import { createRequire } from "node:module";
 import { readFileSync } from "node:fs";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
-import { isBarePackageImportSpecifier } from "../plugins/tsconfig-import-resolver.js";
-const corePackageRequire = createRequire(new URL("../../package.json", import.meta.url));
+import { isBarePackageImportSpecifier } from "../../plugins/tsconfig-import-resolver.js";
+const corePackageRequire = createRequire(new URL("../../../package.json", import.meta.url));
 const appDeclaredPackageCache = /* @__PURE__ */ new Map();
 const appWorkspacePackageCache = /* @__PURE__ */ new Map();
 const CORE_RUNTIME_BARE_SPECIFIER_PACKAGES = /* @__PURE__ */ new Set(["ws"]);

package/src/build/{build-profile-options.d.ts → runtime/build-profile-options.d.ts}

@@ -1,6 +1,6 @@
-import type { BuildOptions } from './build-adapter.js';
+import type { BuildOptions } from '../build-adapter.js';
 import type { BuildProfile } from './build-runtime.js';
-import type { EcoPagesAppConfig } from '../types/internal-types.js';
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
 /**
  * Resolves shared Rolldown options for a build profile.
  */

package/src/build/runtime/build-request-identity.d.ts

@@ -0,0 +1,17 @@
+import type { BuildOptions } from '../contracts/build-contracts.js';
+/**
+ * Canonical identity for one complete {@link BuildOptions} request.
+ *
+ * @remarks
+ * Semantically unordered collections (`external`, `define` keys, array entrypoints)
+ * are sorted. Plugin, `conditions`, and source-transform order is preserved because
+ * Rolldown hook and `conditionNames` precedence depend on it.
+ *
+ * Deprecated / ignored adapter fields (`splitting`, `bundle`, `outbase`) still
+ * participate in the key so requests that differ only on those fields do not
+ * coalesce. Empty `conditions` / `define` / `external` normalize to the same
+ * sentinel as `undefined`.
+ */
+export declare function createBuildRequestIdentity(options: BuildOptions): string;
+/** @deprecated Use {@link createBuildRequestIdentity}. */
+export declare const createBuildOptionsDedupeKey: typeof createBuildRequestIdentity;

package/src/build/runtime/build-request-identity.js

@@ -0,0 +1,54 @@
+import path from "node:path";
+import { createJsxCacheKey, createPluginCacheKey, createSourceTransformCacheKey } from "../cache/cache-keys.js";
+function normalizeEntrypoints(entrypoints) {
+  if (Array.isArray(entrypoints)) {
+    return entrypoints.map((entrypoint) => path.resolve(entrypoint)).sort().join("|");
+  }
+  return Object.entries(entrypoints).sort(([left], [right]) => left.localeCompare(right)).map(([key, value]) => `${key}:${path.resolve(value)}`).join("|");
+}
+function normalizeOrderedStringList(values, label) {
+  if (!values || values.length === 0) {
+    return `${label}:default`;
+  }
+  return `${label}:${values.join(",")}`;
+}
+function normalizeUnorderedStringList(values, label) {
+  if (!values || values.length === 0) {
+    return `${label}:default`;
+  }
+  return `${label}:${[...values].sort().join(",")}`;
+}
+function normalizeDefine(define) {
+  if (!define || Object.keys(define).length === 0) {
+    return "define:default";
+  }
+  return `define:${Object.entries(define).sort(([left], [right]) => left.localeCompare(right)).map(([key, value]) => `${key}=${value}`).join(",")}`;
+}
+function createBuildRequestIdentity(options) {
+  return [
+    normalizeEntrypoints(options.entrypoints),
+    options.root ? path.resolve(options.root) : "root:default",
+    options.outdir ? path.resolve(options.outdir) : "outdir:default",
+    options.outbase ? path.resolve(options.outbase) : "outbase:default",
+    options.splitting ?? "splitting:default",
+    options.bundle ?? "bundle:default",
+    options.externalPackages ?? "externalPackages:default",
+    options.target ?? "target:default",
+    options.format ?? "format:default",
+    options.sourcemap ?? "sourcemap:default",
+    options.minify ?? "minify:default",
+    options.treeshaking ?? "treeshaking:default",
+    options.naming ?? "naming:default",
+    normalizeOrderedStringList(options.conditions, "conditions"),
+    normalizeDefine(options.define),
+    normalizeUnorderedStringList(options.external, "external"),
+    createJsxCacheKey(options.jsx),
+    createPluginCacheKey(options.plugins),
+    createSourceTransformCacheKey(options.sourceTransforms)
+  ].join("::");
+}
+const createBuildOptionsDedupeKey = createBuildRequestIdentity;
+export {
+  createBuildOptionsDedupeKey,
+  createBuildRequestIdentity
+};

package/src/build/runtime/build-request-policy.d.ts

@@ -0,0 +1,59 @@
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
+import type { EcoBuildPlugin } from '../contracts/build-types.js';
+import type { BuildOptions, BuildTranspileProfile } from '../contracts/build-contracts.js';
+import type { BuildProfile } from './build-runtime.js';
+/**
+ * Resolves app-owned server plugins plus JSX ownership for one config.
+ *
+ * @remarks
+ * Always goes through {@link getAppServerBuildPlugins} so sealed-manifest and
+ * loader-fallback apps share one plugin list with the alias resolver. Used by
+ * both request assembly and unified-graph cache keys.
+ */
+export declare function resolveServerAppBuildPlugins(appConfig: EcoPagesAppConfig): EcoBuildPlugin[];
+/**
+ * Merges caller plugins with app-owned manifest plugins.
+ *
+ * @remarks
+ * App-manifest plugins cannot be silently replaced by same-name caller plugins.
+ * Unique caller plugins are prepended so first-wins Rolldown hooks (for example
+ * React vendor/alias rewrites) still run before general app loaders. Use
+ * `excludeAppBuildPlugins` on browser requests to omit app-owned plugins.
+ */
+export declare function mergeCallerBuildPlugins(appPlugins: EcoBuildPlugin[], callerPlugins?: EcoBuildPlugin[]): EcoBuildPlugin[];
+export type ServerBuildRequestInput = Partial<BuildOptions> & {
+    entrypoints: BuildOptions['entrypoints'];
+    profile?: Extract<BuildProfile, 'server-entry' | 'route-module'>;
+};
+export type BrowserBuildRequestInput = Partial<BuildOptions> & {
+    entrypoints: BuildOptions['entrypoints'];
+    profile: BuildTranspileProfile;
+    excludeAppBuildPlugins?: string[];
+};
+/**
+ * Assembles a complete server-oriented {@link BuildOptions} before scheduling.
+ *
+ * @remarks
+ * Defaults `profile` to `'route-module'`. Plugins are
+ * {@link resolveServerAppBuildPlugins} plus unique caller contributions via
+ * {@link mergeCallerBuildPlugins}. Does not attach `sourceTransforms` — unlike
+ * {@link createBrowserBuildRequest}. Pass the returned options into
+ * {@link BuildRuntime.getProfile}; the runtime no longer injects plugins.
+ */
+export declare function createServerBuildRequest(appConfig: EcoPagesAppConfig, input: ServerBuildRequestInput): BuildOptions;
+/**
+ * Assembles a complete browser-oriented {@link BuildOptions} before scheduling.
+ *
+ * @remarks
+ * Applies {@link resolveBuildProfileOptions} for `'browser-hmr'` (browser target
+ * defaults), then overlays {@link getAppTranspileOptions} for the given
+ * {@link BuildTranspileProfile}. That profile selects transpile settings only;
+ * the {@link BuildRuntime} executor slot is chosen later by the caller
+ * (typically {@link BrowserBundleService}).
+ *
+ * Always attaches {@link getAppSourceTransforms}. App browser plugins come from
+ * {@link getAppBrowserBuildPlugins} (includes JSX ownership); use
+ * `excludeAppBuildPlugins` to omit app-owned names. Caller plugins cannot
+ * replace app-manifest names ({@link mergeCallerBuildPlugins}).
+ */
+export declare function createBrowserBuildRequest(appConfig: EcoPagesAppConfig, input: BrowserBuildRequestInput): BuildOptions;