veryfront 0.1.367 → 0.1.369

package/esm/src/extensions/interfaces/bundler.d.ts

@@ -5,12 +5,69 @@
  *
  * @module extensions/interfaces/bundler
  */
+/** Location of an error or warning in source. */
+export interface BundlerMessageLocation {
+    file: string;
+    line: number;
+    column: number;
+    length?: number;
+    lineText?: string;
+}
+/** A diagnostic message (error or warning) from a bundler. */
+export interface BundlerMessage {
+    text: string;
+    location?: BundlerMessageLocation | null;
+    notes?: {
+        text: string;
+        location?: BundlerMessageLocation | null;
+    }[];
+    pluginName?: string;
+    detail?: unknown;
+}
+/** Input file entry in a {@link Metafile}. */
+export interface MetafileInput {
+    bytes: number;
+    imports: {
+        path: string;
+        kind?: string;
+        external?: boolean;
+        original?: string;
+    }[];
+    format?: "cjs" | "esm";
+}
+/** Output file entry in a {@link Metafile}. */
+export interface MetafileOutput {
+    bytes: number;
+    inputs: Record<string, {
+        bytesInOutput: number;
+    }>;
+    imports: {
+        path: string;
+        kind?: string;
+        external?: boolean;
+    }[];
+    exports: string[];
+    entryPoint?: string;
+    cssBundle?: string;
+}
+/** Dependency-graph metadata produced by a bundler when `metafile: true`. */
+export interface Metafile {
+    inputs: Record<string, MetafileInput>;
+    outputs: Record<string, MetafileOutput>;
+}
+/** In-memory source input for {@link BundleOptions.stdin}. */
+export interface StdinOptions {
+    contents: string;
+    resolveDir?: string;
+    sourcefile?: string;
+    loader?: Loader | string;
+}
 /** Options passed to {@link Bundler.bundle}. */
 export interface BundleOptions {
-    /** Entry point file paths. */
-    entryPoints: string[];
+    /** Entry point file paths, or a `{ outputName: inputPath }` map. */
+    entryPoints?: string[] | Record<string, string>;
     /** Output directory. */
-    outdir: string;
+    outdir?: string;
     /** Bundle format (`esm`, `cjs`, `iife`). */
     format?: "esm" | "cjs" | "iife";
     /** Target environment(s). */
@@ -18,11 +75,35 @@ export interface BundleOptions {
     /** Enable minification. */
     minify?: boolean;
     /** Enable source maps. */
-    sourcemap?: boolean | "inline" | "external";
+    sourcemap?: boolean | "inline" | "external" | "linked" | "both";
     /** Enable code splitting. */
     splitting?: boolean;
     /** Additional plugins. */
     plugins?: BundlerPlugin[];
+    /** Whether to bundle dependencies into the output (vs. leaving imports as-is). */
+    bundle?: boolean;
+    /** Write output to disk; when false, returns bytes in-memory only. */
+    write?: boolean;
+    /** Target platform influencing default externals and resolution. */
+    platform?: "browser" | "node" | "neutral";
+    /** Packages/paths to exclude from the bundle. */
+    external?: string[];
+    /** Bundle an in-memory source string instead of reading from disk. */
+    stdin?: StdinOptions;
+    /** Compile-time constant replacements, e.g. `{ "process.env.NODE_ENV": '"production"' }`. */
+    define?: Record<string, string>;
+    /** JSX transform mode. */
+    jsx?: "transform" | "preserve" | "automatic";
+    /** Module specifier used for the automatic JSX runtime import. */
+    jsxImportSource?: string;
+    /** File extensions to try during import resolution. */
+    resolveExtensions?: string[];
+    /** Drop unused exports and dead code. */
+    treeShaking?: boolean;
+    /** Verbosity of diagnostic output. */
+    logLevel?: "silent" | "error" | "warning" | "info" | "debug" | "verbose";
+    /** Emit a dependency-graph {@link Metafile} in the result. */
+    metafile?: boolean;
     /** Extra implementation-specific options. */
     [key: string]: unknown;
 }
@@ -32,22 +113,30 @@ export interface BundleOutput {
     path: string;
     /** Raw byte content. */
     contents: Uint8Array;
+    /** Lazy-decoded UTF-8 string view of `contents`. */
+    text: string;
+    /** Optional content hash. */
+    hash?: string;
 }
 /** Result returned from {@link Bundler.bundle}. */
 export interface BundleResult {
     /** Output files produced by the bundle. */
-    outputs: BundleOutput[];
+    outputFiles: BundleOutput[];
     /** Warnings emitted during bundling. */
-    warnings: string[];
+    warnings: BundlerMessage[];
     /** Errors encountered during bundling. */
-    errors: string[];
+    errors: BundlerMessage[];
+    /** Dependency-graph metadata, populated when `metafile: true`. */
+    metafile?: Metafile;
 }
+/** Loader hint for source files. Mirrors esbuild's `Loader` type. */
+export type Loader = "js" | "jsx" | "ts" | "tsx" | "css" | "json" | "text" | "base64" | "file" | "dataurl" | "binary" | "default" | "empty" | "copy";
 /** Options passed to {@link Bundler.transform}. */
 export interface TransformOptions {
     /** Source code to transform. */
     code: string;
     /** Loader hint (`ts`, `tsx`, `jsx`, `css`, etc.). */
-    loader?: string;
+    loader?: Loader;
     /** Output format. */
     format?: "esm" | "cjs" | "iife";
     /** Target environment(s). */
@@ -56,6 +145,14 @@ export interface TransformOptions {
     minify?: boolean;
     /** Enable source maps. */
     sourcemap?: boolean | "inline" | "external";
+    /** JSX transform mode. */
+    jsx?: "transform" | "preserve" | "automatic";
+    /** Module specifier used for the automatic JSX runtime import. */
+    jsxImportSource?: string;
+    /** Drop unused exports and dead code. */
+    treeShaking?: boolean;
+    /** Preserve original identifier names through minification. */
+    keepNames?: boolean;
     /** Extra implementation-specific options. */
     [key: string]: unknown;
 }
@@ -68,38 +165,74 @@ export interface TransformResult {
     /** Warnings emitted during transformation. */
     warnings: string[];
 }
+/** Arguments passed to an `onResolve` callback. */
+export interface OnResolveArgs {
+    path: string;
+    importer: string;
+    namespace: string;
+    resolveDir: string;
+    /** e.g. "import-statement", "dynamic-import", "require-call", "entry-point". */
+    kind: string;
+    pluginData?: unknown;
+}
+/** Result returned from an `onResolve` callback. */
+export interface OnResolveResult {
+    path?: string;
+    namespace?: string;
+    external?: boolean;
+    errors?: BundlerMessage[];
+    warnings?: BundlerMessage[];
+    pluginData?: unknown;
+    sideEffects?: boolean;
+    watchFiles?: string[];
+}
+/** Arguments passed to an `onLoad` callback. */
+export interface OnLoadArgs {
+    path: string;
+    namespace: string;
+    suffix?: string;
+    pluginData?: unknown;
+}
+/** Result returned from an `onLoad` callback. */
+export interface OnLoadResult {
+    contents?: string | Uint8Array;
+    loader?: string;
+    resolveDir?: string;
+    errors?: BundlerMessage[];
+    warnings?: BundlerMessage[];
+    pluginData?: unknown;
+    watchFiles?: string[];
+}
 /** Build context exposed to bundler plugins. */
 export interface BundlerPluginBuild {
-    /** Register a resolver callback for the given filter. */
     onResolve(options: {
         filter: RegExp;
         namespace?: string;
-    }, callback: (args: {
-        path: string;
-        namespace: string;
-    }) => {
-        path?: string;
-        namespace?: string;
-        external?: boolean;
-    } | undefined): void;
-    /** Register a loader callback for the given filter. */
+    }, callback: (args: OnResolveArgs) => OnResolveResult | null | undefined | void | Promise<OnResolveResult | null | undefined | void>): void;
     onLoad(options: {
         filter: RegExp;
         namespace?: string;
-    }, callback: (args: {
-        path: string;
-        namespace: string;
-    }) => {
-        contents?: string;
-        loader?: string;
-    } | undefined): void;
+    }, callback: (args: OnLoadArgs) => OnLoadResult | null | undefined | void | Promise<OnLoadResult | null | undefined | void>): void;
+    onDispose(callback: () => void): void;
 }
 /** A bundler plugin that hooks into the build pipeline. */
 export interface BundlerPlugin {
     /** Unique plugin name. */
     name: string;
-    /** Called once when the plugin is registered. */
-    setup(build: BundlerPluginBuild): void;
+    /** Called once when the plugin is registered. May be async. */
+    setup(build: BundlerPluginBuild): void | Promise<void>;
+}
+/** Incremental/rebuild context produced by {@link Bundler.context}. */
+export interface BuildContext {
+    /** Re-run the build with cached state. */
+    rebuild(): Promise<BundleResult>;
+    /** Release context resources. */
+    dispose(): Promise<void>;
+}
+/** Failure thrown by {@link Bundler.bundle} or {@link Bundler.transform}. */
+export interface BuildFailure extends Error {
+    errors: BundlerMessage[];
+    warnings: BundlerMessage[];
 }
 /**
  * Bundler contract interface.
@@ -112,6 +245,8 @@ export interface Bundler {
     bundle(options: BundleOptions): Promise<BundleResult>;
     /** Transform a single source string without writing to disk. */
     transform(options: TransformOptions): Promise<TransformResult>;
+    /** Create an incremental build context (watch/rebuild mode). */
+    context?(options: BundleOptions): Promise<BuildContext>;
     /** Release bundler resources (child processes, watchers, etc.). */
     stop?(): Promise<void>;
 }

package/esm/src/extensions/interfaces/bundler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/bundler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/bundler.ts"],"names":[],"mappings":"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"}

package/esm/src/extensions/interfaces/index.d.ts

@@ -6,7 +6,8 @@
  * @module extensions/interfaces
  */
 import "../../../_dnt.polyfills.js";
-export type { BundleOptions, BundleOutput, Bundler, BundleResult, BundlerPlugin, BundlerPluginBuild, TransformOptions, TransformResult, } from "./bundler.js";
+export type { BuildContext, BuildFailure, BundleOptions, BundleOutput, Bundler, BundleResult, BundlerMessage, BundlerMessageLocation, BundlerPlugin, BundlerPluginBuild, Loader, Metafile, MetafileInput, MetafileOutput, OnLoadArgs, OnLoadResult, OnResolveArgs, OnResolveResult, StdinOptions, TransformOptions, TransformResult, } from "./bundler.js";
+export type { ImportSpecifier, ModuleLexer } from "./module-lexer.js";
 export type { CacheStore } from "./cache-store.js";
 export type { TokenCacheEntry, TokenCacheStats, TokenCacheStore } from "./token-cache-store.js";
 export type { CSSCompileOptions, CSSCompiler, CSSModuleSource, CSSProcessor, CSSStylesheetSource, } from "./css-processor.js";

package/esm/src/extensions/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,4BAA4B,CAAC;AAEpC,YAAY,EACV,aAAa,EACb,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGhG,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxE,YAAY,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGvF,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAGpG,YAAY,EACV,OAAO,EACP,UAAU,EACV,eAAe,EACf,cAAc,EACd,6BAA6B,EAC7B,QAAQ,EACR,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,UAAU,EACV,MAAM,EACN,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,wBAAwB,EACxB,eAAe,GAChB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,4BAA4B,CAAC;AAEpC,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,kBAAkB,EAClB,MAAM,EACN,QAAQ,EACR,aAAa,EACb,cAAc,EACd,UAAU,EACV,YAAY,EACZ,aAAa,EACb,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGtE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGhG,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxE,YAAY,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGvF,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAGpG,YAAY,EACV,OAAO,EACP,UAAU,EACV,eAAe,EACf,cAAc,EACd,6BAA6B,EAC7B,QAAQ,EACR,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,UAAU,EACV,MAAM,EACN,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,wBAAwB,EACxB,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/esm/src/extensions/interfaces/module-lexer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Contract interface for ES module lexers.
+ *
+ * Parses ES module import/export specifiers from source code.
+ * Kept separate from {@link Bundler} because the surfaces are orthogonal:
+ * a lexer only inspects specifier positions, while a bundler compiles and
+ * emits output.
+ *
+ * Default implementation: `@veryfront/ext-esbuild` (backed by `es-module-lexer`).
+ *
+ * @module extensions/interfaces/module-lexer
+ */
+/**
+ * A single import specifier position record, matching the shape produced by
+ * `es-module-lexer`.
+ */
+export interface ImportSpecifier {
+    /** Module specifier (e.g. "react"). Undefined when the specifier cannot be statically resolved (dynamic import with non-literal expression, or import.meta). */
+    n: string | undefined;
+    /** Start of module specifier. */
+    s: number;
+    /** End of module specifier. */
+    e: number;
+    /** Start of import statement. */
+    ss: number;
+    /** End of import statement. */
+    se: number;
+    /** Index of the dynamic import token in the source; -1 for static imports, -2 for import.meta. */
+    d: number;
+    /** Start position of the import attributes (with/assert) block in the source; -1 if none. */
+    a: number;
+}
+/**
+ * Module lexer contract interface.
+ *
+ * Implementations parse ES module import specifiers from source code and
+ * return positional records suitable for further rewriting.
+ */
+export interface ModuleLexer {
+    /** Optional async initialization (e.g., loading WASM). Called lazily by the default impl before first parse. */
+    init?(): Promise<void>;
+    /** Parse ES module import/export specifiers from source code. */
+    parse(code: string): readonly ImportSpecifier[];
+}
+//# sourceMappingURL=module-lexer.d.ts.map

package/esm/src/extensions/interfaces/module-lexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-lexer.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/module-lexer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,gKAAgK;IAChK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtB,iCAAiC;IACjC,CAAC,EAAE,MAAM,CAAC;IACV,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,kGAAkG;IAClG,CAAC,EAAE,MAAM,CAAC;IACV,6FAA6F;IAC7F,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,gHAAgH;IAChH,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,iEAAiE;IACjE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,eAAe,EAAE,CAAC;CACjD"}

package/esm/src/extensions/interfaces/module-lexer.js

@@ -0,0 +1,13 @@
+/**
+ * Contract interface for ES module lexers.
+ *
+ * Parses ES module import/export specifiers from source code.
+ * Kept separate from {@link Bundler} because the surfaces are orthogonal:
+ * a lexer only inspects specifier positions, while a bundler compiles and
+ * emits output.
+ *
+ * Default implementation: `@veryfront/ext-esbuild` (backed by `es-module-lexer`).
+ *
+ * @module extensions/interfaces/module-lexer
+ */
+export {};

package/esm/src/extensions/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAA+B,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElG,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,MAAM,CAA+B;IAE7C;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;gBAI5C,MAAM,EAAE,eAAe;IAInC;;;;OAIG;IACH,cAAc,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE;IAIpE,OAAO,CAAC,mBAAmB;IA8B3B;;;OAGG;IACH,eAAe,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE;IA6ErE;;;OAGG;IACG,QAAQ,CACZ,UAAU,EAAE,iBAAiB,EAAE,EAC/B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,IAAI,CAAC;IAgFhB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAcnC"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAA+B,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElG,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,MAAM,CAA+B;IAE7C;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;gBAI5C,MAAM,EAAE,eAAe;IAInC;;;;OAIG;IACH,cAAc,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE;IAIpE,OAAO,CAAC,mBAAmB;IA8B3B;;;OAGG;IACH,eAAe,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE;IA6ErE;;;OAGG;IACG,QAAQ,CACZ,UAAU,EAAE,iBAAiB,EAAE,EAC/B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,IAAI,CAAC;IAgFhB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAmBnC"}

package/esm/src/extensions/loader.js

@@ -215,7 +215,13 @@ export class ExtensionLoader {
                 }
             }
         }
+        const hadSetupExtensions = this.setupOrder.length > 0;
         this.setupOrder = [];
-        reset();
+        // Only clear the contract registry when this loader actually registered
+        // contracts via setupAll(). Otherwise an idempotent teardown on an empty
+        // loader would wipe contracts registered out-of-band (e.g. by the test
+        // harness in `tests/_helpers/contract-init.ts`).
+        if (hadSetupExtensions)
+            reset();
     }
 }

package/esm/src/extensions/recommendations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recommendations.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/recommendations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqBH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1E"}
+{"version":3,"file":"recommendations.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/recommendations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwBH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1E"}

package/esm/src/extensions/recommendations.js

@@ -5,6 +5,9 @@
  */
 const recommendations = new Map([
     ["Bundler", "@veryfront/ext-esbuild"],
+    // ModuleLexer ships in the same package as Bundler (es-module-lexer +
+    // esbuild are co-bundled into ext-esbuild).
+    ["ModuleLexer", "@veryfront/ext-esbuild"],
     ["CacheStore", "@veryfront/ext-redis"],
     ["TokenCacheStore", "@veryfront/ext-redis"],
     ["CSSProcessor", "@veryfront/ext-tailwind"],

package/esm/src/platform/compat/esbuild.d.ts

@@ -1,8 +1,22 @@
-export type { BuildOptions, BuildResult, TransformOptions, TransformResult } from "esbuild";
-export declare function getEsbuild(): Promise<typeof import("esbuild")>;
-export declare function transform(code: string, options?: import("esbuild").TransformOptions): Promise<import("esbuild").TransformResult>;
-export declare function build(options: import("esbuild").BuildOptions): Promise<import("esbuild").BuildResult>;
-export declare function stop(): Promise<void>;
-/** Eager initialization for server startup. */
+/**
+ * Compatibility shim for code that previously imported esbuild via this path.
+ *
+ * The actual esbuild runtime now lives in the `@veryfront/ext-esbuild`
+ * extension; this module forwards to the registered `Bundler` contract so
+ * legacy callers keep working without importing `esbuild` directly.
+ */
+import { build as bundlerBuild, stop as bundlerStop, transform as bundlerTransform } from "../../extensions/bundler.js";
+import type { BundleOptions, BundleResult, TransformOptions, TransformResult } from "../../extensions/bundler.js";
+export type { BundleOptions as BuildOptions, BundleResult as BuildResult, TransformOptions, TransformResult, } from "../../extensions/bundler.js";
+/** esbuild-shaped facade backed by the registered `Bundler` contract. */
+export declare function getEsbuild(): {
+    build: (opts: BundleOptions) => Promise<BundleResult>;
+    transform: (code: string, opts?: Omit<TransformOptions, "code">) => Promise<TransformResult>;
+    stop: () => Promise<void>;
+};
+export declare const transform: typeof bundlerTransform;
+export declare const build: typeof bundlerBuild;
+export declare const stop: typeof bundlerStop;
+/** No-op kept for backwards compatibility with legacy bootstrap callers. */
 export declare function initializeEsbuild(): Promise<void>;
 //# sourceMappingURL=esbuild.d.ts.map

package/esm/src/platform/compat/esbuild.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"esbuild.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/esbuild.ts"],"names":[],"mappings":"AAQA,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AA6H5F,wBAAsB,UAAU,IAAI,OAAO,CAAC,cAAc,SAAS,CAAC,CAAC,CAMpE;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,SAAS,EAAE,gBAAgB,GAC3C,OAAO,CAAC,OAAO,SAAS,EAAE,eAAe,CAAC,CAG5C;AAED,wBAAsB,KAAK,CACzB,OAAO,EAAE,OAAO,SAAS,EAAE,YAAY,GACtC,OAAO,CAAC,OAAO,SAAS,EAAE,WAAW,CAAC,CAGxC;AAED,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1C;AAED,+CAA+C;AAC/C,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvD"}
+{"version":3,"file":"esbuild.d.ts","sourceRoot":"","sources":["../../../../src/src/platform/compat/esbuild.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,KAAK,IAAI,YAAY,EAErB,IAAI,IAAI,WAAW,EACnB,SAAS,IAAI,gBAAgB,EAC9B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,EAChB,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,aAAa,IAAI,YAAY,EAC7B,YAAY,IAAI,WAAW,EAC3B,gBAAgB,EAChB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AAErC,yEAAyE;AACzE,wBAAgB,UAAU,IAAI;IAC5B,KAAK,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACtD,SAAS,EAAE,CACT,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,KAClC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAOA;AAED,eAAO,MAAM,SAAS,yBAAmB,CAAC;AAC1C,eAAO,MAAM,KAAK,qBAAe,CAAC;AAClC,eAAO,MAAM,IAAI,oBAAc,CAAC;AAEhC,4EAA4E;AAC5E,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvD"}

package/esm/src/platform/compat/esbuild.js

@@ -1,141 +1,24 @@
 /**
- * esbuild compatibility layer with deno compile support.
- * Extracts esbuild binary from VFS to temp dir on first use in compiled binaries.
- * Sets ESBUILD_BINARY_PATH in both Deno.env and process.env (esbuild reads process.env).
+ * Compatibility shim for code that previously imported esbuild via this path.
+ *
+ * The actual esbuild runtime now lives in the `@veryfront/ext-esbuild`
+ * extension; this module forwards to the registered `Bundler` contract so
+ * legacy callers keep working without importing `esbuild` directly.
  */
-import * as dntShim from "../../../_dnt.shims.js";
-import nodeProcess from "node:process";
-import { serverLogger } from "../../utils/logger/logger.js";
-import { getEnv, setEnv } from "./process.js";
-import { isDenoCompiled } from "./runtime.js";
-import { ESBUILD_VERSION, getEsbuildBinaryName, getVFSBasePath } from "./esbuild-shared.js";
-import { FILE_NOT_FOUND } from "../../errors/index.js";
-function getTempDir() {
-    return getEnv("TMPDIR") ?? getEnv("TEMP") ?? getEnv("TMP") ?? "/tmp";
-}
-function getEsbuildCacheDir() {
-    return `${getTempDir()}/veryfront-esbuild`;
-}
-let esbuildModule = null;
-let setupComplete = false;
-let setupPromise = null;
-async function isFile(path) {
-    try {
-        const stat = await dntShim.Deno.stat(path);
-        return stat.isFile;
-    }
-    catch (_) {
-        /* expected: file may not exist */
-        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 vfsPath of possiblePaths) {
-        if (await isFile(vfsPath))
-            return vfsPath;
-    }
-    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 (_) {
-        /* expected: node_modules directory may not be readable in VFS */
-    }
-    return null;
-}
-async function extractEsbuildBinary() {
-    const cacheDir = getEsbuildCacheDir();
-    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 (_) {
-        /* expected: cached binary does not exist yet, need to extract */
-    }
-    const vfsPath = await findEsbuildInVFS();
-    if (!vfsPath) {
-        const vfsBase = getVFSBasePath(new URL(globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url).pathname, getTempDir());
-        throw FILE_NOT_FOUND.create({
-            detail: `Could not find esbuild binary in deno compile VFS.\n` +
-                `  Platform: ${getEsbuildBinaryName()}\n` +
-                `  VFS base: ${vfsBase}\n` +
-                `  Tip: 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;
-}
-async function ensureEsbuildBinary() {
-    if (setupComplete)
-        return;
-    if (setupPromise) {
-        await setupPromise;
-        return;
-    }
-    setupPromise = (async () => {
-        if (getEnv("ESBUILD_BINARY_PATH") || !isDenoCompiled) {
-            setupComplete = true;
-            return;
-        }
-        try {
-            const binaryPath = await extractEsbuildBinary();
-            setEnv("ESBUILD_BINARY_PATH", binaryPath);
-            nodeProcess.env.ESBUILD_BINARY_PATH = binaryPath;
-        }
-        catch (error) {
-            serverLogger.error("[esbuild] Binary extraction failed", error);
-        }
-        finally {
-            setupComplete = true;
-        }
-    })();
-    try {
-        await setupPromise;
-    }
-    finally {
-        setupPromise = null;
-    }
-}
-export async function getEsbuild() {
-    await ensureEsbuildBinary();
-    if (esbuildModule)
-        return esbuildModule;
-    esbuildModule = await import("esbuild");
-    return esbuildModule;
-}
-export async function transform(code, options) {
-    const esbuild = await getEsbuild();
-    return esbuild.transform(code, options);
-}
-export async function build(options) {
-    const esbuild = await getEsbuild();
-    return esbuild.build(options);
-}
-export async function stop() {
-    const esbuild = await getEsbuild();
-    esbuild.stop();
-}
-/** Eager initialization for server startup. */
+import { build as bundlerBuild, getBundler, stop as bundlerStop, transform as bundlerTransform, } from "../../extensions/bundler.js";
+/** esbuild-shaped facade backed by the registered `Bundler` contract. */
+export function getEsbuild() {
+    getBundler();
+    return {
+        build: bundlerBuild,
+        transform: bundlerTransform,
+        stop: bundlerStop,
+    };
+}
+export const transform = bundlerTransform;
+export const build = bundlerBuild;
+export const stop = bundlerStop;
+/** No-op kept for backwards compatibility with legacy bootstrap callers. */
 export async function initializeEsbuild() {
-    await ensureEsbuildBinary();
+    getBundler();
 }

package/esm/src/rendering/script-page-handling.js

@@ -205,7 +205,7 @@ async function readFileWithFallback(adapter, modulePath, normalizedPath) {
     }
 }
 async function transpileWithEsbuild(source, modulePath, resolveDir) {
-    const { build } = await import("esbuild");
+    const { build } = await import("../extensions/bundler.js");
     const loader = getEsbuildLoader(modulePath);
     const result = await build({
         bundle: true,

package/esm/src/routing/api/module-loader/esbuild-plugin.d.ts

@@ -1,5 +1,5 @@
 import { type LockfileManager } from "../../../utils/index.js";
-import type { Plugin } from "esbuild";
+import type { Plugin } from "../../../extensions/bundler.js";
 interface HTTPPluginOptions {
     allowedHosts: string[];
     lockfile?: LockfileManager;

package/esm/src/routing/api/module-loader/esbuild-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"esbuild-plugin.d.ts","sourceRoot":"","sources":["../../../../../src/src/routing/api/module-loader/esbuild-plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAW,MAAM,EAAE,MAAM,SAAS,CAAC;AAI/C,UAAU,iBAAiB;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,EAAE,GAAG,MAAM,CA2K9E"}
+{"version":3,"file":"esbuild-plugin.d.ts","sourceRoot":"","sources":["../../../../../src/src/routing/api/module-loader/esbuild-plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAW,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAItE,UAAU,iBAAiB;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,EAAE,GAAG,MAAM,CA2K9E"}

package/esm/src/routing/api/module-loader/loader.js

@@ -213,7 +213,7 @@ function loadAndTranspileModule(modulePath, projectDir, adapter, fs, config) {
         for (const name of userDeps.keys()) {
             userExternals.push(name, `${name}/*`);
         }
-        const { build } = await import("esbuild");
+        const { build } = await import("../../../extensions/bundler.js");
         // Many npm packages use CJS require() for Node built-ins (e.g. require('fs')).
         // When esbuild bundles CJS into ESM output, these become __require() shims that
         // fail at runtime. Inject a createRequire-based shim so require() works in ESM.