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

package/README.md

@@ -67,11 +67,11 @@ The manager/orchestration layer is core-owned, but framework-specific strategies
 
 ### Practical Summary
 
-- `ConfigBuilder` now seeds one app-owned build ownership path, adapter, manifest, executor, dev graph, and runtime registry.
+- `ConfigBuilder` seeds one app-owned build ownership path, adapter, manifest, executor, dev graph, and runtime registry.
 - `BrowserBundleService` is the shared browser build seam used by HMR and asset-oriented browser output paths.
 - `ServerModuleTranspiler` is the shared server-side source loading seam used by runtime bootstrap and HMR metadata loading.
 - `createApp()` stays the universal runtime entrypoint, while Vite and Nitro hosts own their advanced dev and build workflows.
-- esbuild remains only as a temporary Bun-path implementation detail and is not a strategic core dependency.
+- One bundled adapter is the default bundler. Vite-based apps route through the `ViteHostBuildAdapter` boundary marker instead.
 
 ## Documentation Map
 
@@ -279,7 +279,6 @@ Use these entrypoints only when implementing host adapters or framework-owned bu
 - `@ecopages/core/dev/host-runtime`
 - `@ecopages/core/build/build-adapter`
 - `@ecopages/core/build/build-types`
-- `@ecopages/core/build/runtime-specifier-alias-plugin`
 - `@ecopages/core/plugins/foreign-jsx-override-plugin`
 
 These host-facing entrypoints are narrower compatibility seams. App code and most extensions should prefer the app-authoring or extension-authoring surfaces.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/core",
-  "version": "0.2.0-alpha.53",
+  "version": "0.2.0-alpha.54",
   "description": "Core package for Ecopages",
   "keywords": [
     "ecopages",
@@ -8,58 +8,75 @@
     "ssg"
   ],
   "license": "MIT",
-  "main": "./src/index.js",
+  "main": "./src/index.ts",
   "type": "module",
+  "files": [
+    "src"
+  ],
   "sideEffects": false,
   "repository": {
     "type": "git",
     "url": "https://github.com/ecopages/ecopages.git",
     "directory": "packages/core"
   },
+  "scripts": {
+    "typecheck": "bunx tsc --noEmit",
+    "release:jsr": "bunx jsr publish"
+  },
   "dependencies": {
-    "@ecopages/file-system": "0.2.0-alpha.53",
+    "@ecopages/file-system": "workspace:*",
     "@ecopages/logger": "^0.2.3",
     "@ecopages/scripts-injector": "^0.1.5",
+    "@oxc-project/runtime": "0.134.0",
     "@worker-tools/html-rewriter": "0.1.0-pre.19",
     "chokidar": "^5.0.0",
     "esbuild": "^0.28.0",
     "ghtml": "^4.0.2",
     "oxc-parser": "^0.124.0",
+    "rolldown": "^1.1.0",
     "ws": "^8.20.1"
   },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/ws": "^8.18.1",
+    "arktype": "^2.2.0",
+    "tailwindcss": "^3.4.19",
+    "valibot": "^1.4.0",
+    "zod": "^4.4.3"
+  },
   "exports": {
     ".": {
-      "browser": "./src/index.browser.js",
-      "import": "./src/index.js",
-      "types": "./src/index.d.ts",
-      "default": "./src/index.js"
+      "browser": "./src/index.browser.ts",
+      "import": "./src/index.ts",
+      "require": "./src/index.ts",
+      "types": "./src/index.ts"
     },
     "./create-app": {
-      "import": "./src/adapters/create-app.js",
-      "types": "./src/adapters/create-app.d.ts",
-      "default": "./src/adapters/create-app.js"
+      "import": "./src/adapters/create-app.ts",
+      "types": "./src/adapters/create-app.ts",
+      "default": "./src/adapters/create-app.ts"
     },
     "./route-renderer/integration-renderer": {
-      "types": "./src/route-renderer/orchestration/integration-renderer.d.ts",
-      "default": "./src/route-renderer/orchestration/integration-renderer.js"
+      "types": "./src/route-renderer/orchestration/integration-renderer.ts",
+      "default": "./src/route-renderer/orchestration/integration-renderer.ts"
     },
     "./route-renderer/component-render-context": {
-      "import": "./src/route-renderer/orchestration/component-render-context.js",
-      "types": "./src/route-renderer/orchestration/component-render-context.d.ts",
-      "default": "./src/route-renderer/orchestration/component-render-context.js"
+      "import": "./src/route-renderer/orchestration/component-render-context.ts",
+      "types": "./src/route-renderer/orchestration/component-render-context.ts",
+      "default": "./src/route-renderer/orchestration/component-render-context.ts"
     },
     "./router/navigation-coordinator": {
-      "types": "./src/router/client/navigation-coordinator.d.ts",
-      "default": "./src/router/client/navigation-coordinator.js"
+      "types": "./src/router/client/navigation-coordinator.ts",
+      "default": "./src/router/client/navigation-coordinator.ts"
     },
     "./router/link-intent": {
-      "types": "./src/router/client/link-intent.d.ts",
-      "default": "./src/router/client/link-intent.js"
+      "types": "./src/router/client/link-intent.ts",
+      "default": "./src/router/client/link-intent.ts"
     },
     "./eco": {
-      "browser": "./src/eco/eco.browser.js",
-      "types": "./src/eco/eco.d.ts",
-      "default": "./src/eco/eco.js"
+      "browser": "./src/eco/eco.browser.ts",
+      "types": "./src/eco/eco.ts",
+      "default": "./src/eco/eco.ts"
     },
     "./declarations": {
       "types": "./src/declarations.d.ts"
@@ -68,202 +85,100 @@
       "types": "./src/env.d.ts"
     },
     "./config-builder": {
-      "types": "./src/config/config-builder.d.ts",
-      "default": "./src/config/config-builder.js"
+      "types": "./src/config/config-builder.ts",
+      "default": "./src/config/config-builder.ts"
     },
     "./constants": {
-      "types": "./src/config/constants.d.ts",
-      "default": "./src/config/constants.js"
+      "types": "./src/config/constants.ts",
+      "default": "./src/config/constants.ts"
     },
     "./bun": {
-      "types": "./src/adapters/bun/index.d.ts",
-      "default": "./src/adapters/bun/index.js"
+      "types": "./src/adapters/bun/index.ts",
+      "default": "./src/adapters/bun/index.ts"
     },
     "./hmr/hmr-strategy": {
-      "types": "./src/hmr/hmr-strategy.d.ts",
-      "default": "./src/hmr/hmr-strategy.js"
+      "types": "./src/hmr/hmr-strategy.ts",
+      "default": "./src/hmr/hmr-strategy.ts"
     },
     "./hmr/client/hmr-runtime": {
-      "types": "./src/hmr/client/hmr-runtime.d.ts",
-      "default": "./src/hmr/client/hmr-runtime.js"
+      "types": "./src/hmr/client/hmr-runtime.ts",
+      "default": "./src/hmr/client/hmr-runtime.ts"
     },
     "./dev/host-runtime": {
-      "types": "./src/dev/host-runtime.d.ts",
-      "default": "./src/dev/host-runtime.js"
+      "types": "./src/dev/host-runtime.ts",
+      "default": "./src/dev/host-runtime.ts"
     },
     "./services/asset-processing-service": {
-      "types": "./src/services/assets/asset-processing-service/index.d.ts",
-      "default": "./src/services/assets/asset-processing-service/index.js"
+      "types": "./src/services/assets/asset-processing-service/index.ts",
+      "default": "./src/services/assets/asset-processing-service/index.ts"
     },
     "./plugins/processor": {
-      "types": "./src/plugins/processor.d.ts",
-      "default": "./src/plugins/processor.js"
+      "types": "./src/plugins/processor.ts",
+      "default": "./src/plugins/processor.ts"
     },
     "./plugins/integration-plugin": {
-      "types": "./src/plugins/integration-plugin.d.ts",
-      "default": "./src/plugins/integration-plugin.js"
+      "types": "./src/plugins/integration-plugin.ts",
+      "default": "./src/plugins/integration-plugin.ts"
     },
     "./plugins/source-transform": {
-      "types": "./src/plugins/source-transform.d.ts",
-      "default": "./src/plugins/source-transform.js"
+      "types": "./src/plugins/source-transform.ts",
+      "default": "./src/plugins/source-transform.ts"
     },
     "./build/build-types": {
-      "types": "./src/build/build-types.d.ts",
-      "default": "./src/build/build-types.js"
+      "types": "./src/build/build-types.ts",
+      "default": "./src/build/build-types.ts"
     },
     "./build/build-adapter": {
-      "types": "./src/build/build-adapter.d.ts",
-      "default": "./src/build/build-adapter.js"
+      "types": "./src/build/build-adapter.ts",
+      "default": "./src/build/build-adapter.ts"
+    },
+    "./build/runtime-build-output-normalizer": {
+      "types": "./src/build/runtime-build-output-normalizer.ts",
+      "default": "./src/build/runtime-build-output-normalizer.ts"
     },
     "./build/browser-runtime-manifest": {
-      "types": "./src/build/browser-runtime-manifest.d.ts",
-      "default": "./src/build/browser-runtime-manifest.js"
+      "types": "./src/build/browser-runtime-manifest.ts",
+      "default": "./src/build/browser-runtime-manifest.ts"
     },
     "./build/browser-runtime-import-rewrite-plugin": {
-      "types": "./src/build/browser-runtime-import-rewrite-plugin.d.ts",
-      "default": "./src/build/browser-runtime-import-rewrite-plugin.js"
+      "types": "./src/build/browser-runtime-import-rewrite-plugin.ts",
+      "default": "./src/build/browser-runtime-import-rewrite-plugin.ts"
+    },
+    "./build/browser-runtime-plugin": {
+      "types": "./src/build/browser-runtime-plugin.ts",
+      "default": "./src/build/browser-runtime-plugin.ts"
     },
     "./build/runtime-specifier-alias-plugin": {
-      "types": "./src/build/runtime-specifier-alias-plugin.d.ts",
-      "default": "./src/build/runtime-specifier-alias-plugin.js"
+      "types": "./src/build/runtime-specifier-alias-plugin.ts",
+      "default": "./src/build/runtime-specifier-alias-plugin.ts"
+    },
+    "./cache": {
+      "types": "./src/cache/index.ts",
+      "default": "./src/cache/index.ts"
     },
     "./plugins/foreign-jsx-override-plugin": {
-      "types": "./src/plugins/foreign-jsx-override-plugin.d.ts",
-      "default": "./src/plugins/foreign-jsx-override-plugin.js"
+      "types": "./src/plugins/foreign-jsx-override-plugin.ts",
+      "default": "./src/plugins/foreign-jsx-override-plugin.ts"
     },
     "./html": {
-      "import": "./src/utils/html.js",
-      "default": "./src/utils/html.js",
-      "types": "./src/utils/html.d.ts"
+      "import": "./src/utils/html.ts",
+      "require": "./src/utils/html.ts"
     },
     "./hash": {
-      "import": "./src/utils/hash.js",
-      "default": "./src/utils/hash.js",
-      "types": "./src/utils/hash.d.ts"
+      "import": "./src/utils/hash.ts",
+      "require": "./src/utils/hash.ts"
+    },
+    "./utils/hash": {
+      "import": "./src/utils/hash.ts",
+      "require": "./src/utils/hash.ts"
     },
     "./errors": {
-      "types": "./src/errors/index.d.ts",
-      "default": "./src/errors/index.js"
+      "types": "./src/errors/index.ts",
+      "default": "./src/errors/index.ts"
     },
     "./integrations/ghtml": {
-      "types": "./src/integrations/ghtml/ghtml.plugin.d.ts",
-      "default": "./src/integrations/ghtml/ghtml.plugin.js"
-    },
-    "./create-app.ts": {
-      "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/orchestration/integration-renderer.d.ts",
-      "default": "./src/route-renderer/orchestration/integration-renderer.js"
-    },
-    "./route-renderer/component-render-context.ts": {
-      "import": "./src/route-renderer/orchestration/component-render-context.js",
-      "types": "./src/route-renderer/orchestration/component-render-context.d.ts",
-      "default": "./src/route-renderer/orchestration/component-render-context.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"
-    },
-    "./eco.ts": {
-      "browser": "./src/eco/eco.browser.js",
-      "types": "./src/eco/eco.d.ts",
-      "default": "./src/eco/eco.js"
-    },
-    "./declarations.ts": {
-      "types": "./src/declarations.d.ts"
-    },
-    "./env.ts": {
-      "types": "./src/env.d.ts"
-    },
-    "./config-builder.ts": {
-      "types": "./src/config/config-builder.d.ts",
-      "default": "./src/config/config-builder.js"
-    },
-    "./constants.ts": {
-      "types": "./src/config/constants.d.ts",
-      "default": "./src/config/constants.js"
-    },
-    "./bun.ts": {
-      "types": "./src/adapters/bun/index.d.ts",
-      "default": "./src/adapters/bun/index.js"
-    },
-    "./hmr/hmr-strategy.ts": {
-      "types": "./src/hmr/hmr-strategy.d.ts",
-      "default": "./src/hmr/hmr-strategy.js"
-    },
-    "./hmr/client/hmr-runtime.ts": {
-      "types": "./src/hmr/client/hmr-runtime.d.ts",
-      "default": "./src/hmr/client/hmr-runtime.js"
-    },
-    "./dev/host-runtime.ts": {
-      "types": "./src/dev/host-runtime.d.ts",
-      "default": "./src/dev/host-runtime.js"
-    },
-    "./services/asset-processing-service.ts": {
-      "types": "./src/services/assets/asset-processing-service/index.d.ts",
-      "default": "./src/services/assets/asset-processing-service/index.js"
-    },
-    "./plugins/processor.ts": {
-      "types": "./src/plugins/processor.d.ts",
-      "default": "./src/plugins/processor.js"
-    },
-    "./plugins/integration-plugin.ts": {
-      "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"
-    },
-    "./build/build-adapter.ts": {
-      "types": "./src/build/build-adapter.d.ts",
-      "default": "./src/build/build-adapter.js"
-    },
-    "./build/browser-runtime-manifest.ts": {
-      "types": "./src/build/browser-runtime-manifest.d.ts",
-      "default": "./src/build/browser-runtime-manifest.js"
-    },
-    "./build/browser-runtime-import-rewrite-plugin.ts": {
-      "types": "./src/build/browser-runtime-import-rewrite-plugin.d.ts",
-      "default": "./src/build/browser-runtime-import-rewrite-plugin.js"
-    },
-    "./build/runtime-specifier-alias-plugin.ts": {
-      "types": "./src/build/runtime-specifier-alias-plugin.d.ts",
-      "default": "./src/build/runtime-specifier-alias-plugin.js"
-    },
-    "./plugins/foreign-jsx-override-plugin.ts": {
-      "types": "./src/plugins/foreign-jsx-override-plugin.d.ts",
-      "default": "./src/plugins/foreign-jsx-override-plugin.js"
-    },
-    "./html.ts": {
-      "import": "./src/utils/html.js",
-      "default": "./src/utils/html.js",
-      "types": "./src/utils/html.d.ts"
-    },
-    "./hash.ts": {
-      "import": "./src/utils/hash.js",
-      "default": "./src/utils/hash.js",
-      "types": "./src/utils/hash.d.ts"
-    },
-    "./errors.ts": {
-      "types": "./src/errors/index.d.ts",
-      "default": "./src/errors/index.js"
-    },
-    "./integrations/ghtml.ts": {
-      "types": "./src/integrations/ghtml/ghtml.plugin.d.ts",
-      "default": "./src/integrations/ghtml/ghtml.plugin.js"
+      "types": "./src/integrations/ghtml/ghtml.plugin.ts",
+      "default": "./src/integrations/ghtml/ghtml.plugin.ts"
     }
-  },
-  "types": "./src/index.d.ts"
-}
+  }
+}

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

@@ -0,0 +1,218 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { afterEach, describe, it } from 'vitest';
+import {
+	AbstractApplicationAdapter,
+	type ApplicationAdapterOptions,
+	type RouteHandler,
+	type RouteGroupDefinition,
+} from './application-adapter.ts';
+import type { ApiHandlerContext, ViewLoader } from '../../types/public-types.ts';
+import {
+	setHostModuleLoader,
+	clearHostModuleLoader,
+} from '../../services/module-loading/host-module-loader-registry.ts';
+
+class TestApplicationAdapter extends AbstractApplicationAdapter<ApplicationAdapterOptions, unknown, Request> {
+	public getCliArgsSnapshot() {
+		return this.cliArgs;
+	}
+
+	public getAppModuleLoader() {
+		return this.appConfig.runtime?.appModuleLoader;
+	}
+
+	public getHostModuleLoader() {
+		return this.appConfig.runtime?.hostModuleLoader;
+	}
+
+	get<P extends string, TContext extends ApiHandlerContext<Request, unknown>>(
+		_path: P,
+		_handler: RouteHandler<Request, unknown, TContext>,
+	): this {
+		return this;
+	}
+
+	post<P extends string, TContext extends ApiHandlerContext<Request, unknown>>(
+		_path: P,
+		_handler: RouteHandler<Request, unknown, TContext>,
+	): this {
+		return this;
+	}
+
+	put<P extends string, TContext extends ApiHandlerContext<Request, unknown>>(
+		_path: P,
+		_handler: RouteHandler<Request, unknown, TContext>,
+	): this {
+		return this;
+	}
+
+	delete<P extends string, TContext extends ApiHandlerContext<Request, unknown>>(
+		_path: P,
+		_handler: RouteHandler<Request, unknown, TContext>,
+	): this {
+		return this;
+	}
+
+	patch<P extends string, TContext extends ApiHandlerContext<Request, unknown>>(
+		_path: P,
+		_handler: RouteHandler<Request, unknown, TContext>,
+	): this {
+		return this;
+	}
+
+	options<P extends string, TContext extends ApiHandlerContext<Request, unknown>>(
+		_path: P,
+		_handler: RouteHandler<Request, unknown, TContext>,
+	): this {
+		return this;
+	}
+
+	head<P extends string, TContext extends ApiHandlerContext<Request, unknown>>(
+		_path: P,
+		_handler: RouteHandler<Request, unknown, TContext>,
+	): this {
+		return this;
+	}
+
+	route<P extends string>(_path: P, _method: 'GET', _handler: RouteHandler<Request, unknown>): this {
+		return this;
+	}
+
+	add(): this {
+		return this;
+	}
+
+	group(_prefix: string, _callback: (builder: unknown) => void): this;
+	group(_group: RouteGroupDefinition<Request, unknown>): this;
+	group(): this {
+		return this;
+	}
+
+	override static<P>(_path: string, _loader: ViewLoader<P>): this {
+		return this;
+	}
+
+	protected async initializeServerAdapter(): Promise<void> {
+		return;
+	}
+
+	async fetch(_request: Request): Promise<Response> {
+		return new Response(null, { status: 204 });
+	}
+
+	start(): Promise<void> {
+		return Promise.resolve();
+	}
+}
+
+afterEach(() => {
+	clearHostModuleLoader();
+	delete process.env.NODE_ENV;
+});
+
+describe('application adapter runtime bootstrap', () => {
+	it('derives embedded cli args from explicit runtime options', () => {
+		process.env.NODE_ENV = 'development';
+		const adapter = new TestApplicationAdapter({
+			appConfig: {
+				runtime: {},
+			} as ApplicationAdapterOptions['appConfig'],
+			runtime: {
+				embedded: true,
+			},
+		});
+
+		assert.deepEqual(adapter.getCliArgsSnapshot(), {
+			preview: false,
+			build: false,
+			start: false,
+			dev: true,
+			port: undefined,
+			hostname: undefined,
+			reactFastRefresh: undefined,
+		});
+		assert.ok(adapter.getAppModuleLoader());
+		assert.equal(adapter.getHostModuleLoader(), undefined);
+	});
+
+	it('auto-detects the host module loader in embedded mode from registry', async () => {
+		process.env.NODE_ENV = 'development';
+		let importedId: string | undefined;
+		const filePath = import.meta.filename;
+		setHostModuleLoader(async (id) => {
+			importedId = id;
+			return { id };
+		});
+
+		const adapter = new TestApplicationAdapter({
+			appConfig: {
+				runtime: {},
+			} as ApplicationAdapterOptions['appConfig'],
+			runtime: {
+				embedded: true,
+			},
+		});
+
+		const appModuleLoader = adapter.getAppModuleLoader();
+		const hostModuleLoader = adapter.getHostModuleLoader();
+
+		assert.ok(appModuleLoader);
+		assert.ok(hostModuleLoader);
+		assert.equal(appModuleLoader?.owner, 'host');
+		assert.deepEqual(await hostModuleLoader?.('/virtual:entry'), { id: '/virtual:entry' });
+		assert.deepEqual(
+			await appModuleLoader?.importModule({
+				filePath,
+				rootDir: '/app',
+				outdir: '/app/.eco/.server-modules',
+			}),
+			{ id: importedId },
+		);
+		assert.match(importedId ?? '', /application-adapter\.test\.ts\?update=/);
+	});
+
+	it('preserves top-level await through the embedded host module loader path', async () => {
+		process.env.NODE_ENV = 'development';
+		const tempDir = fs.mkdtempSync(path.join(tmpdir(), 'ecopages-host-loader-tla-'));
+		const moduleFilePath = path.join(tempDir, 'entry.mjs');
+		fs.writeFileSync(
+			moduleFilePath,
+			['export const value = await Promise.resolve(42);', 'export default { ok: value === 42 };'].join('\n'),
+			'utf8',
+		);
+
+		setHostModuleLoader(async (id) => {
+			const moduleUrl = new URL(id);
+			moduleUrl.search = '';
+			return await import(moduleUrl.href);
+		});
+
+		const adapter = new TestApplicationAdapter({
+			appConfig: {
+				runtime: {},
+			} as ApplicationAdapterOptions['appConfig'],
+			runtime: {
+				embedded: true,
+			},
+		});
+
+		try {
+			const imported = await adapter.getAppModuleLoader()?.importModule<{
+				default: { ok: boolean };
+				value: number;
+			}>({
+				filePath: moduleFilePath,
+				rootDir: tempDir,
+				outdir: path.join(tempDir, '.eco', '.server-modules'),
+			});
+
+			assert.deepEqual(imported?.default, { ok: true });
+			assert.equal(imported?.value, 42);
+		} finally {
+			fs.rmSync(tempDir, { recursive: true, force: true });
+		}
+	});
+});