veryfront 0.1.88 → 0.1.89

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.88",
+    "version": "0.1.89",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "exclude": [

package/esm/src/rendering/orchestrator/module-loader/index.js

@@ -18,8 +18,8 @@ import { validateCachedBundlesByManifestOrCode } from "../../../transforms/esm/c
 import { getHttpBundleCacheDir, getMdxEsmCacheDir } from "../../../utils/cache-dir.js";
 import { dirname, join, normalize } from "../../../platform/compat/path/index.js";
 import { hashCodeHex } from "../../../utils/hash-utils.js";
-import { VERSION } from "../../../utils/version.js";
 import { getModulePathCache, lookupMdxEsmCache, saveModulePathCache, } from "../../../transforms/mdx/esm-module-loader/cache/index.js";
+import { buildMdxEsmPathCacheKey } from "../../../transforms/mdx/esm-module-loader/cache-format.js";
 const logger = rendererLogger.component("module-loader");
 // Re-export utilities
 export { createEsmCache, createModuleCache, generateHash } from "./cache.js";
@@ -327,7 +327,7 @@ export async function transformModuleWithDeps(filePath, tmpDir, localAdapter, co
     }
     if (contentSourceId) {
         const normalizedPath = `_vf_modules/${relativePath.replace(/\.(tsx?|jsx|mdx)$/, ".js")}`;
-        const mdxCacheKey = `v${VERSION}:${normalizedPath}`;
+        const mdxCacheKey = buildMdxEsmPathCacheKey(normalizedPath);
         const cache = await getModulePathCache(tmpDir);
         cache.set(mdxCacheKey, tempFilePath);
         saveModulePathCache(tmpDir).catch((err) => {

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;AASH,OAAO,EAEL,KAAK,UAAU,EAEhB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAE5D,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;AAI9D,eAAO,MAAM,kBAAkB,wBAE7B,CAAC;AA4GH,wBAAgB,UAAU,IAAI,UAAU,CAGvC;AAKD,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;AAED,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CA0ElE;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAevD;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAc1D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIzD;AAeD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAyG5B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,EAEL,KAAK,UAAU,EAEhB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAG5D,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;AAI9D,eAAO,MAAM,kBAAkB,wBAE7B,CAAC;AA0GH,wBAAgB,UAAU,IAAI,UAAU,CAGvC;AAKD,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;AAED,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CA0ElE;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAevD;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAc1D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIzD;AAeD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAyG5B"}

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

@@ -9,14 +9,13 @@ import { join } from "../../../../platform/compat/path/index.js";
 import { rendererLogger as logger } from "../../../../utils/index.js";
 import { getCacheBaseDir, getHttpBundleCacheDir, getMdxEsmCacheDir, } from "../../../../utils/cache-dir.js";
 import { createFileSystem, isNotFoundError, } from "../../../../platform/compat/fs.js";
-import { VERSION } from "../../../../utils/version.js";
 import { LOG_PREFIX_MDX_LOADER } from "../constants.js";
 import { LRUCache } from "../../../../utils/lru-wrapper.js";
+import { buildMdxEsmPathCacheKey, MDX_ESM_ALL_FILE_URL_PATTERN_SOURCE } from "../cache-format.js";
 const MAX_VERIFIED_MODULE_DEPS = 2_000;
 export const verifiedModuleDeps = new LRUCache({
     maxEntries: MAX_VERIFIED_MODULE_DEPS,
 });
-const FILE_PATH_PATTERN = /file:\/\/([^"'\s]+)/gi;
 /**
  * Check if cached code has file:// paths from a different environment.
  * Checks both HTTP bundle paths and MDX ESM cache paths.
@@ -25,7 +24,7 @@ function hasIncompatibleCachePaths(code) {
     const localCacheBaseDir = getCacheBaseDir();
     const localHttpCacheDir = getHttpBundleCacheDir();
     const localMdxCacheDir = getMdxEsmCacheDir();
-    const pattern = new RegExp(FILE_PATH_PATTERN.source, "gi");
+    const pattern = new RegExp(MDX_ESM_ALL_FILE_URL_PATTERN_SOURCE, "gi");
     let match;
     while ((match = pattern.exec(code)) !== null) {
         const path = match[1];
@@ -64,7 +63,7 @@ function hasIncompatibleCachePaths(code) {
  */
 async function findMissingFileDependencies(code) {
     const localFs = getLocalFs();
-    const pattern = new RegExp(FILE_PATH_PATTERN.source, "gi");
+    const pattern = new RegExp(MDX_ESM_ALL_FILE_URL_PATTERN_SOURCE, "gi");
     const missing = [];
     let match;
     while ((match = pattern.exec(code)) !== null) {
@@ -284,7 +283,7 @@ function toMdxEsmCacheKey(filePath, projectDir) {
     }
     relativePath = relativePath.replace(/^\/+/, "");
     const jsPath = relativePath.replace(/\.(tsx?|jsx|mdx)$/, ".js");
-    return `v${VERSION}:_vf_modules/${jsPath}`;
+    return buildMdxEsmPathCacheKey(`_vf_modules/${jsPath}`);
 }
 export async function lookupMdxEsmCache(filePath, cacheDir, projectDir, _contentHash) {
     const cache = await getModulePathCache(cacheDir);
@@ -356,9 +355,9 @@ export async function lookupMdxEsmCache(filePath, cacheDir, projectDir, _content
             };
         }
         // Note: We intentionally skip contentHash validation for MDX-ESM cached files.
-        // The MDX-ESM cache uses transformed-code hashes in filenames (vfmod-v{VERSION}-{hash}.mjs),
+        // The MDX-ESM cache uses transformed-code hashes in namespaced filenames,
         // while the SSR loader provides source-code hashes. These will never match.
-        // The cache version in the key (v{VERSION}:) provides sufficient staleness protection,
+        // The cache namespace in the key provides sufficient staleness protection,
         // and the file's existence confirms it's a valid transform for this codebase.
         // This allows both loaders to share the same module instance, preventing
         // duplicate React contexts which break hooks like useContext.

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

@@ -0,0 +1,10 @@
+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;
+export declare const FRAMEWORK_VF_MODULE_CACHE_NAMESPACE: string;
+export declare function buildMdxEsmTransformCacheKey(projectId: string, normalizedPath: string, contentHash: string): string;
+export declare function buildMdxEsmPathCacheKey(normalizedPath: string): string;
+export declare function buildMdxEsmModuleFileName(contentHash: string): string;
+export declare function buildMdxJsxCacheFileName(filePath: string): string;
+export declare function buildFrameworkVfModuleCacheFileName(pathHash: string, envKey: string, contentHash: string): string;
+//# sourceMappingURL=cache-format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache-format.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/esm-module-loader/cache-format.ts"],"names":[],"mappings":"AAuEA,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,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,MAAM,CAOR;AAED,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjE;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

@@ -0,0 +1,61 @@
+import { hashCodeHex } from "../../../utils/hash-utils.js";
+import { createCacheNamespace } from "../../../utils/cache-namespace.js";
+import { UNRESOLVED_VF_MODULES_PATTERN } from "./constants.js";
+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__";
+function formatMdxEsmTransformCacheKey(namespace, projectId, normalizedPath, contentHash) {
+    return `${namespace}:${projectId}:${normalizedPath}:${contentHash}:ssr`;
+}
+function formatMdxEsmPathCacheKey(namespace, normalizedPath) {
+    return `${namespace}:${normalizedPath}`;
+}
+function formatMdxEsmModuleFileName(namespace, contentHash) {
+    return `vfmod-${namespace}-${contentHash}.mjs`;
+}
+function formatMdxJsxCacheFileName(namespace, filePath) {
+    return `jsx-${namespace}-${hashString(filePath)}.mjs`;
+}
+function formatFrameworkVfModuleCacheFileName(namespace, pathHash, envKey, contentHash) {
+    return `vfmod-${namespace}-${pathHash}-${envKey}-${contentHash}.mjs`;
+}
+function buildMdxEsmCacheSchemaSample() {
+    return {
+        transformKey: formatMdxEsmTransformCacheKey(CACHE_NAMESPACE_SENTINEL, "__vf_project__", "_vf_modules/pages/index.js", "deadbeef"),
+        pathKey: formatMdxEsmPathCacheKey(CACHE_NAMESPACE_SENTINEL, "_vf_modules/pages/index.js"),
+        moduleFile: formatMdxEsmModuleFileName(CACHE_NAMESPACE_SENTINEL, "deadbeef"),
+        jsxFile: formatMdxJsxCacheFileName(CACHE_NAMESPACE_SENTINEL, "/tmp/project/Button.tsx"),
+        unresolvedVfModulesPattern: UNRESOLVED_VF_MODULES_PATTERN.source,
+        allFileUrlPattern: ALL_FILE_URL_PATTERN_SOURCE,
+        mjsFileUrlPattern: MJS_FILE_URL_PATTERN_SOURCE,
+        sourceHashing: [
+            hashString("_vf_modules/pages/index.jsexport default 1;"),
+            hashString("/tmp/project/Button.tsx"),
+        ],
+    };
+}
+function buildFrameworkVfModuleCacheSchemaSample() {
+    return {
+        moduleFile: formatFrameworkVfModuleCacheFileName(CACHE_NAMESPACE_SENTINEL, hashCodeHex("_vf_modules/_veryfront/react/components/Head.js"), hashCodeHex("/app/.cache/veryfront-mdx-esm").slice(0, 8), hashCodeHex("export default function Head() {}")),
+    };
+}
+export const MDX_ESM_ALL_FILE_URL_PATTERN_SOURCE = ALL_FILE_URL_PATTERN_SOURCE;
+export const MDX_ESM_MJS_FILE_URL_PATTERN_SOURCE = MJS_FILE_URL_PATTERN_SOURCE;
+export const MDX_ESM_CACHE_NAMESPACE = createCacheNamespace("mdx-esm", buildMdxEsmCacheSchemaSample());
+export const FRAMEWORK_VF_MODULE_CACHE_NAMESPACE = createCacheNamespace("vf-framework", buildFrameworkVfModuleCacheSchemaSample());
+export function buildMdxEsmTransformCacheKey(projectId, normalizedPath, contentHash) {
+    return formatMdxEsmTransformCacheKey(MDX_ESM_CACHE_NAMESPACE, projectId, normalizedPath, contentHash);
+}
+export function buildMdxEsmPathCacheKey(normalizedPath) {
+    return formatMdxEsmPathCacheKey(MDX_ESM_CACHE_NAMESPACE, normalizedPath);
+}
+export function buildMdxEsmModuleFileName(contentHash) {
+    return formatMdxEsmModuleFileName(MDX_ESM_CACHE_NAMESPACE, contentHash);
+}
+export function buildMdxJsxCacheFileName(filePath) {
+    return formatMdxJsxCacheFileName(MDX_ESM_CACHE_NAMESPACE, filePath);
+}
+export function buildFrameworkVfModuleCacheFileName(pathHash, envKey, contentHash) {
+    return formatFrameworkVfModuleCacheFileName(FRAMEWORK_VF_MODULE_CACHE_NAMESPACE, pathHash, envKey, contentHash);
+}

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

@@ -1 +1 @@
-{"version":3,"file":"import-transformer.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/esm-module-loader/import-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAgB5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK9E;AAyBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,MAAM,CAIjF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,EACpC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CA0HjB"}
+{"version":3,"file":"import-transformer.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/mdx/esm-module-loader/import-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAe5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK9E;AAyBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,MAAM,CAIjF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,EACpC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CA0HjB"}

package/esm/src/transforms/mdx/esm-module-loader/import-transformer.js

@@ -9,12 +9,11 @@
 import { join } from "../../../platform/compat/path/index.js";
 import { rendererLogger as logger } from "../../../utils/index.js";
 import { transformImportsWithMap } from "../../../modules/import-map/index.js";
-import { VERSION } from "../../../utils/version.js";
 import { replaceSpecifiers } from "../../esm/lexer.js";
 import { getLocalReactPaths, isReactSpecifier } from "../../../platform/compat/react-paths.js";
 import { ESBUILD_JSX_FACTORY, ESBUILD_JSX_FRAGMENT, FRAMEWORK_ROOT, JSX_IMPORT_PATTERN, LOG_PREFIX_MDX_LOADER, REACT_IMPORT_PATTERN, } from "./constants.js";
 import { getLocalFs } from "./cache/index.js";
-import { hashString } from "./utils/hash.js";
+import { buildMdxJsxCacheFileName } from "./cache-format.js";
 import { rewriteDntImports } from "./module-fetcher/index.js";
 import { ensureCachedJsxModulePatched } from "./jsx-cache.js";
 /**
@@ -93,7 +92,7 @@ export async function transformJsxImports(code, adapter, esmCacheDir) {
     logger.debug(`${LOG_PREFIX_MDX_LOADER} Transforming ${importsToProcess.length} JSX imports in parallel`);
     const transformResults = await Promise.all(importsToProcess.map(async ({ fullMatch, importClause, filePath, ext }) => {
         try {
-            const transformedFileName = `jsx-v${VERSION}-${hashString(filePath)}.mjs`;
+            const transformedFileName = buildMdxJsxCacheFileName(filePath);
             const transformedPath = join(esmCacheDir, transformedFileName);
             try {
                 const stat = await getLocalFs().stat(transformedPath);

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

@@ -3,7 +3,7 @@
  *
  * @module transforms/mdx/esm-module-loader/module-fetcher/cache-keys
  */
-import { VERSION } from "../../../../utils/version.js";
+import { buildMdxEsmPathCacheKey, buildMdxEsmTransformCacheKey } from "../cache-format.js";
 /**
  * Build cache key for transformed module.
  * Includes content hash so cache invalidates when source changes.
@@ -12,8 +12,8 @@ import { VERSION } from "../../../../utils/version.js";
  * that use relative paths (../lib/utils.js) instead of absolute paths (/_vf_modules/lib/utils.js).
  */
 export function getTransformCacheKey(projectId, normalizedPath, contentHash) {
-    return `v${VERSION}:${projectId}:${normalizedPath}:${contentHash}:ssr`;
+    return buildMdxEsmTransformCacheKey(projectId, normalizedPath, contentHash);
 }
 export function getVersionedPathCacheKey(normalizedPath) {
-    return `v${VERSION}:${normalizedPath}`;
+    return buildMdxEsmPathCacheKey(normalizedPath);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"framework-validator.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/framework-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAOjE;;;;;;;;;;;;GAYG;AACH,wBAAsB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqE/F;AAED;;;;;;GAMG;AACH,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,EAAE,CAAC,CA6BnB;AAYD,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAkDlB"}
+{"version":3,"file":"framework-validator.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/framework-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAQjE;;;;;;;;;;;;GAYG;AACH,wBAAsB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqE/F;AAED;;;;;;GAMG;AACH,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,EAAE,CAAC,CA6BnB;AAYD,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAkDlB"}

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

@@ -11,6 +11,7 @@ import { FRAMEWORK_ROOT, LOG_PREFIX_MDX_LOADER } from "../constants.js";
 import { getLocalFs } from "../cache/index.js";
 import { extractHttpBundlePaths } from "../../../../modules/react-loader/ssr-module-loader/http-bundle-helpers.js";
 import { ensureHttpBundlesExist } from "../../../esm/http-cache.js";
+import { MDX_ESM_MJS_FILE_URL_PATTERN_SOURCE } from "../cache-format.js";
 /**
  * Check if cached code has file:// paths that are incompatible with this environment.
  * Returns true if the cached code should be invalidated (has paths from a different environment).
@@ -97,7 +98,7 @@ export async function hasIncompatibleFrameworkPaths(code, log) {
  */
 export async function findMissingFileDependenciesInCode(code, log) {
     const localFs = getLocalFs();
-    const pattern = /file:\/\/([^"'\s]+\.mjs)/gi;
+    const pattern = new RegExp(MDX_ESM_MJS_FILE_URL_PATTERN_SOURCE, "gi");
     const missing = [];
     const checked = new Set();
     let match;

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

@@ -1 +1 @@
-{"version":3,"file":"module-cache.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/module-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AASjE;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAanF;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkCxB"}
+{"version":3,"file":"module-cache.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/module-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAQjE;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAanF;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmCxB"}

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

@@ -8,11 +8,10 @@
  */
 import { join } from "../../../../platform/compat/path/index.js";
 import * as posix from "../../../../../deps/jsr.io/@std/path/1.1.4/posix/mod.js";
-import { VERSION } from "../../../../utils/version.js";
 import { LOG_PREFIX_MDX_LOADER } from "../constants.js";
 import { getLocalFs, saveModulePathCache } from "../cache/index.js";
 import { hashString } from "../utils/hash.js";
-import { getVersionedPathCacheKey } from "./cache-keys.js";
+import { buildMdxEsmModuleFileName, buildMdxEsmPathCacheKey } from "../cache-format.js";
 import { hasUnresolvedImports } from "./nested-imports.js";
 import { recordModuleToSession } from "./render-sessions.js";
 /**
@@ -46,12 +45,13 @@ export async function cacheModule(normalizedPath, moduleCode, esmCacheDir, pathC
         return null;
     }
     const contentHash = hashString(normalizedPath + moduleCode);
-    const cachePath = join(esmCacheDir, `vfmod-v${VERSION}-${contentHash}.mjs`);
+    const cachePath = join(esmCacheDir, buildMdxEsmModuleFileName(contentHash));
+    const pathCacheKey = buildMdxEsmPathCacheKey(normalizedPath);
     const localFs = getLocalFs();
     try {
         const stat = await localFs.stat(cachePath);
         if (stat?.isFile) {
-            pathCache.set(getVersionedPathCacheKey(normalizedPath), cachePath);
+            pathCache.set(pathCacheKey, cachePath);
             log.debug(`${LOG_PREFIX_MDX_LOADER} Content cache hit: ${normalizedPath}`);
             recordModuleToSession(normalizedPath);
             return cachePath;
@@ -62,7 +62,7 @@ export async function cacheModule(normalizedPath, moduleCode, esmCacheDir, pathC
     }
     await localFs.mkdir(esmCacheDir, { recursive: true });
     await localFs.writeTextFile(cachePath, moduleCode);
-    pathCache.set(getVersionedPathCacheKey(normalizedPath), cachePath);
+    pathCache.set(pathCacheKey, cachePath);
     await saveModulePathCache(esmCacheDir);
     log.debug(`${LOG_PREFIX_MDX_LOADER} Cached vf_module: ${normalizedPath} -> ${cachePath}`);
     recordModuleToSession(normalizedPath);

package/esm/src/transforms/pipeline/stages/ssr-vf-modules/transform.d.ts

@@ -16,10 +16,10 @@ export declare function isCyclePlaceholder(code: string): boolean;
 /**
  * Cache transformed framework code and return the file:// path.
  *
- * Cache key format: vfmod-{VERSION}-{pathHash}-{envKey}-{contentHash}.mjs
+ * Cache key format: vfmod-{namespace}-{pathHash}-{envKey}-{contentHash}.mjs
  *
  * Cache invalidation is handled by:
- * - VERSION prefix: Auto-invalidates on framework releases
+ * - namespace prefix: Auto-rolls when the framework vfmod cache shape changes
  * - envKey (FRAMEWORK_ROOT hash): Prevents cross-environment contamination
  *   (compiled binary vs source have different FRAMEWORK_ROOT values)
  * - contentHash: Content-based invalidation

package/esm/src/transforms/pipeline/stages/ssr-vf-modules/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/pipeline/stages/ssr-vf-modules/transform.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAcrE,OAAO,EAOL,KAAK,gBAAgB,EAGtB,MAAM,gBAAgB,CAAC;AAIxB;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,gBAAgB,EACrB,oBAAoB,UAAQ,EAC5B,KAAK,SAAI,GACR,OAAO,CAAC,MAAM,CAAC,CAyQjB;AAED;;;GAGG;AACH,wBAAsB,kCAAkC,CACtD,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4CxB;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CAEjB"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/pipeline/stages/ssr-vf-modules/transform.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAarE,OAAO,EAOL,KAAK,gBAAgB,EAGtB,MAAM,gBAAgB,CAAC;AAKxB;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,gBAAgB,EACrB,oBAAoB,UAAQ,EAC5B,KAAK,SAAI,GACR,OAAO,CAAC,MAAM,CAAC,CAyQjB;AAED;;;GAGG;AACH,wBAAsB,kCAAkC,CACtD,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4CxB;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CAEjB"}

package/esm/src/transforms/pipeline/stages/ssr-vf-modules/transform.js

@@ -13,11 +13,11 @@ import { hashCodeHex } from "../../../../utils/hash-utils.js";
 import { getHttpBundleCacheDir, getMdxEsmCacheDir } from "../../../../utils/cache-dir.js";
 import { cacheHttpImportsToLocal } from "../../../esm/http-cache.js";
 import { loadImportMap } from "../../../../modules/import-map/index.js";
-import { VERSION } from "../../../../utils/version.js";
 import { buildReactUrl, getReactImportMap } from "../../../import-rewriter/url-builder.js";
 import { findRelativeImports } from "./import-finder.js";
 import { resolveRelativeFrameworkImport, resolveVeryfrontSourcePath } from "./path-resolver.js";
 import { EMBEDDED_SRC_DIR, FRAMEWORK_ROOT, frameworkFileCache, frameworkWriteFlight, LOG_PREFIX, MAX_RELATIVE_IMPORT_DEPTH, transformingFiles, veryfrontTransformCache, } from "./constants.js";
+import { buildFrameworkVfModuleCacheFileName } from "../../../mdx/esm-module-loader/cache-format.js";
 const DENO_CONFIG_STUB_CODE = `export default ${JSON.stringify(denoConfig)};`;
 /**
  * Check if a transformed code string is a cycle placeholder.
@@ -31,10 +31,10 @@ export function isCyclePlaceholder(code) {
 /**
  * Cache transformed framework code and return the file:// path.
  *
- * Cache key format: vfmod-{VERSION}-{pathHash}-{envKey}-{contentHash}.mjs
+ * Cache key format: vfmod-{namespace}-{pathHash}-{envKey}-{contentHash}.mjs
  *
  * Cache invalidation is handled by:
- * - VERSION prefix: Auto-invalidates on framework releases
+ * - namespace prefix: Auto-rolls when the framework vfmod cache shape changes
  * - envKey (FRAMEWORK_ROOT hash): Prevents cross-environment contamination
  *   (compiled binary vs source have different FRAMEWORK_ROOT values)
  * - contentHash: Content-based invalidation
@@ -47,7 +47,7 @@ export async function cacheTransformedCode(transformed, vfModulePath, fs) {
     const envKey = hashCodeHex(FRAMEWORK_ROOT).slice(0, 8);
     const contentHash = hashCodeHex(transformed);
     const pathHash = hashCodeHex(vfModulePath);
-    const fileName = `vfmod-${VERSION}-${pathHash}-${envKey}-${contentHash}.mjs`;
+    const fileName = buildFrameworkVfModuleCacheFileName(pathHash, envKey, contentHash);
     const frameworkCacheDir = join(cacheDir, "framework");
     const cachePath = join(frameworkCacheDir, fileName);
     // Use Singleflight to prevent concurrent writes to the same file

package/esm/src/utils/cache-namespace.d.ts

@@ -0,0 +1,11 @@
+type CacheNamespaceValue = string | number | boolean | null | readonly CacheNamespaceValue[] | {
+    readonly [key: string]: CacheNamespaceValue;
+};
+/**
+ * Build a deterministic cache namespace from a declarative schema description.
+ * Keep the schema close to the cache builders so format changes roll the
+ * namespace automatically instead of relying on a manually bumped constant.
+ */
+export declare function createCacheNamespace(scope: string, schema: CacheNamespaceValue, length?: number): string;
+export {};
+//# sourceMappingURL=cache-namespace.d.ts.map

package/esm/src/utils/cache-namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-namespace.d.ts","sourceRoot":"","sources":["../../../src/src/utils/cache-namespace.ts"],"names":[],"mappings":"AAEA,KAAK,mBAAmB,GACpB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,mBAAmB,EAAE,GAC9B;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAA;CAAE,CAAC;AAqBpD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,mBAAmB,EAC3B,MAAM,SAAK,GACV,MAAM,CAGR"}

package/esm/src/utils/cache-namespace.js

@@ -0,0 +1,24 @@
+import { fnv1aHash } from "./hash-utils.js";
+function serializeCacheNamespaceValue(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value)) {
+        return `[${value.map((entry) => serializeCacheNamespaceValue(entry)).join(",")}]`;
+    }
+    if (typeof value === "object") {
+        const entries = Object.entries(value).sort(([left], [right]) => left.localeCompare(right));
+        return `{${entries
+            .map(([key, entry]) => `${JSON.stringify(key)}:${serializeCacheNamespaceValue(entry)}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+/**
+ * Build a deterministic cache namespace from a declarative schema description.
+ * Keep the schema close to the cache builders so format changes roll the
+ * namespace automatically instead of relying on a manually bumped constant.
+ */
+export function createCacheNamespace(scope, schema, length = 10) {
+    const serialized = serializeCacheNamespaceValue(schema);
+    return `${scope}-${fnv1aHash(serialized).slice(0, length)}`;
+}

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

@@ -1,4 +1,4 @@
-export declare const VERSION = "0.1.88";
+export declare const VERSION = "0.1.89";
 export declare const SERVER_START_TIME: number;
 export interface BuildVersion {
     framework: string;

package/esm/src/utils/version.js

@@ -1,6 +1,6 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.88";
+export const VERSION = "0.1.89";
 export const SERVER_START_TIME = Date.now();
 export function createBuildVersion(projectUpdatedAt) {
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.88",
+  "version": "0.1.89",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.88",
+  "version": "0.1.89",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "exclude": [

package/src/src/rendering/orchestrator/module-loader/index.ts

@@ -25,12 +25,12 @@ import { validateCachedBundlesByManifestOrCode } from "../../../transforms/esm/c
 import { getHttpBundleCacheDir, getMdxEsmCacheDir } from "../../../utils/cache-dir.js";
 import { dirname, join, normalize } from "../../../platform/compat/path/index.js";
 import { hashCodeHex } from "../../../utils/hash-utils.js";
-import { VERSION } from "../../../utils/version.js";
 import {
   getModulePathCache,
   lookupMdxEsmCache,
   saveModulePathCache,
 } from "../../../transforms/mdx/esm-module-loader/cache/index.js";
+import { buildMdxEsmPathCacheKey } from "../../../transforms/mdx/esm-module-loader/cache-format.js";
 
 const logger = rendererLogger.component("module-loader");
 
@@ -455,7 +455,7 @@ export async function transformModuleWithDeps(
 
   if (contentSourceId) {
     const normalizedPath = `_vf_modules/${relativePath.replace(/\.(tsx?|jsx|mdx)$/, ".js")}`;
-    const mdxCacheKey = `v${VERSION}:${normalizedPath}`;
+    const mdxCacheKey = buildMdxEsmPathCacheKey(normalizedPath);
     const cache = await getModulePathCache(tmpDir);
     cache.set(mdxCacheKey, tempFilePath);
 

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

@@ -18,9 +18,9 @@ import {
   type FileSystem,
   isNotFoundError,
 } from "../../../../platform/compat/fs.js";
-import { VERSION } from "../../../../utils/version.js";
 import { LOG_PREFIX_MDX_LOADER } from "../constants.js";
 import { LRUCache } from "../../../../utils/lru-wrapper.js";
+import { buildMdxEsmPathCacheKey, MDX_ESM_ALL_FILE_URL_PATTERN_SOURCE } from "../cache-format.js";
 
 export type CacheLookupResult =
   | { status: "hit"; path: string }
@@ -33,8 +33,6 @@ export const verifiedModuleDeps = new LRUCache<string, true>({
   maxEntries: MAX_VERIFIED_MODULE_DEPS,
 });
 
-const FILE_PATH_PATTERN = /file:\/\/([^"'\s]+)/gi;
-
 /**
  * Check if cached code has file:// paths from a different environment.
  * Checks both HTTP bundle paths and MDX ESM cache paths.
@@ -43,7 +41,7 @@ function hasIncompatibleCachePaths(code: string): boolean {
   const localCacheBaseDir = getCacheBaseDir();
   const localHttpCacheDir = getHttpBundleCacheDir();
   const localMdxCacheDir = getMdxEsmCacheDir();
-  const pattern = new RegExp(FILE_PATH_PATTERN.source, "gi");
+  const pattern = new RegExp(MDX_ESM_ALL_FILE_URL_PATTERN_SOURCE, "gi");
 
   let match: RegExpExecArray | null;
   while ((match = pattern.exec(code)) !== null) {
@@ -87,7 +85,7 @@ function hasIncompatibleCachePaths(code: string): boolean {
  */
 async function findMissingFileDependencies(code: string): Promise<string[]> {
   const localFs = getLocalFs();
-  const pattern = new RegExp(FILE_PATH_PATTERN.source, "gi");
+  const pattern = new RegExp(MDX_ESM_ALL_FILE_URL_PATTERN_SOURCE, "gi");
   const missing: string[] = [];
   let match;
   while ((match = pattern.exec(code)) !== null) {
@@ -335,7 +333,7 @@ function toMdxEsmCacheKey(filePath: string, projectDir?: string): string {
   relativePath = relativePath.replace(/^\/+/, "");
   const jsPath = relativePath.replace(/\.(tsx?|jsx|mdx)$/, ".js");
 
-  return `v${VERSION}:_vf_modules/${jsPath}`;
+  return buildMdxEsmPathCacheKey(`_vf_modules/${jsPath}`);
 }
 
 export async function lookupMdxEsmCache(
@@ -429,9 +427,9 @@ export async function lookupMdxEsmCache(
     }
 
     // Note: We intentionally skip contentHash validation for MDX-ESM cached files.
-    // The MDX-ESM cache uses transformed-code hashes in filenames (vfmod-v{VERSION}-{hash}.mjs),
+    // The MDX-ESM cache uses transformed-code hashes in namespaced filenames,
     // while the SSR loader provides source-code hashes. These will never match.
-    // The cache version in the key (v{VERSION}:) provides sufficient staleness protection,
+    // The cache namespace in the key provides sufficient staleness protection,
     // and the file's existence confirms it's a valid transform for this codebase.
     // This allows both loaders to share the same module instance, preventing
     // duplicate React contexts which break hooks like useContext.

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

@@ -0,0 +1,121 @@
+import { hashCodeHex } from "../../../utils/hash-utils.js";
+import { createCacheNamespace } from "../../../utils/cache-namespace.js";
+import { UNRESOLVED_VF_MODULES_PATTERN } from "./constants.js";
+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__";
+
+function formatMdxEsmTransformCacheKey(
+  namespace: string,
+  projectId: string,
+  normalizedPath: string,
+  contentHash: string,
+): string {
+  return `${namespace}:${projectId}:${normalizedPath}:${contentHash}:ssr`;
+}
+
+function formatMdxEsmPathCacheKey(namespace: string, normalizedPath: string): string {
+  return `${namespace}:${normalizedPath}`;
+}
+
+function formatMdxEsmModuleFileName(namespace: string, contentHash: string): string {
+  return `vfmod-${namespace}-${contentHash}.mjs`;
+}
+
+function formatMdxJsxCacheFileName(namespace: string, filePath: string): string {
+  return `jsx-${namespace}-${hashString(filePath)}.mjs`;
+}
+
+function formatFrameworkVfModuleCacheFileName(
+  namespace: string,
+  pathHash: string,
+  envKey: string,
+  contentHash: string,
+): string {
+  return `vfmod-${namespace}-${pathHash}-${envKey}-${contentHash}.mjs`;
+}
+
+function buildMdxEsmCacheSchemaSample() {
+  return {
+    transformKey: formatMdxEsmTransformCacheKey(
+      CACHE_NAMESPACE_SENTINEL,
+      "__vf_project__",
+      "_vf_modules/pages/index.js",
+      "deadbeef",
+    ),
+    pathKey: formatMdxEsmPathCacheKey(CACHE_NAMESPACE_SENTINEL, "_vf_modules/pages/index.js"),
+    moduleFile: formatMdxEsmModuleFileName(CACHE_NAMESPACE_SENTINEL, "deadbeef"),
+    jsxFile: formatMdxJsxCacheFileName(CACHE_NAMESPACE_SENTINEL, "/tmp/project/Button.tsx"),
+    unresolvedVfModulesPattern: UNRESOLVED_VF_MODULES_PATTERN.source,
+    allFileUrlPattern: ALL_FILE_URL_PATTERN_SOURCE,
+    mjsFileUrlPattern: MJS_FILE_URL_PATTERN_SOURCE,
+    sourceHashing: [
+      hashString("_vf_modules/pages/index.jsexport default 1;"),
+      hashString("/tmp/project/Button.tsx"),
+    ],
+  };
+}
+
+function buildFrameworkVfModuleCacheSchemaSample() {
+  return {
+    moduleFile: formatFrameworkVfModuleCacheFileName(
+      CACHE_NAMESPACE_SENTINEL,
+      hashCodeHex("_vf_modules/_veryfront/react/components/Head.js"),
+      hashCodeHex("/app/.cache/veryfront-mdx-esm").slice(0, 8),
+      hashCodeHex("export default function Head() {}"),
+    ),
+  };
+}
+
+export const MDX_ESM_ALL_FILE_URL_PATTERN_SOURCE = ALL_FILE_URL_PATTERN_SOURCE;
+export const MDX_ESM_MJS_FILE_URL_PATTERN_SOURCE = MJS_FILE_URL_PATTERN_SOURCE;
+
+export const MDX_ESM_CACHE_NAMESPACE = createCacheNamespace(
+  "mdx-esm",
+  buildMdxEsmCacheSchemaSample(),
+);
+
+export const FRAMEWORK_VF_MODULE_CACHE_NAMESPACE = createCacheNamespace(
+  "vf-framework",
+  buildFrameworkVfModuleCacheSchemaSample(),
+);
+
+export function buildMdxEsmTransformCacheKey(
+  projectId: string,
+  normalizedPath: string,
+  contentHash: string,
+): string {
+  return formatMdxEsmTransformCacheKey(
+    MDX_ESM_CACHE_NAMESPACE,
+    projectId,
+    normalizedPath,
+    contentHash,
+  );
+}
+
+export function buildMdxEsmPathCacheKey(normalizedPath: string): string {
+  return formatMdxEsmPathCacheKey(MDX_ESM_CACHE_NAMESPACE, normalizedPath);
+}
+
+export function buildMdxEsmModuleFileName(contentHash: string): string {
+  return formatMdxEsmModuleFileName(MDX_ESM_CACHE_NAMESPACE, contentHash);
+}
+
+export function buildMdxJsxCacheFileName(filePath: string): string {
+  return formatMdxJsxCacheFileName(MDX_ESM_CACHE_NAMESPACE, filePath);
+}
+
+export function buildFrameworkVfModuleCacheFileName(
+  pathHash: string,
+  envKey: string,
+  contentHash: string,
+): string {
+  return formatFrameworkVfModuleCacheFileName(
+    FRAMEWORK_VF_MODULE_CACHE_NAMESPACE,
+    pathHash,
+    envKey,
+    contentHash,
+  );
+}

package/src/src/transforms/mdx/esm-module-loader/import-transformer.ts

@@ -11,7 +11,6 @@ import { join } from "../../../platform/compat/path/index.js";
 import { rendererLogger as logger } from "../../../utils/index.js";
 import { transformImportsWithMap } from "../../../modules/import-map/index.js";
 import type { ImportMapConfig } from "../../../modules/import-map/index.js";
-import { VERSION } from "../../../utils/version.js";
 import { replaceSpecifiers } from "../../esm/lexer.js";
 import { getLocalReactPaths, isReactSpecifier } from "../../../platform/compat/react-paths.js";
 import {
@@ -23,7 +22,7 @@ import {
   REACT_IMPORT_PATTERN,
 } from "./constants.js";
 import { getLocalFs } from "./cache/index.js";
-import { hashString } from "./utils/hash.js";
+import { buildMdxJsxCacheFileName } from "./cache-format.js";
 import { rewriteDntImports } from "./module-fetcher/index.js";
 import { ensureCachedJsxModulePatched } from "./jsx-cache.js";
 import type { ESMLoaderContext } from "./types.js";
@@ -128,7 +127,7 @@ export async function transformJsxImports(
   const transformResults = await Promise.all(
     importsToProcess.map(async ({ fullMatch, importClause, filePath, ext }) => {
       try {
-        const transformedFileName = `jsx-v${VERSION}-${hashString(filePath)}.mjs`;
+        const transformedFileName = buildMdxJsxCacheFileName(filePath);
         const transformedPath = join(esmCacheDir, transformedFileName);
 
         try {

package/src/src/transforms/mdx/esm-module-loader/module-fetcher/cache-keys.ts

@@ -4,7 +4,7 @@
  * @module transforms/mdx/esm-module-loader/module-fetcher/cache-keys
  */
 
-import { VERSION } from "../../../../utils/version.js";
+import { buildMdxEsmPathCacheKey, buildMdxEsmTransformCacheKey } from "../cache-format.js";
 
 /**
  * Build cache key for transformed module.
@@ -18,9 +18,9 @@ export function getTransformCacheKey(
   normalizedPath: string,
   contentHash: string,
 ): string {
-  return `v${VERSION}:${projectId}:${normalizedPath}:${contentHash}:ssr`;
+  return buildMdxEsmTransformCacheKey(projectId, normalizedPath, contentHash);
 }
 
 export function getVersionedPathCacheKey(normalizedPath: string): string {
-  return `v${VERSION}:${normalizedPath}`;
+  return buildMdxEsmPathCacheKey(normalizedPath);
 }

package/src/src/transforms/mdx/esm-module-loader/module-fetcher/framework-validator.ts

@@ -13,6 +13,7 @@ import { FRAMEWORK_ROOT, LOG_PREFIX_MDX_LOADER } from "../constants.js";
 import { getLocalFs } from "../cache/index.js";
 import { extractHttpBundlePaths } from "../../../../modules/react-loader/ssr-module-loader/http-bundle-helpers.js";
 import { ensureHttpBundlesExist } from "../../../esm/http-cache.js";
+import { MDX_ESM_MJS_FILE_URL_PATTERN_SOURCE } from "../cache-format.js";
 
 /**
  * Check if cached code has file:// paths that are incompatible with this environment.
@@ -110,7 +111,7 @@ export async function findMissingFileDependenciesInCode(
   log: Logger,
 ): Promise<string[]> {
   const localFs = getLocalFs();
-  const pattern = /file:\/\/([^"'\s]+\.mjs)/gi;
+  const pattern = new RegExp(MDX_ESM_MJS_FILE_URL_PATTERN_SOURCE, "gi");
   const missing: string[] = [];
   const checked = new Set<string>();
 

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

@@ -10,11 +10,10 @@
 import { join } from "../../../../platform/compat/path/index.js";
 import * as posix from "../../../../../deps/jsr.io/@std/path/1.1.4/posix/mod.js";
 import type { Logger } from "../../../../utils/logger/logger.js";
-import { VERSION } from "../../../../utils/version.js";
 import { LOG_PREFIX_MDX_LOADER } from "../constants.js";
 import { getLocalFs, saveModulePathCache } from "../cache/index.js";
 import { hashString } from "../utils/hash.js";
-import { getVersionedPathCacheKey } from "./cache-keys.js";
+import { buildMdxEsmModuleFileName, buildMdxEsmPathCacheKey } from "../cache-format.js";
 import { hasUnresolvedImports } from "./nested-imports.js";
 import { recordModuleToSession } from "./render-sessions.js";
 
@@ -60,13 +59,14 @@ export async function cacheModule(
   }
 
   const contentHash = hashString(normalizedPath + moduleCode);
-  const cachePath = join(esmCacheDir, `vfmod-v${VERSION}-${contentHash}.mjs`);
+  const cachePath = join(esmCacheDir, buildMdxEsmModuleFileName(contentHash));
+  const pathCacheKey = buildMdxEsmPathCacheKey(normalizedPath);
 
   const localFs = getLocalFs();
   try {
     const stat = await localFs.stat(cachePath);
     if (stat?.isFile) {
-      pathCache.set(getVersionedPathCacheKey(normalizedPath), cachePath);
+      pathCache.set(pathCacheKey, cachePath);
       log.debug(`${LOG_PREFIX_MDX_LOADER} Content cache hit: ${normalizedPath}`);
       recordModuleToSession(normalizedPath);
       return cachePath;
@@ -77,7 +77,7 @@ export async function cacheModule(
 
   await localFs.mkdir(esmCacheDir, { recursive: true });
   await localFs.writeTextFile(cachePath, moduleCode);
-  pathCache.set(getVersionedPathCacheKey(normalizedPath), cachePath);
+  pathCache.set(pathCacheKey, cachePath);
   await saveModulePathCache(esmCacheDir);
   log.debug(`${LOG_PREFIX_MDX_LOADER} Cached vf_module: ${normalizedPath} -> ${cachePath}`);
 

package/src/src/transforms/pipeline/stages/ssr-vf-modules/transform.ts

@@ -15,7 +15,6 @@ import { hashCodeHex } from "../../../../utils/hash-utils.js";
 import { getHttpBundleCacheDir, getMdxEsmCacheDir } from "../../../../utils/cache-dir.js";
 import { cacheHttpImportsToLocal } from "../../../esm/http-cache.js";
 import { loadImportMap } from "../../../../modules/import-map/index.js";
-import { VERSION } from "../../../../utils/version.js";
 import { buildReactUrl, getReactImportMap } from "../../../import-rewriter/url-builder.js";
 import { findRelativeImports } from "./import-finder.js";
 import { resolveRelativeFrameworkImport, resolveVeryfrontSourcePath } from "./path-resolver.js";
@@ -30,6 +29,7 @@ import {
   transformingFiles,
   veryfrontTransformCache,
 } from "./constants.js";
+import { buildFrameworkVfModuleCacheFileName } from "../../../mdx/esm-module-loader/cache-format.js";
 
 const DENO_CONFIG_STUB_CODE = `export default ${JSON.stringify(denoConfig)};`;
 
@@ -46,10 +46,10 @@ export function isCyclePlaceholder(code: string): boolean {
 /**
  * Cache transformed framework code and return the file:// path.
  *
- * Cache key format: vfmod-{VERSION}-{pathHash}-{envKey}-{contentHash}.mjs
+ * Cache key format: vfmod-{namespace}-{pathHash}-{envKey}-{contentHash}.mjs
  *
  * Cache invalidation is handled by:
- * - VERSION prefix: Auto-invalidates on framework releases
+ * - namespace prefix: Auto-rolls when the framework vfmod cache shape changes
  * - envKey (FRAMEWORK_ROOT hash): Prevents cross-environment contamination
  *   (compiled binary vs source have different FRAMEWORK_ROOT values)
  * - contentHash: Content-based invalidation
@@ -66,7 +66,7 @@ export async function cacheTransformedCode(
   const envKey = hashCodeHex(FRAMEWORK_ROOT).slice(0, 8);
   const contentHash = hashCodeHex(transformed);
   const pathHash = hashCodeHex(vfModulePath);
-  const fileName = `vfmod-${VERSION}-${pathHash}-${envKey}-${contentHash}.mjs`;
+  const fileName = buildFrameworkVfModuleCacheFileName(pathHash, envKey, contentHash);
   const frameworkCacheDir = join(cacheDir, "framework");
   const cachePath = join(frameworkCacheDir, fileName);
 

package/src/src/utils/cache-namespace.ts

@@ -0,0 +1,42 @@
+import { fnv1aHash } from "./hash-utils.js";
+
+type CacheNamespaceValue =
+  | string
+  | number
+  | boolean
+  | null
+  | readonly CacheNamespaceValue[]
+  | { readonly [key: string]: CacheNamespaceValue };
+
+function serializeCacheNamespaceValue(value: CacheNamespaceValue): string {
+  if (value === null) return "null";
+
+  if (Array.isArray(value)) {
+    return `[${value.map((entry) => serializeCacheNamespaceValue(entry)).join(",")}]`;
+  }
+
+  if (typeof value === "object") {
+    const entries = Object.entries(value).sort(([left], [right]) => left.localeCompare(right));
+    return `{${
+      entries
+        .map(([key, entry]) => `${JSON.stringify(key)}:${serializeCacheNamespaceValue(entry)}`)
+        .join(",")
+    }}`;
+  }
+
+  return JSON.stringify(value);
+}
+
+/**
+ * Build a deterministic cache namespace from a declarative schema description.
+ * Keep the schema close to the cache builders so format changes roll the
+ * namespace automatically instead of relying on a manually bumped constant.
+ */
+export function createCacheNamespace(
+  scope: string,
+  schema: CacheNamespaceValue,
+  length = 10,
+): string {
+  const serialized = serializeCacheNamespaceValue(schema);
+  return `${scope}-${fnv1aHash(serialized).slice(0, length)}`;
+}

package/src/src/utils/version.ts

@@ -1,6 +1,6 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.88";
+export const VERSION = "0.1.89";
 
 export const SERVER_START_TIME: number = Date.now();