veryfront 0.1.57 → 0.1.59

package/esm/deno.js

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

package/esm/src/modules/server/module-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-server.d.ts","sourceRoot":"","sources":["../../../../src/src/modules/server/module-server.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAIlD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAkBtE;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkDrD,CAAC;AASF,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,uBAAuB;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAqTzG;AAmND;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAG7D"}
+{"version":3,"file":"module-server.d.ts","sourceRoot":"","sources":["../../../../src/src/modules/server/module-server.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAIlD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAkBtE;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsDrD,CAAC;AASF,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,uBAAuB;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAqTzG;AAwND;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAG7D"}

package/esm/src/modules/server/module-server.js

@@ -3,7 +3,7 @@ import * as dntShim from "../../../_dnt.shims.js";
 import { join } from "../../platform/compat/path/index.js";
 import { createFileSystem } from "../../platform/compat/fs.js";
 import { transformToESM } from "../../transforms/esm-transform.js";
-import { serverLogger } from "../../utils/index.js";
+import { serverLogger, VERSION } from "../../utils/index.js";
 import { HTTP_NOT_FOUND, HTTP_OK, HTTP_SERVER_ERROR } from "../../utils/index.js";
 import { getContentTypeForPath } from "../../server/handlers/utils/content-types.js";
 import { createSecureFs } from "../../security/index.js";
@@ -76,6 +76,10 @@ export default {};
         `export default {};`,
     ].join("\n") + "\n",
     "_dnt.polyfills": `export default {};\n`,
+    // Deno import-map alias stub for browser/HTTP-served framework modules.
+    // Must be a JS module (not JSON) because esbuild strips `with { type: "json" }`
+    // at es2020 target, and browsers reject JSON MIME type without the assertion.
+    "_veryfront/_deno-config": `export default ${JSON.stringify({ version: VERSION })};\n`,
 };
 const DEV_MODULE_PREFIX = /^\/(?:_vf_modules|_veryfront\/modules)\//;
 const SNIPPET_MODULE_PREFIX = /^\/_vf_modules\/_snippets\/([a-f0-9]+)\.js/;
@@ -331,6 +335,7 @@ const EMBEDDED_SRC_DIR = join(FRAMEWORK_ROOT, "dist", "framework-src");
 async function findSourceFile(secureFs, projectDir, basePath) {
     // Extensions including .src for compiled binary embedded sources
     const extensions = [
+        ".json",
         ".tsx.src",
         ".ts.src",
         ".jsx.src",
@@ -347,7 +352,7 @@ async function findSourceFile(secureFs, projectDir, basePath) {
     logger.debug("findSourceFile called", { projectDir, basePath });
     const hasKnownExt = extensions.some((ext) => basePath.endsWith(ext));
     const rawBasePathWithoutExt = hasKnownExt
-        ? basePath.replace(/\.(tsx|ts|jsx|js|mdx|md)(\.src)?$/, "")
+        ? basePath.replace(/\.(json|tsx|ts|jsx|js|mdx|md)(\.src)?$/, "")
         : basePath;
     let basePathWithoutExt = rawBasePathWithoutExt.replace(/^\/+/, "");
     if (basePathWithoutExt.startsWith("_vf_modules/")) {
@@ -374,7 +379,7 @@ async function findSourceFile(secureFs, projectDir, basePath) {
             basePath: basePathWithoutExt,
         });
         return {
-            path: `embedded:${basePathWithoutExt}`,
+            path: `embedded:${basePath}`,
             isFrameworkFile: true,
             embeddedContent,
         };
@@ -388,20 +393,24 @@ async function findSourceFile(secureFs, projectDir, basePath) {
             const pathWithinFramework = stripPrefix
                 ? basePathWithoutExt.slice(prefix.length)
                 : basePathWithoutExt;
-            for (const ext of extensions) {
-                const frameworkPath = join(frameworkDir, pathWithinFramework + ext);
-                try {
-                    const stat = await platformFs.stat(frameworkPath);
-                    if (stat.isFile) {
-                        logger.debug(`Found framework ${label} file`, {
-                            basePath: basePathWithoutExt,
-                            resolvedPath: frameworkPath,
-                        });
-                        return { path: frameworkPath, isFrameworkFile: true };
+            // Try direct file match first, then index file fallback
+            const candidates = [pathWithinFramework, `${pathWithinFramework}/index`];
+            for (const candidate of candidates) {
+                for (const ext of extensions) {
+                    const frameworkPath = join(frameworkDir, candidate + ext);
+                    try {
+                        const stat = await platformFs.stat(frameworkPath);
+                        if (stat.isFile) {
+                            logger.debug(`Found framework ${label} file`, {
+                                basePath: basePathWithoutExt,
+                                resolvedPath: frameworkPath,
+                            });
+                            return { path: frameworkPath, isFrameworkFile: true };
+                        }
+                    }
+                    catch (_) {
+                        /* expected: file may not exist at this extension */
                     }
-                }
-                catch (_) {
-                    /* expected: file may not exist at this extension */
                 }
             }
         }

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

@@ -1 +1 @@
-{"version":3,"file":"veryfront-strategy.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/import-rewriter/strategies/veryfront-strategy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AAerB,qBAAa,iBAAkB,YAAW,qBAAqB;IAC7D,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,QAAQ,OAAO;IAExB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO;IAQzD,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,GAAG,aAAa;CAoCvE;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}
+{"version":3,"file":"veryfront-strategy.d.ts","sourceRoot":"","sources":["../../../../../src/src/transforms/import-rewriter/strategies/veryfront-strategy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AAkBrB,qBAAa,iBAAkB,YAAW,qBAAqB;IAC7D,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,QAAQ,OAAO;IAExB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO;IASzD,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,GAAG,aAAa;CAkDvE;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

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

@@ -5,7 +5,7 @@
  * Handles: #veryfront/*, veryfront/*
  */
 import { buildVeryfrontModuleUrl } from "../url-builder.js";
-import { resolveVeryfrontModuleUrl } from "../../veryfront-module-urls.js";
+import { resolveInternalModuleUrl, resolveVeryfrontModuleUrl, } from "../../veryfront-module-urls.js";
 /**
  * SSR-specific module overrides.
  *
@@ -22,21 +22,36 @@ export class VeryfrontStrategy {
     matches(specifier, _ctx) {
         return (specifier.startsWith("#veryfront/") ||
             specifier.startsWith("veryfront/") ||
-            specifier === "veryfront");
+            specifier === "veryfront" ||
+            specifier === "#deno-config");
     }
     rewrite(info, ctx) {
         const specifier = info.specifier;
+        // Handle #deno-config — Deno import-map alias that doesn't exist in browsers.
+        // Rewrite to a JS module (not JSON) because esbuild strips `with { type: "json" }`
+        // at es2020 target and browsers reject JSON MIME without the assertion.
+        if (specifier === "#deno-config") {
+            return { specifier: "/_vf_modules/_veryfront/_deno-config.js" };
+        }
         // Handle #veryfront/* (internal framework imports)
         if (specifier.startsWith("#veryfront/")) {
             const path = specifier.slice("#veryfront/".length);
             // Try resolving via deno.json mappings first (veryfront/head → react/components/Head.js)
             const mapped = resolveVeryfrontModuleUrl(`veryfront/${path}`);
             if (mapped) {
-                // For SSR, append ?ssr=true to signal server-side rendering
                 if (ctx.target === "ssr")
                     return { specifier: `${mapped}?ssr=true` };
                 return { specifier: mapped };
             }
+            // Try resolving via #veryfront/* import map (handles paths where the
+            // filesystem layout differs from the specifier, e.g. #veryfront/compat/console
+            // maps to src/platform/compat/console/index.ts, not src/compat/console.ts)
+            const internalMapped = resolveInternalModuleUrl(specifier);
+            if (internalMapped) {
+                if (ctx.target === "ssr")
+                    return { specifier: `${internalMapped}?ssr=true` };
+                return { specifier: internalMapped };
+            }
             const builtUrl = buildVeryfrontModuleUrl(path);
             if (ctx.target === "ssr")
                 return { specifier: `${builtUrl}?ssr=true` };

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

@@ -1 +1 @@
-{"version":3,"file":"path-resolver.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/pipeline/stages/ssr-vf-modules/path-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAU,MAAM,mCAAmC,CAAC;AAW7E,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EACvC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAmBzD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GACtC,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CA6DzD;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA+D1F;AAED;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GACvC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiExB"}
+{"version":3,"file":"path-resolver.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/pipeline/stages/ssr-vf-modules/path-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAU,MAAM,mCAAmC,CAAC;AAY7E,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EACvC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAmBzD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GACtC,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CA6DzD;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkE1F;AAED;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GACvC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiExB"}

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

@@ -7,6 +7,7 @@
 import { exists } from "../../../../platform/compat/fs.js";
 import { join } from "../../../../platform/compat/path/index.js";
 import { rendererLogger as logger } from "../../../../utils/index.js";
+import { resolveInternalModuleTarget } from "../../../veryfront-module-urls.js";
 import { EMBEDDED_SRC_DIR, EXTENSIONS, FRAMEWORK_LOOKUPS, FRAMEWORK_ROOT, LOG_PREFIX, } from "./constants.js";
 export async function tryReadWithExtensions(fs, basePath) {
     // Try all extensions, including .src versions for embedded sources
@@ -95,7 +96,10 @@ export async function resolveFrameworkFile(vfModulePath, fs) {
 export async function resolveVeryfrontSourcePath(specifier) {
     if (!specifier.startsWith("#veryfront/"))
         return null;
-    const relativePath = specifier.slice("#veryfront/".length);
+    const mappedTarget = resolveInternalModuleTarget(specifier);
+    if (!mappedTarget?.startsWith("./src/"))
+        return null;
+    const relativePath = mappedTarget.slice("./src/".length);
     const hasExtension = /\.(tsx?|jsx?|mjs)$/.test(relativePath);
     // Check embedded sources first (for compiled binaries), then regular src/
     // This order matches FRAMEWORK_LOOKUPS and resolveFrameworkFile to ensure

package/esm/src/transforms/veryfront-module-urls.d.ts

@@ -1,2 +1,11 @@
+export declare function resolveVeryfrontModuleTarget(specifier: string): string | null;
+export declare function resolveInternalModuleTarget(specifier: string): string | null;
 export declare function resolveVeryfrontModuleUrl(specifier: string): string | null;
+/**
+ * Resolve an internal #veryfront/* specifier to a /_vf_modules/ URL.
+ * Uses the deno.json import map to get the correct filesystem path,
+ * which may differ from the specifier path (e.g. #veryfront/compat/console
+ * maps to src/platform/compat/console/index.ts, not src/compat/console.ts).
+ */
+export declare function resolveInternalModuleUrl(specifier: string): string | null;
 //# sourceMappingURL=veryfront-module-urls.d.ts.map

package/esm/src/transforms/veryfront-module-urls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"veryfront-module-urls.d.ts","sourceRoot":"","sources":["../../../src/src/transforms/veryfront-module-urls.ts"],"names":[],"mappings":"AAmDA,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE1E"}
+{"version":3,"file":"veryfront-module-urls.d.ts","sourceRoot":"","sources":["../../../src/src/transforms/veryfront-module-urls.ts"],"names":[],"mappings":"AAwGA,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7E;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG1E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzE"}

package/esm/src/transforms/veryfront-module-urls.js

@@ -1,41 +1,98 @@
 import denoConfig from "../../deno.js";
 const MODULE_EXT_RE = /\.(mjs|cjs|js|jsx|ts|tsx)$/;
 const SRC_PREFIX = "./src/";
+function createTargetIndex() {
+    return {
+        exactTargets: new Map(),
+        prefixTargets: [],
+    };
+}
+function normalizeModulePath(path) {
+    if (!path)
+        return path;
+    if (path.endsWith("/"))
+        return path;
+    return path.replace(MODULE_EXT_RE, ".js");
+}
 function toModuleServerUrl(target) {
     if (!target.startsWith(SRC_PREFIX))
         return null;
     const relative = target.slice(SRC_PREFIX.length);
     if (!relative)
         return null;
-    const withoutExt = relative.replace(MODULE_EXT_RE, "");
-    return `/_vf_modules/_veryfront/${withoutExt}.js`;
+    return `/_vf_modules/_veryfront/${normalizeModulePath(relative)}`;
 }
-function addMapping(map, specifier, target) {
-    const url = toModuleServerUrl(target);
-    if (!url)
+function addMapping(index, specifier, target) {
+    if (!target.startsWith(SRC_PREFIX))
+        return;
+    if (specifier.endsWith("/")) {
+        index.prefixTargets.push({
+            specifierPrefix: specifier,
+            targetPrefix: target.endsWith("/") ? target : `${target}/`,
+        });
         return;
-    map.set(specifier, url);
+    }
+    index.exactTargets.set(specifier, target);
+}
+function finalizeIndex(index) {
+    index.prefixTargets.sort((a, b) => b.specifierPrefix.length - a.specifierPrefix.length);
+}
+function resolveTarget(index, specifier) {
+    const exact = index.exactTargets.get(specifier);
+    if (exact)
+        return exact;
+    for (const { specifierPrefix, targetPrefix } of index.prefixTargets) {
+        if (!specifier.startsWith(specifierPrefix))
+            continue;
+        return `${targetPrefix}${specifier.slice(specifierPrefix.length)}`;
+    }
+    return null;
 }
 const config = denoConfig;
-const veryfrontModuleUrlMap = new Map();
+const veryfrontTargetIndex = createTargetIndex();
+const internalTargetIndex = createTargetIndex();
 for (const [specifier, target] of Object.entries(config.imports ?? {})) {
-    if (!specifier.startsWith("veryfront/"))
-        continue;
     if (typeof target !== "string")
         continue;
-    addMapping(veryfrontModuleUrlMap, specifier, target);
+    if (specifier === "veryfront" || specifier.startsWith("veryfront/")) {
+        addMapping(veryfrontTargetIndex, specifier, target);
+    }
+    // Also index #veryfront imports so the import rewriter can
+    // generate correct /_vf_modules/ URLs that match the actual filesystem layout.
+    if (specifier === "#veryfront" || specifier.startsWith("#veryfront/")) {
+        addMapping(internalTargetIndex, specifier, target);
+    }
 }
 for (const [key, target] of Object.entries(config.exports ?? {})) {
     if (typeof target !== "string")
         continue;
     if (key === ".") {
-        addMapping(veryfrontModuleUrlMap, "veryfront", target);
+        addMapping(veryfrontTargetIndex, "veryfront", target);
         continue;
     }
     if (!key.startsWith("./"))
         continue;
-    addMapping(veryfrontModuleUrlMap, `veryfront/${key.slice(2)}`, target);
+    addMapping(veryfrontTargetIndex, `veryfront/${key.slice(2)}`, target);
+}
+finalizeIndex(veryfrontTargetIndex);
+finalizeIndex(internalTargetIndex);
+export function resolveVeryfrontModuleTarget(specifier) {
+    return resolveTarget(veryfrontTargetIndex, specifier);
+}
+export function resolveInternalModuleTarget(specifier) {
+    return resolveTarget(internalTargetIndex, specifier);
 }
 export function resolveVeryfrontModuleUrl(specifier) {
-    return veryfrontModuleUrlMap.get(specifier) ?? null;
+    const target = resolveVeryfrontModuleTarget(specifier);
+    return target ? toModuleServerUrl(target) : null;
+}
+/**
+ * Resolve an internal #veryfront/* specifier to a /_vf_modules/ URL.
+ * Uses the deno.json import map to get the correct filesystem path,
+ * which may differ from the specifier path (e.g. #veryfront/compat/console
+ * maps to src/platform/compat/console/index.ts, not src/compat/console.ts).
+ */
+export function resolveInternalModuleUrl(specifier) {
+    const target = resolveInternalModuleTarget(specifier);
+    return target ? toModuleServerUrl(target) : null;
 }

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/src/utils/version.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,OAAO,EAAE,MAA6B,CAAC;AAEpD,eAAO,MAAM,iBAAiB,EAAE,MAAmB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,CAM1E"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/src/utils/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,WAAW,CAAC;AAEhC,eAAO,MAAM,iBAAiB,EAAE,MAAmB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,CAM1E"}

package/esm/src/utils/version.js

@@ -1,9 +1,6 @@
-import denoConfig from "../../deno.js";
-function getVersionFromDeno() {
-    return typeof denoConfig.version === "string" ? denoConfig.version : "0.0.0";
-}
-// Use deno.json version directly to avoid env access at module load
-export const VERSION = getVersionFromDeno();
+// Keep in sync with deno.json version.
+// scripts/release.ts updates this constant during releases.
+export const VERSION = "0.1.59";
 export const SERVER_START_TIME = Date.now();
 export function createBuildVersion(projectUpdatedAt) {
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.57",
+  "version": "0.1.59",
   "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.57",
+  "version": "0.1.59",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "exclude": [

package/src/src/modules/server/module-server.ts

@@ -6,7 +6,7 @@ import { join } from "../../platform/compat/path/index.js";
 import type { RuntimeAdapter } from "../../platform/adapters/base.js";
 import { createFileSystem } from "../../platform/compat/fs.js";
 import { type TransformOptions, transformToESM } from "../../transforms/esm-transform.js";
-import { serverLogger } from "../../utils/index.js";
+import { serverLogger, VERSION } from "../../utils/index.js";
 import { HTTP_NOT_FOUND, HTTP_OK, HTTP_SERVER_ERROR } from "../../utils/index.js";
 import { getContentTypeForPath } from "../../server/handlers/utils/content-types.js";
 import { createSecureFs } from "../../security/index.js";
@@ -81,6 +81,10 @@ export default {};
     `export default {};`,
   ].join("\n") + "\n",
   "_dnt.polyfills": `export default {};\n`,
+  // Deno import-map alias stub for browser/HTTP-served framework modules.
+  // Must be a JS module (not JSON) because esbuild strips `with { type: "json" }`
+  // at es2020 target, and browsers reject JSON MIME type without the assertion.
+  "_veryfront/_deno-config": `export default ${JSON.stringify({ version: VERSION })};\n`,
 };
 
 const DEV_MODULE_PREFIX = /^\/(?:_vf_modules|_veryfront\/modules)\//;
@@ -449,6 +453,7 @@ async function findSourceFile(
 ): Promise<FindSourceFileResult | null> {
   // Extensions including .src for compiled binary embedded sources
   const extensions = [
+    ".json",
     ".tsx.src",
     ".ts.src",
     ".jsx.src",
@@ -467,7 +472,7 @@ async function findSourceFile(
 
   const hasKnownExt = extensions.some((ext) => basePath.endsWith(ext));
   const rawBasePathWithoutExt = hasKnownExt
-    ? basePath.replace(/\.(tsx|ts|jsx|js|mdx|md)(\.src)?$/, "")
+    ? basePath.replace(/\.(json|tsx|ts|jsx|js|mdx|md)(\.src)?$/, "")
     : basePath;
   let basePathWithoutExt = rawBasePathWithoutExt.replace(/^\/+/, "");
   if (basePathWithoutExt.startsWith("_vf_modules/")) {
@@ -496,7 +501,7 @@ async function findSourceFile(
       basePath: basePathWithoutExt,
     });
     return {
-      path: `embedded:${basePathWithoutExt}`,
+      path: `embedded:${basePath}`,
       isFrameworkFile: true,
       embeddedContent,
     };
@@ -514,19 +519,23 @@ async function findSourceFile(
         ? basePathWithoutExt.slice(prefix.length)
         : basePathWithoutExt;
 
-      for (const ext of extensions) {
-        const frameworkPath = join(frameworkDir, pathWithinFramework + ext);
-        try {
-          const stat = await platformFs.stat(frameworkPath);
-          if (stat.isFile) {
-            logger.debug(`Found framework ${label} file`, {
-              basePath: basePathWithoutExt,
-              resolvedPath: frameworkPath,
-            });
-            return { path: frameworkPath, isFrameworkFile: true };
+      // Try direct file match first, then index file fallback
+      const candidates = [pathWithinFramework, `${pathWithinFramework}/index`];
+      for (const candidate of candidates) {
+        for (const ext of extensions) {
+          const frameworkPath = join(frameworkDir, candidate + ext);
+          try {
+            const stat = await platformFs.stat(frameworkPath);
+            if (stat.isFile) {
+              logger.debug(`Found framework ${label} file`, {
+                basePath: basePathWithoutExt,
+                resolvedPath: frameworkPath,
+              });
+              return { path: frameworkPath, isFrameworkFile: true };
+            }
+          } catch (_) {
+            /* expected: file may not exist at this extension */
           }
-        } catch (_) {
-          /* expected: file may not exist at this extension */
         }
       }
     }

package/src/src/transforms/import-rewriter/strategies/veryfront-strategy.ts

@@ -12,7 +12,10 @@ import type {
   RewriteResult,
 } from "../types.js";
 import { buildVeryfrontModuleUrl } from "../url-builder.js";
-import { resolveVeryfrontModuleUrl } from "../../veryfront-module-urls.js";
+import {
+  resolveInternalModuleUrl,
+  resolveVeryfrontModuleUrl,
+} from "../../veryfront-module-urls.js";
 
 /**
  * SSR-specific module overrides.
@@ -33,23 +36,38 @@ export class VeryfrontStrategy implements ImportRewriteStrategy {
     return (
       specifier.startsWith("#veryfront/") ||
       specifier.startsWith("veryfront/") ||
-      specifier === "veryfront"
+      specifier === "veryfront" ||
+      specifier === "#deno-config"
     );
   }
 
   rewrite(info: ImportSpecifierInfo, ctx: RewriteContext): RewriteResult {
     const specifier = info.specifier;
 
+    // Handle #deno-config — Deno import-map alias that doesn't exist in browsers.
+    // Rewrite to a JS module (not JSON) because esbuild strips `with { type: "json" }`
+    // at es2020 target and browsers reject JSON MIME without the assertion.
+    if (specifier === "#deno-config") {
+      return { specifier: "/_vf_modules/_veryfront/_deno-config.js" };
+    }
+
     // Handle #veryfront/* (internal framework imports)
     if (specifier.startsWith("#veryfront/")) {
       const path = specifier.slice("#veryfront/".length);
       // Try resolving via deno.json mappings first (veryfront/head → react/components/Head.js)
       const mapped = resolveVeryfrontModuleUrl(`veryfront/${path}`);
       if (mapped) {
-        // For SSR, append ?ssr=true to signal server-side rendering
         if (ctx.target === "ssr") return { specifier: `${mapped}?ssr=true` };
         return { specifier: mapped };
       }
+      // Try resolving via #veryfront/* import map (handles paths where the
+      // filesystem layout differs from the specifier, e.g. #veryfront/compat/console
+      // maps to src/platform/compat/console/index.ts, not src/compat/console.ts)
+      const internalMapped = resolveInternalModuleUrl(specifier);
+      if (internalMapped) {
+        if (ctx.target === "ssr") return { specifier: `${internalMapped}?ssr=true` };
+        return { specifier: internalMapped };
+      }
       const builtUrl = buildVeryfrontModuleUrl(path);
       if (ctx.target === "ssr") return { specifier: `${builtUrl}?ssr=true` };
       return { specifier: builtUrl };

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

@@ -8,6 +8,7 @@
 import { createFileSystem, exists } from "../../../../platform/compat/fs.js";
 import { join } from "../../../../platform/compat/path/index.js";
 import { rendererLogger as logger } from "../../../../utils/index.js";
+import { resolveInternalModuleTarget } from "../../../veryfront-module-urls.js";
 import {
   EMBEDDED_SRC_DIR,
   EXTENSIONS,
@@ -120,7 +121,10 @@ export async function resolveFrameworkFile(
 export async function resolveVeryfrontSourcePath(specifier: string): Promise<string | null> {
   if (!specifier.startsWith("#veryfront/")) return null;
 
-  const relativePath = specifier.slice("#veryfront/".length);
+  const mappedTarget = resolveInternalModuleTarget(specifier);
+  if (!mappedTarget?.startsWith("./src/")) return null;
+
+  const relativePath = mappedTarget.slice("./src/".length);
   const hasExtension = /\.(tsx?|jsx?|mjs)$/.test(relativePath);
 
   // Check embedded sources first (for compiled binaries), then regular src/

package/src/src/transforms/veryfront-module-urls.ts

@@ -8,47 +8,120 @@ type DenoConfig = {
 const MODULE_EXT_RE = /\.(mjs|cjs|js|jsx|ts|tsx)$/;
 const SRC_PREFIX = "./src/";
 
+type ModuleTargetIndex = {
+  exactTargets: Map<string, string>;
+  prefixTargets: Array<{ specifierPrefix: string; targetPrefix: string }>;
+};
+
+function createTargetIndex(): ModuleTargetIndex {
+  return {
+    exactTargets: new Map<string, string>(),
+    prefixTargets: [],
+  };
+}
+
+function normalizeModulePath(path: string): string {
+  if (!path) return path;
+  if (path.endsWith("/")) return path;
+  return path.replace(MODULE_EXT_RE, ".js");
+}
+
 function toModuleServerUrl(target: string): string | null {
   if (!target.startsWith(SRC_PREFIX)) return null;
 
   const relative = target.slice(SRC_PREFIX.length);
   if (!relative) return null;
 
-  const withoutExt = relative.replace(MODULE_EXT_RE, "");
-  return `/_vf_modules/_veryfront/${withoutExt}.js`;
+  return `/_vf_modules/_veryfront/${normalizeModulePath(relative)}`;
 }
 
 function addMapping(
-  map: Map<string, string>,
+  index: ModuleTargetIndex,
   specifier: string,
   target: string,
 ): void {
-  const url = toModuleServerUrl(target);
-  if (!url) return;
-  map.set(specifier, url);
+  if (!target.startsWith(SRC_PREFIX)) return;
+
+  if (specifier.endsWith("/")) {
+    index.prefixTargets.push({
+      specifierPrefix: specifier,
+      targetPrefix: target.endsWith("/") ? target : `${target}/`,
+    });
+    return;
+  }
+
+  index.exactTargets.set(specifier, target);
+}
+
+function finalizeIndex(index: ModuleTargetIndex): void {
+  index.prefixTargets.sort((a, b) => b.specifierPrefix.length - a.specifierPrefix.length);
+}
+
+function resolveTarget(index: ModuleTargetIndex, specifier: string): string | null {
+  const exact = index.exactTargets.get(specifier);
+  if (exact) return exact;
+
+  for (const { specifierPrefix, targetPrefix } of index.prefixTargets) {
+    if (!specifier.startsWith(specifierPrefix)) continue;
+    return `${targetPrefix}${specifier.slice(specifierPrefix.length)}`;
+  }
+
+  return null;
 }
 
 const config = denoConfig as DenoConfig;
-const veryfrontModuleUrlMap = new Map<string, string>();
+const veryfrontTargetIndex = createTargetIndex();
+const internalTargetIndex = createTargetIndex();
 
 for (const [specifier, target] of Object.entries(config.imports ?? {})) {
-  if (!specifier.startsWith("veryfront/")) continue;
   if (typeof target !== "string") continue;
-  addMapping(veryfrontModuleUrlMap, specifier, target);
+
+  if (specifier === "veryfront" || specifier.startsWith("veryfront/")) {
+    addMapping(veryfrontTargetIndex, specifier, target);
+  }
+
+  // Also index #veryfront imports so the import rewriter can
+  // generate correct /_vf_modules/ URLs that match the actual filesystem layout.
+  if (specifier === "#veryfront" || specifier.startsWith("#veryfront/")) {
+    addMapping(internalTargetIndex, specifier, target);
+  }
 }
 
 for (const [key, target] of Object.entries(config.exports ?? {})) {
   if (typeof target !== "string") continue;
 
   if (key === ".") {
-    addMapping(veryfrontModuleUrlMap, "veryfront", target);
+    addMapping(veryfrontTargetIndex, "veryfront", target);
     continue;
   }
 
   if (!key.startsWith("./")) continue;
-  addMapping(veryfrontModuleUrlMap, `veryfront/${key.slice(2)}`, target);
+  addMapping(veryfrontTargetIndex, `veryfront/${key.slice(2)}`, target);
+}
+
+finalizeIndex(veryfrontTargetIndex);
+finalizeIndex(internalTargetIndex);
+
+export function resolveVeryfrontModuleTarget(specifier: string): string | null {
+  return resolveTarget(veryfrontTargetIndex, specifier);
+}
+
+export function resolveInternalModuleTarget(specifier: string): string | null {
+  return resolveTarget(internalTargetIndex, specifier);
 }
 
 export function resolveVeryfrontModuleUrl(specifier: string): string | null {
-  return veryfrontModuleUrlMap.get(specifier) ?? null;
+  const target = resolveVeryfrontModuleTarget(specifier);
+  return target ? toModuleServerUrl(target) : null;
+}
+
+/**
+ * Resolve an internal #veryfront/* specifier to a /_vf_modules/ URL.
+ * Uses the deno.json import map to get the correct filesystem path,
+ * which may differ from the specifier path (e.g. #veryfront/compat/console
+ * maps to src/platform/compat/console/index.ts, not src/compat/console.ts).
+ */
+export function resolveInternalModuleUrl(specifier: string): string | null {
+  const target = resolveInternalModuleTarget(specifier);
+  return target ? toModuleServerUrl(target) : null;
 }

package/src/src/utils/version.ts

@@ -1,11 +1,6 @@
-import denoConfig from "../../deno.js";
-
-function getVersionFromDeno(): string {
-  return typeof denoConfig.version === "string" ? denoConfig.version : "0.0.0";
-}
-
-// Use deno.json version directly to avoid env access at module load
-export const VERSION: string = getVersionFromDeno();
+// Keep in sync with deno.json version.
+// scripts/release.ts updates this constant during releases.
+export const VERSION = "0.1.59";
 
 export const SERVER_START_TIME: number = Date.now();