@ecopages/core 0.2.0-beta.25 → 0.2.0-beta.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/core",
-  "version": "0.2.0-beta.25",
+  "version": "0.2.0-beta.27",
   "description": "Core package for Ecopages",
   "keywords": [
     "ecopages",
@@ -17,7 +17,7 @@
     "directory": "packages/core"
   },
   "dependencies": {
-    "@ecopages/file-system": "0.2.0-beta.25",
+    "@ecopages/file-system": "0.2.0-beta.27",
     "@ecopages/logger": "^0.2.3",
     "@ecopages/scripts-injector": "^0.1.5",
     "@oxc-project/runtime": "0.134.0",
@@ -116,6 +116,10 @@
       "types": "./src/config/constants.d.ts",
       "default": "./src/config/constants.js"
     },
+    "./diagnostics/startup-trace": {
+      "types": "./src/diagnostics/startup-trace.d.ts",
+      "default": "./src/diagnostics/startup-trace.js"
+    },
     "./bun": {
       "types": "./src/adapters/bun/index.d.ts",
       "default": "./src/adapters/bun/index.js"
@@ -124,6 +128,10 @@
       "types": "./src/hmr/hmr-strategy.d.ts",
       "default": "./src/hmr/hmr-strategy.js"
     },
+    "./hmr/hmr-file-change-prep": {
+      "types": "./src/hmr/hmr-file-change-prep.d.ts",
+      "default": "./src/hmr/hmr-file-change-prep.js"
+    },
     "./hmr/client/hmr-runtime": {
       "types": "./src/hmr/client/hmr-runtime.d.ts",
       "default": "./src/hmr/client/hmr-runtime.js"
@@ -165,52 +173,48 @@
       "default": "./src/plugins/source-transform.js"
     },
     "./build/build-types": {
-      "types": "./src/build/build-types.d.ts",
-      "default": "./src/build/build-types.js"
+      "types": "./src/build/contracts/build-types.d.ts",
+      "default": "./src/build/contracts/build-types.js"
     },
     "./build/build-adapter": {
       "types": "./src/build/build-adapter.d.ts",
       "default": "./src/build/build-adapter.js"
     },
-    "./build/runtime-build-executor": {
-      "types": "./src/build/runtime-build-executor.d.ts",
-      "default": "./src/build/runtime-build-executor.js"
-    },
     "./build/build-runtime": {
-      "types": "./src/build/build-runtime.d.ts",
-      "default": "./src/build/build-runtime.js"
+      "types": "./src/build/runtime/build-runtime.d.ts",
+      "default": "./src/build/runtime/build-runtime.js"
     },
     "./build/build-contracts": {
-      "types": "./src/build/build-contracts.d.ts",
-      "default": "./src/build/build-contracts.js"
+      "types": "./src/build/contracts/build-contracts.d.ts",
+      "default": "./src/build/contracts/build-contracts.js"
     },
     "./build/production-build-cache": {
-      "types": "./src/build/production-build-cache.d.ts",
-      "default": "./src/build/production-build-cache.js"
+      "types": "./src/build/cache/production-build-cache.d.ts",
+      "default": "./src/build/cache/production-build-cache.js"
     },
     "./build/server-entry-build-cache": {
-      "types": "./src/build/server-entry-build-cache.d.ts",
-      "default": "./src/build/server-entry-build-cache.js"
+      "types": "./src/build/cache/server-entry-build-cache.d.ts",
+      "default": "./src/build/cache/server-entry-build-cache.js"
     },
     "./build/runtime-build-output-normalizer": {
-      "types": "./src/build/runtime-build-output-normalizer.d.ts",
-      "default": "./src/build/runtime-build-output-normalizer.js"
+      "types": "./src/build/rolldown/runtime-build-output-normalizer.d.ts",
+      "default": "./src/build/rolldown/runtime-build-output-normalizer.js"
     },
     "./build/browser-runtime-manifest": {
-      "types": "./src/build/browser-runtime-manifest.d.ts",
-      "default": "./src/build/browser-runtime-manifest.js"
+      "types": "./src/build/browser/browser-runtime-manifest.d.ts",
+      "default": "./src/build/browser/browser-runtime-manifest.js"
     },
     "./build/browser-runtime-plugin": {
-      "types": "./src/build/browser-runtime-plugin.d.ts",
-      "default": "./src/build/browser-runtime-plugin.js"
+      "types": "./src/build/browser/browser-runtime-plugin.d.ts",
+      "default": "./src/build/browser/browser-runtime-plugin.js"
     },
     "./build/jsx-ownership-plugins": {
-      "types": "./src/build/jsx-ownership-plugins.d.ts",
-      "default": "./src/build/jsx-ownership-plugins.js"
+      "types": "./src/build/browser/jsx-ownership-plugins.d.ts",
+      "default": "./src/build/browser/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"
+      "types": "./src/build/browser/lit-static-render-worker-context.d.ts",
+      "default": "./src/build/browser/lit-static-render-worker-context.js"
     },
     "./cache": {
       "types": "./src/cache/index.d.ts",
@@ -337,6 +341,10 @@
       "types": "./src/config/constants.d.ts",
       "default": "./src/config/constants.js"
     },
+    "./diagnostics/startup-trace.ts": {
+      "types": "./src/diagnostics/startup-trace.d.ts",
+      "default": "./src/diagnostics/startup-trace.js"
+    },
     "./bun.ts": {
       "types": "./src/adapters/bun/index.d.ts",
       "default": "./src/adapters/bun/index.js"
@@ -345,6 +353,10 @@
       "types": "./src/hmr/hmr-strategy.d.ts",
       "default": "./src/hmr/hmr-strategy.js"
     },
+    "./hmr/hmr-file-change-prep.ts": {
+      "types": "./src/hmr/hmr-file-change-prep.d.ts",
+      "default": "./src/hmr/hmr-file-change-prep.js"
+    },
     "./hmr/client/hmr-runtime.ts": {
       "types": "./src/hmr/client/hmr-runtime.d.ts",
       "default": "./src/hmr/client/hmr-runtime.js"
@@ -386,52 +398,48 @@
       "default": "./src/plugins/source-transform.js"
     },
     "./build/build-types.ts": {
-      "types": "./src/build/build-types.d.ts",
-      "default": "./src/build/build-types.js"
+      "types": "./src/build/contracts/build-types.d.ts",
+      "default": "./src/build/contracts/build-types.js"
     },
     "./build/build-adapter.ts": {
       "types": "./src/build/build-adapter.d.ts",
       "default": "./src/build/build-adapter.js"
     },
-    "./build/runtime-build-executor.ts": {
-      "types": "./src/build/runtime-build-executor.d.ts",
-      "default": "./src/build/runtime-build-executor.js"
-    },
     "./build/build-runtime.ts": {
-      "types": "./src/build/build-runtime.d.ts",
-      "default": "./src/build/build-runtime.js"
+      "types": "./src/build/runtime/build-runtime.d.ts",
+      "default": "./src/build/runtime/build-runtime.js"
     },
     "./build/build-contracts.ts": {
-      "types": "./src/build/build-contracts.d.ts",
-      "default": "./src/build/build-contracts.js"
+      "types": "./src/build/contracts/build-contracts.d.ts",
+      "default": "./src/build/contracts/build-contracts.js"
     },
     "./build/production-build-cache.ts": {
-      "types": "./src/build/production-build-cache.d.ts",
-      "default": "./src/build/production-build-cache.js"
+      "types": "./src/build/cache/production-build-cache.d.ts",
+      "default": "./src/build/cache/production-build-cache.js"
     },
     "./build/server-entry-build-cache.ts": {
-      "types": "./src/build/server-entry-build-cache.d.ts",
-      "default": "./src/build/server-entry-build-cache.js"
+      "types": "./src/build/cache/server-entry-build-cache.d.ts",
+      "default": "./src/build/cache/server-entry-build-cache.js"
     },
     "./build/runtime-build-output-normalizer.ts": {
-      "types": "./src/build/runtime-build-output-normalizer.d.ts",
-      "default": "./src/build/runtime-build-output-normalizer.js"
+      "types": "./src/build/rolldown/runtime-build-output-normalizer.d.ts",
+      "default": "./src/build/rolldown/runtime-build-output-normalizer.js"
     },
     "./build/browser-runtime-manifest.ts": {
-      "types": "./src/build/browser-runtime-manifest.d.ts",
-      "default": "./src/build/browser-runtime-manifest.js"
+      "types": "./src/build/browser/browser-runtime-manifest.d.ts",
+      "default": "./src/build/browser/browser-runtime-manifest.js"
     },
     "./build/browser-runtime-plugin.ts": {
-      "types": "./src/build/browser-runtime-plugin.d.ts",
-      "default": "./src/build/browser-runtime-plugin.js"
+      "types": "./src/build/browser/browser-runtime-plugin.d.ts",
+      "default": "./src/build/browser/browser-runtime-plugin.js"
     },
     "./build/jsx-ownership-plugins.ts": {
-      "types": "./src/build/jsx-ownership-plugins.d.ts",
-      "default": "./src/build/jsx-ownership-plugins.js"
+      "types": "./src/build/browser/jsx-ownership-plugins.d.ts",
+      "default": "./src/build/browser/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"
+      "types": "./src/build/browser/lit-static-render-worker-context.d.ts",
+      "default": "./src/build/browser/lit-static-render-worker-context.js"
     },
     "./cache.ts": {
       "types": "./src/cache/index.d.ts",

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

@@ -6,7 +6,7 @@ import { createRequire } from "../../utils/locals-utils.js";
 import { findWebSocketRoute } from "../abstract/ws-pattern-matcher.js";
 import { fileSystem } from "@ecopages/file-system";
 import { setupAppRuntimePlugins } from "../../build/build-adapter.js";
-import { installAppRuntimeBuildExecutor } from "../../build/runtime-build-executor.js";
+import { installBuildRuntime } from "../../build/runtime/build-runtime.js";
 import { StaticSiteGenerator } from "../../static-site-generator/static-site-generator.js";
 import { ProjectWatcher } from "../../watchers/project-watcher.js";
 import { SharedServerAdapter } from "../shared/server-adapter.js";
@@ -156,7 +156,7 @@ class BunServerAdapter extends SharedServerAdapter {
    * Initializes the server adapter's core runtime components.
    */
   async initialize() {
-    installAppRuntimeBuildExecutor(this.appConfig);
+    installBuildRuntime(this.appConfig);
     this.staticSiteGenerator = new StaticSiteGenerator({ appConfig: this.appConfig });
     prepareRuntimePublicDir(this.appConfig);
     const staticBuilderOptions = {

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

@@ -2,7 +2,7 @@ import {} from "node:http";
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
 import { setupAppRuntimePlugins } from "../../build/build-adapter.js";
-import { installAppRuntimeBuildExecutor } from "../../build/runtime-build-executor.js";
+import { installBuildRuntime } from "../../build/runtime/build-runtime.js";
 import { appLogger } from "../../global/app-logger.js";
 import { NodeClientBridge } from "./node-client-bridge.js";
 import { NodeHmrManager } from "./node-hmr-manager.js";
@@ -114,7 +114,7 @@ class NodeServerAdapter extends SharedServerAdapter {
    *    processors during their `setup()` calls.
    */
   async initialize() {
-    installAppRuntimeBuildExecutor(this.appConfig);
+    installBuildRuntime(this.appConfig);
     prepareRuntimePublicDir(this.appConfig);
     if (!this.deferRuntimeAssetSetup) {
       await setupAppRuntimePlugins({

package/src/adapters/shared/hmr-entrypoint-registrar.d.ts

@@ -35,6 +35,16 @@ export declare class HmrEntrypointRegistrar {
     getRegistered(): ReadonlyMap<string, ResolvedHmrEntrypoint>;
     getWatchedFiles(): Map<string, string>;
     clearRegistration(entrypointPath: string): void;
+    /**
+     * Registers an already-materialized HMR entrypoint without running the emit hook.
+     *
+     * @remarks
+     * Cold dev batches build entrypoints in grouped Rolldown passes and then seed
+     * the registrar so the first SSR can resolve the artifact without rebuilding.
+     * The source path is committed verbatim so `getResolvedScriptOutput()` and the
+     * file watcher see it as a regular watched entrypoint.
+     */
+    seedResolvedEntrypoint(resolved: ResolvedHmrEntrypoint): void;
     clearAll(): void;
     /**
      * Registers a single source entrypoint and returns its verified HMR artifact.

package/src/adapters/shared/hmr-entrypoint-registrar.js

@@ -24,6 +24,22 @@ class HmrEntrypointRegistrar {
   clearRegistration(entrypointPath) {
     this.registered.delete(path.resolve(entrypointPath));
   }
+  /**
+   * Registers an already-materialized HMR entrypoint without running the emit hook.
+   *
+   * @remarks
+   * Cold dev batches build entrypoints in grouped Rolldown passes and then seed
+   * the registrar so the first SSR can resolve the artifact without rebuilding.
+   * The source path is committed verbatim so `getResolvedScriptOutput()` and the
+   * file watcher see it as a regular watched entrypoint.
+   */
+  seedResolvedEntrypoint(resolved) {
+    this.registered.set(path.resolve(resolved.sourcePath), {
+      sourcePath: resolved.sourcePath,
+      outputPath: resolved.outputPath,
+      outputUrl: resolved.outputUrl
+    });
+  }
   clearAll() {
     this.inFlight.clear();
     this.registered.clear();
@@ -58,23 +74,31 @@ class HmrEntrypointRegistrar {
     }
   }
   async registerEntrypointInternal(entrypointPath, registrationOptions) {
+    const previous = this.registered.get(entrypointPath);
     const { outputPath, outputUrl } = resolveHmrEntrypointOutputPaths(
       this.options.srcDir,
       this.options.distDir,
       entrypointPath
     );
     removeStaleHmrEntrypointOutput(outputPath, "HMR");
-    await registrationOptions.emit(entrypointPath, outputPath);
-    if (!fileSystem.exists(outputPath)) {
-      throw registrationOptions.getMissingOutputError(entrypointPath, outputPath);
+    try {
+      await registrationOptions.emit(entrypointPath, outputPath);
+      if (!fileSystem.exists(outputPath)) {
+        throw registrationOptions.getMissingOutputError(entrypointPath, outputPath);
+      }
+      const resolved = {
+        sourcePath: entrypointPath,
+        outputPath,
+        outputUrl
+      };
+      this.registered.set(entrypointPath, resolved);
+      return resolved;
+    } catch (error) {
+      if (previous && fileSystem.exists(previous.outputPath)) {
+        this.registered.set(entrypointPath, previous);
+      }
+      throw error;
     }
-    const resolved = {
-      sourcePath: entrypointPath,
-      outputPath,
-      outputUrl
-    };
-    this.registered.set(entrypointPath, resolved);
-    return resolved;
   }
 }
 export {

package/src/adapters/shared/runtime-server-lifecycle.js

@@ -1,7 +1,7 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
 import { RESOLVED_ASSETS_DIR } from "../../config/constants.js";
-import { disposeAppBuildRuntime } from "../../build/build-runtime.js";
+import { disposeAppBuildRuntime } from "../../build/runtime/build-runtime.js";
 import { copyRuntimePublicDirIfChanged } from "./copy-runtime-public-dir.js";
 import { clearAppDevClientBridge } from "../../dev/client-bridge-registry.js";
 import { clearAppHmrManager } from "../../dev/hmr-manager-registry.js";

package/src/adapters/shared/server-static-builder.d.ts

@@ -1,5 +1,5 @@
 import type { EcoPagesAppConfig, IHmrManager } from '../../types/internal-types.js';
-import type { EcoBuildPlugin } from '../../build/build-types.js';
+import type { EcoBuildPlugin } from '../../build/contracts/build-types.js';
 import type { StaticRoute } from '../../types/public-types.js';
 import type { RouteRegistry } from '../../router/server/route-registry.js';
 import type { StaticSiteGenerator } from '../../static-site-generator/static-site-generator.js';
@@ -34,6 +34,7 @@ export interface ServerStaticBuilderParams {
 export interface ServerStaticBuilderLogger {
     warn(message: string, detail?: string): unknown;
     info(message: string): unknown;
+    debug(message: string): unknown;
     error(message: string): unknown;
 }
 /**

package/src/adapters/shared/server-static-builder.js

@@ -3,15 +3,15 @@ import { fileSystem } from "@ecopages/file-system";
 import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from "../../config/constants.js";
 import { appLogger } from "../../global/app-logger.js";
 import { build, getAppBuildAdapter, setupAppRuntimePlugins } from "../../build/build-adapter.js";
+import { createServerBuildRequest } from "../../build/runtime/build-request-policy.js";
+import { requireBuildRuntime } from "../../build/runtime/build-runtime.js";
 import { attachHmrToIntegrations } from "./runtime-server-lifecycle.js";
-import { resolveBuildProfileOptions } from "../../build/build-profile-options.js";
 import {
   getServerBundleOutputPaths,
   lookupServerEntryBuildCache,
   recordServerEntryBuildCache,
   writeServerBundleDeployManifest
-} from "../../build/server-entry-build-cache.js";
-import { getInstalledServerEntryBuildExecutor } from "../../build/runtime-build-executor.js";
+} from "../../build/cache/server-entry-build-cache.js";
 import {
   clearProductionBuildCaches,
   shouldResetStaticExportDirectory
@@ -134,16 +134,14 @@ class ServerStaticBuilder {
       }
     }
     this.logger.info("Bundling server entry file...");
-    const buildOptions = {
-      ...resolveBuildProfileOptions("server-entry", this.appConfig, {
-        entrypoints: [entryPath],
-        outdir: serverOutdir,
-        naming: SERVER_BUNDLE_FILENAME,
-        sourcemap: "hidden"
-      }),
-      entrypoints: [entryPath]
-    };
-    const result = await build(buildOptions, getInstalledServerEntryBuildExecutor(this.appConfig));
+    const buildOptions = createServerBuildRequest(this.appConfig, {
+      profile: "server-entry",
+      entrypoints: [entryPath],
+      outdir: serverOutdir,
+      naming: SERVER_BUNDLE_FILENAME,
+      sourcemap: "hidden"
+    });
+    const result = await build(buildOptions, requireBuildRuntime(this.appConfig).getProfile("server-entry"));
     if (!result.success) {
       const errorMessages = result.logs.map((log) => log.message).join("\n");
       throw new Error(`Failed to bundle server entry file:
@@ -181,7 +179,11 @@ ${errorMessages}`);
       force,
       preserveExportDirectory
     });
-    this.logger.info("Build completed");
+    if (process.env.ECOPAGES_BENCH === "1" && process.env.ECOPAGES_BENCH_VERBOSE !== "1") {
+      this.logger.debug("Build completed");
+    } else {
+      this.logger.info("Build completed");
+    }
   }
 }
 export {

package/src/adapters/shared/shared-hmr-manager.d.ts

@@ -3,14 +3,12 @@ import { type ResolvedHmrEntrypoint } from '../../hmr/hmr-entrypoint-output.js';
 import type { DefaultHmrContext, EcoPagesAppConfig, IHmrManager, IClientBridge } from '../../types/internal-types.js';
 import { type HmrStrategy } from '../../hmr/hmr-strategy.js';
 import { DevelopmentInvalidationService } from '../../services/invalidation/development-invalidation.service.js';
-import type { ClientBridgeEvent } from '../../types/public-types.js';
+import type { ClientBridgeEvent, HmrFileChangeOptions } from '../../types/public-types.js';
 import { HmrEntrypointRegistrar } from './hmr-entrypoint-registrar.js';
 import { BrowserBundleService } from '../../services/assets/browser-bundle.service.js';
 import { type EntrypointDependencyGraph } from '../../services/runtime-state/entrypoint-dependency-graph.service.js';
 import type { ServerModuleTranspiler } from '../../services/module-loading/server-module-transpiler.service.js';
-type HandleFileChangeOptions = {
-    broadcast?: boolean;
-};
+type HandleFileChangeOptions = HmrFileChangeOptions;
 type SharedHmrManagerParams = {
     appConfig: EcoPagesAppConfig;
     bridge: IClientBridge;
@@ -71,6 +69,15 @@ export declare abstract class SharedHmrManager implements IHmrManager {
      */
     private prepareRegisteredScriptChange;
     getOutputUrl(entrypointPath: string): string | undefined;
+    /**
+     * Registers an already-materialized HMR entrypoint without rebuilding it.
+     *
+     * @remarks
+     * Cold dev batches build grouped Rolldown passes up front and then seed the
+     * registrar so the first SSR resolves the artifact from disk. The entrypoint
+     * is also added to the watched files so subsequent source edits still rebuild.
+     */
+    seedResolvedEntrypoint(resolved: ResolvedHmrEntrypoint): void;
     /**
      * Returns the emitted HMR script output when the entrypoint is already registered
      * and its browser bundle exists on disk.

package/src/adapters/shared/shared-hmr-manager.js

@@ -7,7 +7,7 @@ import {
   isRegisteredScriptEntrypoint,
   isBrowserOnlyRegisteredScriptEntrypoint
 } from "../../hmr/hmr-entrypoint-output.js";
-import { requireBuildRuntime } from "../../build/build-runtime.js";
+import { requireBuildRuntime } from "../../build/runtime/build-runtime.js";
 import { fileSystem } from "@ecopages/file-system";
 import { HmrStrategyType } from "../../hmr/hmr-strategy.js";
 import { DefaultHmrStrategy } from "../../hmr/strategies/default-hmr-strategy.js";
@@ -181,6 +181,7 @@ class SharedHmrManager {
     if (isRegisteredScriptEntrypoint(this.entrypointRegistrar.getRegistered(), resolvedFilePath)) {
       await this.prepareRegisteredScriptChange(resolvedFilePath);
     }
+    const shouldBroadcast = options.broadcast ?? true;
     const strategy = this.selectChangeStrategy(filePath);
     if (!strategy) {
       appLogger.warn(`[HMR] No strategy found for ${filePath}`);
@@ -188,10 +189,16 @@ class SharedHmrManager {
     }
     appLogger.debug(`[${this.constructor.name}] Selected strategy: ${strategy.constructor.name}`);
     const action = await strategy.process(filePath);
-    const shouldBroadcast = options.broadcast ?? true;
     if (shouldBroadcast && action.type === "broadcast" && action.events) {
+      if (this.bridge.subscriberCount === 0) {
+        appLogger.debug(
+          `[${this.constructor.name}] Deferring HMR client broadcast for ${filePath} until a subscriber connects`
+        );
+        return;
+      }
       for (const event of action.events) {
-        this.broadcast(event);
+        const graphIdentities = event.graphIdentities ?? options.graphIdentities;
+        this.broadcast(graphIdentities === void 0 ? event : { ...event, graphIdentities });
       }
     }
   }
@@ -282,6 +289,17 @@ class SharedHmrManager {
   getOutputUrl(entrypointPath) {
     return this.entrypointRegistrar.getRegistered().get(path.resolve(entrypointPath))?.outputUrl;
   }
+  /**
+   * Registers an already-materialized HMR entrypoint without rebuilding it.
+   *
+   * @remarks
+   * Cold dev batches build grouped Rolldown passes up front and then seed the
+   * registrar so the first SSR resolves the artifact from disk. The entrypoint
+   * is also added to the watched files so subsequent source edits still rebuild.
+   */
+  seedResolvedEntrypoint(resolved) {
+    this.entrypointRegistrar.seedResolvedEntrypoint(resolved);
+  }
   /**
    * Returns the emitted HMR script output when the entrypoint is already registered
    * and its browser bundle exists on disk.
@@ -314,6 +332,7 @@ class SharedHmrManager {
       getBuildExecutor: () => requireBuildRuntime(this.appConfig).getProfile("browser-hmr"),
       getBrowserBundleService: () => this.browserBundleService,
       getEntrypointDependencyGraph: () => this.entrypointDependencyGraph,
+      seedResolvedEntrypoint: (resolved) => this.seedResolvedEntrypoint(resolved),
       importServerModule: async (filePath) => await this.serverModuleTranspiler.importModule({
         filePath,
         outdir: path.join(resolveInternalExecutionDir(this.appConfig), ".server-modules"),