veryfront 0.1.1100 → 0.1.1101

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.1100",
+    "version": "0.1.1101",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "minimumDependencyAge": {

package/esm/src/routing/api/context-builder.d.ts

@@ -11,10 +11,32 @@ export interface APIContext {
     cookies: Record<string, string>;
     headers: Headers;
     url: URL;
-    json: (data: unknown, init?: ResponseInit) => Response;
+    /**
+     * Read the request body as JSON, or build a JSON response.
+     *
+     * `ctx.json()` with no arguments parses and returns the request body.
+     * `ctx.json(data, init?)` returns a JSON `Response`.
+     */
+    json: {
+        (): Promise<unknown>;
+        (data: unknown, init?: ResponseInit): Response;
+    };
     text: (data: string, init?: ResponseInit) => Response;
     fs: FileSystemAdapter;
 }
+/**
+ * Build the `ctx.json` helper for a request.
+ *
+ * Overloaded on arity. `ctx.json(data)` builds a response; `ctx.json()` reads
+ * the request body, which is what handlers reach for, and what the zero-arg
+ * form was previously misread as. It used to stringify `undefined` into a
+ * Response, so `await ctx.json()` yielded a Response object that serialised
+ * back out as `{}` and silently dropped every posted payload.
+ *
+ * Exported because the isolation Worker builds its own context and has to
+ * behave identically. Handlers must not care which one ran them.
+ */
+export declare function createJsonHelper(request: Request): APIContext["json"];
 export declare function createContext(request: Request, match: RouteMatch, fs: FileSystemAdapter): APIContext;
 /**
  * @deprecated Use {@link flattenRouteParams} directly. Kept as a thin alias so

package/esm/src/routing/api/context-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../../src/src/routing/api/context-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,QAAQ,CAAC;IACvD,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,QAAQ,CAAC;IACtD,EAAE,EAAE,iBAAiB,CAAC;CACvB;AAgBD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,UAAU,EACjB,EAAE,EAAE,iBAAiB,GACpB,UAAU,CAmBZ;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GACxC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExB"}
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../../src/src/routing/api/context-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,GAAG,CAAC;IACT;;;;;OAKG;IACH,IAAI,EAAE;QACJ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC;KAChD,CAAC;IACF,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,QAAQ,CAAC;IACtD,EAAE,EAAE,iBAAiB,CAAC;CACvB;AAgBD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAUrE;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,UAAU,EACjB,EAAE,EAAE,iBAAiB,GACpB,UAAU,CAmBZ;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GACxC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExB"}

package/esm/src/routing/api/context-builder.js

@@ -10,9 +10,30 @@ function createResponse(body, contentType, init) {
         },
     });
 }
+/**
+ * Build the `ctx.json` helper for a request.
+ *
+ * Overloaded on arity. `ctx.json(data)` builds a response; `ctx.json()` reads
+ * the request body, which is what handlers reach for, and what the zero-arg
+ * form was previously misread as. It used to stringify `undefined` into a
+ * Response, so `await ctx.json()` yielded a Response object that serialised
+ * back out as `{}` and silently dropped every posted payload.
+ *
+ * Exported because the isolation Worker builds its own context and has to
+ * behave identically. Handlers must not care which one ran them.
+ */
+export function createJsonHelper(request) {
+    function json(...args) {
+        if (args.length === 0)
+            return request.json();
+        const [data, init] = args;
+        return createResponse(JSON.stringify(data), "application/json", init);
+    }
+    return json;
+}
 export function createContext(request, match, fs) {
     const url = new URL(request.url);
-    const json = (data, init) => createResponse(JSON.stringify(data), "application/json", init);
+    const json = createJsonHelper(request);
     const text = (data, init) => createResponse(data, "text/plain", init);
     return {
         request,

package/esm/src/routing/api/handler.d.ts

@@ -6,6 +6,17 @@ import { loadHandlerModule } from "./module-loader/loader.js";
 import { discoverAppRoutes, discoverPagesRoutes } from "./route-discovery.js";
 import type { HandlerContext } from "../../types/index.js";
 export type { APIContext, APIRoute };
+/**
+ * Reduce a module load error to something safe to put in a response body.
+ *
+ * The message is worth returning, since it usually names a syntax or import
+ * error the developer can act on. The rest of it is not: a raw load error
+ * carries the temp directory the bundle was written to, absolute paths into the
+ * framework install, and a full stack trace. A path inside the project survives
+ * as a project-relative one, because that is the part that identifies the file
+ * to fix.
+ */
+export declare function sanitizeLoadErrorForResponse(message: string, projectDir?: string): string;
 /**
  * Injection interface for testing APIRouteHandler dependencies
  */
@@ -31,7 +42,6 @@ export declare class APIRouteHandler {
     private projectDir;
     private router;
     private routeCache;
-    private lastErrorMessage;
     private activeRequests;
     private destroyRequested;
     private destroyed;

package/esm/src/routing/api/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/src/routing/api/handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAMlD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAErC;;GAEG;AACH,UAAU,mBAAmB;IAC3B,iBAAiB,CAAC,EAAE,OAAO,iBAAiB,CAAC;IAC7C,mBAAmB,CAAC,EAAE,OAAO,mBAAmB,CAAC;IACjD,iBAAiB,CAAC,EAAE,OAAO,iBAAiB,CAAC;IAC7C,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;CAC9B;AAID;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAE3E;AAWD,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAE3E,qBAAa,eAAe;IAmBxB,OAAO,CAAC,UAAU;IAlBpB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,UAAU,CAA6E;IAC/F,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,cAAc,CAAwC;IAE9D,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,iBAAiB,CAA8B;IAEvD,OAAO,CAAC,MAAM,CAAsD;IACpE,OAAO,CAAC,aAAa,CAA8B;gBAGzC,UAAU,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE,cAAc;IAM1B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgD3B,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IA2FxE,OAAO,CAAC,WAAW;IAuCnB,UAAU,IAAI,IAAI;IAKlB,OAAO,IAAI,IAAI;IAWf,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,UAAU;YAQJ,aAAa;YAsBb,gBAAgB;YAOhB,cAAc;YAcd,YAAY;YAOZ,cAAc;CAW7B;AAED,OAAO,EACL,UAAU,EACV,SAAS,EACT,mBAAmB,IAAI,WAAW,EAClC,YAAY,IAAI,IAAI,EACpB,QAAQ,EACR,gBAAgB,IAAI,QAAQ,EAC5B,YAAY,GACb,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/src/routing/api/handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAMlD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAYrC;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAYzF;AAED;;GAEG;AACH,UAAU,mBAAmB;IAC3B,iBAAiB,CAAC,EAAE,OAAO,iBAAiB,CAAC;IAC7C,mBAAmB,CAAC,EAAE,OAAO,mBAAmB,CAAC;IACjD,iBAAiB,CAAC,EAAE,OAAO,iBAAiB,CAAC;IAC7C,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;CAC9B;AAID;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAE3E;AAWD,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAW3E,qBAAa,eAAe;IAkBxB,OAAO,CAAC,UAAU;IAjBpB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,UAAU,CAA6E;IAC/F,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,cAAc,CAAwC;IAE9D,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,iBAAiB,CAA8B;IAEvD,OAAO,CAAC,MAAM,CAAsD;IACpE,OAAO,CAAC,aAAa,CAA8B;gBAGzC,UAAU,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE,cAAc;IAM1B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgD3B,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAwGxE,OAAO,CAAC,WAAW;IAsCnB,UAAU,IAAI,IAAI;IAKlB,OAAO,IAAI,IAAI;IAWf,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,UAAU;YAQJ,aAAa;YAsBb,gBAAgB;YAOhB,cAAc;YAcd,YAAY;YAOZ,cAAc;CAW7B;AAED,OAAO,EACL,UAAU,EACV,SAAS,EACT,mBAAmB,IAAI,WAAW,EAClC,YAAY,IAAI,IAAI,EACpB,QAAQ,EACR,gBAAgB,IAAI,QAAQ,EAC5B,YAAY,GACb,MAAM,yCAAyC,CAAC"}

package/esm/src/routing/api/handler.js

@@ -12,6 +12,33 @@ import { executeAppRoute, executePagesRoute } from "./route-executor.js";
 import { withSpan } from "../../observability/tracing/otlp-setup.js";
 /** Max entries in the loaded-handler LRU cache */
 const HANDLER_CACHE_MAX_ENTRIES = 256;
+/** Longest sanitised load error a response body carries. */
+const MAX_LOAD_ERROR_LENGTH = 300;
+/**
+ * Roots that only ever identify the machine running the server: home
+ * directories and the temp directories bundling writes to.
+ */
+const MACHINE_PATH_PATTERN = /(?:file:\/\/)?\/(?:private\/)?(?:Users|home|root|var\/folders|var\/tmp|tmp)\/\S*/g;
+/**
+ * Reduce a module load error to something safe to put in a response body.
+ *
+ * The message is worth returning, since it usually names a syntax or import
+ * error the developer can act on. The rest of it is not: a raw load error
+ * carries the temp directory the bundle was written to, absolute paths into the
+ * framework install, and a full stack trace. A path inside the project survives
+ * as a project-relative one, because that is the part that identifies the file
+ * to fix.
+ */
+export function sanitizeLoadErrorForResponse(message, projectDir) {
+    // A stack trace is never the actionable part.
+    let text = (message.split("\n")[0] ?? "").trim();
+    if (projectDir) {
+        const root = projectDir.replace(/\/+$/, "");
+        text = text.replaceAll(`file://${root}/`, "").replaceAll(`${root}/`, "");
+    }
+    text = text.replace(MACHINE_PATH_PATTERN, "<PATH>");
+    return text.length > MAX_LOAD_ERROR_LENGTH ? `${text.slice(0, MAX_LOAD_ERROR_LENGTH)}...` : text;
+}
 let injectedDeps = null;
 /**
  * Inject dependencies for testing. Pass null to reset to defaults.
@@ -31,7 +58,6 @@ export class APIRouteHandler {
     projectDir;
     router = new ApiRouteMatcher();
     routeCache = new LRUCache({ maxEntries: HANDLER_CACHE_MAX_ENTRIES });
-    lastErrorMessage = null;
     activeRequests = 0;
     destroyRequested = false;
     destroyed = false;
@@ -116,18 +142,27 @@ export class APIRouteHandler {
                 page: match.route.page,
                 params: match.params,
             });
-            const handler = await this.loadHandler(match);
+            const { handler, errorMessage } = await this.loadHandler(match);
             if (!handler) {
+                const msg = errorMessage ?? "Handler not found";
                 try {
-                    logger.error(`handler module failed to load: ${match.route.page}`);
+                    // The full detail, paths and all, belongs in the log.
+                    logger.error(`handler module failed to load: ${match.route.page}`, { reason: msg });
                 }
                 catch (e) {
                     logger.warn("API error log failed", e);
                 }
-                const msg = this.lastErrorMessage ?? "Handler not found";
                 if (msg.includes("Remote import blocked by allow-list"))
                     return badGateway(msg);
-                return internalServerError("Handler not found");
+                // The reason the module failed to load is the only useful thing here.
+                // Reporting a flat "Handler not found" for what is usually a syntax or
+                // import error sends people hunting for a routing problem that does
+                // not exist. Local development only, and sanitised: a raw load error
+                // carries temp directories, absolute paths and a stack trace, none of
+                // which belong in a response body.
+                return internalServerError(ctx?.isLocalProject
+                    ? sanitizeLoadErrorForResponse(msg, this.projectDir)
+                    : "Handler not found");
             }
             // App Router routes are always named route.ts/js/tsx/jsx
             // Pages Router routes have descriptive names like articles.ts
@@ -156,7 +191,7 @@ export class APIRouteHandler {
             await this.ensureConfig(adapter);
             const cached = this.routeCache.get(modulePath);
             if (cached)
-                return cached;
+                return { handler: cached, errorMessage: null };
             try {
                 const deps = getDeps();
                 const handler = await deps.loadHandlerModule({
@@ -168,16 +203,15 @@ export class APIRouteHandler {
                 // Only cache handlers that export at least one HTTP method.
                 // Empty objects ({}) from failed imports are truthy but useless —
                 // caching them would prevent retry after the user fixes the import.
-                if (handler && Object.keys(handler).length > 0) {
-                    this.routeCache.set(modulePath, handler);
-                }
-                return handler && Object.keys(handler).length > 0 ? handler : null;
+                const usable = handler && Object.keys(handler).length > 0 ? handler : null;
+                if (usable)
+                    this.routeCache.set(modulePath, usable);
+                return { handler: usable, errorMessage: null };
             }
             catch (error) {
                 const msg = error instanceof Error ? error.message : String(error);
-                this.lastErrorMessage = msg;
                 logger.error(`[API] Failed to load handler for ${modulePath}: ${msg}`);
-                return null;
+                return { handler: null, errorMessage: msg };
             }
         }, { "api.modulePath": modulePath });
     }

package/esm/src/routing/api/module-loader/loader.d.ts

@@ -2,4 +2,9 @@ import type { APIRoute, LoadModuleOptions } from "./types.js";
 export { generateCompiledBinaryRequireShim, getNodeExternalPackagesToResolve, loadVeryfrontExportsMap, resolveEsmUserDependencies, resolveNodePackageToFileUrl, rewriteCompiledBinaryUserDependencyImports, rewriteCompiledBinaryVeryfrontImports, rewriteDenoNodeBuiltinImports, rewriteDenoNpmDependencyImports, rewriteNodeExternalImports, } from "./external-import-rewriter.js";
 export { toCjsDestructureBindings } from "./loader-helpers.js";
 export declare function loadHandlerModule(options: LoadModuleOptions): Promise<APIRoute | null>;
+/**
+ * True when a module failed to load because Deno could not resolve one of its
+ * import specifiers, rather than because the module itself is broken.
+ */
+export declare function isSpecifierResolutionError(error: unknown): boolean;
 //# sourceMappingURL=loader.d.ts.map

package/esm/src/routing/api/module-loader/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../../src/src/routing/api/module-loader/loader.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAkB9D,OAAO,EACL,iCAAiC,EACjC,gCAAgC,EAChC,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,0CAA0C,EAC1C,qCAAqC,EACrC,6BAA6B,EAC7B,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAyBtF"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../../src/src/routing/api/module-loader/loader.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAkB9D,OAAO,EACL,iCAAiC,EACjC,gCAAgC,EAChC,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,0CAA0C,EAC1C,qCAAqC,EACrC,6BAA6B,EAC7B,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAyBtF;AA0DD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIlE"}

package/esm/src/routing/api/module-loader/loader.js

@@ -45,8 +45,25 @@ async function loadModule(args) {
         return loadAndTranspileModule(modulePath, projectDir, adapter, fs, config);
     }
     const fileExistsLocally = await fs.exists(modulePath);
-    if (fileExistsLocally)
-        return loadTSModuleDirect(modulePath);
+    if (fileExistsLocally) {
+        try {
+            return await loadTSModuleDirect(modulePath);
+        }
+        catch (error) {
+            // A direct import shares the dev server's runtime context, which is what
+            // makes auto-discovery (agentRegistry and friends) work — but it leaves
+            // specifier resolution to Deno, which knows nothing about the project's
+            // `@/` alias. Bundling can resolve that import map path, so fall back to
+            // it rather than reporting a routing-shaped 500.
+            if (!isSpecifierResolutionError(error))
+                throw error;
+            logger.debug("Direct import could not resolve a specifier, bundling instead", {
+                modulePath,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return loadAndTranspileModule(modulePath, projectDir, adapter, fs, config);
+        }
+    }
     logger.debug(`File not local, using adapter-based loading: ${modulePath}`);
     return loadAndTranspileModule(modulePath, projectDir, adapter, fs, config);
 }
@@ -55,6 +72,24 @@ async function loadModule(args) {
  * This allows the module to share the same runtime context as the dev server,
  * enabling auto-discovery features like agentRegistry to work.
  */
+/**
+ * Deno's resolver reports an unresolvable import as a TypeError whose message
+ * opens by naming the specifier it could not resolve. Anchoring on that opening
+ * is what keeps a module's own error out: a route that throws
+ * `Error("Cannot find module x")` at evaluation time is broken, and re-running
+ * it under bundling would evaluate broken code a second time.
+ */
+const SPECIFIER_RESOLUTION_MESSAGE = /^(?:Import "[^"]+" not a dependency|Module not found "[^"]+"|Relative import path "[^"]+" not prefixed)/;
+/**
+ * True when a module failed to load because Deno could not resolve one of its
+ * import specifiers, rather than because the module itself is broken.
+ */
+export function isSpecifierResolutionError(error) {
+    // Every other error shape the direct import can produce belongs to the module.
+    if (!(error instanceof TypeError))
+        return false;
+    return SPECIFIER_RESOLUTION_MESSAGE.test(error.message.trimStart());
+}
 function loadTSModuleDirect(modulePath) {
     const cacheBuster = `?v=${Date.now()}`;
     const url = modulePath.startsWith("file://")

package/esm/src/server/dev-server/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../../src/src/server/dev-server/middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM7D,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAEnD,UAAU,qBAAqB;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAkFD,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA6B/B;AAkFD,wBAAsB,eAAe,CACnC,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,eAAe,EACvB,cAAc,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC,CASf"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../../src/src/server/dev-server/middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM7D,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAEnD,UAAU,qBAAqB;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAkFD,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAkC/B;AAqHD,wBAAsB,eAAe,CACnC,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,eAAe,EACvB,cAAc,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC,CASf"}

package/esm/src/server/dev-server/middleware.js

@@ -86,11 +86,11 @@ export async function loadMiddlewareFile(projectDir, adapter, options = {}) {
         try {
             logger.debug(`Loading ${middlewareFile}`);
             if (isVirtualFilesystem(adapter.fs)) {
-                return await loadMiddlewareFromVirtualFS(middlewarePath, adapter, options.throwOnError === true);
+                return await loadMiddlewareFromVirtualFS(middlewarePath, adapter, options.throwOnError === true, middlewareFile);
             }
             const middlewareUrl = `file://${middlewarePath}?t=${Date.now()}-${dntShim.crypto.randomUUID()}`;
             const middlewareModule = await import(middlewareUrl);
-            return normalizeMiddlewareExport(middlewareModule, options.throwOnError === true);
+            return normalizeMiddlewareExport(middlewareModule, options.throwOnError === true, middlewareFile);
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
@@ -101,7 +101,7 @@ export async function loadMiddlewareFile(projectDir, adapter, options = {}) {
     }
     return [];
 }
-async function loadMiddlewareFromVirtualFS(middlewarePath, adapter, strictExport) {
+async function loadMiddlewareFromVirtualFS(middlewarePath, adapter, strictExport, sourceFile = "middleware.ts") {
     const fs = createFileSystem();
     const content = await adapter.fs.readFile(middlewarePath);
     const source = typeof content === "string" ? content : new TextDecoder().decode(content);
@@ -130,20 +130,48 @@ async function loadMiddlewareFromVirtualFS(middlewarePath, adapter, strictExport
     try {
         await fs.writeTextFile(tempFile, js);
         const middlewareModule = await import(`file://${tempFile}?v=${Date.now()}`);
-        return normalizeMiddlewareExport(middlewareModule, strictExport);
+        return normalizeMiddlewareExport(middlewareModule, strictExport, sourceFile);
     }
     finally {
         await fs.remove(tempDir, { recursive: true });
     }
 }
-function normalizeMiddlewareExport(middlewareModule, strict = false) {
+/**
+ * Explain what a root middleware file must export. When the module looks like it
+ * was written for Next.js, say so, because that is overwhelmingly why this
+ * fails. A bad root middleware takes down every route, so the message has
+ * to be enough to fix the file without reading the source.
+ */
+function invalidMiddlewareExport(middlewareModule, sourceFile) {
+    const named = middlewareModule && typeof middlewareModule === "object"
+        ? Object.keys(middlewareModule)
+        : [];
+    const looksLikeNext = named.includes("middleware") &&
+        typeof middlewareModule.middleware === "function";
+    const detail = looksLikeNext
+        ? `Found a named "middleware" export, which is the Next.js convention. ` +
+            `Veryfront expects a default export, and its middleware receives ` +
+            `(c, next), where c is a context carrying c.req, not the Request itself.`
+        : named.length > 0
+            ? `Found export(s): ${named.join(", ")}.`
+            : `The module has no usable export.`;
+    return new TypeError(`Invalid middleware export in ${sourceFile}. ${detail}\n` +
+        `Expected a default export that is a middleware function, or a non-empty ` +
+        `array of them:\n\n` +
+        `  export default async function middleware(c, next) {\n` +
+        `    const response = await next();\n` +
+        `    return response;\n` +
+        `  }\n\n` +
+        `See docs/guides/middleware.md.`);
+}
+function normalizeMiddlewareExport(middlewareModule, strict = false, sourceFile = "middleware.ts") {
     const exported = middlewareModule && typeof middlewareModule === "object" &&
         "default" in middlewareModule
         ? middlewareModule.default
         : middlewareModule;
     if (Array.isArray(exported)) {
         if (strict && (exported.length === 0 || exported.some((value) => typeof value !== "function"))) {
-            throw new TypeError("Invalid middleware export: expected a function or non-empty array of functions");
+            throw invalidMiddlewareExport(middlewareModule, sourceFile);
         }
         return exported.filter((middleware) => typeof middleware === "function");
     }
@@ -151,7 +179,7 @@ function normalizeMiddlewareExport(middlewareModule, strict = false) {
         return [exported];
     }
     if (strict) {
-        throw new TypeError("Invalid middleware export: expected a function or non-empty array of functions");
+        throw invalidMiddlewareExport(middlewareModule, sourceFile);
     }
     return [];
 }

package/esm/src/server/handlers/request/ssr/error-page-fallback.js

@@ -78,6 +78,23 @@ async function setCachedPath(cacheKey, path) {
     }
     errorPagePathCache.set(cacheKey, path);
 }
+/**
+ * Whether a "this project has no error page" answer may be cached.
+ *
+ * In dev it may not. Nothing invalidates this cache when the filesystem
+ * changes, so caching the miss means a project that adds `pages/500.tsx` while
+ * the server is running keeps getting the dev overlay until restart, with no
+ * indication why. A miss costs one file probe on an error render, which is not
+ * a path worth optimising in dev.
+ */
+function canCacheMiss(ctx) {
+    return !ctx.isLocalProject;
+}
+async function setCachedMiss(cacheKey, ctx) {
+    if (!canCacheMiss(ctx))
+        return;
+    await setCachedPath(cacheKey, null);
+}
 async function deleteCachedPath(cacheKey) {
     if (injectedCacheRepo) {
         await injectedCacheRepo.delete(cacheKey);
@@ -104,7 +121,7 @@ async function tryLoadErrorPage(pagesDir, pageType, ctx, reactVersion) {
         try {
             const resolvedPath = await ctx.adapter.fs.resolveFile(basePath);
             if (!resolvedPath) {
-                await setCachedPath(cacheKey, null);
+                await setCachedMiss(cacheKey, ctx);
                 return null;
             }
             const fullPath = joinPath(ctx.projectDir, resolvedPath);
@@ -117,7 +134,7 @@ async function tryLoadErrorPage(pagesDir, pageType, ctx, reactVersion) {
         catch (_) {
             // expected: resolveFile may fail, fall through to extension probing
         }
-        await setCachedPath(cacheKey, null);
+        await setCachedMiss(cacheKey, ctx);
         return null;
     }
     for (const ext of ERROR_PAGE_EXTENSIONS) {
@@ -136,7 +153,7 @@ async function tryLoadErrorPage(pagesDir, pageType, ctx, reactVersion) {
             // expected: file with this extension doesn't exist
         }
     }
-    await setCachedPath(cacheKey, null);
+    await setCachedMiss(cacheKey, ctx);
     return null;
 }
 async function loadErrorComponent(filePath, ctx, reactVersion) {

package/esm/src/server/handlers/request/ssr/ssr.handler.d.ts

@@ -15,17 +15,6 @@ import { type SSRServiceLike } from "../../../services/rendering/ssr.service.js"
  * Config override (PRODUCTION_MODE) takes precedence.
  */
 export declare function isProductionMode(ctx: HandlerContext, _url?: URL): boolean;
-/**
- * SSR Handler - Thin orchestration layer
- *
- * Responsibilities:
- * - Route matching and quick rejections
- * - Multi-project context setup
- * - Response building with headers
- * - Custom fallback handling (not-found, error pages)
- *
- * Business logic is delegated to SSRService.
- */
 export declare class SSRHandler extends BaseHandler {
     metadata: HandlerMetadata;
     private ssrService;

package/esm/src/server/handlers/request/ssr/ssr.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssr.handler.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/request/ssr/ssr.handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,aAAa,EACd,MAAM,gBAAgB,CAAC;AAWxB,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,4CAA4C,CAAC;AAMpD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAKzE;AAED;;;;;;;;;;GAUG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,QAAQ,EAAE,eAAe,CAIvB;IAEF,OAAO,CAAC,UAAU,CAAiB;gBAEvB,UAAU,CAAC,EAAE,cAAc;IAKvC,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA8BjE,OAAO,CAAC,qBAAqB;IAmF7B,OAAO,CAAC,iBAAiB;IA8DzB,OAAO,CAAC,cAAc;YAgBR,cAAc;YA6Bd,sBAAsB;YAgBtB,aAAa;CAU5B"}
+{"version":3,"file":"ssr.handler.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/request/ssr/ssr.handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,aAAa,EACd,MAAM,gBAAgB,CAAC;AAWxB,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,4CAA4C,CAAC;AAOpD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAKzE;AA+BD,qBAAa,UAAW,SAAQ,WAAW;IACzC,QAAQ,EAAE,eAAe,CAIvB;IAEF,OAAO,CAAC,UAAU,CAAiB;gBAEvB,UAAU,CAAC,EAAE,cAAc;IAKvC,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA8BjE,OAAO,CAAC,qBAAqB;IAmF7B,OAAO,CAAC,iBAAiB;IAkEzB,OAAO,CAAC,cAAc;YAgBR,cAAc;YA6Bd,sBAAsB;YAgBtB,aAAa;CAU5B"}

package/esm/src/server/handlers/request/ssr/ssr.handler.js

@@ -19,6 +19,7 @@ import { tryNotFoundFallback } from "./not-found-fallback.js";
 import { tryErrorPageFallback } from "./error-page-fallback.js";
 import { SSRService, } from "../../../services/rendering/ssr.service.js";
 import { ErrorPages } from "../../../utils/error-html.js";
+import { VeryfrontError } from "../../../../errors/index.js";
 import { buildSSRResponse } from "./ssr-response-builder.js";
 const logger = serverLogger.component("ssr");
 /**
@@ -43,6 +44,23 @@ export function isProductionMode(ctx, _url) {
  *
  * Business logic is delegated to SSRService.
  */
+/**
+ * True for errors raised while compiling or resolving project source, as
+ * opposed to errors thrown by the running application.
+ *
+ * Module-load failures arrive wrapped in a RUNTIME-category `render-error`,
+ * which loses the original category, so they are identified by their
+ * `criticalFailures` context instead: a page module that could not be *loaded*
+ * always failed to compile or resolve.
+ */
+function isBuildError(error) {
+    if (!(error instanceof VeryfrontError))
+        return false;
+    if (error.category === "BUILD" || error.category === "MODULE")
+        return true;
+    const context = error.context;
+    return Array.isArray(context?.criticalFailures) && context.criticalFailures.length > 0;
+}
 export class SSRHandler extends BaseHandler {
     metadata = {
         name: "SSRHandler",
@@ -182,7 +200,11 @@ export class SSRHandler extends BaseHandler {
             if (result.errorType === "not-found") {
                 return this.handleNotFound(req, ctx, slug, nonce);
             }
-            if (result.errorType === "server-error" && !result.showDevOverlay) {
+            const isServerError = result.errorType === "server-error" ||
+                result.errorType === "runtime";
+            // Project error pages should beat the dev overlay for runtime errors.
+            // Build/import errors stay visible because their overlay is actionable.
+            if (isServerError && !(result.showDevOverlay && isBuildError(result.error))) {
                 const customResponse = await this.tryCustomErrorFallback(req, ctx, result, nonce);
                 if (customResponse)
                     return customResponse;

package/esm/src/transforms/esm/degraded-artifact.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Degradation marking for cached HTTP module artifacts.
+ *
+ * A module whose lazy dependency could not be prefetched is still usable for
+ * the render that produced it, but it must never be mistaken for a complete
+ * artifact on a later render. The marker travels with the code, so any reader
+ * of the on-disk cache can tell the two apart.
+ *
+ * @module transforms/esm/degraded-artifact
+ */
+/** Mark bundle code as produced from an incomplete dependency prefetch. */
+export declare function markDegradedArtifact(code: string): string;
+/** Return whether bundle code was produced from an incomplete prefetch. */
+export declare function isDegradedArtifact(code: string): boolean;
+//# sourceMappingURL=degraded-artifact.d.ts.map

package/esm/src/transforms/esm/degraded-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"degraded-artifact.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/degraded-artifact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/esm/src/transforms/esm/degraded-artifact.js

@@ -0,0 +1,22 @@
+/**
+ * Degradation marking for cached HTTP module artifacts.
+ *
+ * A module whose lazy dependency could not be prefetched is still usable for
+ * the render that produced it, but it must never be mistaken for a complete
+ * artifact on a later render. The marker travels with the code, so any reader
+ * of the on-disk cache can tell the two apart.
+ *
+ * @module transforms/esm/degraded-artifact
+ */
+/** Preserved comment format that survives minification */
+const VF_DEGRADED_MARKER = "\n/*! @vf-degraded */\n";
+/** Mark bundle code as produced from an incomplete dependency prefetch. */
+export function markDegradedArtifact(code) {
+    if (isDegradedArtifact(code))
+        return code;
+    return `${code}${VF_DEGRADED_MARKER}`;
+}
+/** Return whether bundle code was produced from an incomplete prefetch. */
+export function isDegradedArtifact(code) {
+    return code.endsWith(VF_DEGRADED_MARKER);
+}

package/esm/src/transforms/esm/http-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/http-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAGL,KAAK,YAAY,EAKjB,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EAElB,gBAAgB,EAEhB,KAAK,OAAO,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAA2B,MAAM,4BAA4B,CAAC;AACxF,OAAO,EACL,0BAA0B,EAO3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,sBAAsB,EAKvB,MAAM,uBAAuB,CAAC;AAe/B,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,CAAC;AAGF,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAsRlC,wEAAwE;AACxE,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,sBAAsB,CAAC,CAkCjC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,wBAAwB,GAClC,OAAO,CAAC,OAAO,CAAC,CAElB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,wBAAwB,GAClC,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAErF;AAGD,eAAO,MAAM,wBAAwB,0BAAoB,CAAC"}
+{"version":3,"file":"http-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/http-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EAGL,KAAK,YAAY,EAKjB,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EAElB,gBAAgB,EAEhB,KAAK,OAAO,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAA2B,MAAM,4BAA4B,CAAC;AACxF,OAAO,EACL,0BAA0B,EAO3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,sBAAsB,EAKvB,MAAM,uBAAuB,CAAC;AAe/B,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,CAAC;AAGF,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAwTlC,wEAAwE;AACxE,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,sBAAsB,CAAC,CAkCjC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,wBAAwB,GAClC,OAAO,CAAC,OAAO,CAAC,CAElB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,wBAAwB,GAClC,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAErF;AAGD,eAAO,MAAM,wBAAwB,0BAAoB,CAAC"}

package/esm/src/transforms/esm/http-cache.js

@@ -23,6 +23,7 @@ import { CACHE_DIR_TOKEN, detokenizeAllCachePaths, detokenizeCachePaths, tokeniz
 import { looksLikeHtmlContent as looksLikeHtmlNotJs } from "./html-content.js";
 // Extracted modules
 import { embedSourceUrl, extractSourceUrl } from "./source-url-embed.js";
+import { isDegradedArtifact, markDegradedArtifact } from "./degraded-artifact.js";
 import { buildHttpCacheIdentity, buildHttpCacheIdentityMetadata, ensureAbsoluteDir, ensurePreparedHttpCacheRequestOptions, getEffectiveHttpCacheRequest, hashHttpCacheIdentity, hasIncompatibleFilePaths, isHttpUrl, normalizeHttpUrl, prepareHttpCacheRequestOptions, } from "./http-cache-helpers.js";
 import { extractBundleDeps, validateBundleDepsExist } from "./bundle-deps-validator.js";
 import { __clearInFlightHttpFetches, bundleAccumulatorStorage, inFlightHttpFetches, processingStackStorage, refreshDistributedCacheAsync, trackBundleAccumulator, waitForInFlightFetch, } from "./in-flight-manager.js";
@@ -56,15 +57,32 @@ async function cacheHttpModuleInternal(url, options) {
     const fs = createFileSystem();
     if (await exists(cachePath)) {
         const code = await fs.readTextFile(cachePath);
-        const deps = extractBundleDeps(code);
-        if (deps.length > 0) {
-            const depsValid = await validateBundleDepsExist(deps, cacheDir);
-            if (!depsValid) {
-                httpCacheLog.debug("Local cache has missing deps, will re-fetch", {
-                    url: normalizedUrl,
-                    hash,
-                    missingDeps: deps.length,
-                });
+        if (isDegradedArtifact(code)) {
+            // The artifact on disk is the fallback a previous render wrote when a
+            // dependency could not be prefetched. Retry the prefetch instead of
+            // handing the degradation on.
+            httpCacheLog.debug("Local cache holds a degraded artifact, will re-fetch", {
+                url: normalizedUrl,
+                hash,
+            });
+        }
+        else {
+            const deps = extractBundleDeps(code);
+            if (deps.length > 0) {
+                const depsValid = await validateBundleDepsExist(deps, cacheDir);
+                if (!depsValid) {
+                    httpCacheLog.debug("Local cache has missing deps, will re-fetch", {
+                        url: normalizedUrl,
+                        hash,
+                        missingDeps: deps.length,
+                    });
+                }
+                else {
+                    getCachedPaths().set(cacheKey, cachePath);
+                    refreshDistributedCacheAsync(hash, code, cacheDir, normalizedUrl, identityMetadata, getLastDistributedRefresh);
+                    trackBundleAccumulator(hash, normalizedUrl, cachePath);
+                    return cachePath;
+                }
             }
             else {
                 getCachedPaths().set(cacheKey, cachePath);
@@ -73,12 +91,6 @@ async function cacheHttpModuleInternal(url, options) {
                 return cachePath;
             }
         }
-        else {
-            getCachedPaths().set(cacheKey, cachePath);
-            refreshDistributedCacheAsync(hash, code, cacheDir, normalizedUrl, identityMetadata, getLastDistributedRefresh);
-            trackBundleAccumulator(hash, normalizedUrl, cachePath);
-            return cachePath;
-        }
     }
     const processingStack = getProcessingStack();
     if (processingStack.has(cacheIdentity)) {
@@ -198,13 +210,18 @@ async function cacheHttpModuleInternal(url, options) {
             });
         }
         processingStack.add(cacheIdentity);
+        let degraded = [];
         try {
-            code = await rewriteModuleImports(code, normalizedUrl, options, cacheHttpModule);
+            const rewritten = await rewriteModuleImports(code, normalizedUrl, options, cacheHttpModule);
+            code = rewritten.code;
+            degraded = rewritten.degraded;
         }
         finally {
             processingStack.delete(cacheIdentity);
         }
         code = embedSourceUrl(code, normalizedUrl);
+        if (degraded.length > 0)
+            code = markDegradedArtifact(code);
         await fs.mkdir(cacheDir, { recursive: true });
         await fs.writeTextFile(cachePath, code);
         if (!(await exists(cachePath))) {
@@ -212,6 +229,19 @@ async function cacheHttpModuleInternal(url, options) {
                 detail: `[HTTP-CACHE] INVARIANT VIOLATION: File write succeeded but file does not exist: ${cachePath}`,
             });
         }
+        if (degraded.length > 0) {
+            // The file on disk carries this render through, but the artifact is not
+            // the one this URL is supposed to produce. Keeping it out of the
+            // distributed cache and the in-memory path map means the next render
+            // retries the prefetch instead of inheriting one upstream blip for the
+            // lifetime of the distributed entry.
+            httpCacheLog.warn("Not caching a module with unresolved dynamic imports", {
+                url: normalizedUrl,
+                hash,
+                degraded,
+            });
+            return cachePath;
+        }
         try {
             await httpBundleCache.setCode(String(hash), asLocalModuleCode(code), normalizedUrl, HTTP_MODULE_DISTRIBUTED_TTL_SEC, identityMetadata);
         }
@@ -256,7 +286,7 @@ async function cacheHttpModule(url, options) {
 export function cacheHttpImportsToLocal(code, options) {
     const requestOptions = prepareHttpCacheRequestOptions(options);
     return bundleAccumulatorStorage.run([], async () => {
-        const replacements = await buildReplacements(code, undefined, requestOptions, cacheHttpModule);
+        const { replacements } = await buildReplacements(code, undefined, requestOptions, cacheHttpModule);
         if (replacements.size === 0)
             return { code };
         httpCacheLog.debug("Cached HTTP imports", { count: replacements.size });

package/esm/src/transforms/esm/import-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-parser.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/import-parser.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAKtE,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,uBAAuB;IAC/B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAC1C,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAKD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,uBAAuB,CAAC,CAiFlC"}
+{"version":3,"file":"import-parser.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/import-parser.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAKtE,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,uBAAuB;IAC/B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAC1C,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAKD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,uBAAuB,CAAC,CA0HlC"}

package/esm/src/transforms/esm/import-parser.js

@@ -1,3 +1,4 @@
+import { compileContent } from "../mdx/compiler/index.js";
 import { getEsbuild } from "../../platform/compat/esbuild.js";
 import { join } from "../../platform/compat/path/index.js";
 import { createFileSystem } from "../../platform/compat/fs.js";
@@ -11,8 +12,18 @@ export async function parseLocalImports(code, filePath, projectDir, adapter) {
     if (filePath.endsWith(".css") || filePath.endsWith(".json")) {
         return { imports: [], cssImports: [], crossProjectImports: [], missing: [] };
     }
+    // MDX/Markdown is not JSX, so handing the raw source to esbuild under the
+    // `jsx` loader fails with "<stdin>:1:1: ERROR: Syntax error" — which surfaced
+    // to users as "Component has missing dependencies" for a file that exists.
+    // Compile content to JSX first, exactly as the transform pipeline's parse
+    // stage does, then read the imports out of that.
+    let parseSource = code;
+    if (/\.mdx?$/i.test(filePath)) {
+        const compiled = await compileContent("development", projectDir, code, undefined, filePath, "server");
+        parseSource = compiled.compiledCode;
+    }
     const esbuild = await getEsbuild();
-    const result = await esbuild.transform(code, {
+    const result = await esbuild.transform(parseSource, {
         loader: getLoaderFromPath(filePath),
         format: "esm",
         target: "esnext",
@@ -32,6 +43,28 @@ export async function parseLocalImports(code, filePath, projectDir, adapter) {
         const specifier = imp.n;
         if (!specifier)
             continue;
+        // The content compile above runs with the "server" target, which rewrites a
+        // relative specifier to an absolute `file://` URL before the lexer ever
+        // sees it. Without this branch those dependencies match none of the shapes
+        // below and are dropped without even being reported as missing, so an MDX
+        // file's sibling components are never recursively transformed.
+        if (specifier.startsWith("file://")) {
+            const absolutePath = fileUrlToPath(specifier);
+            if (absolutePath && await checkFileExists(absolutePath, adapter)) {
+                const entry = { specifier, absolutePath };
+                if (absolutePath.endsWith(".css"))
+                    cssImports.push(entry);
+                else
+                    localImports.push(entry);
+                continue;
+            }
+            missingImports.push({
+                specifier,
+                fromFile: filePath,
+                reason: `File not found: ${absolutePath ?? specifier}`,
+            });
+            continue;
+        }
         if (specifier.startsWith("./") || specifier.startsWith("../")) {
             const resolved = await resolveLocalImportPath(filePath, specifier, adapter);
             if (resolved) {
@@ -83,6 +116,19 @@ export async function parseLocalImports(code, filePath, projectDir, adapter) {
     }
     return { imports: localImports, cssImports, crossProjectImports, missing: missingImports };
 }
+/** Filesystem path behind a `file://` specifier, or null when it is not one. */
+function fileUrlToPath(specifier) {
+    try {
+        const url = new URL(specifier);
+        if (url.protocol !== "file:")
+            return null;
+        return decodeURIComponent(url.pathname);
+    }
+    catch (_) {
+        /* expected: not a well-formed URL */
+        return null;
+    }
+}
 async function checkFileExists(path, adapter) {
     try {
         const fs = adapter?.fs.stat ? adapter.fs : createFileSystem();

package/esm/src/transforms/esm/specifier-resolver.d.ts

@@ -9,15 +9,32 @@
 import { type CacheOptions } from "./http-cache-helpers.js";
 /** Function signature for caching an HTTP module and returning its local path. */
 export type CacheHttpModuleFn = (url: string, options: CacheOptions) => Promise<string | null>;
+/** Specifier replacements plus the specifiers that were left unresolved. */
+export interface SpecifierReplacements {
+    readonly replacements: ReadonlyMap<string, string>;
+    /** Specifiers left in place because prefetching them failed. */
+    readonly degraded: readonly string[];
+}
+/** Rewritten module code plus the specifiers that were left unresolved. */
+export interface RewrittenModule {
+    readonly code: string;
+    /** Specifiers left in place because prefetching them failed. */
+    readonly degraded: readonly string[];
+}
 /**
  * Build a map of specifier replacements by resolving all imports in the code.
  *
- * Resolution failure is fatal for a static import and best-effort for a
- * specifier only ever used in `import(...)`. See {@link isDynamicOnly}.
+ * Resolution failure is fatal unless the runtime can resolve the specifier on
+ * its own. See {@link runtimeResolvableSpecifiers}. Every specifier left in
+ * place is reported as degraded so callers can decide whether the resulting
+ * code is fit to cache.
  */
-export declare function buildReplacements(code: string, baseUrl: string | undefined, options: CacheOptions, cacheHttpModule: CacheHttpModuleFn): Promise<Map<string, string>>;
+export declare function buildReplacements(code: string, baseUrl: string | undefined, options: CacheOptions, cacheHttpModule: CacheHttpModuleFn): Promise<SpecifierReplacements>;
 /**
  * Rewrite all HTTP/npm/bare import specifiers in module code to local cached paths.
+ *
+ * Reports any specifier left in place, so the caller can keep the resulting
+ * code out of the caches that outlive this render.
  */
-export declare function rewriteModuleImports(code: string, moduleUrl: string, options: CacheOptions, cacheHttpModule: CacheHttpModuleFn): Promise<string>;
+export declare function rewriteModuleImports(code: string, moduleUrl: string, options: CacheOptions, cacheHttpModule: CacheHttpModuleFn): Promise<RewrittenModule>;
 //# sourceMappingURL=specifier-resolver.d.ts.map

package/esm/src/transforms/esm/specifier-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"specifier-resolver.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/specifier-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,EACL,KAAK,YAAY,EAQlB,MAAM,yBAAyB,CAAC;AAEjC,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AA4G/F;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,iBAAiB,GACjC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAoC9B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,iBAAiB,GACjC,OAAO,CAAC,MAAM,CAAC,CAKjB"}
+{"version":3,"file":"specifier-resolver.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/specifier-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,EACL,KAAK,YAAY,EAQlB,MAAM,yBAAyB,CAAC;AAEjC,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAoH/F,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,iBAAiB,GACjC,OAAO,CAAC,qBAAqB,CAAC,CAuChC;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,iBAAiB,GACjC,OAAO,CAAC,eAAe,CAAC,CAa1B"}

package/esm/src/transforms/esm/specifier-resolver.js

@@ -83,21 +83,26 @@ async function resolveSpecifier(specifier, baseUrl, options, cacheHttpModule) {
     return resolveSpecifier(mapped, baseUrl, options, cacheHttpModule);
 }
 /**
- * Specifiers this module only ever reaches through `import(...)`.
+ * Specifiers the runtime can still resolve on its own if prefetching fails.
  *
- * The distinction decides what a resolution failure means. A static import is
- * part of the emitted module's own import graph, so the artifact contract holds
- * for it: every static dependency resolves to a local path before the module is
- * handed to the runtime loader, and a failure to do that is fatal, exactly as
- * it was before graceful degradation existed.
+ * Two conditions must hold together. The specifier must be reached only
+ * through `import(...)`, because a static import is part of the emitted
+ * module's own import graph: every static dependency resolves to a local path
+ * before the module is handed to the runtime loader, and a failure to do that
+ * is fatal, exactly as it was before graceful degradation existed. A dynamic
+ * specifier is resolved by the runtime at call time and is routinely guarded by
+ * the caller (`platform/adapters/redis/modules.js` only calls
+ * `await import("redis")` when the redis adapter is actually used), so failing
+ * to prefetch it leaves the specifier in place rather than taking down a render
+ * that would never have imported it.
  *
- * A dynamic specifier is resolved by the runtime at call time and is routinely
- * guarded by the caller (`platform/adapters/redis/modules.js` only calls
- * `await import("redis")` when the redis adapter is actually used). Pre-fetching
- * it is an optimisation, so failing to pre-fetch it leaves the specifier in
- * place rather than taking down a render that would never have imported it.
+ * The specifier must also be an absolute http(s) URL, because that is the only
+ * form the runtime can resolve without the transform. A relative specifier left
+ * in place resolves against the local bundle cache directory, where the chunk
+ * was never written; `npm:` and bare specifiers need the import map the cached
+ * module no longer carries. Those failures stay fatal.
  */
-function isDynamicOnly(imports) {
+function runtimeResolvableSpecifiers(imports) {
     const dynamic = new Set();
     const staticSpecifiers = new Set();
     for (const imp of imports) {
@@ -107,23 +112,30 @@ function isDynamicOnly(imports) {
     }
     for (const specifier of staticSpecifiers)
         dynamic.delete(specifier);
+    for (const specifier of [...dynamic]) {
+        if (!isHttpUrl(specifier))
+            dynamic.delete(specifier);
+    }
     return dynamic;
 }
 /**
  * Build a map of specifier replacements by resolving all imports in the code.
  *
- * Resolution failure is fatal for a static import and best-effort for a
- * specifier only ever used in `import(...)`. See {@link isDynamicOnly}.
+ * Resolution failure is fatal unless the runtime can resolve the specifier on
+ * its own. See {@link runtimeResolvableSpecifiers}. Every specifier left in
+ * place is reported as degraded so callers can decide whether the resulting
+ * code is fit to cache.
  */
 export async function buildReplacements(code, baseUrl, options, cacheHttpModule) {
     const imports = await parseImports(code);
     const uniqueSpecifiers = [...new Set(imports.map((imp) => imp.n).filter(Boolean))];
-    const dynamicOnly = isDynamicOnly(imports);
+    const runtimeResolvable = runtimeResolvableSpecifiers(imports);
     const settled = await Promise.allSettled(uniqueSpecifiers.map(async (specifier) => ({
         specifier,
         resolved: await resolveSpecifier(specifier, baseUrl, options, cacheHttpModule),
     })));
     const replacements = new Map();
+    const degraded = [];
     for (let i = 0; i < settled.length; i++) {
         const outcome = settled[i];
         const specifier = uniqueSpecifiers[i];
@@ -135,24 +147,32 @@ export async function buildReplacements(code, baseUrl, options, cacheHttpModule)
                 replacements.set(resolvedFor, resolved);
             continue;
         }
-        // A static import must resolve. Leaving one unresolved would emit a module
-        // whose own import graph reaches outside the local cache, which is not what
-        // the runtime loader is handed anywhere else.
-        if (!dynamicOnly.has(specifier))
+        // Anything the runtime cannot resolve on its own must resolve here.
+        // Leaving one unresolved would emit a module whose own import graph reaches
+        // outside the local cache, which is not what the runtime loader is handed
+        // anywhere else.
+        if (!runtimeResolvable.has(specifier))
             throw outcome.reason;
+        degraded.push(specifier);
         logger.warn("Leaving an unresolvable dynamic specifier for runtime resolution", {
             specifier,
             error: outcome.reason instanceof Error ? outcome.reason.message : String(outcome.reason),
         });
     }
-    return replacements;
+    return { replacements, degraded };
 }
 /**
  * Rewrite all HTTP/npm/bare import specifiers in module code to local cached paths.
+ *
+ * Reports any specifier left in place, so the caller can keep the resulting
+ * code out of the caches that outlive this render.
  */
 export async function rewriteModuleImports(code, moduleUrl, options, cacheHttpModule) {
-    const replacements = await buildReplacements(code, moduleUrl, options, cacheHttpModule);
+    const { replacements, degraded } = await buildReplacements(code, moduleUrl, options, cacheHttpModule);
     if (replacements.size === 0)
-        return code;
-    return replaceSpecifiers(code, (specifier) => replacements.get(specifier) ?? null);
+        return { code, degraded };
+    return {
+        code: await replaceSpecifiers(code, (specifier) => replacements.get(specifier) ?? null),
+        degraded,
+    };
 }

package/esm/src/transforms/import-rewriter/strategies/asset-strategy.d.ts

@@ -0,0 +1,23 @@
+import type { ImportRewriteStrategy, ImportSpecifierInfo, RewriteContext, RewriteResult } from "../types.js";
+/**
+ * Reject `import logo from "@/assets/logo.svg"`.
+ *
+ * Veryfront serves static assets from `public/` at the root path; it has no
+ * asset-import model, so there is nothing to rewrite such a specifier to.
+ * Previously the alias and relative strategies fell through to their
+ * "no extension, add .js" branch and emitted `assets/logo.svg.js`, so the
+ * failure surfaced as:
+ *
+ *     Module not found "file:///_vf_modules/assets/logo.svg.js"
+ *
+ * naming a file the author never wrote, in a directory that does not exist.
+ * Failing here instead names the real file and the supported alternative.
+ */
+export declare class AssetStrategy implements ImportRewriteStrategy {
+    readonly name = "asset";
+    readonly priority = 0.6;
+    matches(specifier: string, _ctx: RewriteContext): boolean;
+    rewrite(info: ImportSpecifierInfo, ctx: RewriteContext): RewriteResult;
+}
+export declare const assetStrategy: AssetStrategy;
+//# sourceMappingURL=asset-strategy.d.ts.map

package/esm/src/transforms/import-rewriter/strategies/asset-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-strategy.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/import-rewriter/strategies/asset-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AAarB;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,YAAW,qBAAqB;IACzD,QAAQ,CAAC,IAAI,WAAW;IAGxB,QAAQ,CAAC,QAAQ,OAAO;IAExB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO;IAIzD,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,GAAG,aAAa;CAiBvE;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/esm/src/transforms/import-rewriter/strategies/asset-strategy.js

@@ -0,0 +1,49 @@
+import { COMPILATION_ERROR } from "../../../errors/index.js";
+/**
+ * Static asset extensions that are not JavaScript modules.
+ *
+ * `.css` is deliberately absent — CSS imports are supported and are stripped
+ * by the pipeline's CSS stage before import resolution runs, so they never
+ * reach this strategy.
+ */
+const ASSET_EXTENSION_PATTERN = /\.(?:svg|png|jpe?g|gif|webp|avif|ico|bmp|woff2?|ttf|otf|eot|mp4|webm|mp3|wav|pdf)(?:\?.*)?$/i;
+/**
+ * Reject `import logo from "@/assets/logo.svg"`.
+ *
+ * Veryfront serves static assets from `public/` at the root path; it has no
+ * asset-import model, so there is nothing to rewrite such a specifier to.
+ * Previously the alias and relative strategies fell through to their
+ * "no extension, add .js" branch and emitted `assets/logo.svg.js`, so the
+ * failure surfaced as:
+ *
+ *     Module not found "file:///_vf_modules/assets/logo.svg.js"
+ *
+ * naming a file the author never wrote, in a directory that does not exist.
+ * Failing here instead names the real file and the supported alternative.
+ */
+export class AssetStrategy {
+    name = "asset";
+    // Ahead of the alias (1) and relative strategies so it sees both
+    // `@/assets/logo.svg` and `./logo.svg`.
+    priority = 0.6;
+    matches(specifier, _ctx) {
+        return ASSET_EXTENSION_PATTERN.test(specifier);
+    }
+    rewrite(info, ctx) {
+        // Name the importing file relative to the project. A path outside it is a
+        // machine path, so only the file name goes in the message.
+        const importer = ctx.filePath.startsWith(ctx.projectDir)
+            ? ctx.filePath.slice(ctx.projectDir.length).replace(/^\/+/, "")
+            : ctx.filePath.split("/").pop() ?? ctx.filePath;
+        const fileName = (info.specifier.split("/").pop() ?? info.specifier).split(/[?#]/, 1)[0] ??
+            info.specifier;
+        throw COMPILATION_ERROR.create({
+            detail: `Cannot import the static asset "${info.specifier}" as a module (in ${importer}). ` +
+                `Veryfront serves static assets from public/ at the root path. ` +
+                `Move the file to public/${fileName} and reference it by URL instead, ` +
+                `for example <img src="/${fileName}" />. ` +
+                `See docs/guides/project-structure.md.`,
+        });
+    }
+}
+export const assetStrategy = new AssetStrategy();

package/esm/src/transforms/import-rewriter/strategies/index.d.ts

@@ -4,6 +4,7 @@
  * @module transforms/import-rewriter/strategies
  */
 export { AliasStrategy, aliasStrategy } from "./alias-strategy.js";
+export { AssetStrategy, assetStrategy } from "./asset-strategy.js";
 export { BareStrategy, bareStrategy } from "./bare-strategy.js";
 export { NodeBuiltinStrategy, nodeBuiltinStrategy } from "./node-builtin-strategy.js";
 export { CrossProjectStrategy, crossProjectStrategy, isCrossProjectImport, parseCrossProjectImport, } from "./cross-project-strategy.js";

package/esm/src/transforms/import-rewriter/strategies/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/import-rewriter/strategies/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/import-rewriter/strategies/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

package/esm/src/transforms/import-rewriter/strategies/index.js

@@ -4,6 +4,7 @@
  * @module transforms/import-rewriter/strategies
  */
 export { AliasStrategy, aliasStrategy } from "./alias-strategy.js";
+export { AssetStrategy, assetStrategy } from "./asset-strategy.js";
 export { BareStrategy, bareStrategy } from "./bare-strategy.js";
 export { NodeBuiltinStrategy, nodeBuiltinStrategy } from "./node-builtin-strategy.js";
 export { CrossProjectStrategy, crossProjectStrategy, isCrossProjectImport, parseCrossProjectImport, } from "./cross-project-strategy.js";

package/esm/src/transforms/import-rewriter/unified-rewriter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unified-rewriter.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/import-rewriter/unified-rewriter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAiB,MAAM,YAAY,CAAC;AAkBvF,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,UAAU,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACrC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,UAAU,CAA0B;gBAEhC,OAAO,CAAC,EAAE,cAAc;IAIpC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IA4B3D;;OAEG;IACH,OAAO,CAAC,aAAa;CAoCtB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,uBAA8B,CAAC;AAE3D;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAEjF"}
+{"version":3,"file":"unified-rewriter.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/import-rewriter/unified-rewriter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAiB,MAAM,YAAY,CAAC;AAmBvF,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,UAAU,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACrC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,UAAU,CAA0B;gBAEhC,OAAO,CAAC,EAAE,cAAc;IAIpC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IA4B3D;;OAEG;IACH,OAAO,CAAC,aAAa;CAoCtB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,uBAA8B,CAAC;AAE3D;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAEjF"}

package/esm/src/transforms/import-rewriter/unified-rewriter.js

@@ -7,11 +7,13 @@
 import { withSpan } from "../../observability/tracing/otlp-setup.js";
 import { applyRewrites, parseAllImports } from "./parse-cache.js";
 import { aliasStrategy, bareStrategy, crossProjectStrategy, importMapStrategy, nodeBuiltinStrategy, reactStrategy, relativeStrategy, urlStrategy, vendorStrategy, veryfrontStrategy, } from "./strategies/index.js";
+import { assetStrategy } from "./strategies/asset-strategy.js";
 /**
  * Default strategy execution order by priority.
  */
 const DEFAULT_STRATEGIES = [
     nodeBuiltinStrategy, // 0.5 - Node.js built-ins (noop for browser)
+    assetStrategy, // 0.6 - static assets are not modules; reject with a pointer
     reactStrategy, // 0 - React packages first
     aliasStrategy, // 1 - @/ aliases
     veryfrontStrategy, // 1.5 - #veryfront/*, veryfront/*

package/esm/src/transforms/mdx/esm-module-loader/module-fetcher/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAkC,MAAM,4BAA4B,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAG5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAcxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAS9B;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAOtD;AAED;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,SAAS,EAAE,MAAM;CAI9B;AAcD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,EAC7B,gBAAgB,CAAC,EAAE,MAAM,EACzB,OAAO,GAAE,GAAG,CAAC,MAAM,CAAa,GAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwFxB;AA8ID;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IACR,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GACA,oBAAoB,CAUtB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAkC,MAAM,4BAA4B,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAG5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAcxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAS9B;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAOtD;AAED;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,SAAS,EAAE,MAAM;CAI9B;AAcD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,EAC7B,gBAAgB,CAAC,EAAE,MAAM,EACzB,OAAO,GAAE,GAAG,CAAC,MAAM,CAAa,GAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwFxB;AA+ID;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IACR,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GACA,oBAAoB,CAUtB"}

package/esm/src/transforms/mdx/esm-module-loader/module-fetcher/index.js

@@ -18,7 +18,7 @@ import { getModulePathCache } from "../cache/index.js";
 import { hashString } from "../utils/hash.js";
 import { resolveModuleFile } from "../resolution/file-finder.js";
 import { getTransformCacheKey, getVersionedPathCacheKey } from "./cache-keys.js";
-import { resolveNestedModuleImports } from "./nested-imports.js";
+import { resolveNestedImportBase, resolveNestedModuleImports } from "./nested-imports.js";
 import { readDistributedCache } from "./distributed-cache.js";
 import { resolveUnresolvedModuleViaHttpFallback } from "./http-fallback.js";
 import { normalizePath } from "./module-cache.js";
@@ -215,6 +215,7 @@ async function doFetchAndCacheModule(normalizedPath, context, fetchAndCacheModul
             moduleCode,
             esmCacheDir,
             normalizedPath,
+            parentBasePath: resolveNestedImportBase(normalizedPath, actualFilePath),
             strictMissingModules: context.strictMissingModules ?? true,
             projectSlug,
             fetchAndCacheModule: fetchAndCacheModuleFn,

package/esm/src/transforms/mdx/esm-module-loader/module-fetcher/nested-imports.d.ts

@@ -42,7 +42,26 @@ export interface ResolveNestedModuleImportsInput {
     strictMissingModules: boolean;
     fetchAndCacheModule: (path: string, parent?: string) => Promise<string | null>;
     log?: Logger;
+    /**
+     * Path this module's relative imports resolve against. Defaults to
+     * `normalizedPath`; see {@link resolveNestedImportBase}.
+     */
+    parentBasePath?: string;
 }
+/**
+ * The path a module's own relative imports should resolve against.
+ *
+ * A directory barrel lives at `lib/index.ts` but is addressed as
+ * `_vf_modules/lib`. Resolving its children against `_vf_modules/lib.js` drops
+ * the trailing segment as if it were a filename, so `./constants.js` becomes
+ * `_vf_modules/constants.js` — one directory too high. The file is then not
+ * found and gets replaced by a stub, and the barrel silently stops re-exporting
+ * anything: `does not provide an export named 'COLORS'`.
+ *
+ * When the module actually resolved to an index file, keep the directory
+ * segment by addressing it as `<dir>/index.js`.
+ */
+export declare function resolveNestedImportBase(normalizedPath: string, actualFilePath?: string): string;
 /**
  * Resolve nested /_vf_modules and relative imports into local file:// cache paths.
  */

package/esm/src/transforms/mdx/esm-module-loader/module-fetcher/nested-imports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nested-imports.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/nested-imports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAQtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAMzD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,GACjB;IACD,SAAS,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjF,QAAQ,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjF,CAkCA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAM3F;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,kBAAkB,EAAE,EAC7B,WAAW,EAAE,MAAM,EACnB,oBAAoB,EAAE,OAAO,EAC7B,gBAAgB,CAAC,EAAE,MAAM,EACzB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAqCjB;AAED,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,MAAM,CAAC,CAuDjB"}
+{"version":3,"file":"nested-imports.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/nested-imports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAQtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAMzD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,GACjB;IACD,SAAS,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjF,QAAQ,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjF,CAkCA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAM3F;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,kBAAkB,EAAE,EAC7B,WAAW,EAAE,MAAM,EACnB,oBAAoB,EAAE,OAAO,EAC7B,gBAAgB,CAAC,EAAE,MAAM,EACzB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAqCjB;AAED,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CASR;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,MAAM,CAAC,CA0DjB"}

package/esm/src/transforms/mdx/esm-module-loader/module-fetcher/nested-imports.js

@@ -83,6 +83,28 @@ export async function processNestedImports(moduleCode, results, esmCacheDir, str
     }
     return replaceSourceSpans(moduleCode, replacements);
 }
+/**
+ * The path a module's own relative imports should resolve against.
+ *
+ * A directory barrel lives at `lib/index.ts` but is addressed as
+ * `_vf_modules/lib`. Resolving its children against `_vf_modules/lib.js` drops
+ * the trailing segment as if it were a filename, so `./constants.js` becomes
+ * `_vf_modules/constants.js` — one directory too high. The file is then not
+ * found and gets replaced by a stub, and the barrel silently stops re-exporting
+ * anything: `does not provide an export named 'COLORS'`.
+ *
+ * When the module actually resolved to an index file, keep the directory
+ * segment by addressing it as `<dir>/index.js`.
+ */
+export function resolveNestedImportBase(normalizedPath, actualFilePath) {
+    if (!actualFilePath || !/(?:^|\/)index\.(?:tsx?|jsx?|mdx|md)$/.test(actualFilePath)) {
+        return normalizedPath;
+    }
+    const withoutExt = normalizedPath.replace(/\.(?:js|mjs)$/, "");
+    if (withoutExt.endsWith("/index"))
+        return normalizedPath;
+    return `${withoutExt}/index.js`;
+}
 /**
  * Resolve nested /_vf_modules and relative imports into local file:// cache paths.
  */
@@ -111,7 +133,7 @@ export async function resolveNestedModuleImports(input) {
         original,
         start,
         end,
-        nestedFilePath: await input.fetchAndCacheModule(path, input.normalizedPath),
+        nestedFilePath: await input.fetchAndCacheModule(path, input.parentBasePath ?? input.normalizedPath),
         [key]: path,
     })));
     input.log?.debug(`${LOG_PREFIX_MDX_LOADER} [fetchAndCacheModule] processing vfModules DONE`, {

package/esm/src/utils/version-constant.d.ts

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.1100";
+export declare const VERSION = "0.1.1101";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.1100";
+export const VERSION = "0.1.1101";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.1100",
+  "version": "0.1.1101",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -328,10 +328,10 @@
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
     "ws": "8.21.0",
-    "@veryfront/ext-bundler-esbuild": "0.1.1100",
-    "@veryfront/ext-content-mdx": "0.1.1100",
-    "@veryfront/ext-css-tailwind": "0.1.1100",
-    "@veryfront/ext-parser-babel": "0.1.1100"
+    "@veryfront/ext-bundler-esbuild": "0.1.1101",
+    "@veryfront/ext-content-mdx": "0.1.1101",
+    "@veryfront/ext-css-tailwind": "0.1.1101",
+    "@veryfront/ext-parser-babel": "0.1.1101"
   },
   "devDependencies": {
     "@types/node": "20.9.0"