@ecopages/core 0.2.0-alpha.53 → 0.2.0-alpha.55

package/src/plugins/alias-resolver-plugin.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
+import { AliasResolverCache } from "./alias-resolver-cache.js";
 const RESOLVABLE_EXTENSIONS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".mdx", ".css", ".scss", ".sass", ".less"];
 function findResolvablePath(candidate) {
   if (path.extname(candidate)) {
@@ -41,16 +42,19 @@ function resolveAppSourceAliasPath(srcDir, specifier) {
   const resolved = findResolvablePath(candidate);
   return resolved ? resolveAliasedBarrelTarget(resolved) : void 0;
 }
-function createAliasResolverPlugin(srcDir) {
+function createAliasResolverPlugin(srcDir, options) {
+  const cache = options?.cache ?? new AliasResolverCache();
   return {
     name: "ecopages-alias-resolver",
     setup(build) {
       build.onResolve({ filter: /^@\// }, (args) => {
-        const resolved = resolveAppSourceAliasPath(srcDir, args.path);
-        if (resolved) {
-          return { path: resolved };
+        const cached = cache.get(srcDir, args.path);
+        if (cached.hit) {
+          return cached.resolved ? { path: cached.resolved } : {};
         }
-        return {};
+        const resolved = resolveAppSourceAliasPath(srcDir, args.path);
+        cache.set(srcDir, args.path, resolved);
+        return resolved ? { path: resolved } : {};
       });
     }
   };

package/src/plugins/eco-component-meta-plugin.js

@@ -1,4 +1,4 @@
-import { parseSync } from "oxc-parser";
+import { cachedParseSync } from "../cache/module-parse-cache.js";
 import { rapidhash } from "../utils/hash.js";
 import {
   createEcoBuildPluginFromSourceTransform,
@@ -145,7 +145,7 @@ function findInjectionPoints(node, insertions, injection, isInsideEcoComponent =
   }
 }
 function injectEcoMeta(contents, filePath, integration) {
-  const result = parseSync(filePath, contents);
+  const result = cachedParseSync(filePath, contents);
   if (result.errors.length > 0) {
     console.warn(`[eco-component-meta-plugin] Parse errors in ${filePath}:`, result.errors);
     return contents;

package/src/plugins/foreign-jsx-override-plugin.d.ts

@@ -20,7 +20,7 @@ export interface ForeignJsxOverrideOptions {
  * another JSX integration (e.g. `.kita.tsx`), that file inherits the project
  * `tsconfig` JSX runtime which produces the wrong output (HTML strings instead
  * of framework elements). This plugin rewrites the source to explicitly target
- * the host's JSX factory so esbuild compiles every JSX expression into the
+ * the host's JSX factory so the bundler compiles every JSX expression into the
  * correct element creation calls.
  *
  * The plugin is intentionally framework-agnostic: any integration that does

package/src/route-renderer/orchestration/render-output.utils.d.ts

@@ -48,7 +48,7 @@ export declare function addTriggerAttribute<T extends MarkupNodeLikeShape>(conte
 export declare function addTriggerAttribute(content: unknown, triggerId: string): string | TemplateContentShape | MarkupNodeLikeShape;
 /**
  * Wraps rendered component output in a `<scripts-injector>` element that
- * carries an inline injector map for the legacy (non-global-injector) path.
+ * carries an inline injector map for the component's lazy script groups.
  *
  * @param content Rendered component HTML.
  * @param lazyGroups Resolved lazy script groups attached to the component config.

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

@@ -2,7 +2,7 @@ import type { BuildResult, BuildTranspileProfile } from '../../build/build-adapt
 import type { EcoBuildPlugin } from '../../build/build-types.js';
 import type { EcoPagesAppConfig } from '../../types/internal-types.js';
 export type BrowserBundleOptions = {
-    entrypoints: string[];
+    entrypoints: string[] | Record<string, string>;
     outdir?: string;
     outbase?: string;
     naming?: string;

package/src/services/module-loading/app-module-loader.service.d.ts

@@ -1,5 +1,5 @@
 import type { PageModuleBuildImportOptions } from './page-module-import.service.js';
-export type AppModuleLoaderOwner = 'bun' | 'host';
+export type AppModuleLoaderOwner = 'app' | 'host';
 export interface AppModuleLoader {
     readonly owner: AppModuleLoaderOwner;
     importModule<T = unknown>(options: PageModuleBuildImportOptions): Promise<T>;

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

@@ -1,9 +1,8 @@
-import { getAppBuildExecutor } from "../../build/build-adapter.js";
-import path from "node:path";
+import { getAppBuildExecutor, getAppServerBuildPlugins } from "../../build/build-adapter.js";
 import { createForeignJsxOverridePlugin } from "../../plugins/foreign-jsx-override-plugin.js";
+import path from "node:path";
 import { DevelopmentInvalidationService } from "../invalidation/development-invalidation.service.js";
 import {} from "./app-module-loader.service.js";
-import { createAppNodeBootstrapPlugin } from "./node-bootstrap-plugin.js";
 import { PageModuleImportService } from "./page-module-import.service.js";
 import { supportsSourceModuleLoading } from "./source-module-support.js";
 import { ServerModuleTranspiler } from "./server-module-transpiler.service.js";
@@ -30,7 +29,7 @@ function getAppHostModuleLoader(appConfig) {
   return appConfig.runtime?.hostModuleLoader;
 }
 function getAppModuleLoaderOwner(appConfig) {
-  return getAppHostModuleLoader(appConfig) ? "host" : "bun";
+  return getAppHostModuleLoader(appConfig) ? "host" : "app";
 }
 function setAppHostModuleLoader(appConfig, hostModuleLoader) {
   appConfig.runtime = {
@@ -38,12 +37,7 @@ function setAppHostModuleLoader(appConfig, hostModuleLoader) {
     hostModuleLoader
   };
 }
-function getOwningIntegration(appConfig, filePath) {
-  return appConfig.integrations?.flatMap(
-    (integration) => integration.extensions.filter((extension) => filePath.endsWith(extension)).map((extension) => ({ integration, extension }))
-  ).sort((left, right) => right.extension.length - left.extension.length)[0]?.integration;
-}
-function getBunOwnedJsxPlugins(appConfig) {
+function getJsxOwnershipPlugins(appConfig) {
   const jsxExtensions = (appConfig.integrations ?? []).filter((integration) => integration.jsxImportSource).flatMap(
     (integration) => integration.extensions.filter((extension) => extension.endsWith(".tsx") || extension.endsWith(".jsx")).map((extension) => ({ integration, extension }))
   ).sort((left, right) => right.extension.length - left.extension.length);
@@ -52,7 +46,7 @@ function getBunOwnedJsxPlugins(appConfig) {
       hostJsxImportSource: integration.jsxImportSource,
       foreignExtensions: [extension],
       excludeExtensions: jsxExtensions.filter((candidate) => candidate.extension.length > extension.length).filter((candidate) => candidate.extension.endsWith(extension)).map((candidate) => candidate.extension),
-      name: `ecopages-bun-jsx-ownership-${integration.name}-${extension.replace(/[^a-zA-Z0-9]+/g, "-")}`
+      name: `ecopages-jsx-ownership-${integration.name}-${extension.replace(/[^a-zA-Z0-9]+/g, "-")}`
     })
   );
 }
@@ -62,9 +56,8 @@ function createAppModuleLoader(appConfig) {
     canLoadSourceModuleFromHost: (filePath) => shouldAppUseHostModuleLoader(appConfig, filePath),
     getHostModuleLoader: () => getAppHostModuleLoader(appConfig)
   });
-  const getDefaultPlugins = typeof Bun === "undefined" && appConfig.rootDir ? () => [createAppNodeBootstrapPlugin(appConfig)] : () => [];
-  const appLoaderPlugins = Array.from(appConfig.loaders?.values() ?? []);
-  const bunOwnedJsxPlugins = typeof Bun !== "undefined" ? getBunOwnedJsxPlugins(appConfig) : [];
+  const appServerBuildPlugins = appConfig.runtime?.buildManifest ? getAppServerBuildPlugins(appConfig) : Array.from(appConfig.loaders?.values() ?? []);
+  const jsxOwnershipPlugins = getJsxOwnershipPlugins(appConfig);
   const appModuleLoader = {
     get owner() {
       return getAppModuleLoaderOwner(appConfig);
@@ -72,24 +65,10 @@ function createAppModuleLoader(appConfig) {
     pageModuleImportService,
     async importModule(options) {
       const invalidationVersion = options.invalidationVersion ?? invalidationService.getServerModuleInvalidationVersion();
-      const owningIntegration = getOwningIntegration(appConfig, options.filePath);
-      const owningJsxImportSource = owningIntegration?.jsxImportSource;
-      const mergedPlugins = [
-        ...getDefaultPlugins(),
-        ...appLoaderPlugins,
-        ...bunOwnedJsxPlugins,
-        ...options.plugins ?? []
-      ];
+      const mergedPlugins = [...appServerBuildPlugins, ...jsxOwnershipPlugins, ...options.plugins ?? []];
       return await pageModuleImportService.importModule({
         ...options,
         ...mergedPlugins.length > 0 ? { plugins: mergedPlugins } : {},
-        ...typeof Bun !== "undefined" && owningJsxImportSource ? {
-          jsx: {
-            development: process.env.NODE_ENV === "development",
-            importSource: owningJsxImportSource,
-            runtime: "automatic"
-          }
-        } : {},
         buildExecutor: options.buildExecutor ?? getAppBuildExecutor(appConfig),
         invalidationVersion
       });

package/src/services/module-loading/page-module-import.service.js

@@ -2,6 +2,7 @@ import path from "node:path";
 import { pathToFileURL } from "node:url";
 import { fileSystem } from "@ecopages/file-system";
 import { build } from "../../build/build-adapter.js";
+import { normalizeNodeRuntimeBuildOutputFile } from "../../build/runtime-build-output-normalizer.js";
 import { supportsSourceModuleLoading } from "./source-module-support.js";
 class PageModuleImportService {
   dependencies;
@@ -135,6 +136,7 @@ class PageModuleImportService {
     if (!compiledOutput) {
       throw new Error(noOutputMessage(filePath));
     }
+    normalizeNodeRuntimeBuildOutputFile(compiledOutput, rootDir);
     const compiledOutputUrl = pathToFileURL(compiledOutput);
     if (shouldAddRuntimeUpdateQuery(invalidationVersion, cacheScope)) {
       compiledOutputUrl.searchParams.set(

package/src/types/internal-types.d.ts

@@ -129,7 +129,7 @@ export type EcoPagesAppConfig = {
     loaders: Map<string, EcoBuildPlugin>;
     /**
      * App-owned source transforms that can be adapted into Vite or other
-     * transform-first bundlers without going through the legacy loader bridge.
+     * transform-first bundlers.
      */
     sourceTransforms: Map<string, EcoSourceTransform>;
     /**

package/src/build/browser-runtime-import-rewrite-plugin.d.ts

@@ -1,26 +0,0 @@
-import type { EcoBuildPlugin } from './build-types.js';
-import { type BrowserRuntimeManifest } from './browser-runtime-manifest.js';
-export declare const DEFAULT_BROWSER_RUNTIME_IMPORT_REWRITE_PLUGIN_NAME = "browser-runtime-import-rewrite";
-export type CreateBrowserRuntimeImportRewritePluginOptions = {
-    /** Stable build plugin name used for deduplication and selective exclusion. */
-    name?: string;
-    /** Manifest containing specifier-to-public-URL runtime asset mappings. */
-    manifest: BrowserRuntimeManifest;
-};
-/**
- * Rewrites static ESM import/export specifiers and string-literal dynamic imports
- * from manifest-owned runtime specifiers to concrete browser public URLs.
- */
-export declare function rewriteBrowserRuntimeImports(code: string, specifierMap: ReadonlyMap<string, string>, filePath?: string): string;
-export declare function getBrowserRuntimeImportRewriteMap(plugin: EcoBuildPlugin): ReadonlyMap<string, string> | undefined;
-export declare function collectBrowserRuntimeImportRewriteMap(plugins: EcoBuildPlugin[] | undefined): ReadonlyMap<string, string>;
-/**
- * Creates a build plugin that applies browser runtime manifest import rewrites
- * before the bundler resolves source modules.
- *
- * @remarks
- * This is the migration path away from browser import-map-style runtime aliases:
- * generated and authored browser modules can keep importing manifest-owned
- * specifiers, while the build turns those specifiers into concrete public URLs.
- */
-export declare function createBrowserRuntimeImportRewritePlugin(options: CreateBrowserRuntimeImportRewritePluginOptions): EcoBuildPlugin | null;

package/src/build/dev-build-coordinator.d.ts

@@ -1,72 +0,0 @@
-import { type BuildAdapter, type BuildExecutor, type BuildOptions, type BuildResult } from './build-adapter.js';
-import { EsbuildBuildAdapter } from './esbuild-build-adapter.js';
-import type { EcoBuildPlugin } from './build-types.js';
-export declare function withBuildExecutorPlugins(executor: BuildExecutor, getPlugins: () => EcoBuildPlugin[]): BuildExecutor;
-/**
- * Serialized build coordinator for the shared esbuild adapter.
- *
- * The underlying adapter remains responsible for plain build execution. This
- * coordinator owns the policy that must be shared across callers while Bun-native
- * execution still uses the shared esbuild compatibility backend:
- *
- * - serialized access to the shared esbuild service
- * - recovery from known esbuild worker protocol faults
- *
- * Unlike the previous design, the coordinator does not monkey-patch the adapter
- * or install process-level fault handlers. The owning app/runtime passes this
- * executor explicitly to build consumers that need coordinated builds.
- */
-export declare class DevBuildCoordinator implements BuildExecutor {
-    private buildQueue;
-    private esbuildSessionWarm;
-    private esbuildModuleGeneration;
-    private readonly adapter;
-    constructor(adapter: EsbuildBuildAdapter);
-    /**
-     * Executes a build through the serialized development queue.
-     *
-     * If an esbuild protocol fault is detected, the coordinator resets the queue,
-     * stops the corrupted service, increments the module generation, and retries
-     * the build once.
-     */
-    build(options: BuildOptions): Promise<BuildResult>;
-    /**
-     * Attempts recovery from a known esbuild worker protocol fault.
-     *
-     * Returns `true` only when the error matches the protocol-fault signature and
-     * the coordinator successfully reset its shared state.
-     */
-    recoverFromProtocolFault(error: unknown): Promise<boolean>;
-    /**
-     * Clears internal coordinator state for isolated tests.
-     */
-    resetForTests(): void;
-    /**
-     * Overrides the internal queue promise for fault-recovery tests.
-     */
-    setBuildQueueForTests(queue: Promise<void>): void;
-    /**
-     * Returns the current internal queue promise for fault-recovery tests.
-     */
-    getBuildQueueForTests(): Promise<void>;
-    private runSerialized;
-}
-/**
- * Creates the appropriate build executor for one app/runtime instance.
- *
- * Bun-native esbuild execution always uses the compatibility coordinator so
- * preview/static generation and development flows share the same serialized
- * access and protocol-fault recovery policy. Host-owned execution stays on the
- * plain adapter boundary.
- */
-export declare function createAppBuildExecutor(options: {
-    development: boolean;
-    adapter?: BuildAdapter;
-    getPlugins?: () => EcoBuildPlugin[];
-}): BuildExecutor;
-export declare function createOrReuseAppBuildExecutor(options: {
-    development: boolean;
-    adapter?: BuildAdapter;
-    currentExecutor?: BuildExecutor;
-    getPlugins?: () => EcoBuildPlugin[];
-}): BuildExecutor;

package/src/build/dev-build-coordinator.js

@@ -1,154 +0,0 @@
-import { appLogger } from "../global/app-logger.js";
-import {
-  defaultBunBuildAdapter
-} from "./build-adapter.js";
-import { EsbuildBuildAdapter, ESBUILD_ADAPTER_BRAND } from "./esbuild-build-adapter.js";
-import { mergeEcoBuildPlugins } from "./build-manifest.js";
-function isEsbuildBuildAdapter(adapter) {
-  return adapter instanceof EsbuildBuildAdapter || typeof adapter === "object" && adapter !== null && adapter[ESBUILD_ADAPTER_BRAND] === true;
-}
-function mergeBuildPlugins(options, appPlugins) {
-  if (appPlugins.length === 0) {
-    return options;
-  }
-  return {
-    ...options,
-    plugins: mergeEcoBuildPlugins(options.plugins, appPlugins)
-  };
-}
-class BuildExecutorWithPlugins {
-  executor;
-  getPlugins;
-  constructor(executor, getPlugins) {
-    this.executor = executor;
-    this.getPlugins = getPlugins;
-  }
-  async build(options) {
-    return await this.executor.build(mergeBuildPlugins(options, this.getPlugins()));
-  }
-  unwrap() {
-    return this.executor;
-  }
-}
-function unwrapBuildExecutor(executor) {
-  if (executor instanceof BuildExecutorWithPlugins) {
-    return unwrapBuildExecutor(executor.unwrap());
-  }
-  return executor;
-}
-function withBuildExecutorPlugins(executor, getPlugins) {
-  return new BuildExecutorWithPlugins(executor, getPlugins);
-}
-class DevBuildCoordinator {
-  buildQueue = Promise.resolve();
-  esbuildSessionWarm = false;
-  esbuildModuleGeneration = 0;
-  adapter;
-  constructor(adapter) {
-    this.adapter = adapter;
-  }
-  /**
-   * Executes a build through the serialized development queue.
-   *
-   * If an esbuild protocol fault is detected, the coordinator resets the queue,
-   * stops the corrupted service, increments the module generation, and retries
-   * the build once.
-   */
-  async build(options) {
-    return this.runSerialized(async () => {
-      try {
-        const result = await this.adapter.buildOrThrow(options, this.esbuildModuleGeneration);
-        this.esbuildSessionWarm = true;
-        return result;
-      } catch (error) {
-        if (await this.recoverFromProtocolFault(error)) {
-          appLogger.warn("Recovered from esbuild protocol fault. Retrying build.");
-          try {
-            const retry = await this.adapter.buildOrThrow(options, this.esbuildModuleGeneration);
-            this.esbuildSessionWarm = true;
-            return retry;
-          } catch (retryError) {
-            return this.adapter.createFailureResult(retryError);
-          }
-        }
-        return this.adapter.createFailureResult(error);
-      }
-    });
-  }
-  /**
-   * Attempts recovery from a known esbuild worker protocol fault.
-   *
-   * Returns `true` only when the error matches the protocol-fault signature and
-   * the coordinator successfully reset its shared state.
-   */
-  async recoverFromProtocolFault(error) {
-    if (!this.adapter.isEsbuildProtocolError(error)) {
-      return false;
-    }
-    this.buildQueue = Promise.resolve();
-    this.esbuildSessionWarm = false;
-    await this.adapter.stopEsbuildService(this.esbuildModuleGeneration);
-    this.esbuildModuleGeneration += 1;
-    return true;
-  }
-  /**
-   * Clears internal coordinator state for isolated tests.
-   */
-  resetForTests() {
-    this.buildQueue = Promise.resolve();
-    this.esbuildSessionWarm = false;
-    this.esbuildModuleGeneration = 0;
-  }
-  /**
-   * Overrides the internal queue promise for fault-recovery tests.
-   */
-  setBuildQueueForTests(queue) {
-    this.buildQueue = queue;
-  }
-  /**
-   * Returns the current internal queue promise for fault-recovery tests.
-   */
-  getBuildQueueForTests() {
-    return this.buildQueue;
-  }
-  async runSerialized(operation) {
-    let releaseBuild;
-    const currentBuild = new Promise((resolve) => {
-      releaseBuild = resolve;
-    });
-    const previousBuild = this.buildQueue;
-    this.buildQueue = previousBuild.catch(() => void 0).then(async () => await currentBuild);
-    await previousBuild.catch(() => void 0);
-    try {
-      return await operation();
-    } finally {
-      releaseBuild?.();
-    }
-  }
-}
-function createAppBuildExecutor(options) {
-  const adapter = options.adapter ?? defaultBunBuildAdapter;
-  const baseExecutor = isEsbuildBuildAdapter(adapter) ? new DevBuildCoordinator(adapter) : adapter;
-  if (!options.getPlugins) {
-    return baseExecutor;
-  }
-  return new BuildExecutorWithPlugins(baseExecutor, options.getPlugins);
-}
-function createOrReuseAppBuildExecutor(options) {
-  const adapter = options.adapter ?? defaultBunBuildAdapter;
-  const currentBaseExecutor = options.currentExecutor ? unwrapBuildExecutor(options.currentExecutor) : void 0;
-  const baseExecutor = options.development && currentBaseExecutor instanceof DevBuildCoordinator ? currentBaseExecutor : createAppBuildExecutor({
-    development: options.development,
-    adapter
-  });
-  if (!options.getPlugins) {
-    return baseExecutor;
-  }
-  return withBuildExecutorPlugins(baseExecutor, options.getPlugins);
-}
-export {
-  DevBuildCoordinator,
-  createAppBuildExecutor,
-  createOrReuseAppBuildExecutor,
-  withBuildExecutorPlugins
-};

package/src/build/esbuild-build-adapter.d.ts

@@ -1,79 +0,0 @@
-import type { BuildAdapter, BuildOptions, BuildResult, BuildTranspileOptions, BuildTranspileProfile } from './build-adapter.js';
-/**
- * Node build adapter backed by esbuild.
- *
- * This adapter keeps Ecopages build plugin compatibility (`onResolve`, `onLoad`,
- * and `module`) while delegating bundling and TypeScript/decorator transforms to esbuild.
- */
-export declare const ESBUILD_ADAPTER_BRAND: unique symbol;
-export declare class EsbuildBuildAdapter implements BuildAdapter {
-    readonly ownership: "bun-native";
-    readonly [ESBUILD_ADAPTER_BRAND] = true;
-    private getJavaScriptOutExtension;
-    private collectWorkspaceNodePaths;
-    private getFallbackNodePaths;
-    private rewriteBrowserRuntimeImportsInOutputs;
-    private escapeRegExp;
-    private getPluginsForBuild;
-    private normalizeEsbuildLoader;
-    private inferEsbuildLoaderFromPath;
-    private convertLoadResultToModuleSource;
-    private convertPluginOnLoadResult;
-    private resolvePluginPath;
-    /**
-     * Creates an esbuild plugin bridge compatible with the existing Ecopages
-     * plugin API shape.
-     *
-     * **Plugin ordering is semantically significant.**
-     *
-     * Esbuild applies `onResolve` and `onLoad` hooks in the order they are
-     * registered: the first handler whose filter matches wins for `onResolve`,
-     * and the first handler that returns a non-`undefined` result wins for
-     * `onLoad`. Because we call `plugin.setup(bridge)` sequentially here, the
-     * position of each plugin in the `plugins` array determines its priority:
-     *
-     * - **Index 0** has the highest priority (its hooks run first).
-     * - **Last index** has the lowest priority (its hooks only run if no earlier
-     *   plugin claimed the path).
-     *
-     * When adding new integrations or processors, ensure security-critical plugins
-     * (e.g. `ecopages-client-graph-boundary`) are placed **before** general-purpose
-     * loaders in the array so they always get first refusal on every source file.
-     *
-     * There is currently no priority system or validation — correct ordering is
-     * the caller's responsibility.
-     */
-    private createEcoPluginBridge;
-    private loadEsbuildModule;
-    private isMockedEsbuildModule;
-    /**
-     * Detects the subset of runtime faults that indicate esbuild's worker
-     * protocol is corrupted rather than a normal build error.
-     */
-    isEsbuildProtocolError(error: unknown): boolean;
-    stopEsbuildService(moduleGeneration?: number): Promise<void>;
-    buildOrThrow(options: BuildOptions, moduleGeneration?: number): Promise<BuildResult>;
-    private mapEsbuildSourcemap;
-    private mapEsbuildFormat;
-    private hasTemplateTokens;
-    private toEntryNamePattern;
-    private normalizeMetafilePath;
-    private extractDependencyGraph;
-    /**
-     * Normalizes esbuild errors into Ecopages `BuildLog` entries.
-     */
-    private toBuildLogs;
-    createFailureResult(error: unknown): BuildResult;
-    /**
-     * Bundles entrypoints using esbuild for Node runtime builds.
-     */
-    build(options: BuildOptions): Promise<BuildResult>;
-    /**
-     * Resolves module specifiers from a project root.
-     */
-    resolve(importPath: string, rootDir: string): string;
-    /**
-     * Returns transpile defaults for a known transpile profile.
-     */
-    getTranspileOptions(profile: BuildTranspileProfile): BuildTranspileOptions;
-}