veryfront 0.1.367 → 0.1.369

package/esm/src/server/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/src/server/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAE,KAAK,eAAe,EAAqC,MAAM,wBAAwB,CAAC;AAmCjG,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,OAAO,EAAE,cAAc,CAAC;IAExB,2BAA2B;IAC3B,MAAM,EAAE,eAAe,CAAC;IAExB,wCAAwC;IACxC,cAAc,EAAE,OAAO,CAAC;IAExB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,eAAe,EAAE,eAAe,CAAC;IAEjC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AA2CD;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,EAC3C,SAAS,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,GAClC,OAAO,CAAC,eAAe,CAAC,CAO1B;AAkDD,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CA+I1B;AAED,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAa1B;AAED,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAyB1B"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/src/server/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAE,KAAK,eAAe,EAAqC,MAAM,wBAAwB,CAAC;AAqCjG,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,OAAO,EAAE,cAAc,CAAC;IAExB,2BAA2B;IAC3B,MAAM,EAAE,eAAe,CAAC;IAExB,wCAAwC;IACxC,cAAc,EAAE,OAAO,CAAC;IAExB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,eAAe,EAAE,eAAe,CAAC;IAEjC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAmED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,EAC3C,SAAS,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,GAClC,OAAO,CAAC,eAAe,CAAC,CAO1B;AAkDD,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAkJ1B;AAED,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAa1B;AAED,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAyB1B"}

package/esm/src/server/bootstrap.js

@@ -2,6 +2,8 @@ import { clearConfigCache, getConfig } from "../config/index.js";
 import { orchestrateExtensions, tryResolve } from "../extensions/index.js";
 import { AIProviderRegistryName } from "../extensions/interfaces/index.js";
 import { createAIProviderRegistry } from "../extensions/registries/ai-provider-registry.js";
+import { MISSING_EXTENSION_ERROR } from "../extensions/errors.js";
+import { getRecommendation } from "../extensions/recommendations.js";
 import { setGlobalActiveSpanAccessor, setGlobalMetricsAPI, setGlobalTracerProvider, } from "../observability/tracing/api-shim.js";
 import { getEnvironmentConfig, refreshEnvironmentConfig, } from "../config/environment-config.js";
 import { getErrorMessage } from "../errors/veryfront-error.js";
@@ -22,6 +24,23 @@ const bootstrapProdLog = logger.component("bootstrap-prod");
  * Wire the `TracingExporter` contract (if registered) into the core shim.
  * Must be called after `orchestrateExtensions()` completes.
  */
+/**
+ * Fail-fast: ensure the `Bundler` contract has been registered. Core depends
+ * on it for every JS/TS transform path. `ModuleLexer` is checked too, but
+ * only as a warning (dev-only paths can degrade).
+ */
+function assertRequiredContracts() {
+    if (!tryResolve("Bundler")) {
+        const recommendation = getRecommendation("Bundler");
+        throw MISSING_EXTENSION_ERROR.create({
+            message: `Missing extension for contract "Bundler"${recommendation ? `. Recommended: ${recommendation}` : ""}`,
+            detail: recommendation ? `Install it with: deno add ${recommendation}` : undefined,
+        });
+    }
+    if (!tryResolve("ModuleLexer")) {
+        bootstrapLog.warn(`[bootstrap] no ModuleLexer extension registered — dev-server import rewriting will fail. Recommended: ${getRecommendation("ModuleLexer") ?? "@veryfront/ext-esbuild"}`);
+    }
+}
 function wireTracingShim() {
     const tracing = tryResolve("TracingExporter");
     if (tracing) {
@@ -135,6 +154,7 @@ export async function bootstrap(projectDir, adapter) {
             primeContracts: { [AIProviderRegistryName]: createAIProviderRegistry() },
         });
         wireTracingShim();
+        assertRequiredContracts();
         return {
             adapter,
             config,
@@ -167,6 +187,7 @@ export async function bootstrap(projectDir, adapter) {
             primeContracts: { [AIProviderRegistryName]: createAIProviderRegistry() },
         });
         wireTracingShim();
+        assertRequiredContracts();
         return {
             adapter,
             config,
@@ -222,6 +243,7 @@ export async function bootstrap(projectDir, adapter) {
         primeContracts: { [AIProviderRegistryName]: createAIProviderRegistry() },
     }), fsDispose);
     wireTracingShim();
+    assertRequiredContracts();
     return {
         adapter: enhancedAdapter,
         config,

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

@@ -105,7 +105,7 @@ async function loadMiddlewareFromVirtualFS(middlewarePath, adapter) {
     const content = await adapter.fs.readFile(middlewarePath);
     const source = typeof content === "string" ? content : new TextDecoder().decode(content);
     const loader = getEsbuildLoader(middlewarePath);
-    const { build } = await import("esbuild");
+    const { build } = await import("../../extensions/bundler.js");
     const result = await build({
         bundle: false,
         write: false,

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

@@ -1,4 +1,4 @@
-import type { Plugin } from "esbuild";
+import type { Plugin } from "../../../../extensions/bundler.js";
 import type { RuntimeAdapter } from "../../../../platform/adapters/base.js";
 import { type LockfileManager } from "../../../../utils/import-lockfile.js";
 /** Create relative file system plugin for resolving imports via adapter's fs */

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":"AAAA,OAAO,KAAK,EAA6B,MAAM,EAAe,MAAM,SAAS,CAAC;AAG9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAQ5E,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,sCAAsC,CAAC;AAkB9C,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAyF1F;AAKD,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;AA+DD,kFAAkF;AAClF,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAAyB,GAAG,OAAe,GACnD,MAAM,CAqER;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAUjD"}
+{"version":3,"file":"esbuild-plugins.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/dev/files/esbuild-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA6B,MAAM,EAAe,MAAM,mCAAmC,CAAC;AAGxG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAQ5E,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,sCAAsC,CAAC;AAkB9C,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAyF1F;AAKD,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;AA+DD,kFAAkF;AAClF,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAAyB,GAAG,OAAe,GACnD,MAAM,CAqER;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAUjD"}

package/esm/src/server/handlers/studio/bridge-modules.handler.js

@@ -44,7 +44,7 @@ async function bundleBridge() {
     // Dev mode: bundle on-the-fly with esbuild
     const entryPoint = `${BRIDGE_DIR}bridge-coordinator.ts`;
     const source = await dntShim.Deno.readTextFile(entryPoint);
-    const { build } = await import("esbuild");
+    const { build } = await import("../../../extensions/bundler.js");
     const { outputFiles } = await build({
         bundle: true,
         write: false,

package/esm/src/server/services/rsc/endpoints/script-handlers.js

@@ -17,7 +17,7 @@ async function buildOrServeScript(adapter, path, fallbackBundle, esbuildOptions)
     let esbuild = null;
     try {
         const src = await adapter.fs.readFile(path);
-        esbuild = await import("esbuild");
+        esbuild = await import("../../../../extensions/bundler.js");
         const result = await esbuild.build({
             ...esbuildOptions,
             stdin: { ...esbuildOptions.stdin, contents: src },

package/esm/src/server/services/rsc/orchestrators/hydrator-handler.js

@@ -25,7 +25,7 @@ export class HydratorHandler {
         return this.fsAdapter?.readFile(filePath) ?? compatFs.readTextFile(filePath);
     }
     async bundleHydrator(filePath) {
-        const { build, stop } = await import("esbuild");
+        const { build, stop } = await import("../../../../extensions/bundler.js");
         try {
             const source = await this.readHydratorFile(filePath);
             const result = await build({

package/esm/src/server/shared/browser-module-bundler.js

@@ -4,7 +4,7 @@ import { getDirectory, getEsbuildLoader } from "../../utils/path-utils.js";
 import { createBareExternalPlugin, createHttpExternalPlugin, createRelativeFsPlugin, } from "../handlers/dev/files/esbuild-plugins.js";
 export function bundleBrowserModule(absPath, options) {
     return withSpan("server.browser-module.bundle", async () => {
-        const { build } = await import("esbuild");
+        const { build } = await import("../../extensions/bundler.js");
         const src = await options.adapter.fs.readFile(absPath);
         const importMapJson = await buildImportMapJson({
             projectDir: options.projectDir,

package/esm/src/testing/bdd.d.ts

@@ -8,6 +8,7 @@
  * @module
  */
 import "../../_dnt.polyfills.js";
+import "./init.js";
 /** Test function that can be sync or async */
 type TestFn = () => void | Promise<void>;
 /** Test options for Deno sanitizers (ignored in Node/Bun) */

package/esm/src/testing/bdd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bdd.d.ts","sourceRoot":"","sources":["../../../src/src/testing/bdd.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,yBAAyB,CAAC;AAQjC,8CAA8C;AAC9C,KAAK,MAAM,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzC,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED,oBAAoB;AACpB,KAAK,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAya7D,wBAAgB,QAAQ,CACtB,aAAa,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACxD,WAAW,CAAC,EAAE,WAAW,GAAG,CAAC,MAAM,IAAI,CAAC,EACxC,EAAE,CAAC,EAAE,MAAM,IAAI,GACd,IAAI,CAgBN;yBApBe,QAAQ;8BAuBP,MAAM,GAAG,CAAC,WAAW,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,gBAC1C,WAAW,GAAG,CAAC,MAAM,IAAI,CAAC,OACnC,MAAM,IAAI,KACd,IAAI;gCAHU,MAAM,GAAG,CAAC,WAAW,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,gBAC1C,WAAW,GAAG,CAAC,MAAM,IAAI,CAAC,OACnC,MAAM,IAAI,KACd,IAAI;8BAcU,MAAM,GAAG,CAAC,WAAW,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,gBAC1C,WAAW,GAAG,CAAC,MAAM,IAAI,CAAC,OACnC,MAAM,IAAI,KACd,IAAI;;AAWP,wBAAgB,EAAE,CAChB,aAAa,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACxD,WAAW,CAAC,EAAE,WAAW,GAAG,MAAM,EAClC,EAAE,CAAC,EAAE,MAAM,GACV,IAAI,CAiBN;yBArBe,EAAE;8BAwBD,MAAM,GAAG,CAAC,WAAW,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,gBAC1C,WAAW,GAAG,MAAM,OAC7B,MAAM,KACV,IAAI;gCAHU,MAAM,GAAG,CAAC,WAAW,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,gBAC1C,WAAW,GAAG,MAAM,OAC7B,MAAM,KACV,IAAI;8BAeU,MAAM,GAAG,CAAC,WAAW,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,gBAC1C,WAAW,GAAG,MAAM,OAC7B,MAAM,KACV,IAAI;;AAYP,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAM3C;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAM1C;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAM1C;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAMzC;AAED,eAAO,MAAM,IAAI,WAAK,CAAC;AAEvB,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAG7C"}
+{"version":3,"file":"bdd.d.ts","sourceRoot":"","sources":["../../../src/src/testing/bdd.ts"],"names":[],"mappings":"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"}

package/esm/src/testing/bdd.js

@@ -9,6 +9,7 @@
  */
 import "../../_dnt.polyfills.js";
 import * as dntShim from "../../_dnt.shims.js";
+import "./init.js";
 import { isBun, isDeno } from "../platform/compat/runtime.js";
 import { getEnvOverlayStorage } from "../platform/compat/process.js";
 function getActiveEnvOverlay() {

package/esm/src/testing/init.js

@@ -10,9 +10,16 @@
  * @module
  */
 import * as dntShim from "../../_dnt.shims.js";
+import { EsbuildBundler, EsModuleLexer } from "../../extensions/ext-esbuild/src/index.js";
+import { register as registerContract } from "../extensions/contracts.js";
 const g = dntShim.dntGlobalThis;
 g.__vfDisableLruInterval = true;
 g.__vfTestEnv = true;
 g.__vfTestEnvMask = {
     prefixes: ["VERYFRONT_", "OTEL_", "OAUTH_", "GITHUB_", "OPENAI_", "ANTHROPIC_", "GOOGLE_"],
 };
+// Tests don't run the extension orchestrator; prime the Bundler + ModuleLexer
+// contracts here so transforms that depend on them (lexer.ts, parse-cache.ts,
+// the platform/compat/esbuild shim, and bundler call-sites) work in tests.
+registerContract("Bundler", new EsbuildBundler());
+registerContract("ModuleLexer", new EsModuleLexer());

package/esm/src/transforms/esm/http-bundler.d.ts

@@ -1,4 +1,4 @@
-import type { Plugin } from "esbuild";
+import type { Plugin } from "../../extensions/bundler.js";
 import { getReactUrls } from "./package-registry.js";
 /** Check if code has HTTP imports */
 export declare function hasHttpImports(code: string): boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"http-bundler.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/http-bundler.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,OAAO,EAAyB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AA0B5E,qCAAqC;AACrC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,yDAAyD;AACzD,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CA6GzC;AA4DD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyD1B"}
+{"version":3,"file":"http-bundler.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/http-bundler.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAE1D,OAAO,EAAyB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AA0B5E,qCAAqC;AACrC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,yDAAyD;AACzD,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CA6GzC;AA4DD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyD1B"}

package/esm/src/transforms/esm/lexer.d.ts

@@ -1,13 +1,6 @@
+import type { ImportSpecifier } from "../../extensions/interfaces/module-lexer.js";
+export type { ImportSpecifier };
 export declare function initLexer(): Promise<void>;
-export type ImportSpecifier = {
-    n: string | undefined;
-    s: number;
-    e: number;
-    ss: number;
-    se: number;
-    d: number;
-    a: number;
-};
 export declare function parseImports(code: string): Promise<readonly ImportSpecifier[]>;
 /**
  * Replace import specifiers (the path string) in the code.

package/esm/src/transforms/esm/lexer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lexer.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/lexer.ts"],"names":[],"mappings":"AAuCA,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAc/C;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,CAAC;AAyBF,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAqBpF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7E,OAAO,CAAC,MAAM,CAAC,CAoCjB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GACnE,OAAO,CAAC,MAAM,CAAC,CAsBjB"}
+{"version":3,"file":"lexer.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/lexer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,6CAA6C,CAAC;AAEhG,YAAY,EAAE,eAAe,EAAE,CAAC;AA0ChC,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAS/C;AAyBD,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAqBpF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7E,OAAO,CAAC,MAAM,CAAC,CAoCjB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GACnE,OAAO,CAAC,MAAM,CAAC,CAsBjB"}

package/esm/src/transforms/esm/lexer.js

@@ -1,5 +1,5 @@
 import { logger as baseLogger } from "../../utils/index.js";
-import { init, parse } from "es-module-lexer";
+import { resolve as resolveContract } from "../../extensions/contracts.js";
 const logger = baseLogger.component("es-module-lexer");
 let initPromise = null;
 // Matches HTTP/HTTPS URLs in string literals (single, double, or backtick quotes)
@@ -22,17 +22,16 @@ function unmaskHttpUrls(code, urlMap) {
     }
     return result;
 }
+function getLexer() {
+    return resolveContract("ModuleLexer");
+}
 export async function initLexer() {
     if (initPromise) {
         await initPromise;
         return;
     }
-    // es-module-lexer@1.5 exports init as a Promise (not a function) in ESM build
-    // but some typings expect a function. Handle both to avoid type errors.
-    const anyInit = init;
-    initPromise = typeof anyInit === "function"
-        ? anyInit()
-        : anyInit;
+    const lexer = getLexer();
+    initPromise = lexer.init ? lexer.init() : Promise.resolve();
     await initPromise;
 }
 function logParseError(error, code) {
@@ -60,7 +59,7 @@ export async function parseImports(code) {
     const { masked, urlMap } = maskHttpUrls(code);
     let imports;
     try {
-        [imports] = parse(masked);
+        imports = getLexer().parse(masked);
     }
     catch (error) {
         logParseError(error, masked);
@@ -82,7 +81,7 @@ export async function parseImports(code) {
 export async function replaceSpecifiers(code, replacer) {
     await initLexer();
     const { masked, urlMap } = maskHttpUrls(code);
-    const [imports] = parse(masked);
+    const imports = getLexer().parse(masked);
     let result = masked;
     for (let i = imports.length - 1; i >= 0; i--) {
         const imp = imports[i];
@@ -116,7 +115,7 @@ export async function replaceSpecifiers(code, replacer) {
 export async function rewriteImports(code, rewriter) {
     await initLexer();
     const { masked, urlMap } = maskHttpUrls(code);
-    const [imports] = parse(masked);
+    const imports = getLexer().parse(masked);
     let result = masked;
     for (let i = imports.length - 1; i >= 0; i--) {
         const imp = imports[i];

package/esm/src/transforms/esm/transform-utils.d.ts

@@ -1,4 +1,4 @@
-import type { Loader } from "esbuild";
+import type { Loader } from "../../extensions/bundler.js";
 /**
  * Compute a short 8-character content hash for cache keys.
  * Use this for transform cache keys where a compact hash is preferred.

package/esm/src/transforms/esm/transform-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform-utils.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/transform-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGtC;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAExE;AAaD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD"}
+{"version":3,"file":"transform-utils.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/transform-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAG1D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAExE;AAaD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/esm/src/transforms/import-rewriter/parse-cache.d.ts

@@ -6,7 +6,7 @@
  */
 import type { ImportSpecifierInfo } from "./types.js";
 /**
- * Initialize es-module-lexer (must be called before parsing).
+ * Initialize the ModuleLexer (must be called before parsing).
  */
 export declare function initLexer(): Promise<void>;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"parse-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/import-rewriter/parse-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAKtD;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAS/C;AAsCD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,6CAA6C;IAC7C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAmB1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACvE,MAAM,CAiDR;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7E,OAAO,CAAC,MAAM,CAAC,CAoBjB"}
+{"version":3,"file":"parse-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/import-rewriter/parse-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAStD;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAO/C;AAsCD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,6CAA6C;IAC7C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAmB1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACvE,MAAM,CAiDR;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7E,OAAO,CAAC,MAAM,CAAC,CAoBjB"}

package/esm/src/transforms/import-rewriter/parse-cache.js

@@ -4,17 +4,18 @@
  * Single parse per file - reused across all strategies.
  * This eliminates redundant parsing that happened with the fragmented system.
  */
-import { init, parse } from "es-module-lexer";
+import { resolve as resolveContract } from "../../extensions/contracts.js";
 let initPromise = null;
+function getLexer() {
+    return resolveContract("ModuleLexer");
+}
 /**
- * Initialize es-module-lexer (must be called before parsing).
+ * Initialize the ModuleLexer (must be called before parsing).
  */
 export async function initLexer() {
     if (!initPromise) {
-        const anyInit = init;
-        initPromise = typeof anyInit === "function"
-            ? anyInit()
-            : anyInit;
+        const lexer = getLexer();
+        initPromise = lexer.init ? lexer.init() : Promise.resolve();
     }
     await initPromise;
 }
@@ -47,7 +48,7 @@ function unmaskUrl(specifier, urlMap) {
 export async function parseAllImports(code) {
     await initLexer();
     const { masked, urlMap } = maskHttpUrls(code);
-    const [rawImports] = parse(masked);
+    const rawImports = getLexer().parse(masked);
     const imports = rawImports
         .filter((imp) => imp.n !== undefined)
         .map((imp) => ({

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

@@ -70,7 +70,7 @@ export function transformImports(code, importMap) {
  * Optimized to process all imports in parallel batches for better performance.
  */
 export async function transformJsxImports(code, adapter, esmCacheDir) {
-    const { transform } = await import("esbuild");
+    const { transform } = await import("../../../extensions/bundler.js");
     const importsToProcess = [];
     let jsxMatch;
     while ((jsxMatch = JSX_IMPORT_PATTERN.exec(code)) !== null) {

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

@@ -77,7 +77,7 @@ export async function transformFrameworkCode(content, sourcePath, ctx, throwOnMi
             depth,
         });
         // Return minimally transformed code - it will fail at runtime but won't hang
-        const { transform } = await import("esbuild");
+        const { transform } = await import("../../../../extensions/bundler.js");
         const ext = sourcePath.match(/\.(tsx?|jsx?)$/)?.[1] ?? "tsx";
         let loader = "js";
         if (ext === "tsx")
@@ -121,7 +121,7 @@ export async function transformFrameworkCode(content, sourcePath, ctx, throwOnMi
     // Mark as being transformed
     transformingFiles.add(sourcePath);
     try {
-        const { transform } = await import("esbuild");
+        const { transform } = await import("../../../../extensions/bundler.js");
         const ext = sourcePath.match(/\.(tsx?|jsx?)$/)?.[1] ?? "tsx";
         let loader = "js";
         if (ext === "tsx")

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

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.367";
+export declare const VERSION = "0.1.369";
 //# 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.367";
+export const VERSION = "0.1.369";

package/package.json

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

package/src/cli/commands/init/config-generator.ts

@@ -70,6 +70,7 @@ export async function createPackageJson(
       react: `^${DEFAULT_INIT_REACT_VERSION}`,
       "react-dom": `^${DEFAULT_INIT_REACT_VERSION}`,
       veryfront: `^${VERSION}`,
+      "@veryfront/ext-esbuild": `^${VERSION}`,
       zod: "^3.24.0",
     },
   };

package/src/cli/main.ts

@@ -17,6 +17,20 @@ import * as dntShim from "../_dnt.shims.js";
 
 await import("../src/platform/compat/esbuild-init.js");
 
+// Register the default Bundler + ModuleLexer contracts shipped with the
+// binary so bootstrap paths can resolve them without the user having to
+// declare @veryfront/ext-esbuild as a project extension. User-installed
+// extensions (orchestrated later) can still override these.
+{
+  const { register } = await import("../src/extensions/contracts.js");
+  const { tryResolve } = await import("../src/extensions/index.js");
+  if (!tryResolve("Bundler") || !tryResolve("ModuleLexer")) {
+    const { EsbuildBundler, EsModuleLexer } = await import("../extensions/ext-esbuild/src/index.js");
+    if (!tryResolve("Bundler")) register("Bundler", new EsbuildBundler());
+    if (!tryResolve("ModuleLexer")) register("ModuleLexer", new EsModuleLexer());
+  }
+}
+
 // All imports below must be dynamic to ensure esbuild init completes first
 const { getArgs } = await import("../src/platform/index.js");
 const { hasEnvLoaded, loadEnv, markEnvLoaded, supportsEnvFiles } = await import(

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.367",
+  "version": "0.1.369",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [
@@ -10,6 +10,7 @@ export default {
     "./extensions/ext-node-compat",
     "./extensions/ext-openai",
     "./extensions/ext-opentelemetry",
+    "./extensions/ext-esbuild",
     "./extensions/ext-redis",
     "./extensions/ext-tailwind"
   ],
@@ -143,6 +144,9 @@ export default {
     "veryfront/testing": "./src/testing/index.ts",
     "veryfront/testing/assert": "./src/testing/assert.ts",
     "veryfront/testing/bdd": "./src/testing/bdd.ts",
+    "veryfront/extensions/bundler": "./src/extensions/bundler.ts",
+    "veryfront/extensions/contracts": "./src/extensions/contracts.ts",
+    "veryfront/extensions/interfaces": "./src/extensions/interfaces/index.ts",
     "#veryfront": "./src/index.ts",
     "#veryfront/agent": "./src/agent/index.ts",
     "#veryfront/agent/react": "./src/agent/react/index.ts",
@@ -275,9 +279,6 @@ export default {
     "rehype-raw": "npm:rehype-raw@7.0.0",
     "rehype-sanitize": "npm:rehype-sanitize@6.0.0",
     "rehype-stringify": "npm:rehype-stringify@10.0.1",
-    "esbuild": "npm:esbuild@0.27.4",
-    "esbuild/mod.js": "npm:esbuild@0.27.4",
-    "es-module-lexer": "npm:es-module-lexer@2.0.0",
     "gray-matter": "npm:gray-matter@4.0.3",
     "zod": "npm:zod@4.3.6",
     "mdast": "npm:@types/mdast@4.0.3",
@@ -440,7 +441,6 @@ export default {
       "npm:onnxruntime-node@1.21.0"
     ],
     "deny": [
-      "npm:esbuild@0.27.4",
       "npm:protobufjs@7.5.4"
     ]
   }

package/src/extensions/ext-esbuild/src/binary.ts

@@ -0,0 +1,154 @@
+/**
+ * Binary extraction for `deno compile` VFS.
+ *
+ * Ported from src/platform/compat/esbuild.ts + esbuild-shared.ts. When the
+ * framework runs as a compiled Deno binary, the esbuild native binary lives
+ * inside the VFS and must be copied to a writable path before esbuild's
+ * child-process spawn can find it.
+ *
+ * On normal Deno (not `deno compile`) or when ESBUILD_BINARY_PATH is already
+ * set, `ensureEsbuildBinary()` is a no-op.
+ *
+ * @module extensions/ext-esbuild/binary
+ */
+import * as dntShim from "../../../_dnt.shims.js";
+
+
+import { isDenoCompiled } from "./runtime.js";
+
+const ESBUILD_VERSION = "0.27.4";
+
+function getTempDir(): string {
+  try {
+    return (
+      dntShim.Deno.env.get("TMPDIR") ?? dntShim.Deno.env.get("TEMP") ?? dntShim.Deno.env.get("TMP") ?? "/tmp"
+    );
+  } catch {
+    return "/tmp";
+  }
+}
+
+function getEsbuildBinaryName(): string {
+  const archMap: Record<string, string> = { x86_64: "x64", aarch64: "arm64" };
+  const arch = archMap[dntShim.Deno.build.arch] ?? dntShim.Deno.build.arch;
+  return `@esbuild/${dntShim.Deno.build.os}-${arch}`;
+}
+
+function getVFSBasePath(filePath: string, tempDir: string): string {
+  const denoCompileMatch = filePath.match(/^(.*\/deno-compile-[^/]+)\//);
+  if (denoCompileMatch?.[1]) return denoCompileMatch[1];
+  const parts = filePath.split("/");
+  const srcIndex = parts.lastIndexOf("src");
+  if (srcIndex > 0) return parts.slice(0, srcIndex).join("/");
+  return `${tempDir}/deno-compile-veryfront`;
+}
+
+async function isFile(path: string): Promise<boolean> {
+  try {
+    const stat = await dntShim.Deno.stat(path);
+    return stat.isFile;
+  } catch {
+    return false;
+  }
+}
+
+async function findEsbuildInVFS(): Promise<string | null> {
+  const binaryName = getEsbuildBinaryName();
+  const vfsBase = getVFSBasePath(new URL(import.meta.url).pathname, getTempDir());
+
+  const possiblePaths = [
+    `${vfsBase}/node_modules/${binaryName}/bin/esbuild`,
+    `${vfsBase}/node_modules/.deno/${binaryName}@${ESBUILD_VERSION}/node_modules/${binaryName}/bin/esbuild`,
+    `${vfsBase}/node_modules/.deno/esbuild@${ESBUILD_VERSION}/node_modules/${binaryName}/bin/esbuild`,
+    `${vfsBase}/node_modules/esbuild/bin/esbuild`,
+    `${vfsBase}/node_modules/.package/esbuild@${ESBUILD_VERSION}/bin/esbuild`,
+    `${vfsBase}/node_modules/.package/${binaryName}@${ESBUILD_VERSION}/bin/esbuild`,
+  ];
+
+  for (const p of possiblePaths) {
+    if (await isFile(p)) return p;
+  }
+
+  try {
+    const nodeModulesPath = `${vfsBase}/node_modules`;
+    for await (const entry of dntShim.Deno.readDir(nodeModulesPath)) {
+      if (entry.name !== binaryName && !entry.name.startsWith("@esbuild")) continue;
+      const binPath = `${nodeModulesPath}/${entry.name}/bin/esbuild`;
+      if (await isFile(binPath)) return binPath;
+    }
+  } catch {
+    /* node_modules not readable in VFS */
+  }
+
+  return null;
+}
+
+async function extractEsbuildBinary(): Promise<string> {
+  const cacheDir = `${getTempDir()}/veryfront-esbuild`;
+  const targetPath = `${cacheDir}/esbuild-${ESBUILD_VERSION}`;
+
+  try {
+    const stat = await dntShim.Deno.stat(targetPath);
+    if (stat.isFile && stat.mode && (stat.mode & 0o111)) return targetPath;
+  } catch {
+    /* cache miss */
+  }
+
+  const vfsPath = await findEsbuildInVFS();
+  if (!vfsPath) {
+    throw new Error(
+      `[ext-esbuild] Could not find esbuild binary in deno compile VFS. ` +
+        `Platform: ${getEsbuildBinaryName()}. ` +
+        `Ensure esbuild is in dependencies and deno compile includes node_modules.`,
+    );
+  }
+
+  await dntShim.Deno.mkdir(cacheDir, { recursive: true });
+  const binary = await dntShim.Deno.readFile(vfsPath);
+  await dntShim.Deno.writeFile(targetPath, binary, { mode: 0o755 });
+
+  return targetPath;
+}
+
+let setupComplete = false;
+let setupPromise: Promise<void> | null = null;
+
+/**
+ * Idempotent one-shot setup — copies the esbuild binary out of the VFS (if
+ * running in `deno compile`) and sets ESBUILD_BINARY_PATH. No-op on normal
+ * Deno or when the env var is already set.
+ */
+export async function ensureEsbuildBinary(): Promise<void> {
+  if (setupComplete) return;
+  if (setupPromise) {
+    await setupPromise;
+    return;
+  }
+
+  setupPromise = (async () => {
+    try {
+      if (dntShim.Deno.env.get("ESBUILD_BINARY_PATH") || !isDenoCompiled) {
+        setupComplete = true;
+        return;
+      }
+
+      try {
+        const binaryPath = await extractEsbuildBinary();
+        dntShim.Deno.env.set("ESBUILD_BINARY_PATH", binaryPath);
+        // esbuild reads process.env (not Deno.env) on some code paths.
+        const proc = (dntShim.dntGlobalThis as { process?: { env: Record<string, string> } }).process;
+        if (proc?.env) proc.env.ESBUILD_BINARY_PATH = binaryPath;
+      } catch (err) {
+        console.error("[ext-esbuild] Binary extraction failed:", err);
+      }
+    } finally {
+      setupComplete = true;
+    }
+  })();
+
+  try {
+    await setupPromise;
+  } finally {
+    setupPromise = null;
+  }
+}