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

package/README.md

@@ -31,14 +31,14 @@ flowchart TD
 	B --> D[App build manifest]
 	B --> E[Build executor]
 	B --> F[Dev graph service]
-	B --> G[Runtime specifier registry]
-	B --> H[Host module loader boundary]
-	H --> I[PageModuleImportService]
+	B --> G[Host module loader boundary]
+	G --> H[PageModuleImportService]
+	E --> H
 	E --> I
-	E --> J[BrowserBundleService]
-	I --> K[Runtime app adapter]
-	K --> L[Bun adapter or Node adapter]
-	D --> J
+	E --> I[BrowserBundleService]
+	H --> J[Runtime app adapter]
+	J --> K[Bun adapter or Node adapter]
+	D --> I
 ```
 
 ### Development Invalidation And HMR Flow
@@ -178,6 +178,12 @@ export const MyButton = eco.component({
 });
 ```
 
+Dependency ownership affects final asset packaging:
+
+- Stylesheets and scripts declared from `eco.html()` stay Html-owned and can be emitted as shared app-wide assets.
+- Stylesheets and scripts declared from Pages, Layouts, or Components are resolved into page-owned assets for the rendered route.
+- This split is intentional. Shared Html assets can be cached across routes, while page-owned assets can change without invalidating the global shell.
+
 ### 5. API Handlers
 
 Add server-side routes using `defineApiHandler`. Register them on your `app` instance before starting:
@@ -228,3 +234,53 @@ import { defineApiHandler, defineGroupHandler, eco } from '@ecopages/core';
 Use runtime-specific subpaths only when you explicitly need Bun-native APIs that bypass the universal abstractions:
 
 - `@ecopages/core/bun`
+
+## Entry Point Roles
+
+The published subpaths are grouped by architectural role rather than by source folder.
+
+### App Authoring
+
+Use these entrypoints when building an Ecopages app:
+
+- `@ecopages/core`
+- `@ecopages/core/create-app`
+- `@ecopages/core/config-builder`
+- `@ecopages/core/errors`
+- `@ecopages/core/html`
+- `@ecopages/core/hash`
+- `@ecopages/core/declarations`
+- `@ecopages/core/env`
+- `@ecopages/core/bun`
+
+### Browser Navigation
+
+Use these entrypoints when a browser runtime needs to coordinate document ownership and link intent:
+
+- `@ecopages/core/router/navigation-coordinator`
+- `@ecopages/core/router/link-intent`
+
+### Extension Authoring
+
+Use these entrypoints when implementing integrations, processors, or source transforms:
+
+- `@ecopages/core/plugins/integration-plugin`
+- `@ecopages/core/plugins/processor`
+- `@ecopages/core/plugins/source-transform`
+- `@ecopages/core/route-renderer/integration-renderer`
+- `@ecopages/core/services/asset-processing-service`
+- `@ecopages/core/hmr/hmr-strategy`
+- `@ecopages/core/integrations/ghtml`
+
+### Host And Runtime Composition
+
+Use these entrypoints only when implementing host adapters or framework-owned bundling seams:
+
+- `@ecopages/core/dev/host-runtime`
+- `@ecopages/core/build/build-adapter`
+- `@ecopages/core/build/build-types`
+- `@ecopages/core/build/runtime-specifier-alias-plugin`
+- `@ecopages/core/build/runtime-specifier-aliases`
+- `@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.25",
+  "version": "0.2.0-alpha.27",
   "description": "Core package for Ecopages",
   "keywords": [
     "ecopages",
@@ -66,23 +66,11 @@
       "types": "./src/router/client/link-intent.ts",
       "default": "./src/router/client/link-intent.ts"
     },
-    "./router/client/navigation-coordinator": {
-      "types": "./src/router/client/navigation-coordinator.ts",
-      "default": "./src/router/client/navigation-coordinator.ts"
-    },
-    "./errors/locals-access-error": {
-      "types": "./src/errors/locals-access-error.ts",
-      "default": "./src/errors/locals-access-error.ts"
-    },
     "./eco": {
       "browser": "./src/eco/eco.browser.ts",
       "types": "./src/eco/eco.ts",
       "default": "./src/eco/eco.ts"
     },
-    "./route-renderer/template-serialization": {
-      "types": "./src/route-renderer/orchestration/template-serialization.ts",
-      "default": "./src/route-renderer/orchestration/template-serialization.ts"
-    },
     "./declarations": {
       "types": "./src/declarations.d.ts"
     },
@@ -101,45 +89,18 @@
       "types": "./src/adapters/bun/index.ts",
       "default": "./src/adapters/bun/index.ts"
     },
-    "./bun/create-app": {
-      "types": "./src/adapters/bun/create-app.ts",
-      "default": "./src/adapters/bun/create-app.ts"
-    },
     "./hmr/hmr-strategy": {
       "types": "./src/hmr/hmr-strategy.ts",
       "default": "./src/hmr/hmr-strategy.ts"
     },
-    "./internal-types": {
-      "types": "./src/types/internal-types.ts"
+    "./dev/host-runtime": {
+      "types": "./src/dev/host-runtime.ts",
+      "default": "./src/dev/host-runtime.ts"
     },
     "./services/asset-processing-service": {
       "types": "./src/services/assets/asset-processing-service/index.ts",
       "default": "./src/services/assets/asset-processing-service/index.ts"
     },
-    "./services/invalidation/development-invalidation.service": {
-      "types": "./src/services/invalidation/development-invalidation.service.ts",
-      "default": "./src/services/invalidation/development-invalidation.service.ts"
-    },
-    "./services/module-loading/app-server-module-transpiler.service": {
-      "types": "./src/services/module-loading/app-server-module-transpiler.service.ts",
-      "default": "./src/services/module-loading/app-server-module-transpiler.service.ts"
-    },
-    "./host-module-loader": {
-      "types": "./src/services/module-loading/host-module-loader-registry.ts",
-      "default": "./src/services/module-loading/host-module-loader-registry.ts"
-    },
-    "./utils/deep-merge": {
-      "types": "./src/utils/deep-merge.ts",
-      "default": "./src/utils/deep-merge.ts"
-    },
-    "./utils/invariant": {
-      "types": "./src/utils/invariant.ts",
-      "default": "./src/utils/invariant.ts"
-    },
-    "./utils/parse-cli-args": {
-      "types": "./src/utils/parse-cli-args.ts",
-      "default": "./src/utils/parse-cli-args.ts"
-    },
     "./plugins/processor": {
       "types": "./src/plugins/processor.ts",
       "default": "./src/plugins/processor.ts"
@@ -172,10 +133,6 @@
       "types": "./src/plugins/foreign-jsx-override-plugin.ts",
       "default": "./src/plugins/foreign-jsx-override-plugin.ts"
     },
-    "./adapters/bun/client-bridge": {
-      "types": "./src/adapters/bun/client-bridge.ts",
-      "default": "./src/adapters/bun/client-bridge.ts"
-    },
     "./html": {
       "import": "./src/utils/html.ts",
       "require": "./src/utils/html.ts"

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

@@ -10,6 +10,7 @@
 
 import type { Server } from 'bun';
 import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from '../../config/constants.ts';
+import { StaticContentServer } from '../../dev/sc-server.ts';
 import { appLogger } from '../../global/app-logger.ts';
 import { getBunRuntime } from '../../utils/runtime.ts';
 import type { ApiHandlerContext, RouteGroupBuilder } from '../../types/public-types.ts';
@@ -47,6 +48,41 @@ export class BunEcopagesApp<WebSocketData = undefined> extends SharedApplication
 	serverAdapter: BunServerAdapterResult | undefined;
 	private server: Server<WebSocketData> | null = null;
 
+	private async startStaticPreviewServer(port: number, hostname: string): Promise<void> {
+		await new Promise((resolve) => setTimeout(resolve, 100));
+
+		for (let attempt = 0; attempt < 20; attempt += 1) {
+			try {
+				const previewServer = StaticContentServer.createServer({
+					appConfig: this.appConfig,
+					options: { port },
+				});
+
+				if (previewServer.server?.port) {
+					appLogger.info(`Preview running at http://${hostname}:${previewServer.server.port}`);
+					return;
+				}
+
+				break;
+			} catch (error) {
+				const errorMessage = error instanceof Error ? error.message : String(error);
+				const errorCode =
+					typeof error === 'object' && error !== null && 'code' in error
+						? String((error as { code?: unknown }).code)
+						: undefined;
+				const isPortReleaseRace = errorCode === 'EADDRINUSE' || errorMessage.includes('EADDRINUSE');
+
+				if (!isPortReleaseRace || attempt === 19) {
+					throw error;
+				}
+
+				await new Promise((resolve) => setTimeout(resolve, 100));
+			}
+		}
+
+		appLogger.error('Failed to start preview server');
+	}
+
 	public async fetch(request: Request): Promise<Response> {
 		if (!this.serverAdapter) {
 			this.serverAdapter = await this.initializeServerAdapter();
@@ -137,13 +173,22 @@ export class BunEcopagesApp<WebSocketData = undefined> extends SharedApplication
 
 		const enableHmr = dev || (!preview && !build);
 		const serverOptions = this.serverAdapter.getServerOptions({ enableHmr });
+		const configuredHostname = String(serverOptions.hostname ?? DEFAULT_ECOPAGES_HOSTNAME);
+		const configuredPort = Number(serverOptions.port ?? DEFAULT_ECOPAGES_PORT);
+		const runtimeServerOptions =
+			(preview || build) && requiresFetchRuntime
+				? {
+						...serverOptions,
+						port: 0,
+					}
+				: serverOptions;
 
 		const bun = getBunRuntime();
 		if (!bun) {
 			throw new Error('Bun runtime is required for the Bun adapter');
 		}
 
-		const bunServer = bun.serve(serverOptions as Bun.Serve.Options<WebSocketData>);
+		const bunServer = bun.serve(runtimeServerOptions as Bun.Serve.Options<WebSocketData>);
 		this.server = bunServer as Server<WebSocketData>;
 
 		await this.serverAdapter.completeInitialization(this.server).catch((error: Error) => {
@@ -157,8 +202,15 @@ export class BunEcopagesApp<WebSocketData = undefined> extends SharedApplication
 
 		if (build || preview) {
 			appLogger.debugTime('Building static pages');
-			await this.serverAdapter.buildStatic({ preview });
+			await this.serverAdapter.buildStatic({ preview: false });
 			this.server.stop(true);
+
+			if (preview) {
+				const previewHostname = configuredHostname;
+				const previewPort = configuredPort;
+				await this.startStaticPreviewServer(previewPort, previewHostname);
+			}
+
 			appLogger.debugTimeEnd('Building static pages');
 
 			if (build) {

package/src/adapters/bun/hmr-manager.test.ts

@@ -227,13 +227,11 @@ test('HmrManager stop clears retained registration state', async () => {
 		fs.writeFileSync(outputPath, 'export default 1;', 'utf8');
 	});
 
-	manager.registerSpecifierMap({ react: '/assets/vendors/react.js' });
 	await manager.registerEntrypoint(entrypointPath);
 
 	manager.stop();
 
 	assert.equal(manager.getWatchedFiles().size, 0);
-	assert.equal(manager.getSpecifierMap().size, 0);
 });
 
 test('HmrManager keeps internal browser and server-module outputs out of distDir', async () => {

package/src/adapters/bun/hmr-manager.ts

@@ -20,7 +20,6 @@ import {
 	NoopEntrypointDependencyGraph,
 	setAppEntrypointDependencyGraph,
 } from '../../services/runtime-state/entrypoint-dependency-graph.service.ts';
-import { getAppRuntimeSpecifierRegistry } from '../../services/runtime-state/runtime-specifier-registry.service.ts';
 import type { ServerModuleTranspiler } from '../../services/module-loading/server-module-transpiler.service.ts';
 import { resolveInternalExecutionDir, resolveInternalWorkDir } from '../../utils/resolve-work-dir.ts';
 
@@ -60,7 +59,6 @@ export class HmrManager implements IHmrManager {
 	private readonly entrypointRegistrar: HmrEntrypointRegistrar;
 	private readonly browserBundleService: BrowserBundleService;
 	private readonly entrypointDependencyGraph: ReturnType<typeof getAppEntrypointDependencyGraph>;
-	private readonly runtimeSpecifierRegistry: ReturnType<typeof getAppRuntimeSpecifierRegistry>;
 	private readonly serverModuleTranspiler: ServerModuleTranspiler;
 	private wsHandler!: {
 		open: (ws: BunSocket) => void;
@@ -86,7 +84,6 @@ export class HmrManager implements IHmrManager {
 				? existingEntrypointDependencyGraph
 				: new NoopEntrypointDependencyGraph();
 		setAppEntrypointDependencyGraph(this.appConfig, this.entrypointDependencyGraph);
-		this.runtimeSpecifierRegistry = getAppRuntimeSpecifierRegistry(this.appConfig);
 		this.serverModuleTranspiler = getAppServerModuleTranspiler(this.appConfig);
 		this.cleanDistDir();
 		this.initializeStrategies();
@@ -132,7 +129,6 @@ export class HmrManager implements IHmrManager {
 	private initializeStrategies(): void {
 		const jsContext = {
 			getWatchedFiles: () => this.watchedFiles,
-			getSpecifierMap: () => this.runtimeSpecifierRegistry.getAll(),
 			getDistDir: () => this.distDir,
 			getPlugins: () => this.plugins,
 			getSrcDir: () => this.appConfig.absolutePaths.srcDir,
@@ -168,19 +164,6 @@ export class HmrManager implements IHmrManager {
 		return this.enabled;
 	}
 
-	/**
-	 * Registers runtime bare-specifier mappings exposed by integrations.
-	 *
-	 * @remarks
-	 * These mappings are consumed by framework-owned HMR strategies that preserve
-	 * shared runtime imports in browser bundles. The registry stays generic so
-	 * these mappings can later support broader import-map-style runtime features
-	 * without moving integration semantics into core.
-	 */
-	public registerSpecifierMap(map: Record<string, string>): void {
-		this.runtimeSpecifierRegistry.register(map);
-	}
-
 	public getWebSocketHandler(): BunSocketHandler {
 		const open = (ws: BunSocket) => {
 			this.bridge.subscribe(ws);
@@ -272,10 +255,6 @@ export class HmrManager implements IHmrManager {
 		return this.watchedFiles;
 	}
 
-	public getSpecifierMap(): Map<string, string> {
-		return this.runtimeSpecifierRegistry.getAll();
-	}
-
 	public getDistDir(): string {
 		return this.distDir;
 	}
@@ -287,7 +266,6 @@ export class HmrManager implements IHmrManager {
 	public getDefaultContext(): DefaultHmrContext {
 		return {
 			getWatchedFiles: () => this.watchedFiles,
-			getSpecifierMap: () => this.runtimeSpecifierRegistry.getAll(),
 			getDistDir: () => this.distDir,
 			getPlugins: () => this.plugins,
 			getSrcDir: () => this.appConfig.absolutePaths.srcDir,
@@ -390,7 +368,7 @@ export class HmrManager implements IHmrManager {
 	 * @remarks
 	 * Emitted `_hmr` files remain on disk because parallel app processes may share
 	 * the same dist directory. The in-memory indexes are cleared so stale
-	 * entrypoints and specifier maps cannot leak through a reused manager object.
+	 * entrypoints cannot leak through a reused manager object.
 	 */
 	public stop() {
 		this.entrypointRegistrations.clear();
@@ -399,7 +377,6 @@ export class HmrManager implements IHmrManager {
 		}
 		this.watchers.clear();
 		this.watchedFiles.clear();
-		this.runtimeSpecifierRegistry.clear();
 		this.entrypointDependencyGraph.reset();
 		this.plugins = [];
 	}

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

@@ -11,6 +11,7 @@ import { SharedServerAdapter } from '../shared/server-adapter.ts';
 import type { ServerAdapterResult } from '../abstract/server-adapter.ts';
 import { ApiResponseBuilder } from '../shared/api-response.ts';
 import { installSharedRuntimeBuildExecutor } from '../shared/runtime-bootstrap.ts';
+import { StaticContentServer } from '../../dev/sc-server.ts';
 
 import { ServerRouteHandler, type ServerRouteHandlerParams } from '../shared/server-route-handler.ts';
 import { ServerStaticBuilder, type ServerStaticBuilderParams } from '../shared/server-static-builder.ts';
@@ -352,11 +353,36 @@ export class BunServerAdapter extends SharedServerAdapter<BunServerAdapterParams
 			});
 		}
 
-		await this.staticBuilder.build(options, {
-			router: this.router,
-			routeRendererFactory: this.routeRendererFactory,
-			staticRoutes: this.staticRoutes,
+		const buildRuntimeOrigin = this.serverInstance
+			? `http://${this.serverInstance.hostname || DEFAULT_ECOPAGES_HOSTNAME}:${this.serverInstance.port || DEFAULT_ECOPAGES_PORT}`
+			: undefined;
+
+		await this.staticBuilder.build(
+			{ ...options, preview: false, baseUrl: buildRuntimeOrigin },
+			{
+				router: this.router,
+				routeRendererFactory: this.routeRendererFactory,
+				staticRoutes: this.staticRoutes,
+			},
+		);
+
+		if (!options?.preview) {
+			return;
+		}
+
+		const previewHostname = this.serveOptions.hostname || DEFAULT_ECOPAGES_HOSTNAME;
+		const previewPort = Number(this.serveOptions.port || DEFAULT_ECOPAGES_PORT);
+		const previewServer = StaticContentServer.createServer({
+			appConfig: this.appConfig,
+			options: { port: previewPort },
 		});
+
+		if (previewServer.server?.port) {
+			appLogger.info(`Preview running at http://${previewHostname}:${previewServer.server.port}`);
+			return;
+		}
+
+		appLogger.error('Failed to start preview server');
 	}
 
 	/**

package/src/adapters/node/node-hmr-manager.test.ts

@@ -283,13 +283,11 @@ test('NodeHmrManager stop clears retained registration state', async () => {
 		fs.writeFileSync(outputPath, 'export default 1;', 'utf8');
 	});
 
-	manager.registerSpecifierMap({ react: '/assets/vendors/react.js' });
 	await manager.registerEntrypoint(entrypointPath);
 
 	manager.stop();
 
 	assert.equal(manager.getWatchedFiles().size, 0);
-	assert.equal(manager.getSpecifierMap().size, 0);
 	assert.equal(config.runtime?.entrypointDependencyGraph?.getDependencyEntrypoints(entrypointPath).size, 0);
 });
 

package/src/adapters/node/node-hmr-manager.ts

@@ -19,7 +19,6 @@ import {
 	setAppEntrypointDependencyGraph,
 	type EntrypointDependencyGraph,
 } from '../../services/runtime-state/entrypoint-dependency-graph.service.ts';
-import { getAppRuntimeSpecifierRegistry } from '../../services/runtime-state/runtime-specifier-registry.service.ts';
 import type { ServerModuleTranspiler } from '../../services/module-loading/server-module-transpiler.service.ts';
 import { resolveInternalExecutionDir, resolveInternalWorkDir } from '../../utils/resolve-work-dir.ts';
 
@@ -59,7 +58,6 @@ export class NodeHmrManager implements IHmrManager {
 	private readonly entrypointRegistrar: HmrEntrypointRegistrar;
 	private readonly browserBundleService: BrowserBundleService;
 	private readonly entrypointDependencyGraph: EntrypointDependencyGraph;
-	private readonly runtimeSpecifierRegistry: ReturnType<typeof getAppRuntimeSpecifierRegistry>;
 	private readonly serverModuleTranspiler: ServerModuleTranspiler;
 
 	constructor({ appConfig, bridge }: NodeHmrManagerParams) {
@@ -81,7 +79,6 @@ export class NodeHmrManager implements IHmrManager {
 				? existingEntrypointDependencyGraph
 				: new InMemoryEntrypointDependencyGraph();
 		setAppEntrypointDependencyGraph(this.appConfig, this.entrypointDependencyGraph);
-		this.runtimeSpecifierRegistry = getAppRuntimeSpecifierRegistry(this.appConfig);
 		this.serverModuleTranspiler = getAppServerModuleTranspiler(this.appConfig);
 		this.cleanDistDir();
 		this.initializeStrategies();
@@ -123,7 +120,6 @@ export class NodeHmrManager implements IHmrManager {
 	private initializeStrategies(): void {
 		const jsContext = {
 			getWatchedFiles: () => this.watchedFiles,
-			getSpecifierMap: () => this.runtimeSpecifierRegistry.getAll(),
 			getDistDir: () => this.distDir,
 			getPlugins: () => this.plugins,
 			getSrcDir: () => this.appConfig.absolutePaths.srcDir,
@@ -154,19 +150,6 @@ export class NodeHmrManager implements IHmrManager {
 		return this.enabled;
 	}
 
-	/**
-	 * Registers runtime bare-specifier mappings exposed by integrations.
-	 *
-	 * @remarks
-	 * These mappings are consumed by framework-owned HMR strategies such as the
-	 * React integration strategy when they rewrite browser bundles. The registry
-	 * stays generic so the same mappings can support broader import-map-style
-	 * runtime features later without moving integration semantics into core.
-	 */
-	public registerSpecifierMap(map: Record<string, string>): void {
-		this.runtimeSpecifierRegistry.register(map);
-	}
-
 	public async buildRuntime(): Promise<void> {
 		const runtimeSource = path.resolve(import.meta.dirname, '../../hmr/client/hmr-runtime.ts');
 
@@ -239,10 +222,6 @@ export class NodeHmrManager implements IHmrManager {
 		return this.watchedFiles;
 	}
 
-	public getSpecifierMap(): Map<string, string> {
-		return this.runtimeSpecifierRegistry.getAll();
-	}
-
 	public getDistDir(): string {
 		return this.distDir;
 	}
@@ -254,7 +233,6 @@ export class NodeHmrManager implements IHmrManager {
 	public getDefaultContext(): DefaultHmrContext {
 		return {
 			getWatchedFiles: () => this.watchedFiles,
-			getSpecifierMap: () => this.runtimeSpecifierRegistry.getAll(),
 			getDistDir: () => this.distDir,
 			getPlugins: () => this.plugins,
 			getSrcDir: () => this.appConfig.absolutePaths.srcDir,
@@ -361,8 +339,8 @@ export class NodeHmrManager implements IHmrManager {
 	 * @remarks
 	 * The manager intentionally does not remove emitted `_hmr` files from disk
 	 * because multiple app processes may share the same dist directory during test
-	 * runs. It does clear in-memory indexes so old entrypoints, dependencies, and
-	 * specifier maps cannot leak across a reused manager instance.
+	 * runs. It does clear in-memory indexes so old entrypoints and dependencies
+	 * cannot leak across a reused manager instance.
 	 */
 	public stop() {
 		this.entrypointRegistrations.clear();
@@ -371,7 +349,6 @@ export class NodeHmrManager implements IHmrManager {
 		}
 		this.watchers.clear();
 		this.watchedFiles.clear();
-		this.runtimeSpecifierRegistry.clear();
 		this.entrypointDependencyGraph.reset();
 		this.plugins = [];
 	}

package/src/adapters/shared/explicit-static-render-preparation.ts

@@ -0,0 +1,58 @@
+import type { EcoPagesAppConfig } from '../../types/internal-types.ts';
+import type { EcoFunctionComponent, EcoPageComponent } from '../../types/public-types.ts';
+import type { ExplicitViewRenderer, ExplicitViewRendererResolver } from '../../route-renderer/route-renderer.ts';
+
+type ExplicitStaticRenderPreparationResult = {
+	renderer: ExplicitViewRenderer;
+	props: Record<string, unknown>;
+	view: EcoFunctionComponent<Record<string, unknown>, any>;
+};
+
+function getViewIntegrationName(view: {
+	config?: { integration?: string; __eco?: { integration?: string } };
+}): string | undefined {
+	return view.config?.integration ?? view.config?.__eco?.integration;
+}
+
+/**
+ * Resolves the renderer and static props needed to render one explicit static
+ * view at runtime or during static generation.
+ */
+export async function prepareExplicitStaticRender(input: {
+	routePath: string;
+	view: EcoPageComponent<any>;
+	params: Record<string, string | string[]>;
+	appConfig: EcoPagesAppConfig;
+	runtimeOrigin: string;
+	routeRendererFactory: ExplicitViewRendererResolver;
+	errors: {
+		missingIntegration(routePath: string): string;
+		noRendererForIntegration(integrationName: string): string;
+	};
+}): Promise<ExplicitStaticRenderPreparationResult> {
+	const integrationName = getViewIntegrationName(input.view);
+	if (!integrationName) {
+		throw new Error(input.errors.missingIntegration(input.routePath));
+	}
+
+	const renderer = input.routeRendererFactory.getExplicitViewRenderer(integrationName);
+	if (!renderer) {
+		throw new Error(input.errors.noRendererForIntegration(integrationName));
+	}
+
+	const props = input.view.staticProps
+		? (
+				await input.view.staticProps({
+					pathname: { params: input.params },
+					appConfig: input.appConfig,
+					runtimeOrigin: input.runtimeOrigin,
+				})
+			).props
+		: {};
+
+	return {
+		renderer,
+		props,
+		view: input.view as EcoFunctionComponent<Record<string, unknown>, any>,
+	};
+}

package/src/adapters/shared/explicit-static-route-matcher.test.ts

@@ -246,7 +246,7 @@ describe('ExplicitStaticRouteMatcher', () => {
 			const matcher = new ExplicitStaticRouteMatcher({
 				appConfig: { baseUrl: 'http://localhost:3000' } as any,
 				routeRendererFactory: {
-					getRendererByIntegration: vi.fn(() => ({
+					getExplicitViewRenderer: vi.fn(() => ({
 						renderToResponse,
 					})),
 				} as any,
@@ -269,7 +269,7 @@ describe('ExplicitStaticRouteMatcher', () => {
 			const matcher = new ExplicitStaticRouteMatcher({
 				appConfig: { baseUrl: 'http://localhost:3000' } as any,
 				routeRendererFactory: {
-					getRendererByIntegration: vi.fn(() => null),
+					getExplicitViewRenderer: vi.fn(() => null),
 				} as any,
 				staticRoutes: [createMockRoute('/about', viewWithoutIntegration)],
 			});
@@ -282,7 +282,7 @@ describe('ExplicitStaticRouteMatcher', () => {
 		test('should throw error when renderer is not found', async () => {
 			const view = createMockView('nonexistent-integration');
 			const RendererFactory = {
-				getRendererByIntegration: vi.fn(() => null),
+				getExplicitViewRenderer: vi.fn(() => null),
 			};
 
 			const matcher = new ExplicitStaticRouteMatcher({
@@ -303,7 +303,7 @@ describe('ExplicitStaticRouteMatcher', () => {
 			const mockResponse = new Response('<html>Test</html>');
 			const RenderToResponse = vi.fn(() => mockResponse);
 			const RendererFactory = {
-				getRendererByIntegration: vi.fn(() => ({
+				getExplicitViewRenderer: vi.fn(() => ({
 					renderToResponse: RenderToResponse,
 				})),
 			};
@@ -331,7 +331,7 @@ describe('ExplicitStaticRouteMatcher', () => {
 			const mockResponse = new Response('<html>Test</html>');
 			const RenderToResponse = vi.fn(() => mockResponse);
 			const RendererFactory = {
-				getRendererByIntegration: vi.fn(() => ({
+				getExplicitViewRenderer: vi.fn(() => ({
 					renderToResponse: RenderToResponse,
 				})),
 			};
@@ -357,7 +357,7 @@ describe('ExplicitStaticRouteMatcher', () => {
 
 			const mockResponse = new Response('<html>Test</html>');
 			const RendererFactory = {
-				getRendererByIntegration: vi.fn(() => ({
+				getExplicitViewRenderer: vi.fn(() => ({
 					renderToResponse: vi.fn(() => mockResponse),
 				})),
 			};