@ecopages/core 0.2.0-alpha.39 → 0.2.0-alpha.40

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

@@ -106,7 +106,7 @@ class PageModuleImportService {
     const fileBaseName = path.basename(filePath, path.extname(filePath));
     const cacheScopeSuffix = cacheScope ? `-${sanitizeCacheScope(cacheScope)}` : "";
     const invalidationSuffix = shouldVersionBuildOutputPath(invalidationVersion) ? `-v${invalidationVersion}` : "";
-    const outputFileName = `${fileBaseName}-${fileHash}${cacheScopeSuffix}${invalidationSuffix}.js`;
+    const outputFileName = `${fileBaseName}-${fileHash}${cacheScopeSuffix}${invalidationSuffix}.mjs`;
     const outputNamingTemplate = `${fileBaseName}-${fileHash}${cacheScopeSuffix}${invalidationSuffix}.[ext]`;
     const buildResult = await this.dependencies.buildModule(
       {
@@ -131,7 +131,7 @@ class PageModuleImportService {
       throw new Error(transpileErrorMessage(details));
     }
     const preferredOutputPath = path.join(outdir, outputFileName);
-    const compiledOutput = buildResult.outputs.find((output) => output.path === preferredOutputPath)?.path ?? buildResult.outputs.find((output) => output.path.endsWith(".js"))?.path;
+    const compiledOutput = buildResult.outputs.find((output) => output.path === preferredOutputPath)?.path ?? buildResult.outputs.find((output) => /\.(?:[cm]?js)$/u.test(output.path))?.path;
     if (!compiledOutput) {
       throw new Error(noOutputMessage(filePath));
     }

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

@@ -7,7 +7,7 @@ import type { EcoPageComponent } from '../eco/eco.types.js';
 import type { EcoPagesAppConfig } from './internal-types.js';
 import type { HmrStrategy } from '../hmr/hmr-strategy.js';
 import type { BrowserBundleExecutor } from '../services/assets/browser-bundle.service.js';
-import type { ProcessedAsset } from '../services/assets/asset-processing-service/assets.types.js';
+import type { AssetDefinition, ProcessedAsset } from '../services/assets/asset-processing-service/assets.types.js';
 import type { CacheStats, CacheStrategy } from '../services/cache/cache.types.js';
 import type { InteractionEventsString as ScriptsInjectorInteractionEventsString } from '@ecopages/scripts-injector/types';
 export type { EcoPagesAppConfig } from './internal-types.js';
@@ -676,6 +676,10 @@ export interface PagePackageResult {
      * Full processed asset list before any page-level partitioning.
      */
     assets: ProcessedAsset[];
+    /**
+     * Optional structured Page Browser Graph carried through route preparation.
+     */
+    pageBrowserGraph?: PageBrowserGraphResult;
     /**
      * Assets that should still be injected into the final HTML document.
      */
@@ -704,16 +708,29 @@ export interface PagePackageResult {
 /**
  * Page-scoped browser output planned before final HTML packaging.
  *
- * The initial seam keeps the graph payload intentionally small: integrations
- * return the processed assets that belong to the Page browser graph, while the
- * surrounding route pipeline remains free to evolve toward richer entry/lazy/
- * shared chunk structure later.
+ * This shape keeps page-browser ownership explicit without forcing downstream
+ * HTML packaging to understand how integrations discovered the graph. Entry
+ * assets represent the initial page bootstrap outputs, while chunk assets stay
+ * separate so callers can preserve lazy/shared chunk identity until the point
+ * they intentionally flatten for page packaging.
  */
 export interface PageBrowserGraphResult {
     /**
-     * Processed assets owned by the current Page browser graph.
+     * Processed assets needed for the initial page browser bootstrap.
      */
-    assets: ProcessedAsset[];
+    entryAssets: ProcessedAsset[];
+    /**
+     * Processed browser chunks referenced after the initial page bootstrap.
+     */
+    chunkAssets: ProcessedAsset[];
+}
+export type PageBrowserGraphContributionContext = {
+    file: string;
+    pageModule: EcoPageFile;
+};
+export interface PageBrowserGraphContribution {
+    dependencies?: AssetDefinition[];
+    assets?: ProcessedAsset[];
 }
 export type OwnershipValidationErrorCode = 'UNKNOWN_INTEGRATION_OWNER' | 'MISSING_COMPONENT_METADATA';
 export interface OwnershipValidationError {

package/src/adapters/bun/server-lifecycle.d.ts

@@ -1,63 +0,0 @@
-import type { EcoPagesAppConfig } from '../../types/internal-types.js';
-import type { EcoBuildPlugin } from '../../build/build-types.js';
-import { StaticSiteGenerator } from '../../static-site-generator/static-site-generator.js';
-import type { ClientBridge } from './client-bridge.js';
-import type { HmrManager } from './hmr-manager.js';
-export interface WatcherCallbacks {
-    refreshRouterRoutesCallback: () => Promise<void>;
-}
-export interface ServerLifecycleParams {
-    appConfig: EcoPagesAppConfig;
-    runtimeOrigin: string;
-    hmrManager: HmrManager;
-    bridge: ClientBridge;
-}
-/**
- * Coordinates Bun-runtime server startup side effects for one app instance.
- *
- * @remarks
- * This class keeps runtime-only concerns together: build-runtime bootstrapping,
- * Bun loader registration, public asset preparation, plugin setup, and file
- * watching. Core config/build state is expected to already be finalized before
- * this lifecycle runs.
- */
-export declare class ServerLifecycle {
-    private readonly appConfig;
-    private readonly hmrManager;
-    private readonly bridge;
-    private readonly runtimeOrigin;
-    private staticSiteGenerator;
-    constructor({ appConfig, runtimeOrigin, hmrManager, bridge }: ServerLifecycleParams);
-    /**
-     * Initializes the runtime services that Bun startup depends on.
-     *
-     * @returns The static-site generator instance reused by the adapter.
-     */
-    initialize(): Promise<StaticSiteGenerator>;
-    /**
-     * Registers config-owned build loaders with Bun's runtime plugin API.
-     *
-     * @remarks
-     * Bun remains responsible only for transport-level plugin registration here.
-     * Loader ownership and composition were already finalized during config build.
-     */
-    setupLoaders(): void;
-    /**
-     * Runs runtime-only processor and integration setup for this Bun app session.
-     *
-     * @param options.watch Whether watch mode is enabled.
-     * @returns The browser build plugins visible to HMR after runtime setup.
-     */
-    initializePlugins(options?: {
-        watch?: boolean;
-    }): Promise<EcoBuildPlugin[]>;
-    /**
-     * Starts file watching and wires change events back into the adapter refresh
-     * callback.
-     */
-    startWatching(callbacks: WatcherCallbacks): Promise<void>;
-    /**
-     * Returns the static-site generator created during initialization.
-     */
-    getStaticSiteGenerator(): StaticSiteGenerator;
-}

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

@@ -1,92 +0,0 @@
-import { getBunRuntime } from "../../utils/runtime.js";
-import { appLogger } from "../../global/app-logger.js";
-import { StaticSiteGenerator } from "../../static-site-generator/static-site-generator.js";
-import {
-  bindSharedRuntimeHmrManager,
-  initializeSharedRuntimePlugins,
-  prepareSharedRuntimePublicDir,
-  startSharedProjectWatching
-} from "../shared/runtime-bootstrap.js";
-class ServerLifecycle {
-  appConfig;
-  hmrManager;
-  bridge;
-  runtimeOrigin;
-  staticSiteGenerator;
-  constructor({ appConfig, runtimeOrigin, hmrManager, bridge }) {
-    this.appConfig = appConfig;
-    this.runtimeOrigin = runtimeOrigin;
-    this.hmrManager = hmrManager;
-    this.bridge = bridge;
-  }
-  /**
-   * Initializes the runtime services that Bun startup depends on.
-   *
-   * @returns The static-site generator instance reused by the adapter.
-   */
-  async initialize() {
-    this.staticSiteGenerator = new StaticSiteGenerator({ appConfig: this.appConfig });
-    await this.hmrManager.buildRuntime();
-    this.setupLoaders();
-    prepareSharedRuntimePublicDir(this.appConfig);
-    return this.staticSiteGenerator;
-  }
-  /**
-   * Registers config-owned build loaders with Bun's runtime plugin API.
-   *
-   * @remarks
-   * Bun remains responsible only for transport-level plugin registration here.
-   * Loader ownership and composition were already finalized during config build.
-   */
-  setupLoaders() {
-    const loaders = this.appConfig.loaders;
-    for (const loader of loaders.values()) {
-      getBunRuntime()?.plugin(loader);
-    }
-  }
-  /**
-   * Runs runtime-only processor and integration setup for this Bun app session.
-   *
-   * @param options.watch Whether watch mode is enabled.
-   * @returns The browser build plugins visible to HMR after runtime setup.
-   */
-  async initializePlugins(options) {
-    try {
-      const hmrEnabled = !!options?.watch;
-      this.hmrManager.setEnabled(hmrEnabled);
-      await initializeSharedRuntimePlugins({
-        appConfig: this.appConfig,
-        runtimeOrigin: this.runtimeOrigin,
-        hmrManager: this.hmrManager,
-        onRuntimePlugin: (plugin) => {
-          getBunRuntime()?.plugin(plugin);
-        }
-      });
-      return bindSharedRuntimeHmrManager(this.appConfig, this.hmrManager);
-    } catch (error) {
-      appLogger.error(`Failed to initialize plugins: ${error instanceof Error ? error.message : String(error)}`);
-      throw error;
-    }
-  }
-  /**
-   * Starts file watching and wires change events back into the adapter refresh
-   * callback.
-   */
-  async startWatching(callbacks) {
-    await startSharedProjectWatching({
-      appConfig: this.appConfig,
-      refreshRouterRoutesCallback: callbacks.refreshRouterRoutesCallback,
-      hmrManager: this.hmrManager,
-      bridge: this.bridge
-    });
-  }
-  /**
-   * Returns the static-site generator created during initialization.
-   */
-  getStaticSiteGenerator() {
-    return this.staticSiteGenerator;
-  }
-}
-export {
-  ServerLifecycle
-};

package/src/adapters/shared/runtime-bootstrap.d.ts

@@ -1,38 +0,0 @@
-import { type BuildExecutor } from '../../build/build-adapter.js';
-import type { EcoBuildPlugin } from '../../build/build-types.js';
-import type { EcoPagesAppConfig, IClientBridge, IHmrManager } from '../../types/internal-types.js';
-/**
- * Installs and returns the app-owned runtime build executor used by adapter
- * startup and follow-up runtime work.
- */
-export declare function installSharedRuntimeBuildExecutor(appConfig: EcoPagesAppConfig, options: {
-    development: boolean;
-}): BuildExecutor;
-/**
- * Copies app public assets into dist and ensures the resolved assets directory
- * exists before request handling begins.
- */
-export declare function prepareSharedRuntimePublicDir(appConfig: EcoPagesAppConfig): void;
-/**
- * Runs runtime plugin setup against app-owned config/runtime state and optional
- * host plugin registration hooks.
- */
-export declare function initializeSharedRuntimePlugins(options: {
-    appConfig: EcoPagesAppConfig;
-    runtimeOrigin: string;
-    hmrManager?: IHmrManager;
-    onRuntimePlugin?: (plugin: unknown) => void;
-}): Promise<void>;
-/**
- * Starts shared project watching for runtime adapters.
- */
-export declare function startSharedProjectWatching(options: {
-    appConfig: EcoPagesAppConfig;
-    refreshRouterRoutesCallback: () => Promise<void>;
-    hmrManager: IHmrManager;
-    bridge: IClientBridge;
-}): Promise<void>;
-/**
- * Binds a runtime HMR manager to app-owned plugin and integration state.
- */
-export declare function bindSharedRuntimeHmrManager(appConfig: EcoPagesAppConfig, hmrManager: IHmrManager): EcoBuildPlugin[];

package/src/adapters/shared/runtime-bootstrap.js

@@ -1,43 +0,0 @@
-import path from "node:path";
-import { fileSystem } from "@ecopages/file-system";
-import { getAppBrowserBuildPlugins, setupAppRuntimePlugins } from "../../build/build-adapter.js";
-import { installAppRuntimeBuildExecutor } from "../../build/runtime-build-executor.js";
-import { RESOLVED_ASSETS_DIR } from "../../config/constants.js";
-import { ProjectWatcher } from "../../watchers/project-watcher.js";
-function installSharedRuntimeBuildExecutor(appConfig, options) {
-  return installAppRuntimeBuildExecutor(appConfig, options);
-}
-function prepareSharedRuntimePublicDir(appConfig) {
-  const srcPublicDir = path.join(appConfig.rootDir, appConfig.srcDir, appConfig.publicDir);
-  if (fileSystem.exists(srcPublicDir)) {
-    fileSystem.copyDir(srcPublicDir, path.join(appConfig.rootDir, appConfig.distDir));
-  }
-  fileSystem.ensureDir(path.join(appConfig.absolutePaths.distDir, RESOLVED_ASSETS_DIR));
-}
-async function initializeSharedRuntimePlugins(options) {
-  await setupAppRuntimePlugins(options);
-}
-async function startSharedProjectWatching(options) {
-  const watcher = new ProjectWatcher({
-    config: options.appConfig,
-    refreshRouterRoutesCallback: options.refreshRouterRoutesCallback,
-    hmrManager: options.hmrManager,
-    bridge: options.bridge
-  });
-  await watcher.createWatcherSubscription();
-}
-function bindSharedRuntimeHmrManager(appConfig, hmrManager) {
-  const browserBuildPlugins = getAppBrowserBuildPlugins(appConfig);
-  hmrManager.setPlugins(browserBuildPlugins);
-  for (const integration of appConfig.integrations) {
-    integration.setHmrManager(hmrManager);
-  }
-  return browserBuildPlugins;
-}
-export {
-  bindSharedRuntimeHmrManager,
-  initializeSharedRuntimePlugins,
-  installSharedRuntimeBuildExecutor,
-  prepareSharedRuntimePublicDir,
-  startSharedProjectWatching
-};