veryfront 0.1.1237 → 0.1.1239

package/esm/src/transforms/mdx/compiler/mdx-compiler.js

@@ -1,8 +1,43 @@
 import { rendererLogger } from "../../../utils/index.js";
 import { resolve as resolveContract } from "../../../extensions/contracts.js";
-import { createError, toError } from "../../../errors/index.js";
+import { MDX_COMPILE_ERROR, VeryfrontError } from "../../../errors/index.js";
 import { withSpan } from "../../../observability/tracing/otlp-setup.js";
+import { isFrontmatterSyntaxError } from "./frontmatter-extractor.js";
 const logger = rendererLogger.component("mdx-compiler");
+const ObjectPrototypeHasOwnProperty = Object.prototype.hasOwnProperty;
+const ReflectApply = Reflect.apply;
+const ReflectGetOwnPropertyDescriptor = Reflect.getOwnPropertyDescriptor;
+function readOwnDataProperty(value, key) {
+    try {
+        const descriptor = ReflectGetOwnPropertyDescriptor(value, key);
+        if (descriptor !== undefined &&
+            ReflectApply(ObjectPrototypeHasOwnProperty, descriptor, ["value"]) === true) {
+            return descriptor.value;
+        }
+    }
+    catch {
+        // A hostile proxy cannot provide trusted source-diagnostic evidence.
+    }
+    return undefined;
+}
+function isMdxSourceCompileError(error) {
+    const source = readOwnDataProperty(error, "source");
+    const ruleId = readOwnDataProperty(error, "ruleId");
+    const line = readOwnDataProperty(error, "line");
+    const column = readOwnDataProperty(error, "column");
+    const isMdxParserError = typeof source === "string" &&
+        /(?:^|-)mdx(?:-|$)|micromark|remark|recma|rehype/.test(source) &&
+        typeof ruleId === "string" &&
+        Number.isSafeInteger(line) &&
+        Number.isSafeInteger(column);
+    // Frontmatter failures are identified by the symbol `extractFrontmatter`
+    // stamps at the throw site, not by matching stack-frame paths: `extract()` is
+    // the only frontmatter path and it tags every SyntaxError it raises. A
+    // stack-path heuristic would only add false positives (any SyntaxError whose
+    // stack happened to pass through the YAML shim) and does not survive
+    // `deno compile` anyway.
+    return isMdxParserError || isFrontmatterSyntaxError(error);
+}
 export function compileMDXRuntime(mode, projectDir, content, frontmatter, filePath, target = "server", baseUrl, studioEmbed) {
     return withSpan("transforms.compileMDXRuntime", async () => {
         try {
@@ -19,15 +54,19 @@ export function compileMDXRuntime(mode, projectDir, content, frontmatter, filePa
             });
         }
         catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
             logger.error("Compilation failed:", {
                 filePath,
-                error: error instanceof Error ? error.message : String(error),
-                stack: error instanceof Error ? error.stack : undefined,
+                error: err.message,
+                stack: err.stack,
+            });
+            if (err instanceof VeryfrontError || !isMdxSourceCompileError(err)) {
+                throw err;
+            }
+            throw MDX_COMPILE_ERROR.create({
+                detail: `MDX compilation error: ${err.message} | file: ${filePath ?? "<memory>"}`,
+                cause: err,
             });
-            throw toError(createError({
-                type: "build",
-                message: `MDX compilation error: ${error instanceof Error ? error.message : String(error)} | file: ${filePath ?? "<memory>"}`,
-            }));
         }
     }, {
         "mdx.filePath": filePath ?? "memory",

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAW5D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAK9D,eAAO,MAAM,kBAAkB,wBAE7B,CAAC;AAgIH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAOvF;AAUD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,CAM1F;AAqBD,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsBvF;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAezE;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C;AAQD,2DAA2D;AAC3D,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD;AAuBD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CA0ElE;AA+ED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,SAAwB,EACpC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAaT;AAED,wBAAsB,mCAAmC,CACvD,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,SAAwB,EACpC,SAAS,GAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAiD,EAChF,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,CAwBlB;AAOD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAevD;AAED,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAkEf;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAc1D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOzD;AAoBD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EAMnB,YAAY,CAAC,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,EAChE,YAAY,SAAwB,EACpC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,CA+J5B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAe5D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAK9D,eAAO,MAAM,kBAAkB,wBAE7B,CAAC;AAgIH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAOvF;AAUD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,CAM1F;AAqBD,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsBvF;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAezE;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C;AAQD,2DAA2D;AAC3D,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD;AAuBD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CA+ElE;AA+ED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,SAAwB,EACpC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAaT;AAED,wBAAsB,mCAAmC,CACvD,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,SAAwB,EACpC,SAAS,GAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAiD,EAChF,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,CAwBlB;AAOD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAevD;AAED,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAkEf;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAc1D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOzD;AAoBD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EAMnB,YAAY,CAAC,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,EAChE,YAAY,SAAwB,EACpC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,CA+J5B"}

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

@@ -14,7 +14,7 @@ import { LOG_PREFIX_MDX_LOADER } from "../constants.js";
 import { LRUCache } from "../../../../utils/lru-wrapper.js";
 import { registerCache } from "../../../../utils/memory/index.js";
 import { hashCodeHex } from "../../../../utils/hash-utils.js";
-import { buildMdxEsmPathCacheKey, MDX_ESM_ALL_FILE_URL_PATTERN_SOURCE } from "../cache-format.js";
+import { buildMdxEsmPathCacheKey, MDX_ESM_ALL_FILE_URL_PATTERN_SOURCE, UNRESOLVED_IMPORTS_SIDECAR_SUFFIX, } from "../cache-format.js";
 import { ensureMdxModuleDependencies } from "../module-fetcher/dependency-recovery.js";
 import { findStaticImportFromSpans } from "../utils/source-spans.js";
 import { formatCacheVersionSegment, isCacheVersionSegment, } from "../../../../utils/cache-version.js";
@@ -299,7 +299,7 @@ export function invalidateModulePaths(changedPaths) {
                 });
             }
         }
-        // Delete stale .mjs files from disk
+        // Delete stale modules and their tenant-attribution evidence from disk.
         for (const mjsPath of staleMjsFiles) {
             try {
                 await localFs.remove(mjsPath);
@@ -308,6 +308,12 @@ export function invalidateModulePaths(changedPaths) {
             catch (_) {
                 /* expected: file may already be gone */
             }
+            try {
+                await localFs.remove(`${mjsPath}${UNRESOLVED_IMPORTS_SIDECAR_SUFFIX}`);
+            }
+            catch (_) {
+                /* expected: most modules have no unresolved-import evidence */
+            }
         }
     };
     _pendingDiskCleanup = _pendingDiskCleanup.then(cleanup, cleanup).catch((error) => {

package/esm/src/transforms/mdx/esm-module-loader/cache-format.d.ts

@@ -1,3 +1,4 @@
+export declare const UNRESOLVED_IMPORTS_SIDECAR_SUFFIX = ".unresolved-imports.json";
 export declare const MDX_ESM_ALL_FILE_URL_PATTERN_SOURCE: string;
 export declare const MDX_ESM_MJS_FILE_URL_PATTERN_SOURCE: string;
 export declare const MDX_ESM_CACHE_NAMESPACE: string;

package/esm/src/transforms/mdx/esm-module-loader/cache-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-format.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/esm-module-loader/cache-format.ts"],"names":[],"mappings":"AAkJA,eAAO,MAAM,mCAAmC,QAA8B,CAAC;AAC/E,eAAO,MAAM,mCAAmC,QAA8B,CAAC;AAE/E,eAAO,MAAM,uBAAuB,QAGnC,CAAC;AAEF,eAAO,MAAM,mCAAmC,QAG/C,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAUR;AAED,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,MAAM,EACtB,YAAY,SAAwB,EACpC,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAOR;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,GACf,MAAM,CAOR;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAErF;AAED,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,MAAM,CAOR"}
+{"version":3,"file":"cache-format.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/esm-module-loader/cache-format.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,iCAAiC,6BAA6B,CAAC;AAuI5E,eAAO,MAAM,mCAAmC,QAA8B,CAAC;AAC/E,eAAO,MAAM,mCAAmC,QAA8B,CAAC;AAE/E,eAAO,MAAM,uBAAuB,QAGnC,CAAC;AAEF,eAAO,MAAM,mCAAmC,QAG/C,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAUR;AAED,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,MAAM,EACtB,YAAY,SAAwB,EACpC,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAOR;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,GACf,MAAM,CAOR;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAErF;AAED,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,MAAM,CAOR"}

package/esm/src/transforms/mdx/esm-module-loader/cache-format.js

@@ -8,6 +8,8 @@ import { hashString } from "./utils/hash.js";
 const ALL_FILE_URL_PATTERN_SOURCE = /file:\/\/([^"'\s]+)/.source;
 const MJS_FILE_URL_PATTERN_SOURCE = /file:\/\/([^"'\s]+\.mjs)/.source;
 const CACHE_NAMESPACE_SENTINEL = "__vf_cache_namespace__";
+export const UNRESOLVED_IMPORTS_SIDECAR_SUFFIX = ".unresolved-imports.json";
+const MDX_ESM_PATH_CACHE_ATTRIBUTION_SCHEMA = "unresolved-import-sidecars-v1";
 const PUBLIC_RUNTIME_SPECIFIERS = [
     "veryfront/head",
     "veryfront/router",
@@ -52,6 +54,7 @@ function buildMdxEsmCacheSchemaSample() {
         unresolvedVfModulesPattern: UNRESOLVED_VF_MODULES_PATTERN.source,
         allFileUrlPattern: ALL_FILE_URL_PATTERN_SOURCE,
         mjsFileUrlPattern: MJS_FILE_URL_PATTERN_SOURCE,
+        pathCacheAttributionSchema: MDX_ESM_PATH_CACHE_ATTRIBUTION_SCHEMA,
         sourceHashing: [
             hashString("_vf_modules/pages/index.jsexport default 1;"),
             hashString("/tmp/project/Button.tsx\0export default function Button() {}"),

package/esm/src/transforms/mdx/esm-module-loader/loader-helpers.d.ts

@@ -25,8 +25,10 @@ export declare function initializeCacheDir(context: ESMLoaderContext): Promise<s
 export declare function findVfModuleImports(code: string): Array<{
     original: string;
     path: string;
+    suffix: string;
     start: number;
     end: number;
+    isDynamic?: boolean;
 }>;
 /**
  * Process /_vf_modules/ imports and replace them with file:// paths.
@@ -34,7 +36,9 @@ export declare function findVfModuleImports(code: string): Array<{
 export declare function processVfModuleImports(code: string, imports: Array<{
     original: string;
     path: string;
+    suffix?: string;
     start: number;
     end: number;
+    isDynamic?: boolean;
 }>, context: ESMLoaderContext, projectDir: string, strictMissingModules: boolean): Promise<string>;
 //# sourceMappingURL=loader-helpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"loader-helpers.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/esm-module-loader/loader-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAQnD;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAapF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAWnE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgCnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,GACX,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAMvE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,EAC9E,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,MAAM,EAClB,oBAAoB,EAAE,OAAO,GAC5B,OAAO,CAAC,MAAM,CAAC,CA4HjB"}
+{"version":3,"file":"loader-helpers.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/esm-module-loader/loader-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAwBH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AASnD;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAapF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAWnE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgCnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,GACX,KAAK,CAAC;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC,CAoBD;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC,EACF,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,MAAM,EAClB,oBAAoB,EAAE,OAAO,GAC5B,OAAO,CAAC,MAAM,CAAC,CA4JjB"}

package/esm/src/transforms/mdx/esm-module-loader/loader-helpers.js

@@ -17,11 +17,13 @@ import { exists as fsExists } from "../../../platform/compat/fs.js";
 import { LOG_PREFIX_MDX_LOADER } from "./constants.js";
 import { getLocalFs } from "./cache/index.js";
 import { createStubModule } from "./utils/stub-module.js";
-import { findStaticImportFromSpans, replaceSourceSpans, } from "./utils/source-spans.js";
+import { findDynamicImportSpans, findStaticImportFromSpans, replaceSourceSpans, } from "./utils/source-spans.js";
 import { createModuleFetcherContext, fetchAndCacheModule } from "./module-fetcher/index.js";
 import { buildMissingModuleError } from "./missing-module.js";
+import { dynamicDependencyFailure, toImportStringLiteral, } from "./module-fetcher/nested-imports.js";
 import { parallelMap } from "../../../utils/parallel.js";
 import { assertMdxModuleImportCount, MAX_MDX_MODULE_IMPORTS_PER_FILE, MAX_MDX_MODULE_TRANSFORM_CONCURRENCY, } from "./module-fetcher/limits.js";
+import { splitSpecifierSuffix } from "../../shared/specifier-suffix.js";
 /**
  * Check which framework bundles are missing from disk.
  * Returns the list of missing file paths.
@@ -92,7 +94,15 @@ export async function initializeCacheDir(context) {
  * Find /_vf_modules/ imports in code.
  */
 export function findVfModuleImports(code) {
-    return findStaticImportFromSpans(code, (specifier) => specifier.match(/^\/?(_vf_modules\/[^?]+)(?:\?.*)?$/)?.[1], MAX_MDX_MODULE_IMPORTS_PER_FILE + 1);
+    const matchVfModule = (specifier) => specifier.match(/^\/?(_vf_modules\/.+)$/)?.[1] ?? null;
+    const staticImports = findStaticImportFromSpans(code, matchVfModule, MAX_MDX_MODULE_IMPORTS_PER_FILE + 1);
+    const dynamicImports = findDynamicImportSpans(code, matchVfModule, MAX_MDX_MODULE_IMPORTS_PER_FILE + 1).map((importSpan) => ({ ...importSpan, isDynamic: true }));
+    return [...staticImports, ...dynamicImports]
+        .map((importSpan) => {
+        const { path, suffix } = splitSpecifierSuffix(importSpan.path);
+        return { ...importSpan, path, suffix };
+    })
+        .sort((left, right) => left.start - right.start);
 }
 /**
  * Process /_vf_modules/ imports and replace them with file:// paths.
@@ -137,7 +147,7 @@ export async function processVfModuleImports(code, imports, context, projectDir,
         strictMissingModules,
     });
     const fetchStart = performance.now();
-    const results = await parallelMap(imports, async ({ original, path, start, end }, index) => {
+    const results = await parallelMap(imports, async ({ original, path, suffix, start, end, isDynamic }, index) => {
         return await withSpan(SpanNames.MDX_FETCH_MODULE, async () => {
             const moduleStart = performance.now();
             logger.debug(`${LOG_PREFIX_MDX_LOADER} Fetching module START`, {
@@ -145,14 +155,26 @@ export async function processVfModuleImports(code, imports, context, projectDir,
                 index,
                 path,
             });
-            const filePath = await fetchAndCacheModule(path, fetcherContext);
+            let filePath;
+            let deferredError;
+            try {
+                filePath = await fetchAndCacheModule(path, fetcherContext);
+            }
+            catch (error) {
+                if (!isDynamic)
+                    throw error;
+                deferredError = dynamicDependencyFailure(path, error) ?? undefined;
+                if (!deferredError)
+                    throw error;
+                filePath = null;
+            }
             logger.debug(`${LOG_PREFIX_MDX_LOADER} Fetching module DONE`, {
                 projectSlug,
                 index,
                 path,
                 durationMs: (performance.now() - moduleStart).toFixed(1),
             });
-            return { original, start, end, filePath, path };
+            return { original, start, end, filePath, path, suffix, isDynamic, deferredError };
         }, {
             "mdx.module_path": path,
             "mdx.module_index": index,
@@ -165,16 +187,29 @@ export async function processVfModuleImports(code, imports, context, projectDir,
         durationMs: (performance.now() - fetchStart).toFixed(1),
     });
     const replacements = [];
-    for (const { original, start, end, filePath, path } of results) {
+    for (const { original, start, end, filePath, path, suffix, isDynamic, deferredError } of results) {
         if (filePath) {
+            const importTarget = toImportStringLiteral(`file://${filePath}${suffix ?? ""}`);
             replacements.push({
                 start,
                 end,
                 expected: original,
-                replacement: `from "file://${filePath}"`,
+                replacement: isDynamic ? importTarget : `from ${importTarget}`,
             });
             continue;
         }
+        if (isDynamic) {
+            const deferredPath = await createStubModule(path, code, original, context.esmCacheDir, { failOnImport: strictMissingModules, deferredError });
+            if (deferredPath) {
+                replacements.push({
+                    start,
+                    end,
+                    expected: original,
+                    replacement: toImportStringLiteral(`file://${deferredPath}${suffix ?? ""}`),
+                });
+                continue;
+            }
+        }
         if (strictMissingModules) {
             throw buildMissingModuleError({
                 modulePath: path,
@@ -186,11 +221,12 @@ export async function processVfModuleImports(code, imports, context, projectDir,
         }
         const stubPath = await createStubModule(path, code, original, context.esmCacheDir);
         if (stubPath) {
+            const importTarget = toImportStringLiteral(`file://${stubPath}${suffix ?? ""}`);
             replacements.push({
                 start,
                 end,
                 expected: original,
-                replacement: `from "file://${stubPath}"`,
+                replacement: isDynamic ? importTarget : `from ${importTarget}`,
             });
         }
     }

package/esm/src/transforms/mdx/esm-module-loader/missing-module.d.ts

@@ -9,5 +9,7 @@ type MissingModuleContext = {
     projectSlug?: string;
 };
 export declare function buildMissingModuleError(ctx: MissingModuleContext): Error;
+/** Return true only for missing-module errors produced by this loader. */
+export declare function isMdxMissingModuleError(error: unknown): boolean;
 export {};
 //# sourceMappingURL=missing-module.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"missing-module.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/esm-module-loader/missing-module.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,KAAK,oBAAoB,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAcF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,oBAAoB,GAAG,KAAK,CA4BxE"}
+{"version":3,"file":"missing-module.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/esm-module-loader/missing-module.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,KAAK,oBAAoB,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAcF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,oBAAoB,GAAG,KAAK,CA4BxE;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE/D"}

package/esm/src/transforms/mdx/esm-module-loader/missing-module.js

@@ -39,3 +39,7 @@ export function buildMissingModuleError(ctx) {
     }
     return error;
 }
+/** Return true only for missing-module errors produced by this loader. */
+export function isMdxMissingModuleError(error) {
+    return error instanceof Error && error.name === "MissingModuleError";
+}

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

@@ -1 +1 @@
-{"version":3,"file":"http-fallback.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/http-fallback.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,KAAK,oBAAoB,GAAG,OAAO,kBAAkB,CAAC;AACtD,KAAK,kBAAkB,GAAG,OAAO,WAAW,CAAC;AAE7C,MAAM,WAAW,2CAA2C;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/E,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,gBAAgB,CAAC,EAAE,kBAAkB,CAAC;CACvC;AAED;;GAEG;AACH,wBAAsB,sCAAsC,CAC1D,KAAK,EAAE,2CAA2C,GACjD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqCxB"}
+{"version":3,"file":"http-fallback.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/http-fallback.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,KAAK,oBAAoB,GAAG,OAAO,kBAAkB,CAAC;AACtD,KAAK,kBAAkB,GAAG,OAAO,WAAW,CAAC;AAE7C,MAAM,WAAW,2CAA2C;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/E,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,gBAAgB,CAAC,EAAE,kBAAkB,CAAC;CACvC;AAED;;GAEG;AACH,wBAAsB,sCAAsC,CAC1D,KAAK,EAAE,2CAA2C,GACjD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyCxB"}

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

@@ -12,7 +12,11 @@ import { cacheModule } from "./module-cache.js";
 export async function resolveUnresolvedModuleViaHttpFallback(input) {
     const fetchViaHttp = input.fetchViaHttp ?? fetchModuleViaHTTP;
     const cacheLocalModule = input.cacheLocalModule ?? cacheModule;
-    const moduleCode = await fetchViaHttp(input.normalizedPath, input.adapter, input.fetchAndCacheModule, input.log, input.projectSlug, input.isLocalProject, input.dependencyPinningCacheKey, { moduleServerOrigin: input.moduleServerOrigin });
+    const moduleCode = await fetchViaHttp(input.normalizedPath, input.adapter, input.fetchAndCacheModule, input.log, input.projectSlug, input.isLocalProject, input.dependencyPinningCacheKey, {
+        esmCacheDir: input.esmCacheDir,
+        moduleServerOrigin: input.moduleServerOrigin,
+        strictMissingModules: input.strictMissingModules ?? true,
+    });
     if (moduleCode) {
         return await cacheLocalModule(input.normalizedPath, moduleCode, input.esmCacheDir, input.pathCache, input.log, input.reactVersion, input.dependencyPinningCacheKey, input.moduleServerOrigin);
     }

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

@@ -9,8 +9,10 @@
 import type { Logger } from "../../../../utils/index.js";
 import type { RuntimeAdapter } from "../../../../platform/adapters/base.js";
 export interface FetchModuleViaHttpOptions {
+    esmCacheDir?: string;
     fetchFn?: typeof fetch;
     moduleServerOrigin?: string;
+    strictMissingModules?: boolean;
     timeoutMs?: number;
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"http-fetcher.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/http-fetcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAa5E,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6GD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,cAAc,EACvB,qBAAqB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EAChF,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,OAAO,EACxB,yBAAyB,CAAC,EAAE,MAAM,EAClC,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiIxB"}
+{"version":3,"file":"http-fetcher.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/http-fetcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAkB5E,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6GD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,cAAc,EACvB,qBAAqB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EAChF,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,OAAO,EACxB,yBAAyB,CAAC,EAAE,MAAM,EAClC,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA8KxB"}

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

@@ -10,7 +10,7 @@ import { SpanNames } from "../../../../observability/index.js";
 import { withSpan } from "../../../../observability/tracing/otlp-setup.js";
 import { LOG_PREFIX_MDX_LOADER } from "../constants.js";
 import { rewriteVeryfrontImports } from "./import-rewriter.js";
-import { findNestedImports } from "./nested-imports.js";
+import { dynamicDependencyFailure, findNestedImports, toImportStringLiteral, } from "./nested-imports.js";
 import { replaceSourceSpans } from "../utils/source-spans.js";
 import { HTTP_FETCH_TIMEOUT_MS } from "../../../../utils/constants/http.js";
 import { readHttpModuleText } from "../../../shared/http-module-response.js";
@@ -19,6 +19,7 @@ import { MAX_TIMER_DELAY_MS } from "../../../../utils/constants/limits.js";
 import { parallelMap } from "../../../../utils/parallel.js";
 import { Semaphore } from "../../../../modules/react-loader/ssr-module-loader/concurrency/semaphore.js";
 import { assertMdxModuleImportCount, MAX_MDX_MODULE_TRANSFORM_CONCURRENCY } from "./limits.js";
+import { createStubModule } from "../utils/stub-module.js";
 function discardResponseBody(response) {
     try {
         const cancellation = response.body?.cancel();
@@ -76,7 +77,7 @@ function isNameResolutionError(error) {
  * RFC 6761 only *recommends* that resolvers map the `.localhost` tree to
  * loopback. macOS, systemd-resolved and CI honour it for arbitrary subdomains,
  * but a plain glibc NSS setup can resolve only the bare name and fail
- * `<slug>.localhost` with EAI_AGAIN/ENOTFOUND — which would make this fallback
+ * `<slug>.localhost` with EAI_AGAIN/ENOTFOUND, which would make this fallback
  * unable to reach the dev server at all.
  *
  * Pinning the connection to 127.0.0.1 while keeping subdomain routing is not an
@@ -85,8 +86,8 @@ function isNameResolutionError(error) {
  *
  * The retry therefore carries the project in `x-project-slug`, which the dev
  * server reads inbound (see server/context/request-context.ts and
- * server/runtime-handler/project-resolution.ts) and which fetch — unlike `Host`
- * — is allowed to set. Without it a multi-project workspace would lose tenant
+ * server/runtime-handler/project-resolution.ts) and which fetch, unlike `Host`,
+ * is allowed to set. Without it a multi-project workspace would lose tenant
  * identity, because resolveDefaultProjectSlug() returns undefined there.
  */
 async function fetchModuleWithLoopbackFallback(fetchFn, url, init, log, projectSlug) {
@@ -164,36 +165,74 @@ export async function fetchModuleViaHTTP(normalizedPath, adapter, fetchAndCacheM
         const moduleCode = rewriteVeryfrontImports(await readHttpModuleText(response, MAX_MDX_MODULE_CODE_BYTES, controller.signal));
         const { vfModules, relative } = findNestedImports(moduleCode);
         const allImports = [
-            ...vfModules.map(({ original, path, start, end }) => ({
+            ...vfModules.map(({ original, path, suffix, start, end, isDynamic, isSideEffect }) => ({
                 original,
                 path,
+                suffix,
                 start,
                 end,
+                isDynamic,
+                isSideEffect,
                 key: "nestedPath",
             })),
-            ...relative.map(({ original, path, start, end }) => ({
+            ...relative.map(({ original, path, suffix, start, end, isDynamic, isSideEffect }) => ({
                 original,
                 path,
+                suffix,
                 start,
                 end,
+                isDynamic,
+                isSideEffect,
                 key: "relativePath",
             })),
         ];
         assertMdxModuleImportCount(normalizedPath, allImports.length);
-        const results = await parallelMap(allImports, async ({ original, path, start, end, key }) => {
-            const nestedFilePath = await fetchAndCacheModuleFn(path, normalizedPath);
-            return { original, start, end, nestedFilePath, [key]: path };
+        const results = await parallelMap(allImports, async ({ original, path, suffix, start, end, isDynamic, isSideEffect, key }) => {
+            let nestedFilePath;
+            let deferredError;
+            try {
+                nestedFilePath = await fetchAndCacheModuleFn(path, normalizedPath);
+            }
+            catch (error) {
+                deferredError = isDynamic
+                    ? dynamicDependencyFailure(path, error) ?? undefined
+                    : undefined;
+                if (!deferredError || !options.esmCacheDir)
+                    throw error;
+                nestedFilePath = null;
+            }
+            if (!nestedFilePath && isDynamic && options.esmCacheDir) {
+                nestedFilePath = await createStubModule(path, moduleCode, original, options.esmCacheDir, { failOnImport: options.strictMissingModules ?? true, deferredError });
+            }
+            return {
+                original,
+                start,
+                end,
+                suffix,
+                isDynamic,
+                isSideEffect,
+                nestedFilePath,
+                [key]: path,
+            };
         }, {
             semaphore: new Semaphore(MAX_MDX_MODULE_TRANSFORM_CONCURRENCY),
         });
         const replacements = [];
-        for (const { original, start, end, nestedFilePath } of results) {
+        for (const { original, start, end, suffix, isDynamic, isSideEffect, nestedFilePath } of results) {
             if (nestedFilePath) {
+                // The suffix and the cache path are author- and filesystem-controlled.
+                // Interpolating either into a hand-written double-quoted literal emits
+                // a module that fails to parse whenever one contains `"` or `\`.
+                const importTarget = toImportStringLiteral(`file://${nestedFilePath}${suffix ?? ""}`);
                 replacements.push({
                     start,
                     end,
                     expected: original,
-                    replacement: `from "file://${nestedFilePath}"`,
+                    replacement: isDynamic
+                        ? importTarget
+                        : isSideEffect
+                            ? `import ${importTarget}`
+                            : `from ${importTarget}`,
                 });
             }
         }

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

@@ -4,24 +4,35 @@
  * @module transforms/mdx/esm-module-loader/module-fetcher/nested-imports
  */
 import type { NestedImportResult } from "../types.js";
+import { type DeferredImportErrorDescriptor } from "../utils/stub-module.js";
 import type { Logger } from "../../../../utils/index.js";
+type NestedImportSpan = {
+    original: string;
+    path: string;
+    start: number;
+    end: number;
+    suffix?: string;
+    isDynamic?: boolean;
+    isSideEffect?: boolean;
+};
+/** Return the sanitized runtime failure for a dependency error that can stay lazy. */
+export declare function dynamicDependencyFailure(modulePath: string, error: unknown): DeferredImportErrorDescriptor | null;
+/**
+ * Serialize a resolved module URL as a JavaScript string literal.
+ *
+ * A preserved suffix is author-controlled text (`?label="x"`, a backslash in a
+ * cache path). Wrapping it in quotes by hand emits a module that fails to
+ * parse, taking every other import in the file down with it, so every emitted
+ * specifier must go through this.
+ */
+export declare function toImportStringLiteral(url: string): string;
 /**
  * Find nested module imports in code.
  * Matches both /_vf_modules/... and file:///_vf_modules/... patterns.
  */
 export declare function findNestedImports(moduleCode: string): {
-    vfModules: Array<{
-        original: string;
-        path: string;
-        start: number;
-        end: number;
-    }>;
-    relative: Array<{
-        original: string;
-        path: string;
-        start: number;
-        end: number;
-    }>;
+    vfModules: NestedImportSpan[];
+    relative: NestedImportSpan[];
 };
 /**
  * Check for unresolved /_vf_modules/ imports.
@@ -68,4 +79,5 @@ export declare function resolveNestedImportBase(normalizedPath: string, actualFi
  * Resolve nested /_vf_modules and relative imports into local file:// cache paths.
  */
 export declare function resolveNestedModuleImports(input: ResolveNestedModuleImportsInput): Promise<string>;
+export {};
 //# sourceMappingURL=nested-imports.d.ts.map

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;AAazD;;;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,CAoCA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAU3F;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;AAoBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,MAAM,CAAC,CAgEjB"}
+{"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;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAoB,KAAK,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AAW/F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAezD,KAAK,gBAAgB,GAAG;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAQF,sFAAsF;AACtF,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,GACb,6BAA6B,GAAG,IAAI,CAgDtC;AAaD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,GACjB;IACD,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B,CAoIA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAoC3F;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,CA+EjB;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;AAoBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,MAAM,CAAC,CAyFjB"}