@ecopages/core 0.2.0-beta.38 → 0.2.0-beta.39

package/README.md

@@ -18,6 +18,7 @@ The current core package is organized around app-owned runtime state and explici
 The important ownership rules are:
 
 - `ConfigBuilder.build()` finalizes app-owned build and runtime services.
+- Component identity attribution is one shared source transform for server, browser, and HMR compilation paths: after a lexical `eco.` gate, it uses Oxc to wrap supported factory options with `bindComponentIdentity()`, which factories retain as `config.identity`.
 - browser bundling and server module loading are explicit, separate paths.
 - runtime hosts stay thin and delegate framework work into core services.
 - HMR and invalidation use shared graph-aware services instead of runtime-specific ad hoc wiring.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/core",
-  "version": "0.2.0-beta.38",
+  "version": "0.2.0-beta.39",
   "description": "Core package for Ecopages",
   "keywords": [
     "ecopages",
@@ -17,7 +17,7 @@
     "directory": "packages/core"
   },
   "dependencies": {
-    "@ecopages/file-system": "0.2.0-beta.38",
+    "@ecopages/file-system": "0.2.0-beta.39",
     "@ecopages/logger": "^0.2.3",
     "@ecopages/scripts-injector": "^0.1.5",
     "@oxc-project/runtime": "0.141.0",
@@ -32,7 +32,7 @@
     "@standard-schema/utils": "^0.3.0"
   },
   "peerDependencies": {
-    "@ecopages/dev-toolbar": "0.2.0-beta.38"
+    "@ecopages/dev-toolbar": "0.2.0-beta.39"
   },
   "peerDependenciesMeta": {
     "@ecopages/dev-toolbar": {
@@ -143,6 +143,10 @@
       "types": "./src/diagnostics/startup-trace.d.ts",
       "default": "./src/diagnostics/startup-trace.js"
     },
+    "./diagnostics/request-pipeline-metrics": {
+      "types": "./src/diagnostics/request-pipeline-metrics.d.ts",
+      "default": "./src/diagnostics/request-pipeline-metrics.js"
+    },
     "./bun": {
       "types": "./src/adapters/bun/index.d.ts",
       "default": "./src/adapters/bun/index.js"
@@ -227,6 +231,14 @@
       "types": "./src/build/contracts/build-contracts.d.ts",
       "default": "./src/build/contracts/build-contracts.js"
     },
+    "./build/contracts/content-virtual-modules": {
+      "types": "./src/build/contracts/content-virtual-modules.d.ts",
+      "default": "./src/build/contracts/content-virtual-modules.js"
+    },
+    "./services/module-loading/collection-server-module-build.service": {
+      "types": "./src/services/module-loading/collection-server-module-build.service.d.ts",
+      "default": "./src/services/module-loading/collection-server-module-build.service.js"
+    },
     "./build/production-build-cache": {
       "types": "./src/build/cache/production-build-cache.d.ts",
       "default": "./src/build/cache/production-build-cache.js"
@@ -424,6 +436,10 @@
       "types": "./src/diagnostics/startup-trace.d.ts",
       "default": "./src/diagnostics/startup-trace.js"
     },
+    "./diagnostics/request-pipeline-metrics.ts": {
+      "types": "./src/diagnostics/request-pipeline-metrics.d.ts",
+      "default": "./src/diagnostics/request-pipeline-metrics.js"
+    },
     "./bun.ts": {
       "types": "./src/adapters/bun/index.d.ts",
       "default": "./src/adapters/bun/index.js"
@@ -508,6 +524,14 @@
       "types": "./src/build/contracts/build-contracts.d.ts",
       "default": "./src/build/contracts/build-contracts.js"
     },
+    "./build/contracts/content-virtual-modules.ts": {
+      "types": "./src/build/contracts/content-virtual-modules.d.ts",
+      "default": "./src/build/contracts/content-virtual-modules.js"
+    },
+    "./services/module-loading/collection-server-module-build.service.ts": {
+      "types": "./src/services/module-loading/collection-server-module-build.service.d.ts",
+      "default": "./src/services/module-loading/collection-server-module-build.service.js"
+    },
     "./build/production-build-cache.ts": {
       "types": "./src/build/cache/production-build-cache.d.ts",
       "default": "./src/build/cache/production-build-cache.js"

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

@@ -468,6 +468,7 @@ export class BunServerAdapter extends SharedServerAdapter {
                 appConfig: this.appConfig,
                 runtimeOrigin: this.runtimeOrigin,
             });
+            await this.startDevStaticRoutePrewarmWhenReady();
         }
         this.fullyInitialized = true;
         if (this.options?.watch)

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

@@ -314,6 +314,7 @@ export class NodeServerAdapter extends SharedServerAdapter {
                 runtimeOrigin: this.runtimeOrigin,
             });
             this.configureSharedResponseHandlers(this.staticRoutes, this.hmrManager);
+            await this.startDevStaticRoutePrewarmWhenReady();
             const watcher = new ProjectWatcher({
                 config: this.appConfig,
                 refreshRouterRoutesCallback: this.createSharedWatchRefreshCallback({

package/src/adapters/shared/http/explicit-static-render-preparation.js

@@ -1,5 +1,5 @@
 function getViewIntegrationName(view) {
-    return view.config?.integration ?? view.config?.__eco?.integration;
+    return view.config?.integration ?? view.config?.identity?.integration;
 }
 /**
  * Resolves the renderer and static props needed to render one explicit static

package/src/adapters/shared/http/explicit-static-route-matcher.js

@@ -2,7 +2,7 @@ import { appLogger } from '../../../global/app-logger.js';
 import { prepareExplicitStaticRender } from './explicit-static-render-preparation.js';
 import { matchExplicitStaticPathPattern } from '../../abstract/segment-path-matcher.js';
 export const EXPLICIT_STATIC_ROUTE_MATCHER_ERRORS = {
-    missingIntegration: (routePath) => `View at ${routePath} is missing __eco.integration. Ensure it's defined with eco.page() and exported as default.`,
+    missingIntegration: (routePath) => `View at ${routePath} is missing component identity integration. Ensure it's defined with eco.page() and exported as default.`,
     noRendererForIntegration: (integrationName) => `No renderer found for integration: ${integrationName}`,
 };
 /**

package/src/adapters/shared/http/fs-server-response-matcher.js

@@ -3,6 +3,7 @@ import { appLogger } from '../../../global/app-logger.js';
 import { PageRequestCacheCoordinator } from '../../../services/cache/page-request-cache-coordinator.service.js';
 import { ServerUtils } from '../../../utils/server-utils.module.js';
 import { FileRouteMiddlewarePipeline } from './file-route-middleware-pipeline.js';
+import { HttpError } from '../../../errors/http-error.js';
 import { LocalsAccessError } from '../../../errors/locals-access-error.js';
 import { isDevelopmentRuntime } from '../../../utils/runtime.js';
 /**
@@ -74,13 +75,18 @@ export class FileSystemResponseMatcher {
             const renderFn = async () => {
                 const result = await routeRenderer.execute({
                     file: executionPlan.pageFilePath,
+                    pageModule: executionPlan.pageModule,
                     params: match.params,
                     query: match.query,
                     locals: executionPlan.localsForRender,
                 });
                 const html = await this.pageRequestCacheCoordinator.bodyToString(result.body);
                 const strategy = result.cacheStrategy ?? this.pageRequestCacheCoordinator.getDefaultCacheStrategy();
-                return { html, strategy };
+                return {
+                    html,
+                    strategy,
+                    sourceDependencyPaths: result.sourceDependencyPaths,
+                };
             };
             const renderResponse = async () => {
                 return this.pageRequestCacheCoordinator.render({
@@ -99,6 +105,9 @@ export class FileSystemResponseMatcher {
             if (error instanceof Response) {
                 return error;
             }
+            if (HttpError.isHttpError(error) && error.status === 404) {
+                return await this.renderCustomNotFoundResponseOrServerError(match.requestedPathname);
+            }
             if (error instanceof LocalsAccessError) {
                 return await this.createInternalServerErrorResponse(error.message, match.requestedPathname, error);
             }
@@ -211,13 +220,14 @@ export class FileSystemResponseMatcher {
         const localsStore = {};
         const pageFilePath = match.templateRoute.filePath;
         const pageModule = await this.importPageModule(pageFilePath);
-        const Page = pageModule?.default;
-        const pageMiddleware = (Page?.middleware ?? []);
-        const pageCacheStrategy = Page?.cache ?? this.pageRequestCacheCoordinator.getDefaultCacheStrategy();
+        const pageComponent = pageModule.default;
+        const pageMiddleware = pageComponent.middleware ?? [];
+        const pageCacheStrategy = pageModule.cache ?? pageComponent.cache ?? this.pageRequestCacheCoordinator.getDefaultCacheStrategy();
         return {
             cacheKey,
             request: resolvedRequest,
             pageFilePath,
+            pageModule,
             pageMiddleware,
             pageCacheStrategy,
             localsStore,
@@ -237,9 +247,7 @@ export class FileSystemResponseMatcher {
      */
     async importPageModule(filePath) {
         const routeRenderer = this.routeRendererFactory.getPageRenderer(filePath);
-        return routeRenderer.loadPageModule(filePath, {
-            cacheScope: 'request-metadata',
-        });
+        return routeRenderer.loadPageModule(filePath);
     }
     /**
      * Get the underlying cache service for external invalidation.

package/src/adapters/shared/runtime/collect-dev-prewarm-plan.d.ts

@@ -0,0 +1,11 @@
+import type { EcoPagesAppConfig } from '../../../types/internal-types.js';
+import type { DevPrewarmReadiness } from './dev-static-route-prewarm.js';
+export type DevPrewarmPlan = {
+    pathnames: readonly string[];
+    beforeReadyPathnames: readonly string[];
+    readiness: DevPrewarmReadiness;
+};
+/**
+ * Aggregates processor-declared dev prewarm pathnames and readiness into one plan.
+ */
+export declare function collectAppDevPrewarmPlan(appConfig: EcoPagesAppConfig): Promise<DevPrewarmPlan>;

package/src/adapters/shared/runtime/collect-dev-prewarm-plan.js

@@ -0,0 +1,29 @@
+/**
+ * Aggregates processor-declared dev prewarm pathnames and readiness into one plan.
+ */
+export async function collectAppDevPrewarmPlan(appConfig) {
+    const pathnames = new Set(appConfig.devPrewarmPaths ?? []);
+    const beforeReadyPathnames = new Set(appConfig.devPrewarmBeforeReadyPaths ?? []);
+    let readiness = 'background';
+    for (const processor of appConfig.processors.values()) {
+        const contributor = processor;
+        const plan = await contributor.collectDevPrewarmPlan();
+        for (const pathname of plan.pathnames) {
+            pathnames.add(pathname);
+        }
+        if (plan.readiness === 'beforeReady') {
+            readiness = 'beforeReady';
+            for (const pathname of plan.pathnames) {
+                beforeReadyPathnames.add(pathname);
+            }
+        }
+    }
+    for (const pathname of beforeReadyPathnames) {
+        pathnames.add(pathname);
+    }
+    return {
+        pathnames: [...pathnames],
+        beforeReadyPathnames: [...beforeReadyPathnames],
+        readiness,
+    };
+}

package/src/adapters/shared/runtime/dev-static-route-prewarm.d.ts

@@ -0,0 +1,16 @@
+export type DevPrewarmReadiness = 'background' | 'beforeReady';
+export type DevStaticRoutePrewarmOptions = {
+    pathnames: readonly string[];
+    readiness?: DevPrewarmReadiness;
+    renderPath: (pathname: string) => Promise<void>;
+    /** Invoked with the pathname list before rendering begins. */
+    onPathnamesResolved?: (pathnames: readonly string[]) => void;
+};
+/**
+ * Renders declared pathnames so first client navigations hit warm graphs and scoped watch HTML cache.
+ */
+export declare function runDevStaticRoutePrewarm(options: DevStaticRoutePrewarmOptions): Promise<void>;
+/**
+ * Fire-and-forget wrapper around {@link runDevStaticRoutePrewarm}.
+ */
+export declare function startDevStaticRoutePrewarm(options: DevStaticRoutePrewarmOptions): void;

package/src/adapters/shared/runtime/dev-static-route-prewarm.js

@@ -0,0 +1,66 @@
+import { appLogger } from '../../../global/app-logger.js';
+const LOG_PREFIX = '[ecopages:dev-prewarm]';
+function resolvePrewarmConcurrency() {
+    const fromEnv = process.env.ECOPAGES_DEV_PREWARM_STATIC_ROUTES_PARALLELISM;
+    if (fromEnv) {
+        const parsed = Number(fromEnv);
+        if (Number.isFinite(parsed) && parsed > 0) {
+            return Math.floor(parsed);
+        }
+    }
+    return 3;
+}
+async function runWithConcurrency(items, concurrency, worker) {
+    if (items.length === 0) {
+        return;
+    }
+    let index = 0;
+    const runners = Array.from({ length: Math.min(concurrency, items.length) }, async () => {
+        while (index < items.length) {
+            const current = items[index];
+            index += 1;
+            if (current === undefined) {
+                continue;
+            }
+            await worker(current);
+        }
+    });
+    await Promise.all(runners);
+}
+/**
+ * Renders declared pathnames so first client navigations hit warm graphs and scoped watch HTML cache.
+ */
+export async function runDevStaticRoutePrewarm(options) {
+    const pathnames = [...new Set(options.pathnames)];
+    if (pathnames.length === 0) {
+        return;
+    }
+    options.onPathnamesResolved?.(pathnames);
+    const concurrency = resolvePrewarmConcurrency();
+    const readiness = options.readiness ?? 'background';
+    appLogger.debug(`${LOG_PREFIX} started (${pathnames.length} path(s), concurrency ${concurrency}, readiness=${readiness})`);
+    appLogger.debug(`${LOG_PREFIX} pathnames: ${pathnames.join(', ')}`);
+    await runWithConcurrency(pathnames, concurrency, async (pathname) => {
+        try {
+            await options.renderPath(pathname);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (readiness === 'beforeReady') {
+                appLogger.warn(`${LOG_PREFIX} skipped ${pathname}: ${message}`);
+            }
+            else {
+                appLogger.debug(`${LOG_PREFIX} skipped ${pathname}: ${message}`);
+            }
+        }
+    });
+    appLogger.debug(`${LOG_PREFIX} finished (${pathnames.length} path(s))`);
+}
+/**
+ * Fire-and-forget wrapper around {@link runDevStaticRoutePrewarm}.
+ */
+export function startDevStaticRoutePrewarm(options) {
+    void runDevStaticRoutePrewarm(options).catch((error) => {
+        appLogger.error(`${LOG_PREFIX} failed: ${error instanceof Error ? error.message : String(error)}`);
+    });
+}

package/src/adapters/shared/runtime/render-context.js

@@ -34,7 +34,7 @@ export function createRenderContext(options) {
      * Throws an error if the integration cannot be determined or is not found.
      */
     const getRendererForView = (view) => {
-        const integrationName = view.config?.integration ?? view.config?.__eco?.integration;
+        const integrationName = view.config?.integration ?? view.config?.identity?.integration;
         invariant(!!integrationName, 'Cannot determine integration for view. Set view.config.integration explicitly or ensure the view is defined with eco.page() in a file with a recognized extension.');
         const integration = integrations.find((i) => i.name === integrationName);
         invariant(!!integration, `No integration found for: ${integrationName}`);

package/src/adapters/shared/runtime/server-adapter.d.ts

@@ -26,6 +26,12 @@ export declare abstract class SharedServerAdapter<TOptions extends ServerAdapter
     protected schemaValidator: SchemaValidationService;
     protected readonly apiRequestPipeline: ApiRequestPipeline<Request, unknown>;
     protected hostOwnsDevClient: boolean;
+    private devStaticRoutePrewarmStarted;
+    private sharedPageCacheService;
+    /**
+     * Warms declared static paths after the final watch-mode response pipeline exists.
+     */
+    protected startDevStaticRoutePrewarmWhenReady(): Promise<void>;
     protected initializeSharedRouteHandling(options: {
         staticRoutes: StaticRoute[];
         hmrManager?: SharedHmrAssetManager;
@@ -60,7 +66,7 @@ export declare abstract class SharedServerAdapter<TOptions extends ServerAdapter
      */
     protected configureSharedResponseHandlers(staticRoutes: StaticRoute[], hmrManager?: IHmrManager): void;
     private createSharedResponseHandlerDependencies;
-    private createSharedPageCacheService;
+    private getOrCreateSharedPageCacheService;
     protected getCacheService(): CacheInvalidator | null;
     protected getRenderContext(): RenderContext;
     private tryHandleSharedDevClientRequest;

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

@@ -5,7 +5,7 @@ import { RouteRegistry } from '../../../router/server/route-registry.js';
 import { startupTrace } from '../../../diagnostics/startup-trace.js';
 import { requestBuildDedupe } from '../../../diagnostics/request-build-dedupe.js';
 import { MemoryCacheStore } from '../../../services/cache/memory-cache-store.js';
-import { PageCacheService } from '../../../services/cache/page-cache-service.js';
+import { PageCacheService, registerAppPageCacheService } from '../../../services/cache/page-cache-service.js';
 import { SchemaValidationService } from '../../../services/validation/schema-validation-service.js';
 import { StaticSiteGenerator } from '../../../static-site-generator/static-site-generator.js';
 import { ServerStaticBuilder } from './server-static-builder.js';
@@ -13,6 +13,8 @@ import { ExplicitStaticRouteMatcher } from '../http/explicit-static-route-matche
 import { FileSystemServerResponseFactory } from '../http/fs-server-response-factory.js';
 import { FileSystemResponseMatcher } from '../http/fs-server-response-matcher.js';
 import { ServerRouteHandler } from './server-route-handler.js';
+import { startDevStaticRoutePrewarm, runDevStaticRoutePrewarm } from './dev-static-route-prewarm.js';
+import { collectAppDevPrewarmPlan } from './collect-dev-prewarm-plan.js';
 import { createRenderContext } from './render-context.js';
 import { ApiRequestPipeline } from '../http/api-request-pipeline.js';
 import { injectDevToolbarIntoHtmlResponse, shouldInjectDevToolbarHtmlResponse, } from '../../../dev-toolbar/dev-toolbar-html-response.js';
@@ -33,6 +35,40 @@ export class SharedServerAdapter extends AbstractServerAdapter {
         getCacheService: () => this.getCacheService(),
     });
     hostOwnsDevClient = false;
+    devStaticRoutePrewarmStarted = false;
+    sharedPageCacheService;
+    /**
+     * Warms declared static paths after the final watch-mode response pipeline exists.
+     */
+    async startDevStaticRoutePrewarmWhenReady() {
+        if (!this.options?.watch || this.devStaticRoutePrewarmStarted) {
+            return;
+        }
+        this.devStaticRoutePrewarmStarted = true;
+        const runtimeOrigin = this.runtimeOrigin;
+        const plan = await collectAppDevPrewarmPlan(this.appConfig);
+        const beforeReadyPathnames = new Set(plan.beforeReadyPathnames);
+        const allPathnames = plan.pathnames;
+        const options = {
+            pathnames: allPathnames,
+            readiness: 'background',
+            renderPath: async (pathname) => {
+                const response = await this.routeHandler.handleResponse(new Request(new URL(pathname, runtimeOrigin).toString(), { method: 'GET' }));
+                await response.arrayBuffer();
+            },
+        };
+        if (beforeReadyPathnames.size > 0) {
+            await runDevStaticRoutePrewarm({
+                ...options,
+                pathnames: [...beforeReadyPathnames],
+                readiness: 'beforeReady',
+            });
+        }
+        const backgroundPathnames = allPathnames.filter((pathname) => !beforeReadyPathnames.has(pathname));
+        if (backgroundPathnames.length > 0) {
+            startDevStaticRoutePrewarm({ ...options, pathnames: backgroundPathnames });
+        }
+    }
     async initializeSharedRouteHandling(options) {
         this.ensureRouteRendererFactory();
         await this.initSharedRouter();
@@ -132,7 +168,7 @@ export class SharedServerAdapter extends AbstractServerAdapter {
                 watchMode: !!this.options?.watch,
             },
         });
-        const cacheService = this.createSharedPageCacheService();
+        const cacheService = this.getOrCreateSharedPageCacheService();
         const fileSystemResponseMatcher = new FileSystemResponseMatcher({
             appConfig: this.appConfig,
             assetPrefix: path.join(this.appConfig.rootDir, this.appConfig.distDir),
@@ -154,16 +190,39 @@ export class SharedServerAdapter extends AbstractServerAdapter {
                 : undefined,
         };
     }
-    createSharedPageCacheService() {
+    getOrCreateSharedPageCacheService() {
+        if (this.sharedPageCacheService !== undefined) {
+            return this.sharedPageCacheService;
+        }
         const cacheConfig = this.appConfig.cache;
-        const isCacheEnabled = cacheConfig?.enabled ?? !this.options?.watch;
+        const watch = Boolean(this.options?.watch);
+        if (watch) {
+            if (cacheConfig?.enabled === false) {
+                this.sharedPageCacheService = null;
+                registerAppPageCacheService(this.appConfig, null);
+                return null;
+            }
+            const store = cacheConfig?.store === 'memory' || !cacheConfig?.store
+                ? new MemoryCacheStore({ maxEntries: cacheConfig?.maxEntries })
+                : cacheConfig.store;
+            const service = new PageCacheService({ store, enabled: true });
+            this.sharedPageCacheService = service;
+            registerAppPageCacheService(this.appConfig, service);
+            return service;
+        }
+        const isCacheEnabled = cacheConfig?.enabled ?? true;
         if (!isCacheEnabled) {
+            this.sharedPageCacheService = null;
+            registerAppPageCacheService(this.appConfig, null);
             return null;
         }
         const store = cacheConfig?.store === 'memory' || !cacheConfig?.store
             ? new MemoryCacheStore({ maxEntries: cacheConfig?.maxEntries })
             : cacheConfig.store;
-        return new PageCacheService({ store, enabled: true });
+        const service = new PageCacheService({ store, enabled: true });
+        this.sharedPageCacheService = service;
+        registerAppPageCacheService(this.appConfig, service);
+        return service;
     }
     getCacheService() {
         return this.fileSystemResponseMatcher?.getCacheService() ?? null;

package/src/build/README.md

@@ -201,7 +201,7 @@ Mixed-integration apps need explicit `@jsxImportSource` handling in two differen
 | ------------------------------------ | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
 | `getJsxOwnershipPlugins()`           | App-wide server/transpile builds          | Each JSX integration extension gets its **own** `jsxImportSource` so native files keep their owning runtime.            |
 | `getHostScopedJsxOwnershipPlugins()` | One integration's **client** bundle graph | Foreign `.tsx`/`.jsx` files compile with the **host** integration JSX runtime (for example React bundling `.kita.tsx`). |
-| `eco-component-meta-plugin`          | Component metadata injection              | Prepends the **owning** integration pragma only when injecting `__eco` metadata into native files.                      |
+| component identity source transform  | Component identity attribution            | Prepends the **owning** integration pragma when injecting `identity` into native files.                                 |
 
 `foreign-jsx-override-plugin.ts` is the shared implementation. Prefer the helpers above instead of calling it directly from integrations.
 

package/src/build/browser/browser-runtime-plugin.js

@@ -21,7 +21,7 @@
  */
 import path from 'node:path';
 import { existsSync, readFileSync } from 'node:fs';
-import { cachedParseSync } from '../../cache/module-parse-cache.js';
+import { parseModuleSource } from '../../cache/module-parse-cache.js';
 import { getBrowserRuntimeSpecifierMap } from './browser-runtime-manifest.js';
 import { buildSpecifierFilter } from './browser-runtime-plugin-helpers.js';
 /**
@@ -80,10 +80,7 @@ export function rewriteBrowserRuntimeImports(code, specifierMap, filePath = 'bro
     }
     const edits = [];
     try {
-        const result = cachedParseSync(filePath, code, {
-            sourceType: 'module',
-            lang: path.extname(filePath).endsWith('x') ? 'tsx' : 'ts',
-        });
+        const result = parseModuleSource(filePath, code);
         const walk = (node) => {
             if (!isRecord(node)) {
                 return;

package/src/build/cache/production-build-cache.d.ts

@@ -3,7 +3,8 @@ import type { EcoPagesAppConfig } from '../../types/internal-types.js';
  * Shared manifest fields for persisted production build caches.
  */
 export interface ProductionCacheManifestBase {
-    invalidationVersion: string;
+    invalidationVersion?: string;
+    corePackageVersion?: string;
     buildInputsFingerprint?: string;
     buildKey?: string;
     builtAt?: number;
@@ -15,6 +16,6 @@ export declare function getProductionBuildCacheManifestPaths(appConfig: EcoPages
 export declare function clearPersistedProductionBuildCacheManifests(appConfig: EcoPagesAppConfig): void;
 export declare function readProductionCacheManifest<T extends ProductionCacheManifestBase>(manifestPath: string): T | undefined;
 export declare function writeProductionCacheManifest(manifestPath: string, manifest: unknown): void;
-export declare function isProductionCacheManifestCurrent(manifest: ProductionCacheManifestBase | undefined, invalidationVersion: string): boolean;
+export declare function isProductionCacheManifestCurrent(manifest: ProductionCacheManifestBase | undefined, packageVersion: string): boolean;
 export declare function matchesProductionCacheFingerprint(manifest: ProductionCacheManifestBase | undefined, buildInputsFingerprint: string): boolean;
 export declare function matchesProductionCacheBuildKey(manifest: ProductionCacheManifestBase | undefined, buildKey: string): boolean;

package/src/build/cache/production-build-cache.js

@@ -45,8 +45,8 @@ export function writeProductionCacheManifest(manifestPath, manifest) {
     fileSystem.ensureDir(path.dirname(manifestPath));
     fileSystem.write(manifestPath, `${JSON.stringify(manifest, null, '\t')}\n`);
 }
-export function isProductionCacheManifestCurrent(manifest, invalidationVersion) {
-    return manifest?.invalidationVersion === invalidationVersion;
+export function isProductionCacheManifestCurrent(manifest, packageVersion) {
+    return (manifest?.corePackageVersion ?? manifest?.invalidationVersion) === packageVersion;
 }
 export function matchesProductionCacheFingerprint(manifest, buildInputsFingerprint) {
     return manifest?.buildInputsFingerprint === buildInputsFingerprint;

package/src/build/contracts/content-virtual-modules.d.ts

@@ -0,0 +1,12 @@
+/** Virtual module prefix for collection imports, e.g. `ecopages:content/docs`. */
+export declare const CONTENT_VIRTUAL_MODULE_PREFIX = "ecopages:content";
+/** Matches `ecopages:content/<collection>` metadata specifiers (no MDX imports). */
+export declare const CONTENT_VIRTUAL_MODULE_PATTERN: RegExp;
+/** Matches `ecopages:content/<collection>/server` component resolver specifiers. */
+export declare const CONTENT_SERVER_VIRTUAL_MODULE_PATTERN: RegExp;
+export type ParsedCollectionSpecifier = {
+    collectionName: string;
+    variant: 'entries' | 'server';
+};
+export declare function parseCollectionSpecifier(specifier: string): ParsedCollectionSpecifier | null;
+export declare function isContentServerVirtualModule(specifier: string): boolean;

package/src/build/contracts/content-virtual-modules.js

@@ -0,0 +1,29 @@
+/** Virtual module prefix for collection imports, e.g. `ecopages:content/docs`. */
+export const CONTENT_VIRTUAL_MODULE_PREFIX = 'ecopages:content';
+/** Matches `ecopages:content/<collection>` metadata specifiers (no MDX imports). */
+export const CONTENT_VIRTUAL_MODULE_PATTERN = /^ecopages:content\/[a-z][a-z0-9-]*$/;
+/** Matches `ecopages:content/<collection>/server` component resolver specifiers. */
+export const CONTENT_SERVER_VIRTUAL_MODULE_PATTERN = /^ecopages:content\/[a-z][a-z0-9-]+\/server$/;
+export function parseCollectionSpecifier(specifier) {
+    const normalized = specifier.startsWith(`${CONTENT_VIRTUAL_MODULE_PREFIX}/`)
+        ? specifier.slice(`${CONTENT_VIRTUAL_MODULE_PREFIX}/`.length)
+        : specifier.startsWith('content/')
+            ? specifier.slice('content/'.length)
+            : null;
+    if (!normalized) {
+        return null;
+    }
+    if (normalized.endsWith('/server')) {
+        return {
+            collectionName: normalized.slice(0, -'/server'.length),
+            variant: 'server',
+        };
+    }
+    return {
+        collectionName: normalized,
+        variant: 'entries',
+    };
+}
+export function isContentServerVirtualModule(specifier) {
+    return CONTENT_SERVER_VIRTUAL_MODULE_PATTERN.test(specifier);
+}

package/src/build/rolldown/rolldown-adapter-helpers.js

@@ -307,7 +307,7 @@ export function resolveRolldownOptions(options, contextRoot, outdir, appRootRequ
         transformOptions.target = options.target;
     }
     const bundlePlugins = options.plugins ?? [];
-    const sourceTransforms = options.target === 'browser' ? (options.sourceTransforms ?? []) : [];
+    const sourceTransforms = options.sourceTransforms ?? [];
     const appPlugins = createRolldownPluginBridge(bundlePlugins, contextRoot, sourceTransforms);
     const allPlugins = [
         ...(rolldownPlatform === 'node' ? [createNodeBuiltinExternalPlugin()] : []),

package/src/build/runtime/build-request-policy.d.ts

@@ -7,7 +7,7 @@ import type { BuildProfile } from './build-runtime.js';
  *
  * @remarks
  * Always goes through {@link getAppServerBuildPlugins} so sealed-manifest and
- * loader-fallback apps share one plugin list with the alias resolver. Used by
+ * source-transform apps share one plugin list with the alias resolver. Used by
  * both request assembly and unified-graph cache keys.
  */
 export declare function resolveServerAppBuildPlugins(appConfig: EcoPagesAppConfig): EcoBuildPlugin[];
@@ -36,9 +36,8 @@ export type BrowserBuildRequestInput = Partial<BuildOptions> & {
  * @remarks
  * Defaults `profile` to `'route-module'`. Plugins are
  * {@link resolveServerAppBuildPlugins} plus unique caller contributions via
- * {@link mergeCallerBuildPlugins}. Does not attach `sourceTransforms` — unlike
- * {@link createBrowserBuildRequest}. Pass the returned options into
- * {@link BuildRuntime.getProfile}; the runtime no longer injects plugins.
+ * {@link mergeCallerBuildPlugins}. Source transforms are applied on every
+ * compilation target, so server module loading shares browser attribution.
  */
 export declare function createServerBuildRequest(appConfig: EcoPagesAppConfig, input: ServerBuildRequestInput): BuildOptions;
 /**

package/src/build/runtime/build-request-policy.js

@@ -7,7 +7,7 @@ import { getAppSourceTransforms } from '../../plugins/source-transform.js';
  *
  * @remarks
  * Always goes through {@link getAppServerBuildPlugins} so sealed-manifest and
- * loader-fallback apps share one plugin list with the alias resolver. Used by
+ * source-transform apps share one plugin list with the alias resolver. Used by
  * both request assembly and unified-graph cache keys.
  */
 export function resolveServerAppBuildPlugins(appConfig) {
@@ -36,9 +36,8 @@ export function mergeCallerBuildPlugins(appPlugins, callerPlugins) {
  * @remarks
  * Defaults `profile` to `'route-module'`. Plugins are
  * {@link resolveServerAppBuildPlugins} plus unique caller contributions via
- * {@link mergeCallerBuildPlugins}. Does not attach `sourceTransforms` — unlike
- * {@link createBrowserBuildRequest}. Pass the returned options into
- * {@link BuildRuntime.getProfile}; the runtime no longer injects plugins.
+ * {@link mergeCallerBuildPlugins}. Source transforms are applied on every
+ * compilation target, so server module loading shares browser attribution.
  */
 export function createServerBuildRequest(appConfig, input) {
     const profile = input.profile ?? 'route-module';
@@ -49,6 +48,7 @@ export function createServerBuildRequest(appConfig, input) {
         ...overrides,
         entrypoints: input.entrypoints,
         ...(plugins.length > 0 ? { plugins } : {}),
+        sourceTransforms: getAppSourceTransforms(appConfig),
     };
 }
 /**

package/src/cache/index.d.ts

@@ -3,4 +3,5 @@
  *
  * @module @ecopages/core/cache
  */
-export { ModuleParseCache, moduleParseCache, cachedParseSync, type ModuleParseOptions } from './module-parse-cache.js';
+export { ModuleParseCache, moduleParseCache, cachedParseSync, parseModuleSource, parserLanguageForFile, type ModuleParseOptions, type ParserLanguage, } from './module-parse-cache.js';
+export { recordModuleTransformProfile } from './module-transform-profiler.js';