@ecopages/core 0.2.0-beta.30 → 0.2.0-beta.32

package/src/build/rolldown/runtime-build-output-normalizer.js

@@ -1,201 +1,253 @@
-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));
-const appDeclaredPackageCache = /* @__PURE__ */ new Map();
-const appWorkspacePackageCache = /* @__PURE__ */ new Map();
-const CORE_RUNTIME_BARE_SPECIFIER_PACKAGES = /* @__PURE__ */ new Set(["ws"]);
+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));
+const appDeclaredPackageCache = new Map();
+const appWorkspacePackageCache = new Map();
+/**
+ * Core-owned packages that are part of the Node adapter's runtime surface and
+ * should therefore be preserved as bare specifiers in bundled output.
+ *
+ * Only list packages whose bare-specifier form will be resolvable from the
+ * app's Node.js runtime (i.e. they ship alongside the framework and do not
+ * need to be in the app's own package.json).
+ *
+ * Build-time tools (e.g. oxc-parser, rolldown) deliberately omitted — their
+ * imports in server-side output must be rewritten to absolute file: URLs so
+ * the bundler does not embed them in app code.
+ */
+const CORE_RUNTIME_BARE_SPECIFIER_PACKAGES = new Set(['ws']);
 function tryResolveRuntimeImport(specifier, resolver) {
-  try {
-    return resolver.resolve(specifier);
-  } catch {
-    return void 0;
-  }
+    try {
+        return resolver.resolve(specifier);
+    }
+    catch {
+        return undefined;
+    }
 }
+/**
+ * Extracts the package name from a file:// URL pointing to a node_modules path.
+ *
+ * @remarks
+ * Given a URL like `file:///path/to/node_modules/@scope/pkg/dist/index.js`,
+ * returns `@scope/pkg`. Given `file:///path/to/node_modules/pkg/dist/index.js`,
+ * returns `pkg`. Returns `undefined` if the URL doesn't point to node_modules.
+ *
+ * Handles pnpm's nested node_modules structure by finding the LAST node_modules
+ * in the path (e.g., `node_modules/.pnpm/pkg@version/node_modules/@scope/pkg/...`).
+ */
 function extractPackageNameFromFileUrl(specifier) {
-  if (!specifier.startsWith("file://")) {
-    return void 0;
-  }
-  const lastNodeModulesIndex = specifier.lastIndexOf("/node_modules/");
-  if (lastNodeModulesIndex === -1) {
-    return void 0;
-  }
-  const afterNodeModules = specifier.slice(lastNodeModulesIndex + "/node_modules/".length);
-  const parts = afterNodeModules.split("/");
-  if (parts.length === 0) {
-    return void 0;
-  }
-  if (parts[0]?.startsWith("@") && parts.length > 1) {
-    return `${parts[0]}/${parts[1]}`;
-  }
-  return parts[0];
+    if (!specifier.startsWith('file://')) {
+        return undefined;
+    }
+    // Find the LAST node_modules in the path to handle pnpm's nested structure
+    const lastNodeModulesIndex = specifier.lastIndexOf('/node_modules/');
+    if (lastNodeModulesIndex === -1) {
+        return undefined;
+    }
+    const afterNodeModules = specifier.slice(lastNodeModulesIndex + '/node_modules/'.length);
+    const parts = afterNodeModules.split('/');
+    if (parts.length === 0) {
+        return undefined;
+    }
+    if (parts[0]?.startsWith('@') && parts.length > 1) {
+        return `${parts[0]}/${parts[1]}`;
+    }
+    return parts[0];
 }
 function getPackageNameFromSpecifier(specifier) {
-  if (specifier.startsWith("@")) {
-    return specifier.split("/").slice(0, 2).join("/");
-  }
-  return specifier.split("/")[0] ?? specifier;
+    if (specifier.startsWith('@')) {
+        return specifier.split('/').slice(0, 2).join('/');
+    }
+    return specifier.split('/')[0] ?? specifier;
 }
 function getDeclaredAppPackages(rootDir) {
-  const cacheKey = path.resolve(rootDir);
-  const cached = appDeclaredPackageCache.get(cacheKey);
-  if (cached) {
-    return cached;
-  }
-  const packageJsonPath = path.resolve(rootDir, "package.json");
-  const declaredPackages = /* @__PURE__ */ new Set();
-  try {
-    const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
-    for (const field of ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"]) {
-      const entries = packageJson[field];
-      if (!entries || typeof entries !== "object") {
-        continue;
-      }
-      for (const packageName of Object.keys(entries)) {
-        declaredPackages.add(packageName);
-      }
-    }
-  } catch {
+    const cacheKey = path.resolve(rootDir);
+    const cached = appDeclaredPackageCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    const packageJsonPath = path.resolve(rootDir, 'package.json');
+    const declaredPackages = new Set();
+    try {
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+        for (const field of ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies']) {
+            const entries = packageJson[field];
+            if (!entries || typeof entries !== 'object') {
+                continue;
+            }
+            for (const packageName of Object.keys(entries)) {
+                declaredPackages.add(packageName);
+            }
+        }
+    }
+    catch {
+        appDeclaredPackageCache.set(cacheKey, declaredPackages);
+        return declaredPackages;
+    }
     appDeclaredPackageCache.set(cacheKey, declaredPackages);
     return declaredPackages;
-  }
-  appDeclaredPackageCache.set(cacheKey, declaredPackages);
-  return declaredPackages;
 }
+/**
+ * Returns the set of workspace packages declared in the app's package.json.
+ *
+ * Workspace packages are identified by the `workspace:` protocol in their
+ * version specifier (e.g., `"workspace:*"`, `"workspace:^1.0.0"`). These
+ * packages are typically source-only and must be bundled rather than
+ * externalized.
+ */
 function getWorkspacePackages(rootDir) {
-  const cacheKey = path.resolve(rootDir);
-  const cached = appWorkspacePackageCache.get(cacheKey);
-  if (cached) {
-    return cached;
-  }
-  const packageJsonPath = path.resolve(rootDir, "package.json");
-  const workspacePackages = /* @__PURE__ */ new Set();
-  try {
-    const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
-    for (const field of ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"]) {
-      const entries = packageJson[field];
-      if (!entries || typeof entries !== "object") {
-        continue;
-      }
-      for (const [packageName, version] of Object.entries(entries)) {
-        if (typeof version === "string" && version.startsWith("workspace:")) {
-          workspacePackages.add(packageName);
+    const cacheKey = path.resolve(rootDir);
+    const cached = appWorkspacePackageCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    const packageJsonPath = path.resolve(rootDir, 'package.json');
+    const workspacePackages = new Set();
+    try {
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+        for (const field of ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies']) {
+            const entries = packageJson[field];
+            if (!entries || typeof entries !== 'object') {
+                continue;
+            }
+            for (const [packageName, version] of Object.entries(entries)) {
+                if (typeof version === 'string' && version.startsWith('workspace:')) {
+                    workspacePackages.add(packageName);
+                }
+            }
         }
-      }
     }
-  } catch {
+    catch {
+        appWorkspacePackageCache.set(cacheKey, workspacePackages);
+        return workspacePackages;
+    }
     appWorkspacePackageCache.set(cacheKey, workspacePackages);
     return workspacePackages;
-  }
-  appWorkspacePackageCache.set(cacheKey, workspacePackages);
-  return workspacePackages;
 }
-function isWorkspacePackageImport(specifier, rootDir) {
-  return getWorkspacePackages(rootDir).has(getPackageNameFromSpecifier(specifier));
+/**
+ * Returns true if the given specifier is a workspace package.
+ *
+ * Workspace packages are declared with the `workspace:` protocol and are
+ * typically source-only, requiring bundling rather than externalization.
+ */
+export function isWorkspacePackageImport(specifier, rootDir) {
+    return getWorkspacePackages(rootDir).has(getPackageNameFromSpecifier(specifier));
 }
-function isDeclaredAppPackageImport(specifier, rootDir) {
-  return getDeclaredAppPackages(rootDir).has(getPackageNameFromSpecifier(specifier));
+export function isDeclaredAppPackageImport(specifier, rootDir) {
+    return getDeclaredAppPackages(rootDir).has(getPackageNameFromSpecifier(specifier));
 }
+/**
+ * Whether the given bare specifier should be left as-is (not rewritten to a
+ * file URL) in bundled output.
+ *
+ * Two categories qualify:
+ * 1. **App-declared packages** — present in the app's own package.json; the
+ *    app's resolver will find them at runtime.
+ * 2. **Core runtime surface packages** — a curated subset of the framework's
+ *    own dependencies that are part of its public Node adapter surface (e.g.
+ *    `ws`). These ship alongside the framework and are resolvable from the
+ *    bundled output's location even when the app has not declared them.
+ *
+ * Build-time packages declared by core (e.g. `oxc-parser`, `rolldown`) are
+ * intentionally *not* included here — their imports must still be rewritten
+ * to absolute `file:` URLs so they are not left as bare specifiers in app
+ * output.
+ */
 function isDeclaredInResolutionChain(specifier, rootDir) {
-  const packageName = getPackageNameFromSpecifier(specifier);
-  if (CORE_RUNTIME_BARE_SPECIFIER_PACKAGES.has(packageName)) {
-    return true;
-  }
-  return isDeclaredAppPackageImport(specifier, rootDir);
+    const packageName = getPackageNameFromSpecifier(specifier);
+    if (CORE_RUNTIME_BARE_SPECIFIER_PACKAGES.has(packageName)) {
+        return true;
+    }
+    return isDeclaredAppPackageImport(specifier, rootDir);
 }
 function rewriteRuntimeImportSpecifier(specifier, quote, rootDir) {
-  if (!isBarePackageImportSpecifier(specifier, rootDir)) {
-    return void 0;
-  }
-  if (isDeclaredInResolutionChain(specifier, rootDir)) {
-    return void 0;
-  }
-  const resolvedPath = tryResolveRuntimeImport(specifier, corePackageRequire);
-  if (!resolvedPath || !/\.(?:[cm]?[jt]s|tsx|jsx)$/u.test(resolvedPath)) {
-    return void 0;
-  }
-  return `${quote}${pathToFileURL(resolvedPath).href}${quote}`;
+    if (!isBarePackageImportSpecifier(specifier, rootDir)) {
+        return undefined;
+    }
+    if (isDeclaredInResolutionChain(specifier, rootDir)) {
+        return undefined;
+    }
+    const resolvedPath = tryResolveRuntimeImport(specifier, corePackageRequire);
+    if (!resolvedPath || !/\.(?:[cm]?[jt]s|tsx|jsx)$/u.test(resolvedPath)) {
+        return undefined;
+    }
+    return `${quote}${pathToFileURL(resolvedPath).href}${quote}`;
 }
 function rewriteRuntimeBuildOutputImports(code, rootDir) {
-  const rewriteSpecifier = (prefix, quote, specifier) => {
-    const rewrittenSpecifier = rewriteRuntimeImportSpecifier(specifier, quote, rootDir);
-    return `${prefix}${rewrittenSpecifier ?? `${quote}${specifier}${quote}`}`;
-  };
-  const rewriteFileUrl = (prefix, quote, specifier) => {
-    const packageName = extractPackageNameFromFileUrl(specifier);
-    if (!packageName) {
-      return `${prefix}${quote}${specifier}${quote}`;
-    }
-    if (!isDeclaredInResolutionChain(packageName, rootDir)) {
-      return `${prefix}${quote}${specifier}${quote}`;
-    }
-    const lastNodeModulesIndex = specifier.lastIndexOf("/node_modules/");
-    if (lastNodeModulesIndex === -1) {
-      return `${prefix}${quote}${specifier}${quote}`;
-    }
-    const afterNodeModules = specifier.slice(lastNodeModulesIndex + "/node_modules/".length);
-    const afterPackage = afterNodeModules.slice(packageName.length);
-    const bareSpecifier = packageName + afterPackage;
-    return `${prefix}${quote}${bareSpecifier}${quote}`;
-  };
-  const withResolvedPackages = code.replace(
-    /(\bfrom\s+)(['"])([^'"\\]+)\2/g,
-    (_match, prefix, quote, specifier) => rewriteSpecifier(prefix, quote, specifier)
-  ).replace(
-    /(\bimport\s+)(['"])([^'"\\]+)\2/g,
-    (_match, prefix, quote, specifier) => rewriteSpecifier(prefix, quote, specifier)
-  ).replace(
-    /(\bimport\s*\(\s*)(['"])([^'"\\]+)\2/g,
-    (_match, prefix, quote, specifier) => rewriteSpecifier(prefix, quote, specifier)
-  );
-  const withBareSpecifiers = withResolvedPackages.replace(
-    /(\bfrom\s+)(['"])(file:\/\/[^'"\\]+)\2/g,
-    (_match, prefix, quote, specifier) => rewriteFileUrl(prefix, quote, specifier)
-  ).replace(
-    /(\bimport\s+)(['"])(file:\/\/[^'"\\]+)\2/g,
-    (_match, prefix, quote, specifier) => rewriteFileUrl(prefix, quote, specifier)
-  ).replace(
-    /(\bimport\s*\(\s*)(['"])(file:\/\/[^'"\\]+)\2/g,
-    (_match, prefix, quote, specifier) => rewriteFileUrl(prefix, quote, specifier)
-  );
-  return withBareSpecifiers.replace(
-    /(['"])(@oxc-project\/runtime\/(?:helpers(?:\/esm)?\/[^'"\\]+))\1/g,
-    (match, quote, specifier) => {
-      const resolvedPath = tryResolveRuntimeImport(specifier, corePackageRequire);
-      return resolvedPath ? `${quote}${pathToFileURL(resolvedPath).href}${quote}` : match;
-    }
-  );
+    const rewriteSpecifier = (prefix, quote, specifier) => {
+        const rewrittenSpecifier = rewriteRuntimeImportSpecifier(specifier, quote, rootDir);
+        return `${prefix}${rewrittenSpecifier ?? `${quote}${specifier}${quote}`}`;
+    };
+    /**
+     * Rewrites file:// URLs pointing to node_modules back to bare specifiers,
+     * but only when the package is resolvable from the app's resolution chain.
+     *
+     * @remarks
+     * Rolldown resolves external imports to file:// URLs during the build. For
+     * packages declared in the app's package.json, rewriting to bare specifiers
+     * is safe and preserves CJS named-export interop. For transitive
+     * dependencies that aren't directly resolvable, the file:// URL is kept as-is
+     * to avoid ERR_MODULE_NOT_FOUND errors at runtime.
+     */
+    const rewriteFileUrl = (prefix, quote, specifier) => {
+        const packageName = extractPackageNameFromFileUrl(specifier);
+        if (!packageName) {
+            return `${prefix}${quote}${specifier}${quote}`;
+        }
+        if (!isDeclaredInResolutionChain(packageName, rootDir)) {
+            return `${prefix}${quote}${specifier}${quote}`;
+        }
+        // Extract the subpath after the package name
+        // Use lastIndexOf to handle pnpm's nested node_modules structure
+        const lastNodeModulesIndex = specifier.lastIndexOf('/node_modules/');
+        if (lastNodeModulesIndex === -1) {
+            return `${prefix}${quote}${specifier}${quote}`;
+        }
+        const afterNodeModules = specifier.slice(lastNodeModulesIndex + '/node_modules/'.length);
+        const afterPackage = afterNodeModules.slice(packageName.length);
+        // Reconstruct the bare specifier
+        const bareSpecifier = packageName + afterPackage;
+        return `${prefix}${quote}${bareSpecifier}${quote}`;
+    };
+    const withResolvedPackages = code
+        .replace(/(\bfrom\s+)(['"])([^'"\\]+)\2/g, (_match, prefix, quote, specifier) => rewriteSpecifier(prefix, quote, specifier))
+        .replace(/(\bimport\s+)(['"])([^'"\\]+)\2/g, (_match, prefix, quote, specifier) => rewriteSpecifier(prefix, quote, specifier))
+        .replace(/(\bimport\s*\(\s*)(['"])([^'"\\]+)\2/g, (_match, prefix, quote, specifier) => rewriteSpecifier(prefix, quote, specifier));
+    // Rewrite file:// URLs pointing to node_modules back to bare specifiers
+    const withBareSpecifiers = withResolvedPackages
+        .replace(/(\bfrom\s+)(['"])(file:\/\/[^'"\\]+)\2/g, (_match, prefix, quote, specifier) => rewriteFileUrl(prefix, quote, specifier))
+        .replace(/(\bimport\s+)(['"])(file:\/\/[^'"\\]+)\2/g, (_match, prefix, quote, specifier) => rewriteFileUrl(prefix, quote, specifier))
+        .replace(/(\bimport\s*\(\s*)(['"])(file:\/\/[^'"\\]+)\2/g, (_match, prefix, quote, specifier) => rewriteFileUrl(prefix, quote, specifier));
+    return withBareSpecifiers.replace(/(['"])(@oxc-project\/runtime\/(?:helpers(?:\/esm)?\/[^'"\\]+))\1/g, (match, quote, specifier) => {
+        const resolvedPath = tryResolveRuntimeImport(specifier, corePackageRequire);
+        return resolvedPath ? `${quote}${pathToFileURL(resolvedPath).href}${quote}` : match;
+    });
 }
-function normalizeNodeRuntimeBuildOutputFile(filePath, rootDir) {
-  if (process.env.ECOPAGES_LOGGER_DEBUG === "true") {
-    console.log(`[normalizeNodeRuntimeBuildOutputFile] Checking ${filePath}`);
-  }
-  if (!/\.(?:[cm]?js)$/u.test(filePath)) {
-    return;
-  }
-  const fileSystem = corePackageRequire("node:fs");
-  if (!fileSystem.existsSync(filePath)) {
-    return;
-  }
-  const code = fileSystem.readFileSync(filePath, "utf-8");
-  const rewritten = rewriteRuntimeBuildOutputImports(code, rootDir);
-  if (rewritten !== code) {
-    if (process.env.ECOPAGES_LOGGER_DEBUG === "true") {
-      console.log(`[normalizeNodeRuntimeBuildOutputFile] Rewriting ${filePath}`);
-    }
-    fileSystem.writeFileSync(filePath, rewritten);
-  }
+export function normalizeNodeRuntimeBuildOutputFile(filePath, rootDir) {
+    if (process.env.ECOPAGES_LOGGER_DEBUG === 'true') {
+        console.log(`[normalizeNodeRuntimeBuildOutputFile] Checking ${filePath}`);
+    }
+    if (!/\.(?:[cm]?js)$/u.test(filePath)) {
+        return;
+    }
+    const fileSystem = corePackageRequire('node:fs');
+    if (!fileSystem.existsSync(filePath)) {
+        return;
+    }
+    const code = fileSystem.readFileSync(filePath, 'utf-8');
+    const rewritten = rewriteRuntimeBuildOutputImports(code, rootDir);
+    if (rewritten !== code) {
+        if (process.env.ECOPAGES_LOGGER_DEBUG === 'true') {
+            console.log(`[normalizeNodeRuntimeBuildOutputFile] Rewriting ${filePath}`);
+        }
+        fileSystem.writeFileSync(filePath, rewritten);
+    }
 }
-function normalizeNodeRuntimeBuildOutputs(outputPaths, rootDir) {
-  for (const outputPath of outputPaths) {
-    normalizeNodeRuntimeBuildOutputFile(outputPath, rootDir);
-  }
+export function normalizeNodeRuntimeBuildOutputs(outputPaths, rootDir) {
+    for (const outputPath of outputPaths) {
+        normalizeNodeRuntimeBuildOutputFile(outputPath, rootDir);
+    }
 }
-export {
-  isDeclaredAppPackageImport,
-  isWorkspacePackageImport,
-  normalizeNodeRuntimeBuildOutputFile,
-  normalizeNodeRuntimeBuildOutputs
-};

package/src/build/rolldown/server-side-css-shim-plugin.js

@@ -1,35 +1,58 @@
-import { existsSync, readFileSync } from "node:fs";
-import path from "node:path";
+/**
+ * Server-side CSS shim plugin for the bundler adapter.
+ *
+ * @remarks
+ * Page modules imported by the server (so the framework can read
+ * `getStaticProps` / `staticPaths` / page metadata) commonly have
+ * `import './style.css'` at the top. The bundler does not bundle
+ * CSS, and the server only needs the JS exports — the CSS itself
+ * is delivered to the browser via the page's `dependencies.stylesheets`
+ * declarations. This plugin:
+ *
+ * - Resolves `.css` imports to the absolute on-disk path.
+ * - Loads them and returns an empty ESM module with
+ *   `moduleSideEffects: true` so the bundler keeps the import in
+ *   the dependency graph without trying to bundle the bytes.
+ *
+ * The plugin is added by the adapter on every server-side build.
+ * Browser-side builds that want real CSS bundling should keep using
+ * a dedicated CSS pipeline (e.g. the postcss processor's output)
+ * and continue to declare stylesheets in `dependencies.stylesheets`
+ * — the shim is intentionally inert for those flows.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
 const CSS_PATH = /\.css$/u;
-const CSS_QUERY = "?ecopages-css-shim";
+const CSS_QUERY = '?ecopages-css-shim';
 function stripShimQuery(id) {
-  const queryIndex = id.indexOf("?");
-  return queryIndex === -1 ? id : id.slice(0, queryIndex);
+    const queryIndex = id.indexOf('?');
+    return queryIndex === -1 ? id : id.slice(0, queryIndex);
 }
-function createServerSideCssShimPlugin() {
-  return {
-    name: "ecopages:server-side-css-shim",
-    async resolveId(source, importer) {
-      if (!CSS_PATH.test(source)) {
-        return null;
-      }
-      const resolved = importer ? path.resolve(path.dirname(importer), source) : path.resolve(source);
-      return existsSync(resolved) ? `${resolved}${CSS_QUERY}` : null;
-    },
-    async load(id) {
-      if (!id.endsWith(CSS_QUERY)) {
-        return null;
-      }
-      const realPath = stripShimQuery(id);
-      readFileSync(realPath, "utf-8");
-      return {
-        code: 'export default "";',
-        moduleType: "js",
-        moduleSideEffects: true
-      };
-    }
-  };
+/**
+ * Builds a Rolldown plugin that turns `.css` imports into no-op ESM
+ * modules while preserving the dependency graph.
+ */
+export function createServerSideCssShimPlugin() {
+    return {
+        name: 'ecopages:server-side-css-shim',
+        async resolveId(source, importer) {
+            if (!CSS_PATH.test(source)) {
+                return null;
+            }
+            const resolved = importer ? path.resolve(path.dirname(importer), source) : path.resolve(source);
+            return existsSync(resolved) ? `${resolved}${CSS_QUERY}` : null;
+        },
+        async load(id) {
+            if (!id.endsWith(CSS_QUERY)) {
+                return null;
+            }
+            const realPath = stripShimQuery(id);
+            readFileSync(realPath, 'utf-8');
+            return {
+                code: 'export default "";',
+                moduleType: 'js',
+                moduleSideEffects: true,
+            };
+        },
+    };
 }
-export {
-  createServerSideCssShimPlugin
-};

package/src/build/runtime/build-profile-options.js

@@ -1,37 +1,37 @@
-function resolveBuildProfileOptions(profile, appConfig, overrides = {}) {
-  const root = appConfig.rootDir;
-  switch (profile) {
-    case "server-entry":
-      return {
-        root,
-        target: "node",
-        format: "esm",
-        sourcemap: "none",
-        minify: false,
-        externalPackages: true,
-        ...overrides
-      };
-    case "route-module":
-      return {
-        root,
-        target: "es2022",
-        format: "esm",
-        sourcemap: "none",
-        minify: false,
-        externalPackages: true,
-        ...overrides
-      };
-    case "browser-hmr":
-      return {
-        root,
-        target: "browser",
-        format: "esm",
-        sourcemap: "none",
-        minify: false,
-        ...overrides
-      };
-  }
+/**
+ * Resolves shared Rolldown options for a build profile.
+ */
+export function resolveBuildProfileOptions(profile, appConfig, overrides = {}) {
+    const root = appConfig.rootDir;
+    switch (profile) {
+        case 'server-entry':
+            return {
+                root,
+                target: 'node',
+                format: 'esm',
+                sourcemap: 'none',
+                minify: false,
+                externalPackages: true,
+                ...overrides,
+            };
+        case 'route-module':
+            return {
+                root,
+                target: 'es2022',
+                format: 'esm',
+                sourcemap: 'none',
+                minify: false,
+                externalPackages: true,
+                ...overrides,
+            };
+        case 'browser-hmr':
+            return {
+                root,
+                target: 'browser',
+                format: 'esm',
+                sourcemap: 'none',
+                minify: false,
+                ...overrides,
+            };
+    }
 }
-export {
-  resolveBuildProfileOptions
-};