veryfront 0.1.115 → 0.1.117

package/esm/deno.js

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

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

@@ -359,9 +359,9 @@ async function findSourceFile(secureFs, projectDir, basePath) {
         basePathWithoutExt = basePathWithoutExt.slice("_vf_modules/".length);
     }
     const frameworkLookups = [
-        // Embedded sources for compiled binaries (.src extensions)
-        ["_veryfront/", EMBEDDED_SRC_DIR, "_veryfront-embedded", true],
         ["_veryfront/", join(FRAMEWORK_ROOT, "src"), "_veryfront", true],
+        // Embedded sources are a fallback for compiled binaries when src/ is unavailable.
+        ["_veryfront/", EMBEDDED_SRC_DIR, "_veryfront-embedded", true],
         // Fallback to projectDir for local dev/proxy setups where FRAMEWORK_ROOT may differ.
         ["_veryfront/", join(projectDir, "src"), "_veryfront-project", true],
     ];

package/esm/src/react/components/ai/markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../../../src/src/react/components/ai/markdown.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iCAAiC;IACjC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,KAAK,CAAC,SAAS,CAAC;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAmJD,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,SAAS,EACT,aAAoB,EACpB,eAAe,GAChB,EAAE,aAAa,GAAG,KAAK,CAAC,YAAY,CA+FpC"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../../../src/src/react/components/ai/markdown.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iCAAiC;IACjC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,KAAK,CAAC,SAAS,CAAC;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAkKD,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,SAAS,EACT,aAAoB,EACpB,eAAe,GAChB,EAAE,aAAa,GAAG,KAAK,CAAC,YAAY,CA+FpC"}

package/esm/src/react/components/ai/markdown.js

@@ -7,7 +7,9 @@ const ESM_REACT_MARKDOWN = "https://esm.sh/react-markdown@9.0.3?external=react&t
 const ESM_REMARK_GFM = "https://esm.sh/remark-gfm@4.0.1?target=es2022&pin=v135";
 const ESM_REHYPE_HIGHLIGHT = "https://esm.sh/rehype-highlight@7.0.2?target=es2022&pin=v135";
 const ESM_MERMAID = "https://esm.sh/mermaid@11.4.1?pin=v135";
-const dynamicImport = new Function("url", "return import(url)");
+async function importFromUrl(url) {
+    return await import(url);
+}
 // deno-lint-ignore no-explicit-any
 let ReactMarkdown = null;
 // deno-lint-ignore no-explicit-any
@@ -23,7 +25,7 @@ async function loadMermaid() {
         return null;
     if (mermaidModule)
         return mermaidModule;
-    mermaidPromise ??= dynamicImport(ESM_MERMAID);
+    mermaidPromise ??= importFromUrl(ESM_MERMAID);
     mermaidModule = await mermaidPromise;
     mermaidModule.default.initialize({
         startOnLoad: false,
@@ -101,9 +103,9 @@ export function Markdown({ children, className, enableMermaid = true, renderCode
         async function load() {
             if (!ReactMarkdown) {
                 const [rmModule, gfmModule, highlightModule] = await Promise.all([
-                    dynamicImport(ESM_REACT_MARKDOWN),
-                    dynamicImport(ESM_REMARK_GFM),
-                    dynamicImport(ESM_REHYPE_HIGHLIGHT),
+                    importFromUrl(ESM_REACT_MARKDOWN),
+                    importFromUrl(ESM_REMARK_GFM),
+                    importFromUrl(ESM_REHYPE_HIGHLIGHT),
                 ]);
                 ReactMarkdown = rmModule.default;
                 remarkGfm = gfmModule.default;

package/esm/src/server/handlers/dev/files/dev-file.handler.d.ts

@@ -4,6 +4,7 @@ import type { HandlerContext, HandlerMetadata, HandlerResult } from "../../types
 export declare class DevFileHandler extends BaseHandler {
     metadata: HandlerMetadata;
     handle(req: dntShim.Request, ctx: HandlerContext): Promise<HandlerResult>;
+    private handleWithContext;
     private createErrorModule;
 }
 //# sourceMappingURL=dev-file.handler.d.ts.map

package/esm/src/server/handlers/dev/files/dev-file.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-file.handler.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/dev/files/dev-file.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,aAAa,EACd,MAAM,gBAAgB,CAAC;AASxB,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,EAAE,eAAe,CAKvB;IAEI,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAwC/E,OAAO,CAAC,iBAAiB;CAM1B"}
+{"version":3,"file":"dev-file.handler.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/dev/files/dev-file.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,aAAa,EACd,MAAM,gBAAgB,CAAC;AAWxB,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,EAAE,eAAe,CAKvB;IAEI,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;YA4CjE,iBAAiB;IAmC/B,OAAO,CAAC,iBAAiB;CAM1B"}

package/esm/src/server/handlers/dev/files/dev-file.handler.js

@@ -3,6 +3,8 @@ import { BaseHandler } from "../../response/base.js";
 import { validateDevFilePath } from "./path-validator.js";
 import { bundleDevFile } from "./esbuild-bundler.js";
 import { HTTP_INTERNAL_SERVER_ERROR, HTTP_NOT_FOUND, PRIORITY_MEDIUM_DEV_FILES, } from "../../../../utils/constants/index.js";
+import { isExtendedFSAdapter } from "../../../../platform/adapters/fs/wrapper.js";
+import { getHostEnv } from "../../../../platform/compat/process.js";
 export class DevFileHandler extends BaseHandler {
     metadata = {
         name: "DevFileHandler",
@@ -18,6 +20,32 @@ export class DevFileHandler extends BaseHandler {
         if (req.method !== "GET" || !pathname.startsWith("/_veryfront/fs/")) {
             return this.continue();
         }
+        const fsAdapter = ctx.adapter.fs;
+        const isExtended = isExtendedFSAdapter(fsAdapter);
+        if (!ctx.isLocalProject && ctx.projectSlug && isExtended && fsAdapter.isMultiProjectMode()) {
+            const effectiveToken = ctx.proxyToken || getHostEnv("VERYFRONT_API_TOKEN") || "";
+            const branch = ctx.parsedDomain?.branch ?? null;
+            return await fsAdapter.runWithContext(ctx.projectSlug, effectiveToken, () => this.handleWithContext(req, pathname, ctx), ctx.projectId, {
+                productionMode: false,
+                releaseId: ctx.releaseId,
+                branch,
+                environmentName: ctx.environmentName,
+            });
+        }
+        if (isExtended && fsAdapter.isContextualMode()) {
+            try {
+                if (ctx.proxyToken)
+                    fsAdapter.setRequestToken(ctx.proxyToken);
+                fsAdapter.setRequestBranch(ctx.parsedDomain?.branch ?? null);
+                fsAdapter.setProductionMode(false, ctx.releaseId);
+            }
+            catch (_) {
+                /* expected: some fs adapter operations may not be supported */
+            }
+        }
+        return await this.handleWithContext(req, pathname, ctx);
+    }
+    async handleWithContext(req, pathname, ctx) {
         const encoded = pathname.slice("/_veryfront/fs/".length).replace(/\.js$/, "");
         const absPath = await validateDevFilePath(encoded, ctx);
         if (absPath.startsWith("Error:")) {

package/esm/src/server/handlers/dev/files/esbuild-bundler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"esbuild-bundler.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/dev/files/esbuild-bundler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAKrD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BnF"}
+{"version":3,"file":"esbuild-bundler.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/dev/files/esbuild-bundler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMrD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAuCnF"}

package/esm/src/server/handlers/dev/files/esbuild-bundler.js

@@ -1,3 +1,4 @@
+import { buildImportMapJson } from "../../../../html/index.js";
 import { getDirectory, getEsbuildLoader } from "../../../../utils/path-utils.js";
 import { createBareExternalPlugin, createRelativeFsPlugin } from "./esbuild-plugins.js";
 import { withSpan } from "../../../../observability/tracing/otlp-setup.js";
@@ -5,6 +6,11 @@ export function bundleDevFile(absPath, ctx) {
     return withSpan("server.dev.esbuild.bundleFile", async () => {
         const { build } = await import("esbuild");
         const src = await ctx.adapter.fs.readFile(absPath);
+        const importMapJson = await buildImportMapJson({
+            projectDir: ctx.projectDir,
+            config: ctx.config,
+        });
+        const importMap = JSON.parse(importMapJson);
         const { outputFiles } = await build({
             bundle: true,
             write: false,
@@ -20,7 +26,12 @@ export function bundleDevFile(absPath, ctx) {
                 resolveDir: getDirectory(absPath),
                 sourcefile: absPath,
             },
-            plugins: [createRelativeFsPlugin(ctx.projectDir, ctx.adapter), createBareExternalPlugin()],
+            plugins: [
+                createRelativeFsPlugin(ctx.projectDir, ctx.adapter),
+                createBareExternalPlugin({
+                    importMapImports: importMap.imports,
+                }),
+            ],
         });
         return outputFiles?.[0]?.text ?? "export default null";
     }, { "bundle.filePath": absPath, "bundle.projectSlug": ctx.projectSlug ?? "unknown" });

package/esm/src/server/handlers/dev/files/esbuild-plugins.d.ts

@@ -8,6 +8,7 @@ interface BareExternalPluginOptions {
     lockfile?: LockfileManager;
     projectDir?: string;
     strict?: boolean;
+    importMapImports?: Record<string, string>;
 }
 /** Create bare module external plugin that rewrites npm imports to esm.sh URLs */
 export declare function createBareExternalPlugin(options?: BareExternalPluginOptions | boolean): Plugin;

package/esm/src/server/handlers/dev/files/esbuild-plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"esbuild-plugins.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/dev/files/esbuild-plugins.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA6B,MAAM,EAAe,MAAM,SAAS,CAAC;AAG9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAG5E,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,sCAAsC,CAAC;AAc9C,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CA6C1F;AAkBD,UAAU,yBAAyB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA+DD,kFAAkF;AAClF,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAAyB,GAAG,OAAe,GACnD,MAAM,CAoER"}
+{"version":3,"file":"esbuild-plugins.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/dev/files/esbuild-plugins.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA6B,MAAM,EAAe,MAAM,SAAS,CAAC;AAG9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAG5E,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,sCAAsC,CAAC;AAc9C,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CA6C1F;AAkBD,UAAU,yBAAyB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AA4ED,kFAAkF;AAClF,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAAyB,GAAG,OAAe,GACnD,MAAM,CAwER"}

package/esm/src/server/handlers/dev/files/esbuild-plugins.js

@@ -64,14 +64,14 @@ export function createRelativeFsPlugin(projectDir, adapter) {
  * Bare specifiers that should be kept as-is (not rewritten to esm.sh URLs).
  * These are resolved by the browser's import map injected in the HTML <head>.
  */
-const IMPORT_MAP_RESOLVED = new Set([
-    "react",
-    "react-dom",
-    "react-dom/client",
-    "react-dom/server",
-    "react/jsx-runtime",
-    "react/jsx-dev-runtime",
-]);
+const DEFAULT_IMPORT_MAP_IMPORTS = {
+    react: "",
+    "react-dom": "",
+    "react-dom/client": "",
+    "react-dom/server": "",
+    "react/jsx-runtime": "",
+    "react/jsx-dev-runtime": "",
+};
 /** Map of common packages to their esm.sh URLs for browser imports */
 const ESM_PACKAGE_MAP = {};
 function isBareImport(path) {
@@ -83,6 +83,15 @@ function isBareImport(path) {
 function toEsmUrl(path) {
     return ESM_PACKAGE_MAP[path] ?? `https://esm.sh/${path}`;
 }
+function isImportMapResolved(path, imports) {
+    if (Object.prototype.hasOwnProperty.call(imports, path))
+        return true;
+    for (const key of Object.keys(imports)) {
+        if (key.endsWith("/") && path.startsWith(key))
+            return true;
+    }
+    return false;
+}
 function resolveAsExternalOrHttps(path, bundle) {
     if (bundle)
         return { path, namespace: "https" };
@@ -127,6 +136,10 @@ export function createBareExternalPlugin(options = false) {
     const { bundle = false, strict = false } = opts;
     const lockfile = opts.lockfile ??
         (opts.projectDir && bundle ? createLockfileManager(opts.projectDir) : null);
+    const importMapImports = {
+        ...DEFAULT_IMPORT_MAP_IMPORTS,
+        ...(opts.importMapImports ?? {}),
+    };
     return {
         name: "veryfront-bare-ext",
         setup(build) {
@@ -137,7 +150,7 @@ export function createBareExternalPlugin(options = false) {
                     return undefined;
                 // Keep import-map-resolved specifiers as bare externals — the browser's
                 // <script type="importmap"> resolves them to the correct CDN URL.
-                if (IMPORT_MAP_RESOLVED.has(args.path)) {
+                if (isImportMapResolved(args.path, importMapImports)) {
                     return { path: args.path, external: true };
                 }
                 return resolveAsExternalOrHttps(toEsmUrl(args.path), bundle);

package/esm/src/server/handlers/dev/framework-candidates.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"framework-candidates.generated.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/dev/framework-candidates.generated.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EA4kKjD,CAAC"}
+{"version":3,"file":"framework-candidates.generated.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/dev/framework-candidates.generated.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAilKjD,CAAC"}

package/esm/src/server/handlers/dev/framework-candidates.generated.js

@@ -912,6 +912,7 @@ export const FRAMEWORK_CANDIDATES = [
     "Debounced",
     "Default",
     "Default:",
+    "DefaultModule<T>",
     "Definitions",
     "Delete",
     "Denied",
@@ -998,7 +999,6 @@ export const FRAMEWORK_CANDIDATES = [
     "For",
     "Format",
     "Framer",
-    "Function(",
     "GPT-4o",
     "Gemini",
     "GeminiLogo",
@@ -1124,6 +1124,7 @@ export const FRAMEWORK_CANDIDATES = [
     "Mermaid",
     "MermaidDiagram",
     "MermaidDiagram({",
+    "MermaidModule",
     "Message",
     "Message(",
     "Message,",
@@ -1319,11 +1320,12 @@ export const FRAMEWORK_CANDIDATES = [
     "Previous",
     "Primitives",
     "Promise.all([",
+    "Promise<MermaidModule>",
+    "Promise<T>",
     "Promise<any",
-    "Promise<any>",
-    "Promise<any>;",
     "Promise<void>",
     "Promise<void>;",
+    "Promise<{",
     "Property",
     "Props",
     "Provided",
@@ -1590,6 +1592,7 @@ export const FRAMEWORK_CANDIDATES = [
     "System",
     "T",
     "T,",
+    "T;",
     "TABS.map((tab)",
     "TABS:",
     "TARGET_ICON_ELEMENTS);",
@@ -2658,11 +2661,6 @@ export const FRAMEWORK_CANDIDATES = [
     "dynamic-tool",
     "dynamic={isDynamicTool(tool)}",
     "dynamic?:",
-    "dynamicImport",
-    "dynamicImport(ESM_MERMAID);",
-    "dynamicImport(ESM_REACT_MARKDOWN),",
-    "dynamicImport(ESM_REHYPE_HIGHLIGHT),",
-    "dynamicImport(ESM_REMARK_GFM),",
     "e.dataTransfer.files.length",
     "e.dataTransfer.types.includes(",
     "e.g.",
@@ -3102,6 +3100,11 @@ export const FRAMEWORK_CANDIDATES = [
     "ignores",
     "import",
     "import(url)",
+    "importFromUrl<DefaultModule<unknown>>(ESM_REACT_MARKDOWN),",
+    "importFromUrl<DefaultModule<unknown>>(ESM_REHYPE_HIGHLIGHT),",
+    "importFromUrl<DefaultModule<unknown>>(ESM_REMARK_GFM),",
+    "importFromUrl<MermaidModule>(ESM_MERMAID);",
+    "importFromUrl<T>(url:",
     "imports",
     "in",
     "index",
@@ -3124,6 +3127,7 @@ export const FRAMEWORK_CANDIDATES = [
     "initialContent,",
     "initialContent:",
     "initialContent={content}",
+    "initialize(config:",
     "injected",
     "injection.",
     "inline",
@@ -4188,6 +4192,7 @@ export const FRAMEWORK_CANDIDATES = [
     "render",
     "render():",
     "render();",
+    "render(id:",
     "render;",
     "render?:",
     "renderCodeBlock",

package/esm/src/transforms/mdx/esm-module-loader/resolution/file-finder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-finder.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/resolution/file-finder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAsC5E,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AA0BD,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAkHtC;AAED,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GACjD,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAqB9E"}
+{"version":3,"file":"file-finder.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/resolution/file-finder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAuC5E,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AA0BD,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAkHtC;AAED,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GACjD,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAqB9E"}

package/esm/src/transforms/mdx/esm-module-loader/resolution/file-finder.js

@@ -21,10 +21,11 @@ const FRAMEWORK_EXTENSIONS = [
     ".jsx",
     ".js", // Regular sources for dev mode
 ];
-// Framework lookup directories in priority order
+// Framework lookup directories in priority order.
+// Prefer source files when they exist; embedded .src files are a fallback.
 const FRAMEWORK_LOOKUP_DIRS = [
-    EMBEDDED_SRC_DIR, // Embedded sources for compiled binaries (.src files)
     join(FRAMEWORK_ROOT, "src"), // Regular sources for dev mode
+    EMBEDDED_SRC_DIR, // Embedded sources for compiled binaries (.src files)
 ];
 function decodeContent(content) {
     return typeof content === "string" ? content : new TextDecoder().decode(content);
@@ -113,8 +114,8 @@ export async function resolveModuleFile(normalizedPath, adapter, projectDir) {
     if (!isFramework)
         return null;
     // Try to resolve framework files from multiple locations:
-    // 1. EMBEDDED_SRC_DIR (dist/framework-src) - for compiled binaries with .src extensions
-    // 2. FRAMEWORK_ROOT/src - for development mode with regular extensions
+    // 1. FRAMEWORK_ROOT/src - source checkouts should prefer current source files
+    // 2. EMBEDDED_SRC_DIR (dist/framework-src) - fallback for compiled binaries
     const localFs = getLocalFs();
     logger.debug(`${LOG_PREFIX_MDX_LOADER} Resolving framework file`, {
         normalizedPath,

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/pipeline/stages/ssr-vf-modules/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE,eAAO,MAAM,UAAU,qBAAqB,CAAC;AAG7C,eAAO,MAAM,UAAU,UAAiC,CAAC;AASzD,eAAO,MAAM,cAAc,QAAyB,CAAC;AAKrD,eAAO,MAAM,gBAAgB,QAAwD,CAAC;AAItF,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAK3E,CAAC;AAGF,eAAO,MAAM,oBAAoB,sBAA6B,CAAC;AAG/D,eAAO,MAAM,uBAAuB,qBAA4B,CAAC;AAGjE,eAAO,MAAM,kBAAkB,qBAA4B,CAAC;AAG5D,eAAO,MAAM,iBAAiB,aAAoB,CAAC;AAGnD,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;CACzC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/pipeline/stages/ssr-vf-modules/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEjE,eAAO,MAAM,UAAU,qBAAqB,CAAC;AAG7C,eAAO,MAAM,UAAU,UAAiC,CAAC;AASzD,eAAO,MAAM,cAAc,QAAyB,CAAC;AAKrD,eAAO,MAAM,gBAAgB,QAAwD,CAAC;AAKtF,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAK3E,CAAC;AAGF,eAAO,MAAM,oBAAoB,sBAA6B,CAAC;AAG/D,eAAO,MAAM,uBAAuB,qBAA4B,CAAC;AAGjE,eAAO,MAAM,kBAAkB,qBAA4B,CAAC;AAG5D,eAAO,MAAM,iBAAiB,aAAoB,CAAC;AAGnD,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;CACzC"}

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

@@ -18,13 +18,14 @@ export const FRAMEWORK_ROOT = RUNTIME_FRAMEWORK_ROOT;
 // These are .src files created by scripts/prepare-framework-sources.ts.
 // In compiled binaries, files are extracted to the runtime directory.
 export const EMBEDDED_SRC_DIR = join(RUNTIME_FRAMEWORK_ROOT, "dist", "framework-src");
-// Map of _vf_modules prefixes to framework directories
-// We try embedded sources first (for compiled binaries), then regular src/
+// Map of _vf_modules prefixes to framework directories.
+// Prefer regular src/ when present so source checkouts never serve stale
+// dist/framework-src copies; compiled binaries fall back to embedded .src files.
 export const FRAMEWORK_LOOKUPS = [
-    // Embedded sources for compiled binaries (these are .src files)
-    ["_veryfront/", EMBEDDED_SRC_DIR],
     // Regular sources for dev mode
     ["_veryfront/", join(FRAMEWORK_ROOT, "src")],
+    // Embedded sources for compiled binaries (these are .src files)
+    ["_veryfront/", EMBEDDED_SRC_DIR],
 ];
 // Singleflight for framework module file writes to prevent race conditions
 export const frameworkWriteFlight = new Singleflight();

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

@@ -20,9 +20,9 @@ export declare function resolveFrameworkFile(vfModulePath: string, fs: ReturnTyp
  * Resolve a #veryfront/ import to the actual framework source file path.
  * Returns the resolved path if found, null otherwise.
  *
- * IMPORTANT: This function checks embedded sources FIRST (for compiled binaries),
- * then falls back to regular src/. This matches resolveFrameworkFile's behavior
- * and ensures consistent path resolution for cycle detection.
+ * IMPORTANT: This function prefers regular src/ when present, then falls back
+ * to embedded sources for compiled binaries. This matches resolveFrameworkFile's
+ * behavior and ensures consistent path resolution for cycle detection.
  */
 export declare function resolveVeryfrontSourcePath(specifier: string, existsFn?: (path: string) => Promise<boolean>): Promise<string | null>;
 /**

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

@@ -89,9 +89,9 @@ export async function resolveFrameworkFile(vfModulePath, fs, existsFn = exists)
  * Resolve a #veryfront/ import to the actual framework source file path.
  * Returns the resolved path if found, null otherwise.
  *
- * IMPORTANT: This function checks embedded sources FIRST (for compiled binaries),
- * then falls back to regular src/. This matches resolveFrameworkFile's behavior
- * and ensures consistent path resolution for cycle detection.
+ * IMPORTANT: This function prefers regular src/ when present, then falls back
+ * to embedded sources for compiled binaries. This matches resolveFrameworkFile's
+ * behavior and ensures consistent path resolution for cycle detection.
  */
 export async function resolveVeryfrontSourcePath(specifier, existsFn = exists) {
     if (!specifier.startsWith("#veryfront/"))
@@ -101,13 +101,13 @@ export async function resolveVeryfrontSourcePath(specifier, existsFn = exists) {
         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/
+    // Prefer regular src/ when present, then fall back to embedded sources.
     // This order matches FRAMEWORK_LOOKUPS and resolveFrameworkFile to ensure
     // consistent path resolution across the codebase, which is critical for
     // cycle detection in transformingFiles.
     const lookupDirs = [
-        EMBEDDED_SRC_DIR, // Embedded sources for compiled binaries (.src files)
         join(FRAMEWORK_ROOT, "src"), // Regular sources for dev mode
+        EMBEDDED_SRC_DIR, // Embedded sources for compiled binaries (.src files)
     ];
     for (const dir of lookupDirs) {
         const basePath = join(dir, relativePath);

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

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.115";
+export declare const VERSION = "0.1.117";
 //# sourceMappingURL=version-constant.d.ts.map

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

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.115";
+export const VERSION = "0.1.117";

package/package.json

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

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

@@ -480,9 +480,9 @@ async function findSourceFile(
   }
 
   const frameworkLookups: [string, string, string, boolean][] = [
-    // Embedded sources for compiled binaries (.src extensions)
-    ["_veryfront/", EMBEDDED_SRC_DIR, "_veryfront-embedded", true],
     ["_veryfront/", join(FRAMEWORK_ROOT, "src"), "_veryfront", true],
+    // Embedded sources are a fallback for compiled binaries when src/ is unavailable.
+    ["_veryfront/", EMBEDDED_SRC_DIR, "_veryfront-embedded", true],
     // Fallback to projectDir for local dev/proxy setups where FRAMEWORK_ROOT may differ.
     ["_veryfront/", join(projectDir, "src"), "_veryfront-project", true],
   ];

package/src/src/react/components/ai/markdown.tsx

@@ -27,7 +27,22 @@ const ESM_REMARK_GFM = "https://esm.sh/remark-gfm@4.0.1?target=es2022&pin=v135";
 const ESM_REHYPE_HIGHLIGHT = "https://esm.sh/rehype-highlight@7.0.2?target=es2022&pin=v135";
 const ESM_MERMAID = "https://esm.sh/mermaid@11.4.1?pin=v135";
 
-const dynamicImport = new Function("url", "return import(url)") as (url: string) => Promise<any>;
+type DefaultModule<T> = { default: T };
+
+type MermaidModule = {
+  default: {
+    initialize(config: {
+      startOnLoad: boolean;
+      theme: string;
+      securityLevel: string;
+    }): void;
+    render(id: string, code: string): Promise<{ svg: string }>;
+  };
+};
+
+async function importFromUrl<T>(url: string): Promise<T> {
+  return await import(url) as T;
+}
 
 // deno-lint-ignore no-explicit-any
 let ReactMarkdown: any = null;
@@ -37,7 +52,7 @@ let remarkGfm: any = null;
 let rehypeHighlight: any = null;
 
 // deno-lint-ignore no-explicit-any
-let mermaidPromise: Promise<any> | null = null;
+let mermaidPromise: Promise<MermaidModule> | null = null;
 // deno-lint-ignore no-explicit-any
 let mermaidModule: any = null;
 
@@ -45,7 +60,7 @@ async function loadMermaid(): Promise<any | null> {
   if (!isBrowserEnvironment()) return null;
   if (mermaidModule) return mermaidModule;
 
-  mermaidPromise ??= dynamicImport(ESM_MERMAID);
+  mermaidPromise ??= importFromUrl<MermaidModule>(ESM_MERMAID);
   mermaidModule = await mermaidPromise;
 
   mermaidModule.default.initialize({
@@ -180,9 +195,9 @@ export function Markdown({
     async function load(): Promise<void> {
       if (!ReactMarkdown) {
         const [rmModule, gfmModule, highlightModule] = await Promise.all([
-          dynamicImport(ESM_REACT_MARKDOWN),
-          dynamicImport(ESM_REMARK_GFM),
-          dynamicImport(ESM_REHYPE_HIGHLIGHT),
+          importFromUrl<DefaultModule<unknown>>(ESM_REACT_MARKDOWN),
+          importFromUrl<DefaultModule<unknown>>(ESM_REMARK_GFM),
+          importFromUrl<DefaultModule<unknown>>(ESM_REHYPE_HIGHLIGHT),
         ]);
 
         ReactMarkdown = rmModule.default;

package/src/src/server/handlers/dev/files/dev-file.handler.ts

@@ -13,6 +13,8 @@ import {
   HTTP_NOT_FOUND,
   PRIORITY_MEDIUM_DEV_FILES,
 } from "../../../../utils/constants/index.js";
+import { isExtendedFSAdapter } from "../../../../platform/adapters/fs/wrapper.js";
+import { getHostEnv } from "../../../../platform/compat/process.js";
 
 export class DevFileHandler extends BaseHandler {
   metadata: HandlerMetadata = {
@@ -32,6 +34,45 @@ export class DevFileHandler extends BaseHandler {
       return this.continue();
     }
 
+    const fsAdapter = ctx.adapter.fs;
+    const isExtended = isExtendedFSAdapter(fsAdapter);
+
+    if (!ctx.isLocalProject && ctx.projectSlug && isExtended && fsAdapter.isMultiProjectMode()) {
+      const effectiveToken = ctx.proxyToken || getHostEnv("VERYFRONT_API_TOKEN") || "";
+      const branch = ctx.parsedDomain?.branch ?? null;
+
+      return await fsAdapter.runWithContext(
+        ctx.projectSlug,
+        effectiveToken,
+        () => this.handleWithContext(req, pathname, ctx),
+        ctx.projectId,
+        {
+          productionMode: false,
+          releaseId: ctx.releaseId,
+          branch,
+          environmentName: ctx.environmentName,
+        },
+      );
+    }
+
+    if (isExtended && fsAdapter.isContextualMode()) {
+      try {
+        if (ctx.proxyToken) fsAdapter.setRequestToken(ctx.proxyToken);
+        fsAdapter.setRequestBranch(ctx.parsedDomain?.branch ?? null);
+        fsAdapter.setProductionMode(false, ctx.releaseId);
+      } catch (_) {
+        /* expected: some fs adapter operations may not be supported */
+      }
+    }
+
+    return await this.handleWithContext(req, pathname, ctx);
+  }
+
+  private async handleWithContext(
+    req: dntShim.Request,
+    pathname: string,
+    ctx: HandlerContext,
+  ): Promise<HandlerResult> {
     const encoded = pathname.slice("/_veryfront/fs/".length).replace(/\.js$/, "");
     const absPath = await validateDevFilePath(encoded, ctx);
 

package/src/src/server/handlers/dev/files/esbuild-bundler.ts

@@ -1,4 +1,5 @@
 import type { HandlerContext } from "../../types.js";
+import { buildImportMapJson } from "../../../../html/index.js";
 import { getDirectory, getEsbuildLoader } from "../../../../utils/path-utils.js";
 import { createBareExternalPlugin, createRelativeFsPlugin } from "./esbuild-plugins.js";
 import { withSpan } from "../../../../observability/tracing/otlp-setup.js";
@@ -9,6 +10,11 @@ export function bundleDevFile(absPath: string, ctx: HandlerContext): Promise<str
     async () => {
       const { build } = await import("esbuild");
       const src = await ctx.adapter.fs.readFile(absPath);
+      const importMapJson = await buildImportMapJson({
+        projectDir: ctx.projectDir,
+        config: ctx.config,
+      });
+      const importMap = JSON.parse(importMapJson) as { imports?: Record<string, string> };
 
       const { outputFiles } = await build({
         bundle: true,
@@ -25,7 +31,12 @@ export function bundleDevFile(absPath: string, ctx: HandlerContext): Promise<str
           resolveDir: getDirectory(absPath),
           sourcefile: absPath,
         },
-        plugins: [createRelativeFsPlugin(ctx.projectDir, ctx.adapter), createBareExternalPlugin()],
+        plugins: [
+          createRelativeFsPlugin(ctx.projectDir, ctx.adapter),
+          createBareExternalPlugin({
+            importMapImports: importMap.imports,
+          }),
+        ],
       });
 
       return outputFiles?.[0]?.text ?? "export default null";

package/src/src/server/handlers/dev/files/esbuild-plugins.ts

@@ -75,14 +75,14 @@ export function createRelativeFsPlugin(projectDir: string, adapter: RuntimeAdapt
  * Bare specifiers that should be kept as-is (not rewritten to esm.sh URLs).
  * These are resolved by the browser's import map injected in the HTML <head>.
  */
-const IMPORT_MAP_RESOLVED = new Set([
-  "react",
-  "react-dom",
-  "react-dom/client",
-  "react-dom/server",
-  "react/jsx-runtime",
-  "react/jsx-dev-runtime",
-]);
+const DEFAULT_IMPORT_MAP_IMPORTS: Record<string, string> = {
+  react: "",
+  "react-dom": "",
+  "react-dom/client": "",
+  "react-dom/server": "",
+  "react/jsx-runtime": "",
+  "react/jsx-dev-runtime": "",
+};
 
 /** Map of common packages to their esm.sh URLs for browser imports */
 const ESM_PACKAGE_MAP: Record<string, string> = {};
@@ -92,6 +92,7 @@ interface BareExternalPluginOptions {
   lockfile?: LockfileManager;
   projectDir?: string;
   strict?: boolean;
+  importMapImports?: Record<string, string>;
 }
 
 function isBareImport(path: string): boolean {
@@ -107,6 +108,19 @@ function toEsmUrl(path: string): string {
   return ESM_PACKAGE_MAP[path] ?? `https://esm.sh/${path}`;
 }
 
+function isImportMapResolved(
+  path: string,
+  imports: Record<string, string>,
+): boolean {
+  if (Object.prototype.hasOwnProperty.call(imports, path)) return true;
+
+  for (const key of Object.keys(imports)) {
+    if (key.endsWith("/") && path.startsWith(key)) return true;
+  }
+
+  return false;
+}
+
 function resolveAsExternalOrHttps(
   path: string,
   bundle: boolean,
@@ -165,6 +179,10 @@ export function createBareExternalPlugin(
   const { bundle = false, strict = false } = opts;
   const lockfile = opts.lockfile ??
     (opts.projectDir && bundle ? createLockfileManager(opts.projectDir) : null);
+  const importMapImports = {
+    ...DEFAULT_IMPORT_MAP_IMPORTS,
+    ...(opts.importMapImports ?? {}),
+  };
 
   return {
     name: "veryfront-bare-ext",
@@ -175,7 +193,7 @@ export function createBareExternalPlugin(
 
         // Keep import-map-resolved specifiers as bare externals — the browser's
         // <script type="importmap"> resolves them to the correct CDN URL.
-        if (IMPORT_MAP_RESOLVED.has(args.path)) {
+        if (isImportMapResolved(args.path, importMapImports)) {
           return { path: args.path, external: true };
         }
 

package/src/src/server/handlers/dev/framework-candidates.generated.ts

@@ -913,6 +913,7 @@ export const FRAMEWORK_CANDIDATES: readonly string[] = [
   "Debounced",
   "Default",
   "Default:",
+  "DefaultModule<T>",
   "Definitions",
   "Delete",
   "Denied",
@@ -999,7 +1000,6 @@ export const FRAMEWORK_CANDIDATES: readonly string[] = [
   "For",
   "Format",
   "Framer",
-  "Function(",
   "GPT-4o",
   "Gemini",
   "GeminiLogo",
@@ -1125,6 +1125,7 @@ export const FRAMEWORK_CANDIDATES: readonly string[] = [
   "Mermaid",
   "MermaidDiagram",
   "MermaidDiagram({",
+  "MermaidModule",
   "Message",
   "Message(",
   "Message,",
@@ -1320,11 +1321,12 @@ export const FRAMEWORK_CANDIDATES: readonly string[] = [
   "Previous",
   "Primitives",
   "Promise.all([",
+  "Promise<MermaidModule>",
+  "Promise<T>",
   "Promise<any",
-  "Promise<any>",
-  "Promise<any>;",
   "Promise<void>",
   "Promise<void>;",
+  "Promise<{",
   "Property",
   "Props",
   "Provided",
@@ -1591,6 +1593,7 @@ export const FRAMEWORK_CANDIDATES: readonly string[] = [
   "System",
   "T",
   "T,",
+  "T;",
   "TABS.map((tab)",
   "TABS:",
   "TARGET_ICON_ELEMENTS);",
@@ -2659,11 +2662,6 @@ export const FRAMEWORK_CANDIDATES: readonly string[] = [
   "dynamic-tool",
   "dynamic={isDynamicTool(tool)}",
   "dynamic?:",
-  "dynamicImport",
-  "dynamicImport(ESM_MERMAID);",
-  "dynamicImport(ESM_REACT_MARKDOWN),",
-  "dynamicImport(ESM_REHYPE_HIGHLIGHT),",
-  "dynamicImport(ESM_REMARK_GFM),",
   "e.dataTransfer.files.length",
   "e.dataTransfer.types.includes(",
   "e.g.",
@@ -3103,6 +3101,11 @@ export const FRAMEWORK_CANDIDATES: readonly string[] = [
   "ignores",
   "import",
   "import(url)",
+  "importFromUrl<DefaultModule<unknown>>(ESM_REACT_MARKDOWN),",
+  "importFromUrl<DefaultModule<unknown>>(ESM_REHYPE_HIGHLIGHT),",
+  "importFromUrl<DefaultModule<unknown>>(ESM_REMARK_GFM),",
+  "importFromUrl<MermaidModule>(ESM_MERMAID);",
+  "importFromUrl<T>(url:",
   "imports",
   "in",
   "index",
@@ -3125,6 +3128,7 @@ export const FRAMEWORK_CANDIDATES: readonly string[] = [
   "initialContent,",
   "initialContent:",
   "initialContent={content}",
+  "initialize(config:",
   "injected",
   "injection.",
   "inline",
@@ -4189,6 +4193,7 @@ export const FRAMEWORK_CANDIDATES: readonly string[] = [
   "render",
   "render():",
   "render();",
+  "render(id:",
   "render;",
   "render?:",
   "renderCodeBlock",

package/src/src/transforms/mdx/esm-module-loader/resolution/file-finder.ts

@@ -32,10 +32,11 @@ const FRAMEWORK_EXTENSIONS = [
   ".js", // Regular sources for dev mode
 ];
 
-// Framework lookup directories in priority order
+// Framework lookup directories in priority order.
+// Prefer source files when they exist; embedded .src files are a fallback.
 const FRAMEWORK_LOOKUP_DIRS = [
-  EMBEDDED_SRC_DIR, // Embedded sources for compiled binaries (.src files)
   join(FRAMEWORK_ROOT, "src"), // Regular sources for dev mode
+  EMBEDDED_SRC_DIR, // Embedded sources for compiled binaries (.src files)
 ];
 
 export interface FileResolutionResult {
@@ -145,8 +146,8 @@ export async function resolveModuleFile(
   if (!isFramework) return null;
 
   // Try to resolve framework files from multiple locations:
-  // 1. EMBEDDED_SRC_DIR (dist/framework-src) - for compiled binaries with .src extensions
-  // 2. FRAMEWORK_ROOT/src - for development mode with regular extensions
+  // 1. FRAMEWORK_ROOT/src - source checkouts should prefer current source files
+  // 2. EMBEDDED_SRC_DIR (dist/framework-src) - fallback for compiled binaries
   const localFs = getLocalFs();
 
   logger.debug(`${LOG_PREFIX_MDX_LOADER} Resolving framework file`, {

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

@@ -26,13 +26,14 @@ export const FRAMEWORK_ROOT = RUNTIME_FRAMEWORK_ROOT;
 // In compiled binaries, files are extracted to the runtime directory.
 export const EMBEDDED_SRC_DIR = join(RUNTIME_FRAMEWORK_ROOT, "dist", "framework-src");
 
-// Map of _vf_modules prefixes to framework directories
-// We try embedded sources first (for compiled binaries), then regular src/
+// Map of _vf_modules prefixes to framework directories.
+// Prefer regular src/ when present so source checkouts never serve stale
+// dist/framework-src copies; compiled binaries fall back to embedded .src files.
 export const FRAMEWORK_LOOKUPS: Array<[prefix: string, frameworkDir: string]> = [
-  // Embedded sources for compiled binaries (these are .src files)
-  ["_veryfront/", EMBEDDED_SRC_DIR],
   // Regular sources for dev mode
   ["_veryfront/", join(FRAMEWORK_ROOT, "src")],
+  // Embedded sources for compiled binaries (these are .src files)
+  ["_veryfront/", EMBEDDED_SRC_DIR],
 ];
 
 // Singleflight for framework module file writes to prevent race conditions

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

@@ -116,9 +116,9 @@ export async function resolveFrameworkFile(
  * Resolve a #veryfront/ import to the actual framework source file path.
  * Returns the resolved path if found, null otherwise.
  *
- * IMPORTANT: This function checks embedded sources FIRST (for compiled binaries),
- * then falls back to regular src/. This matches resolveFrameworkFile's behavior
- * and ensures consistent path resolution for cycle detection.
+ * IMPORTANT: This function prefers regular src/ when present, then falls back
+ * to embedded sources for compiled binaries. This matches resolveFrameworkFile's
+ * behavior and ensures consistent path resolution for cycle detection.
  */
 export async function resolveVeryfrontSourcePath(
   specifier: string,
@@ -132,13 +132,13 @@ export async function resolveVeryfrontSourcePath(
   const relativePath = mappedTarget.slice("./src/".length);
   const hasExtension = /\.(tsx?|jsx?|mjs)$/.test(relativePath);
 
-  // Check embedded sources first (for compiled binaries), then regular src/
+  // Prefer regular src/ when present, then fall back to embedded sources.
   // This order matches FRAMEWORK_LOOKUPS and resolveFrameworkFile to ensure
   // consistent path resolution across the codebase, which is critical for
   // cycle detection in transformingFiles.
   const lookupDirs = [
-    EMBEDDED_SRC_DIR, // Embedded sources for compiled binaries (.src files)
     join(FRAMEWORK_ROOT, "src"), // Regular sources for dev mode
+    EMBEDDED_SRC_DIR, // Embedded sources for compiled binaries (.src files)
   ];
 
   for (const dir of lookupDirs) {

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

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.115";
+export const VERSION = "0.1.117";