veryfront 0.1.368 → 0.1.370

package/esm/cli/commands/build/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/build/command.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA+EjE"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/build/command.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFjE"}

package/esm/cli/commands/build/command.js

@@ -7,6 +7,7 @@ import { displayBuildConfig, displayBuildStart } from "./config-display.js";
 import { handleBuildError } from "./error-handler.js";
 import { displayBuildSuccess } from "./stats-display.js";
 import { isJsonMode, streamJsonLine } from "../../shared/json-output.js";
+import { ensureBuiltinContentTransformer } from "../../shared/ensure-content-transformer.js";
 export function buildCommand(options) {
     return withSpan("cli.command.build", async () => {
         const outputDir = options.outputDir ?? join(options.projectDir, "dist");
@@ -21,6 +22,7 @@ export function buildCommand(options) {
             }
             const adapter = await runtime.get();
             await getConfig(options.projectDir, adapter);
+            ensureBuiltinContentTransformer();
             if (isJsonMode()) {
                 streamJsonLine({ type: "step", name: "config", status: "completed" });
                 streamJsonLine({ type: "step", name: "build", status: "started" });

package/esm/cli/commands/init/config-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-generator.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init/config-generator.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC1C,CAAC,CAAC;CACJ;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,IAAI,CAAC,CA0Df"}
+{"version":3,"file":"config-generator.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init/config-generator.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC1C,CAAC,CAAC;CACJ;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,IAAI,CAAC,CA2Df"}

package/esm/cli/commands/init/config-generator.js

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

package/esm/cli/main.js

@@ -13,6 +13,21 @@
 import "../_dnt.polyfills.js";
 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("../src/utils/env-loader.js");

package/esm/cli/shared/ensure-content-transformer.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The CLI ships ext-mdx baked in so the compiled binary can render MDX/Markdown
+ * pages out of the box. Library consumers (programmatic `startProductionServer`)
+ * still opt in via `veryfront.config.ts` extensions. Bootstrap's
+ * `setupAll → teardownAll → reset()` clears the contract registry, so this
+ * must run *after* the server-start (or `getConfig`) call returns. We skip
+ * registration when a user-provided extension already supplied the contract.
+ */
+export declare function ensureBuiltinContentTransformer(): void;
+//# sourceMappingURL=ensure-content-transformer.d.ts.map

package/esm/cli/shared/ensure-content-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-content-transformer.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/ensure-content-transformer.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAGtD"}

package/esm/cli/shared/ensure-content-transformer.js

@@ -0,0 +1,16 @@
+import { tryResolve } from "../../src/extensions/index.js";
+import { register } from "../../src/extensions/contracts.js";
+import { MdxContentTransformer } from "../../extensions/ext-mdx/src/index.js";
+/**
+ * The CLI ships ext-mdx baked in so the compiled binary can render MDX/Markdown
+ * pages out of the box. Library consumers (programmatic `startProductionServer`)
+ * still opt in via `veryfront.config.ts` extensions. Bootstrap's
+ * `setupAll → teardownAll → reset()` clears the contract registry, so this
+ * must run *after* the server-start (or `getConfig`) call returns. We skip
+ * registration when a user-provided extension already supplied the contract.
+ */
+export function ensureBuiltinContentTransformer() {
+    if (tryResolve("ContentTransformer"))
+        return;
+    register("ContentTransformer", new MdxContentTransformer());
+}

package/esm/cli/shared/server-startup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-startup.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/server-startup.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,cAAc,EACd,qBAAqB,EAEtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAcD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAoB5D;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CASrD;AAED,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAqB5D"}
+{"version":3,"file":"server-startup.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/server-startup.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,cAAc,EACd,qBAAqB,EAEtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAGlE,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAcD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAsB5D;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAWrD;AAED,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAuB5D"}

package/esm/cli/shared/server-startup.js

@@ -1,5 +1,6 @@
 import { getEnv, runtime, setEnv } from "../../src/platform/index.js";
 import { startDevServer, startProductionServer, } from "../../src/server/index.js";
+import { ensureBuiltinContentTransformer } from "./ensure-content-transformer.js";
 function buildDiscoveryConfig(options) {
     const token = getEnv("VERYFRONT_API_TOKEN") ?? "";
     const slug = getEnv("VERYFRONT_PROJECT_SLUG") ?? options.fallbackProjectSlug ?? "";
@@ -19,7 +20,7 @@ export async function startCliProxyModeServer(options) {
     if (!getEnv("NODE_ENV") && !getEnv("DENO_ENV")) {
         setEnv("NODE_ENV", "development");
     }
-    return await startProductionServer({
+    const result = await startProductionServer({
         port: options.port,
         projectDir: options.projectDir,
         signal: options.signal,
@@ -28,6 +29,8 @@ export async function startCliProxyModeServer(options) {
         defaultProjectId: options.defaultProjectId,
         discoveryConfig: buildDiscoveryConfig(options),
     });
+    ensureBuiltinContentTransformer();
+    return result;
 }
 export async function startCliDevServer(options) {
     const devOptions = {
@@ -37,7 +40,9 @@ export async function startCliDevServer(options) {
         enableFastRefresh: options.enableFastRefresh,
         signal: options.signal,
     };
-    return await startDevServer(devOptions);
+    const result = await startDevServer(devOptions);
+    ensureBuiltinContentTransformer();
+    return result;
 }
 export async function startCliProductionServer(options) {
     const adapter = options.adapter ?? (await runtime.get());
@@ -59,5 +64,7 @@ export async function startCliProductionServer(options) {
         // through `/_veryfront/rsc/module?` for non-local deployments, so no
         // `localProjects` entry is required for the compiled binary to work.
     };
-    return await startProductionServer(serverOptions);
+    const result = await startProductionServer(serverOptions);
+    ensureBuiltinContentTransformer();
+    return result;
 }

package/esm/deno.d.ts

@@ -123,6 +123,9 @@ declare namespace _default {
         "veryfront/testing": string;
         "veryfront/testing/assert": string;
         "veryfront/testing/bdd": string;
+        "veryfront/extensions/bundler": string;
+        "veryfront/extensions/contracts": string;
+        "veryfront/extensions/interfaces": string;
         "#veryfront": string;
         "#veryfront/agent": string;
         "#veryfront/agent/react": string;
@@ -255,9 +258,6 @@ declare namespace _default {
         "rehype-raw": string;
         "rehype-sanitize": string;
         "rehype-stringify": string;
-        esbuild: string;
-        "esbuild/mod.js": string;
-        "es-module-lexer": string;
         "gray-matter": string;
         zod: string;
         mdast: string;

package/esm/deno.js

@@ -1,15 +1,17 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.368",
+    "version": "0.1.370",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "workspace": [
         "./extensions/ext-anthropic",
         "./extensions/ext-babel",
         "./extensions/ext-jwt",
+        "./extensions/ext-mdx",
         "./extensions/ext-node-compat",
         "./extensions/ext-openai",
         "./extensions/ext-opentelemetry",
+        "./extensions/ext-esbuild",
         "./extensions/ext-redis",
         "./extensions/ext-tailwind"
     ],
@@ -143,6 +145,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 +280,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 +442,6 @@ export default {
             "npm:onnxruntime-node@1.21.0"
         ],
         "deny": [
-            "npm:esbuild@0.27.4",
             "npm:protobufjs@7.5.4"
         ]
     }

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

@@ -0,0 +1,7 @@
+/**
+ * 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 declare function ensureEsbuildBinary(): Promise<void>;
+//# sourceMappingURL=binary.d.ts.map

package/esm/extensions/ext-esbuild/src/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../../../src/extensions/ext-esbuild/src/binary.ts"],"names":[],"mappings":"AAmHA;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiCzD"}

package/esm/extensions/ext-esbuild/src/binary.js

@@ -0,0 +1,143 @@
+/**
+ * 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() {
+    try {
+        return (dntShim.Deno.env.get("TMPDIR") ?? dntShim.Deno.env.get("TEMP") ?? dntShim.Deno.env.get("TMP") ?? "/tmp");
+    }
+    catch {
+        return "/tmp";
+    }
+}
+function getEsbuildBinaryName() {
+    const archMap = { 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, tempDir) {
+    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) {
+    try {
+        const stat = await dntShim.Deno.stat(path);
+        return stat.isFile;
+    }
+    catch {
+        return false;
+    }
+}
+async function findEsbuildInVFS() {
+    const binaryName = getEsbuildBinaryName();
+    const vfsBase = getVFSBasePath(new URL(globalThis[Symbol.for("import-meta-ponyfill-esmodule")](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() {
+    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 = 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() {
+    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.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;
+    }
+}

package/esm/extensions/ext-esbuild/src/es-module-lexer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * es-module-lexer-backed implementation of the {@link ModuleLexer} contract.
+ *
+ * es-module-lexer@2 exports `init` as a Promise in its ESM build but older
+ * typings expect a function. We tolerate both shapes (as the in-tree
+ * src/transforms/esm/lexer.ts did).
+ *
+ * @module extensions/ext-esbuild/es-module-lexer
+ */
+import type { ImportSpecifier, ModuleLexer } from "../../../src/extensions/interfaces/index.js";
+/** es-module-lexer-backed {@link ModuleLexer} implementation. */
+export declare class EsModuleLexer implements ModuleLexer {
+    private initPromise;
+    init(): Promise<void>;
+    parse(code: string): readonly ImportSpecifier[];
+}
+//# sourceMappingURL=es-module-lexer.d.ts.map

package/esm/extensions/ext-esbuild/src/es-module-lexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"es-module-lexer.d.ts","sourceRoot":"","sources":["../../../../src/extensions/ext-esbuild/src/es-module-lexer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAGhG,iEAAiE;AACjE,qBAAa,aAAc,YAAW,WAAW;IAC/C,OAAO,CAAC,WAAW,CAA8B;IAE3C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,eAAe,EAAE;CAIhD"}

package/esm/extensions/ext-esbuild/src/es-module-lexer.js

@@ -0,0 +1,29 @@
+/**
+ * es-module-lexer-backed implementation of the {@link ModuleLexer} contract.
+ *
+ * es-module-lexer@2 exports `init` as a Promise in its ESM build but older
+ * typings expect a function. We tolerate both shapes (as the in-tree
+ * src/transforms/esm/lexer.ts did).
+ *
+ * @module extensions/ext-esbuild/es-module-lexer
+ */
+import { init, parse } from "es-module-lexer";
+/** es-module-lexer-backed {@link ModuleLexer} implementation. */
+export class EsModuleLexer {
+    initPromise = null;
+    async init() {
+        if (this.initPromise) {
+            await this.initPromise;
+            return;
+        }
+        const anyInit = init;
+        this.initPromise = typeof anyInit === "function"
+            ? anyInit()
+            : anyInit;
+        await this.initPromise;
+    }
+    parse(code) {
+        const [imports] = parse(code);
+        return imports;
+    }
+}

package/esm/extensions/ext-esbuild/src/esbuild-bundler.d.ts

@@ -0,0 +1,20 @@
+/**
+ * esbuild-backed implementation of the {@link Bundler} contract.
+ *
+ * Lazy-initializes the esbuild binary (including `deno compile` VFS
+ * extraction) on first use. All options pass through to esbuild unchanged
+ * because the {@link BundleOptions} shape was designed to be esbuild-compatible;
+ * the only translation is converting {@link BundlerPlugin}s into esbuild
+ * plugins via {@link toEsbuildPlugin}.
+ *
+ * @module extensions/ext-esbuild/esbuild-bundler
+ */
+import type { BuildContext, BundleOptions, Bundler, BundleResult, TransformOptions, TransformResult } from "../../../src/extensions/interfaces/index.js";
+/** esbuild-backed {@link Bundler} implementation. */
+export declare class EsbuildBundler implements Bundler {
+    bundle(options: BundleOptions): Promise<BundleResult>;
+    transform(options: TransformOptions): Promise<TransformResult>;
+    context(options: BundleOptions): Promise<BuildContext>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=esbuild-bundler.d.ts.map

package/esm/extensions/ext-esbuild/src/esbuild-bundler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild-bundler.d.ts","sourceRoot":"","sources":["../../../../src/extensions/ext-esbuild/src/esbuild-bundler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EAEb,OAAO,EACP,YAAY,EAGZ,gBAAgB,EAChB,eAAe,EAChB,MAAM,6CAA6C,CAAC;AAoDrD,qDAAqD;AACrD,qBAAa,cAAe,YAAW,OAAO;IACtC,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAWrD,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAW9D,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAiBtD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAM5B"}

package/esm/extensions/ext-esbuild/src/esbuild-bundler.js

@@ -0,0 +1,98 @@
+/**
+ * esbuild-backed implementation of the {@link Bundler} contract.
+ *
+ * Lazy-initializes the esbuild binary (including `deno compile` VFS
+ * extraction) on first use. All options pass through to esbuild unchanged
+ * because the {@link BundleOptions} shape was designed to be esbuild-compatible;
+ * the only translation is converting {@link BundlerPlugin}s into esbuild
+ * plugins via {@link toEsbuildPlugin}.
+ *
+ * @module extensions/ext-esbuild/esbuild-bundler
+ */
+import { ensureEsbuildBinary } from "./binary.js";
+import { toEsbuildPlugin } from "./plugin-adapter.js";
+let esbuildModule = null;
+async function getEsbuild() {
+    await ensureEsbuildBinary();
+    if (esbuildModule)
+        return esbuildModule;
+    esbuildModule = await import("esbuild");
+    return esbuildModule;
+}
+// deno-lint-ignore no-explicit-any
+function toMessage(m) {
+    return {
+        text: m.text,
+        location: m.location ?? null,
+        notes: m.notes,
+        pluginName: m.pluginName,
+        detail: m.detail,
+    };
+}
+// deno-lint-ignore no-explicit-any
+function toMessages(ms) {
+    return (ms ?? []).map(toMessage);
+}
+// deno-lint-ignore no-explicit-any
+function toOutput(f) {
+    return {
+        path: f.path,
+        contents: f.contents,
+        text: f.text,
+        hash: f.hash,
+    };
+}
+function mapOptions(options) {
+    const { plugins, ...rest } = options;
+    const mapped = { ...rest };
+    if (plugins && plugins.length > 0) {
+        mapped.plugins = plugins.map(toEsbuildPlugin);
+    }
+    return mapped;
+}
+/** esbuild-backed {@link Bundler} implementation. */
+export class EsbuildBundler {
+    async bundle(options) {
+        const esbuild = await getEsbuild();
+        const result = await esbuild.build(mapOptions(options));
+        return {
+            outputFiles: (result.outputFiles ?? []).map(toOutput),
+            warnings: toMessages(result.warnings),
+            errors: toMessages(result.errors),
+            metafile: result.metafile,
+        };
+    }
+    async transform(options) {
+        const esbuild = await getEsbuild();
+        const { code, ...rest } = options;
+        const result = await esbuild.transform(code, rest);
+        return {
+            code: result.code,
+            map: result.map,
+            warnings: toMessages(result.warnings).map((m) => m.text),
+        };
+    }
+    async context(options) {
+        const esbuild = await getEsbuild();
+        const ctx = await esbuild.context(mapOptions(options));
+        return {
+            rebuild: async () => {
+                const result = await ctx.rebuild();
+                return {
+                    outputFiles: (result.outputFiles ?? []).map(toOutput),
+                    warnings: toMessages(result.warnings),
+                    errors: toMessages(result.errors),
+                    metafile: result.metafile,
+                };
+            },
+            dispose: () => ctx.dispose(),
+        };
+    }
+    async stop() {
+        const m = esbuildModule;
+        if (!m)
+            return;
+        esbuildModule = null;
+        await m.stop();
+    }
+}

package/esm/extensions/ext-esbuild/src/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ext-esbuild — Bundler + ModuleLexer contract implementations backed by
+ * esbuild and es-module-lexer.
+ *
+ * @module extensions/ext-esbuild
+ */
+import type { ExtensionFactory } from "../../../src/extensions/index.js";
+import { EsbuildBundler } from "./esbuild-bundler.js";
+import { EsModuleLexer } from "./es-module-lexer.js";
+/**
+ * Default export — the ext-esbuild extension factory.
+ *
+ * Registers both the `Bundler` (esbuild-backed) and `ModuleLexer`
+ * (es-module-lexer-backed) contracts.
+ */
+declare const extEsbuild: ExtensionFactory;
+export default extEsbuild;
+export { EsbuildBundler, EsModuleLexer };
+//# sourceMappingURL=index.d.ts.map

package/esm/extensions/ext-esbuild/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/extensions/ext-esbuild/src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;GAKG;AACH,QAAA,MAAM,UAAU,EAAE,gBAwBjB,CAAC;AAEF,eAAe,UAAU,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC"}

package/esm/extensions/ext-esbuild/src/index.js

@@ -0,0 +1,40 @@
+/**
+ * ext-esbuild — Bundler + ModuleLexer contract implementations backed by
+ * esbuild and es-module-lexer.
+ *
+ * @module extensions/ext-esbuild
+ */
+import { EsbuildBundler } from "./esbuild-bundler.js";
+import { EsModuleLexer } from "./es-module-lexer.js";
+/**
+ * Default export — the ext-esbuild extension factory.
+ *
+ * Registers both the `Bundler` (esbuild-backed) and `ModuleLexer`
+ * (es-module-lexer-backed) contracts.
+ */
+const extEsbuild = () => {
+    const bundler = new EsbuildBundler();
+    const lexer = new EsModuleLexer();
+    return {
+        name: "ext-esbuild",
+        version: "0.1.0",
+        capabilities: [
+            { type: "contract", name: "Bundler" },
+            { type: "contract", name: "ModuleLexer" },
+        ],
+        setup(ctx) {
+            if (!ctx.get("Bundler")) {
+                ctx.provide("Bundler", bundler);
+            }
+            if (!ctx.get("ModuleLexer")) {
+                ctx.provide("ModuleLexer", lexer);
+            }
+            ctx.logger.info("[ext-esbuild] Bundler + ModuleLexer registered");
+        },
+        async teardown() {
+            await bundler.stop?.();
+        },
+    };
+};
+export default extEsbuild;
+export { EsbuildBundler, EsModuleLexer };

package/esm/extensions/ext-esbuild/src/plugin-adapter.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Plugin adapter — converts {@link BundlerPlugin} (the bundler-agnostic
+ * contract shape) into an esbuild `Plugin`. The contract's onResolve /
+ * onLoad shapes were deliberately designed to match esbuild's, so the
+ * translation is near-1:1; this module exists to isolate the esbuild
+ * import from the rest of the extension.
+ *
+ * @module extensions/ext-esbuild/plugin-adapter
+ */
+import type { BundlerPlugin } from "../../../src/extensions/interfaces/index.js";
+type EsbuildPlugin = any;
+export declare function toEsbuildPlugin(plugin: BundlerPlugin): EsbuildPlugin;
+export {};
+//# sourceMappingURL=plugin-adapter.d.ts.map

package/esm/extensions/ext-esbuild/src/plugin-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-adapter.d.ts","sourceRoot":"","sources":["../../../../src/extensions/ext-esbuild/src/plugin-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,aAAa,EAMd,MAAM,6CAA6C,CAAC;AAErD,KAAK,aAAa,GAAG,GAAG,CAAC;AAEzB,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CA4CpE"}