@ecopages/core 0.2.0-alpha.2 → 0.2.0-alpha.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/core",
-  "version": "0.2.0-alpha.2",
+  "version": "0.2.0-alpha.21",
   "description": "Core package for Ecopages",
   "keywords": [
     "ecopages",
@@ -17,14 +17,14 @@
     "directory": "packages/core"
   },
   "dependencies": {
-    "@ecopages/file-system": "0.2.0-alpha.2",
-    "@ecopages/logger": "latest",
+    "@ecopages/file-system": "0.2.0-alpha.21",
+    "@ecopages/logger": "^0.2.3",
     "@ecopages/scripts-injector": "^0.1.3",
     "@worker-tools/html-rewriter": "0.1.0-pre.19",
-    "chokidar": "^4.0.3",
-    "esbuild": "^0.27.3",
+    "chokidar": "^5.0.0",
+    "esbuild": "^0.28.0",
     "ghtml": "^4.0.2",
-    "oxc-parser": "^0.110.0",
+    "oxc-parser": "^0.124.0",
     "ws": "^8.18.0"
   },
   "exports": {
@@ -35,21 +35,39 @@
       "default": "./src/index.js"
     },
     "./create-app": {
-      "types": "./src/create-app.d.ts",
-      "default": "./src/create-app.js"
+      "import": "./src/adapters/create-app.js",
+      "types": "./src/adapters/create-app.d.ts",
+      "default": "./src/adapters/create-app.js"
     },
     "./route-renderer/integration-renderer": {
-      "types": "./src/route-renderer/integration-renderer.d.ts",
-      "default": "./src/route-renderer/integration-renderer.js"
+      "types": "./src/route-renderer/orchestration/integration-renderer.d.ts",
+      "default": "./src/route-renderer/orchestration/integration-renderer.js"
+    },
+    "./router/navigation-coordinator": {
+      "types": "./src/router/client/navigation-coordinator.d.ts",
+      "default": "./src/router/client/navigation-coordinator.js"
+    },
+    "./router/link-intent": {
+      "types": "./src/router/client/link-intent.d.ts",
+      "default": "./src/router/client/link-intent.js"
+    },
+    "./router/client/navigation-coordinator": {
+      "types": "./src/router/client/navigation-coordinator.d.ts",
+      "default": "./src/router/client/navigation-coordinator.js"
     },
     "./errors/locals-access-error": {
       "types": "./src/errors/locals-access-error.d.ts",
       "default": "./src/errors/locals-access-error.js"
     },
     "./eco": {
+      "browser": "./src/eco/eco.browser.js",
       "types": "./src/eco/eco.d.ts",
       "default": "./src/eco/eco.js"
     },
+    "./route-renderer/template-serialization": {
+      "types": "./src/route-renderer/orchestration/template-serialization.d.ts",
+      "default": "./src/route-renderer/orchestration/template-serialization.js"
+    },
     "./declarations": {
       "types": "./src/declarations.d.ts"
     },
@@ -61,8 +79,8 @@
       "default": "./src/config/config-builder.js"
     },
     "./constants": {
-      "types": "./src/constants.d.ts",
-      "default": "./src/constants.js"
+      "types": "./src/config/constants.d.ts",
+      "default": "./src/config/constants.js"
     },
     "./bun": {
       "types": "./src/adapters/bun/index.d.ts",
@@ -72,20 +90,28 @@
       "types": "./src/adapters/bun/create-app.d.ts",
       "default": "./src/adapters/bun/create-app.js"
     },
-    "./bun/define-api-handler": {
-      "types": "./src/adapters/bun/define-api-handler.d.ts",
-      "default": "./src/adapters/bun/define-api-handler.js"
-    },
     "./hmr/hmr-strategy": {
       "types": "./src/hmr/hmr-strategy.d.ts",
       "default": "./src/hmr/hmr-strategy.js"
     },
     "./internal-types": {
-      "types": "./src/internal-types.d.ts"
+      "types": "./src/types/internal-types.d.ts"
     },
     "./services/asset-processing-service": {
-      "types": "./src/services/asset-processing-service/index.d.ts",
-      "default": "./src/services/asset-processing-service/index.js"
+      "types": "./src/services/assets/asset-processing-service/index.d.ts",
+      "default": "./src/services/assets/asset-processing-service/index.js"
+    },
+    "./services/invalidation/development-invalidation.service": {
+      "types": "./src/services/invalidation/development-invalidation.service.d.ts",
+      "default": "./src/services/invalidation/development-invalidation.service.js"
+    },
+    "./services/module-loading/app-server-module-transpiler.service": {
+      "types": "./src/services/module-loading/app-server-module-transpiler.service.d.ts",
+      "default": "./src/services/module-loading/app-server-module-transpiler.service.js"
+    },
+    "./host-module-loader": {
+      "types": "./src/services/module-loading/host-module-loader-registry.d.ts",
+      "default": "./src/services/module-loading/host-module-loader-registry.js"
     },
     "./utils/deep-merge": {
       "types": "./src/utils/deep-merge.d.ts",
@@ -107,6 +133,10 @@
       "types": "./src/plugins/integration-plugin.d.ts",
       "default": "./src/plugins/integration-plugin.js"
     },
+    "./plugins/source-transform": {
+      "types": "./src/plugins/source-transform.d.ts",
+      "default": "./src/plugins/source-transform.js"
+    },
     "./build/build-types": {
       "types": "./src/build/build-types.d.ts",
       "default": "./src/build/build-types.js"
@@ -115,32 +145,27 @@
       "types": "./src/build/build-adapter.d.ts",
       "default": "./src/build/build-adapter.js"
     },
-    "./adapters/bun/client-bridge": {
-      "types": "./src/adapters/bun/client-bridge.d.ts",
-      "default": "./src/adapters/bun/client-bridge.js"
+    "./build/runtime-specifier-alias-plugin": {
+      "types": "./src/build/runtime-specifier-alias-plugin.d.ts",
+      "default": "./src/build/runtime-specifier-alias-plugin.js"
     },
-    "./node": {
-      "types": "./src/adapters/node/index.d.ts",
-      "default": "./src/adapters/node/index.js"
+    "./build/runtime-specifier-aliases": {
+      "types": "./src/build/runtime-specifier-aliases.d.ts",
+      "default": "./src/build/runtime-specifier-aliases.js"
     },
-    "./node/server-adapter": {
-      "types": "./src/adapters/node/server-adapter.d.ts",
-      "default": "./src/adapters/node/server-adapter.js"
+    "./plugins/foreign-jsx-override-plugin": {
+      "types": "./src/plugins/foreign-jsx-override-plugin.d.ts",
+      "default": "./src/plugins/foreign-jsx-override-plugin.js"
     },
-    "./node/create-app": {
-      "types": "./src/adapters/node/create-app.d.ts",
-      "default": "./src/adapters/node/create-app.js"
+    "./adapters/bun/client-bridge": {
+      "types": "./src/adapters/bun/client-bridge.d.ts",
+      "default": "./src/adapters/bun/client-bridge.js"
     },
     "./html": {
       "import": "./src/utils/html.js",
       "default": "./src/utils/html.js",
       "types": "./src/utils/html.d.ts"
     },
-    "./css": {
-      "import": "./src/utils/css.js",
-      "default": "./src/utils/css.js",
-      "types": "./src/utils/css.d.ts"
-    },
     "./hash": {
       "import": "./src/utils/hash.js",
       "default": "./src/utils/hash.js",
@@ -155,21 +180,39 @@
       "default": "./src/integrations/ghtml/ghtml.plugin.js"
     },
     "./create-app.ts": {
-      "types": "./src/create-app.d.ts",
-      "default": "./src/create-app.js"
+      "import": "./src/adapters/create-app.js",
+      "types": "./src/adapters/create-app.d.ts",
+      "default": "./src/adapters/create-app.js"
     },
     "./route-renderer/integration-renderer.ts": {
-      "types": "./src/route-renderer/integration-renderer.d.ts",
-      "default": "./src/route-renderer/integration-renderer.js"
+      "types": "./src/route-renderer/orchestration/integration-renderer.d.ts",
+      "default": "./src/route-renderer/orchestration/integration-renderer.js"
+    },
+    "./router/navigation-coordinator.ts": {
+      "types": "./src/router/client/navigation-coordinator.d.ts",
+      "default": "./src/router/client/navigation-coordinator.js"
+    },
+    "./router/link-intent.ts": {
+      "types": "./src/router/client/link-intent.d.ts",
+      "default": "./src/router/client/link-intent.js"
+    },
+    "./router/client/navigation-coordinator.ts": {
+      "types": "./src/router/client/navigation-coordinator.d.ts",
+      "default": "./src/router/client/navigation-coordinator.js"
     },
     "./errors/locals-access-error.ts": {
       "types": "./src/errors/locals-access-error.d.ts",
       "default": "./src/errors/locals-access-error.js"
     },
     "./eco.ts": {
+      "browser": "./src/eco/eco.browser.js",
       "types": "./src/eco/eco.d.ts",
       "default": "./src/eco/eco.js"
     },
+    "./route-renderer/template-serialization.ts": {
+      "types": "./src/route-renderer/orchestration/template-serialization.d.ts",
+      "default": "./src/route-renderer/orchestration/template-serialization.js"
+    },
     "./declarations.ts": {
       "types": "./src/declarations.d.ts"
     },
@@ -181,8 +224,8 @@
       "default": "./src/config/config-builder.js"
     },
     "./constants.ts": {
-      "types": "./src/constants.d.ts",
-      "default": "./src/constants.js"
+      "types": "./src/config/constants.d.ts",
+      "default": "./src/config/constants.js"
     },
     "./bun.ts": {
       "types": "./src/adapters/bun/index.d.ts",
@@ -192,20 +235,28 @@
       "types": "./src/adapters/bun/create-app.d.ts",
       "default": "./src/adapters/bun/create-app.js"
     },
-    "./bun/define-api-handler.ts": {
-      "types": "./src/adapters/bun/define-api-handler.d.ts",
-      "default": "./src/adapters/bun/define-api-handler.js"
-    },
     "./hmr/hmr-strategy.ts": {
       "types": "./src/hmr/hmr-strategy.d.ts",
       "default": "./src/hmr/hmr-strategy.js"
     },
     "./internal-types.ts": {
-      "types": "./src/internal-types.d.ts"
+      "types": "./src/types/internal-types.d.ts"
     },
     "./services/asset-processing-service.ts": {
-      "types": "./src/services/asset-processing-service/index.d.ts",
-      "default": "./src/services/asset-processing-service/index.js"
+      "types": "./src/services/assets/asset-processing-service/index.d.ts",
+      "default": "./src/services/assets/asset-processing-service/index.js"
+    },
+    "./services/invalidation/development-invalidation.service.ts": {
+      "types": "./src/services/invalidation/development-invalidation.service.d.ts",
+      "default": "./src/services/invalidation/development-invalidation.service.js"
+    },
+    "./services/module-loading/app-server-module-transpiler.service.ts": {
+      "types": "./src/services/module-loading/app-server-module-transpiler.service.d.ts",
+      "default": "./src/services/module-loading/app-server-module-transpiler.service.js"
+    },
+    "./host-module-loader.ts": {
+      "types": "./src/services/module-loading/host-module-loader-registry.d.ts",
+      "default": "./src/services/module-loading/host-module-loader-registry.js"
     },
     "./utils/deep-merge.ts": {
       "types": "./src/utils/deep-merge.d.ts",
@@ -227,6 +278,10 @@
       "types": "./src/plugins/integration-plugin.d.ts",
       "default": "./src/plugins/integration-plugin.js"
     },
+    "./plugins/source-transform.ts": {
+      "types": "./src/plugins/source-transform.d.ts",
+      "default": "./src/plugins/source-transform.js"
+    },
     "./build/build-types.ts": {
       "types": "./src/build/build-types.d.ts",
       "default": "./src/build/build-types.js"
@@ -235,32 +290,27 @@
       "types": "./src/build/build-adapter.d.ts",
       "default": "./src/build/build-adapter.js"
     },
-    "./adapters/bun/client-bridge.ts": {
-      "types": "./src/adapters/bun/client-bridge.d.ts",
-      "default": "./src/adapters/bun/client-bridge.js"
+    "./build/runtime-specifier-alias-plugin.ts": {
+      "types": "./src/build/runtime-specifier-alias-plugin.d.ts",
+      "default": "./src/build/runtime-specifier-alias-plugin.js"
     },
-    "./node.ts": {
-      "types": "./src/adapters/node/index.d.ts",
-      "default": "./src/adapters/node/index.js"
+    "./build/runtime-specifier-aliases.ts": {
+      "types": "./src/build/runtime-specifier-aliases.d.ts",
+      "default": "./src/build/runtime-specifier-aliases.js"
     },
-    "./node/server-adapter.ts": {
-      "types": "./src/adapters/node/server-adapter.d.ts",
-      "default": "./src/adapters/node/server-adapter.js"
+    "./plugins/foreign-jsx-override-plugin.ts": {
+      "types": "./src/plugins/foreign-jsx-override-plugin.d.ts",
+      "default": "./src/plugins/foreign-jsx-override-plugin.js"
     },
-    "./node/create-app.ts": {
-      "types": "./src/adapters/node/create-app.d.ts",
-      "default": "./src/adapters/node/create-app.js"
+    "./adapters/bun/client-bridge.ts": {
+      "types": "./src/adapters/bun/client-bridge.d.ts",
+      "default": "./src/adapters/bun/client-bridge.js"
     },
     "./html.ts": {
       "import": "./src/utils/html.js",
       "default": "./src/utils/html.js",
       "types": "./src/utils/html.d.ts"
     },
-    "./css.ts": {
-      "import": "./src/utils/css.js",
-      "default": "./src/utils/css.js",
-      "types": "./src/utils/css.d.ts"
-    },
     "./hash.ts": {
       "import": "./src/utils/hash.js",
       "default": "./src/utils/hash.js",

package/src/adapters/README.md

@@ -0,0 +1,39 @@
+# Runtime Adapters
+
+This directory contains the runtime-host integration layer for Ecopages.
+
+## Purpose
+
+Adapters translate app-owned core services into concrete runtime behavior at the host boundary. Bun remains the direct core runtime, while Node compatibility is driven by the Ecopages CLI thin-host path and reuses internal adapter pieces here.
+
+They are responsible for:
+
+- starting and stopping runtime-specific servers or thin hosts
+- delegating startup into framework-owned loaders and services
+- bridging runtime-specific request/response or HMR transport details
+- keeping host/runtime transport details out of generic core orchestration
+
+They are not responsible for:
+
+- deciding plugin lifecycle ordering
+- owning server-module semantics
+- owning browser bundling policy
+- owning route rendering semantics
+
+## Main Areas
+
+- `bun/`: Bun server adapter, lifecycle coordination, bridge, and HMR transport
+- `node/`: internal Node compatibility adapter pieces used by the CLI thin-host path
+- `shared/`: runtime-neutral adapter helpers used by both hosts
+
+## Ownership Boundary
+
+The adapter layer is transport-oriented.
+
+Core services still own:
+
+- config finalization
+- build-manifest assembly
+- server loading
+- invalidation classification
+- route rendering orchestration

package/src/adapters/abstract/application-adapter.d.ts

@@ -6,15 +6,40 @@
  *
  * @module ApplicationAdapter
  */
-import type { EcoPagesAppConfig } from '../../internal-types.js';
-import type { ApiHandler, ApiHandlerContext, ErrorHandler, Middleware, RouteOptions, StaticRoute, ViewLoader } from '../../public-types.js';
+import type { SourceModuleLoader } from '../../services/module-loading/module-loading-types.js';
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
+import type { ApiHandler, ApiHandlerContext, ErrorHandler, Middleware, RouteOptions, StaticRoute, ViewLoader } from '../../types/public-types.js';
 import { type ReturnParseCliArgs } from '../../utils/parse-cli-args.js';
+/**
+ * Runtime bootstrap options layered on top of the app config.
+ *
+ * These options let a host runtime embed Ecopages without mutating process
+ * globals or app runtime state before calling `createApp()`.
+ */
+export interface ApplicationRuntimeOptions {
+    /**
+     * Forces the app into the embedded-runtime CLI mode used by host
+     * environments.
+     *
+     * When enabled and no explicit `hostModuleLoader` is provided, the
+     * adapter auto-detects a host module loader from the global scope.
+     */
+    embedded?: boolean;
+    /**
+     * Explicit source module loader for request-time imports.
+     *
+     * When omitted in embedded mode, the adapter attempts automatic
+     * detection from globals set by the host environment.
+     */
+    hostModuleLoader?: SourceModuleLoader;
+}
 /**
  * Configuration options for application adapters
  */
 export interface ApplicationAdapterOptions {
     appConfig: EcoPagesAppConfig;
     serverOptions?: Record<string, any>;
+    runtime?: ApplicationRuntimeOptions;
     /**
      * Options for clearing the output directory before starting the server
      * @default false
@@ -43,6 +68,7 @@ export declare abstract class AbstractApplicationAdapter<TOptions extends Applic
     protected appConfig: EcoPagesAppConfig;
     protected serverOptions: Record<string, any>;
     protected cliArgs: ReturnParseCliArgs;
+    protected runtimeOptions: ApplicationRuntimeOptions;
     protected apiHandlers: ApiHandler[];
     protected staticRoutes: StaticRoute[];
     protected errorHandler?: ErrorHandler;

package/src/adapters/abstract/application-adapter.js

@@ -1,4 +1,9 @@
 import { appLogger } from "../../global/app-logger.js";
+import {
+  getAppModuleLoader,
+  setAppHostModuleLoader
+} from "../../services/module-loading/app-server-module-transpiler.service.js";
+import { getHostModuleLoader } from "../../services/module-loading/host-module-loader-registry.js";
 import { invariant } from "../../utils/invariant.js";
 import { fileSystem } from "@ecopages/file-system";
 import { parseCliArgs } from "../../utils/parse-cli-args.js";
@@ -6,20 +11,27 @@ class AbstractApplicationAdapter {
   appConfig;
   serverOptions;
   cliArgs;
+  runtimeOptions;
   apiHandlers = [];
   staticRoutes = [];
   errorHandler;
   constructor(options) {
     this.appConfig = options.appConfig;
     this.serverOptions = options.serverOptions || {};
-    this.cliArgs = parseCliArgs();
+    this.runtimeOptions = options.runtime ?? {};
+    this.cliArgs = parseCliArgs({ embeddedRuntime: this.runtimeOptions.embedded });
+    const hostModuleLoader = this.runtimeOptions.hostModuleLoader ?? (this.runtimeOptions.embedded ? getHostModuleLoader() : void 0);
+    if (hostModuleLoader) {
+      setAppHostModuleLoader(this.appConfig, hostModuleLoader);
+    }
+    getAppModuleLoader(this.appConfig);
     if (options.clearOutput) {
       this.clearDistFolder().catch((error) => {
         appLogger.error("Error clearing dist folder", error);
       });
     }
   }
-  async clearDistFolder(_filter = []) {
+  async clearDistFolder() {
     const distPath = this.appConfig.absolutePaths.distDir;
     const distExists = fileSystem.exists(distPath);
     if (!distExists) return;

package/src/adapters/abstract/router-adapter.d.ts

@@ -6,7 +6,7 @@
  *
  * @module RouterAdapter
  */
-import type { Routes } from '../../internal-types.js';
+import type { Routes } from '../../types/internal-types.js';
 /**
  * Abstract base class for router adapters across different runtimes
  */

package/src/adapters/abstract/server-adapter.d.ts

@@ -6,8 +6,8 @@
  *
  * @module ServerAdapter
  */
-import type { EcoPagesAppConfig } from '../../internal-types.js';
-import type { ApiHandler } from '../../public-types.js';
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
+import type { ApiHandler } from '../../types/public-types.js';
 /**
  * Configuration options for all server adapters
  */

package/src/adapters/bun/client-bridge.d.ts

@@ -1,5 +1,5 @@
 import type { ServerWebSocket } from 'bun';
-import type { ClientBridgeEvent, IClientBridge } from '../../public-types';
+import type { ClientBridgeEvent, IClientBridge } from '../../types/public-types.js';
 type BunSocket = ServerWebSocket<unknown>;
 /**
  * Manages WebSocket subscribers and broadcasts development events.

package/src/adapters/bun/create-app.d.ts

@@ -8,18 +8,10 @@
  * @module EcopagesApp
  */
 import type { Server } from 'bun';
-import type { EcoPagesAppConfig } from '../../internal-types.js';
-import type { ApiHandlerContext, RouteGroupBuilder } from '../../public-types.js';
-import { type ApplicationAdapterOptions } from '../abstract/application-adapter.js';
+import type { ApiHandlerContext, RouteGroupBuilder } from '../../types/public-types.js';
 import { SharedApplicationAdapter } from '../shared/application-adapter.js';
+import type { EcopagesAppOptions } from '../create-app.js';
 import { type BunServerAdapterResult } from './server-adapter.js';
-/**
- * Configuration options for the Bun application adapter
- */
-export interface EcopagesAppOptions extends ApplicationAdapterOptions {
-    appConfig: EcoPagesAppConfig;
-    serverOptions?: Record<string, any>;
-}
 /**
  * Bun-specific route group builder that properly infers route params from path patterns.
  * When you define a route like `/posts/:slug`, the handler context will have
@@ -34,7 +26,7 @@ export type BunRouteGroupBuilder<WebSocketData = undefined, TContext extends Api
  * This class extends the {@link AbstractApplicationAdapter}
  * and provides methods for handling HTTP requests and managing the server.
  */
-export declare class EcopagesApp<WebSocketData = undefined> extends SharedApplicationAdapter<EcopagesAppOptions, Server<WebSocketData>, Request> {
+export declare class BunEcopagesApp<WebSocketData = undefined> extends SharedApplicationAdapter<EcopagesAppOptions, Server<WebSocketData>, Request> {
     serverAdapter: BunServerAdapterResult | undefined;
     private server;
     fetch(request: Request): Promise<Response>;
@@ -57,4 +49,4 @@ export declare class EcopagesApp<WebSocketData = undefined> extends SharedApplic
 /**
  * Factory function to create a Bun application
  */
-export declare function createApp<WebSocketData = undefined>(options: EcopagesAppOptions): Promise<EcopagesApp<WebSocketData>>;
+export declare function createApp<WebSocketData = undefined>(options: EcopagesAppOptions): Promise<BunEcopagesApp<WebSocketData>>;

package/src/adapters/bun/create-app.js

@@ -1,10 +1,9 @@
-import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from "../../constants.js";
+import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from "../../config/constants.js";
 import { appLogger } from "../../global/app-logger.js";
 import { getBunRuntime } from "../../utils/runtime.js";
-import {} from "../abstract/application-adapter.js";
 import { SharedApplicationAdapter } from "../shared/application-adapter.js";
 import { createBunServerAdapter } from "./server-adapter.js";
-class EcopagesApp extends SharedApplicationAdapter {
+class BunEcopagesApp extends SharedApplicationAdapter {
   serverAdapter;
   server = null;
   async fetch(request) {
@@ -109,9 +108,9 @@ class EcopagesApp extends SharedApplicationAdapter {
   }
 }
 async function createApp(options) {
-  return new EcopagesApp(options);
+  return new BunEcopagesApp(options);
 }
 export {
-  EcopagesApp,
+  BunEcopagesApp,
   createApp
 };