xbintsc 0.2.8 → 0.3.1

package/dist/src/driver/paths.js

@@ -8,6 +8,9 @@ export function findRuntimeDir() {
     const candidates = [
         resolve(here, "../../runtime"),
         resolve(here, "../../../runtime"),
+        // Packaged release layout: `<root>/bin/xbintsc` next to `<root>/runtime`.
+        resolve(here, "../runtime"),
+        resolve(here, "runtime"),
         resolve(process.cwd(), "runtime"),
     ];
     for (const candidate of candidates) {
@@ -19,4 +22,50 @@ export function findRuntimeDir() {
 export function findPackageRoot() {
     return resolve(findRuntimeDir(), "..");
 }
+/** `<package>/vendor` — where a bundled toolchain is assembled (may not exist). */
+export function vendorRootDir() {
+    return resolve(findPackageRoot(), "vendor");
+}
+/** Platform-architecture slug, e.g. `darwin-arm64`, `linux-x64`, `win32-x64`. */
+export function platformSlug() {
+    return `${process.platform}-${process.arch}`;
+}
+/**
+ * Base name (no extension) of a packaged release archive, e.g.
+ * `xbintsc-linux-x64`. Matches the top-level directory inside the archive.
+ */
+export function releaseArchiveBase(platform = process.platform, arch = process.arch) {
+    return `xbintsc-${platform}-${arch}`;
+}
+/**
+ * Extension for a release archive. `.tar.zst` when a `zstd` binary is available
+ * (smaller, faster), otherwise the universally supported `.tar.gz`.
+ */
+export function releaseArchiveExtension(useZstd) {
+    return useZstd ? ".tar.zst" : ".tar.gz";
+}
+/**
+ * Directory that may hold a toolchain shipped next to the package:
+ * `<package>/vendor/<os>-<arch>` (or a generic `vendor/`). Undefined when none
+ * is present, in which case the driver falls back to the system PATH.
+ */
+export function findVendorDir() {
+    const roots = [];
+    try {
+        roots.push(findPackageRoot());
+    }
+    catch {
+        // `runtime/` may be absent (e.g. a bare `emit` install); vendor is optional.
+    }
+    roots.push(resolve(here, "../../.."), resolve(here, "../.."), process.cwd());
+    for (const root of roots) {
+        const specific = join(root, "vendor", platformSlug());
+        if (existsSync(specific))
+            return specific;
+        const generic = join(root, "vendor");
+        if (existsSync(generic))
+            return generic;
+    }
+    return undefined;
+}
 //# sourceMappingURL=paths.js.map

package/dist/src/driver/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/driver/paths.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAErD,iEAAiE;AACjE,MAAM,UAAU,cAAc;IAC5B,MAAM,UAAU,GAAG;QACjB,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC;QAC9B,OAAO,CAAC,IAAI,EAAE,kBAAkB,CAAC;QACjC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC;KAClC,CAAC;IACF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;IAC5D,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,CAAC,cAAc,EAAE,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/driver/paths.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAErD,iEAAiE;AACjE,MAAM,UAAU,cAAc;IAC5B,MAAM,UAAU,GAAG;QACjB,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC;QAC9B,OAAO,CAAC,IAAI,EAAE,kBAAkB,CAAC;QACjC,0EAA0E;QAC1E,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC;QAC3B,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;QACxB,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC;KAClC,CAAC;IACF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;IAC5D,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,CAAC,cAAc,EAAE,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,eAAe,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,YAAY;IAC1B,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAAmB,OAAO,CAAC,QAAQ,EACnC,OAAe,OAAO,CAAC,IAAI;IAE3B,OAAO,WAAW,QAAQ,IAAI,IAAI,EAAE,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;IAC/E,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;QACtD,IAAI,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACrC,IAAI,UAAU,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;IAC1C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/driver/runtime-lib.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Prebuilt runtime archives.
+ *
+ * The C runtime is normally compiled once into a static archive by
+ * `npm run runtime`:
+ *
+ *   runtime/lib/<os>-<arch>/core.a        (the core `xt_*.c` runtime)
+ *   runtime/lib/<os>-<arch>/ext_<name>.a  (per-extension sources, e.g. ext_node.a)
+ *
+ * Shipping these lets `build` link without compiling C, and shortens the first
+ * build. When an archive is missing the driver transparently falls back to
+ * compiling the `.c` sources, so the archives are an optimization, not a hard
+ * dependency.
+ */
+/** Directory holding the prebuilt archives for the current host. */
+export declare function runtimeLibDir(): string;
+/** Absolute path to a prebuilt archive (`core`, `ext_node`, …), if present. */
+export declare function findRuntimeLibrary(name: string): string | undefined;

package/dist/src/driver/runtime-lib.js

@@ -0,0 +1,31 @@
+/**
+ * Prebuilt runtime archives.
+ *
+ * The C runtime is normally compiled once into a static archive by
+ * `npm run runtime`:
+ *
+ *   runtime/lib/<os>-<arch>/core.a        (the core `xt_*.c` runtime)
+ *   runtime/lib/<os>-<arch>/ext_<name>.a  (per-extension sources, e.g. ext_node.a)
+ *
+ * Shipping these lets `build` link without compiling C, and shortens the first
+ * build. When an archive is missing the driver transparently falls back to
+ * compiling the `.c` sources, so the archives are an optimization, not a hard
+ * dependency.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { findRuntimeDir, platformSlug } from "./paths.js";
+/** Directory holding the prebuilt archives for the current host. */
+export function runtimeLibDir() {
+    return join(findRuntimeDir(), "lib", platformSlug());
+}
+/** Absolute path to a prebuilt archive (`core`, `ext_node`, …), if present. */
+export function findRuntimeLibrary(name) {
+    const base = join(runtimeLibDir(), name);
+    for (const candidate of [`${base}.a`, `${base}.lib`]) {
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return undefined;
+}
+//# sourceMappingURL=runtime-lib.js.map

package/dist/src/driver/runtime-lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-lib.js","sourceRoot":"","sources":["../../../src/driver/runtime-lib.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1D,oEAAoE;AACpE,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,CAAC;IACzC,KAAK,MAAM,SAAS,IAAI,CAAC,GAAG,IAAI,IAAI,EAAE,GAAG,IAAI,MAAM,CAAC,EAAE,CAAC;QACrD,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IAC9C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/driver/toolchain-download.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Which toolchain xbintsc bundles for each host.
+ *
+ * The end goal is that `build` needs no user-installed compiler. Per the
+ * recorded decisions (see `doc/requirements.md`):
+ *
+ *   Linux   -> the official LLVM release (clang + lld + llvm-ar)
+ *   Windows -> llvm-mingw (clang + lld + the MinGW-w64 sysroot/CRT/import libs)
+ *   macOS   -> nothing; the Xcode Command Line Tools are the prerequisite
+ *
+ * This module only maps a host to a pinned download; the actual fetch lives in
+ * `scripts/fetch-toolchain.ts`.
+ */
+/** Pinned LLVM release used for the Linux bundle. */
+export declare const LLVM_VERSION = "18.1.8";
+/** Pinned llvm-mingw release used for the Windows bundle. */
+export declare const LLVM_MINGW_VERSION = "20260908";
+export interface ToolchainDownload {
+    /** Download URL. */
+    readonly url: string;
+    /** Suggested local file name for the archive. */
+    readonly archive: string;
+    /** Archive type. Both are unpacked with `tar` (bsdtar reads zip). */
+    readonly kind: "tar.xz" | "zip";
+    /** Leading path segments to strip while extracting. */
+    readonly stripComponents: number;
+}
+/**
+ * The toolchain to bundle for a host, or undefined when the host's own SDK is
+ * used instead (macOS: the Xcode Command Line Tools).
+ */
+export declare function toolchainDownload(platform?: string, arch?: string): ToolchainDownload | undefined;
+export interface SupportLibrary {
+    /** Candidate download URLs, tried in order. */
+    readonly urls: readonly string[];
+    /** Local file name for the downloaded `.deb`. */
+    readonly archive: string;
+    /** Path inside the extracted `.deb` data tree. */
+    readonly member: string;
+    /** File name placed in `vendor/<os>-<arch>/lib/`. */
+    readonly dest: string;
+}
+/**
+ * Extra shared libraries the bundled toolchain needs but that are not part of
+ * the OS C library. The official Linux LLVM build links the legacy
+ * `libtinfo.so.5` soname, which current distributions no longer ship, so we
+ * bundle it (from the Ubuntu `libtinfo5` package) into `vendor/<os>-<arch>/lib`
+ * and point `LD_LIBRARY_PATH` at that directory.
+ */
+export declare function toolchainSupportLibraries(platform?: string, arch?: string): readonly SupportLibrary[];

package/dist/src/driver/toolchain-download.js

@@ -0,0 +1,76 @@
+/**
+ * Which toolchain xbintsc bundles for each host.
+ *
+ * The end goal is that `build` needs no user-installed compiler. Per the
+ * recorded decisions (see `doc/requirements.md`):
+ *
+ *   Linux   -> the official LLVM release (clang + lld + llvm-ar)
+ *   Windows -> llvm-mingw (clang + lld + the MinGW-w64 sysroot/CRT/import libs)
+ *   macOS   -> nothing; the Xcode Command Line Tools are the prerequisite
+ *
+ * This module only maps a host to a pinned download; the actual fetch lives in
+ * `scripts/fetch-toolchain.ts`.
+ */
+/** Pinned LLVM release used for the Linux bundle. */
+export const LLVM_VERSION = "18.1.8";
+/** Pinned llvm-mingw release used for the Windows bundle. */
+export const LLVM_MINGW_VERSION = "20260908";
+/**
+ * The toolchain to bundle for a host, or undefined when the host's own SDK is
+ * used instead (macOS: the Xcode Command Line Tools).
+ */
+export function toolchainDownload(platform = process.platform, arch = process.arch) {
+    if (platform === "linux") {
+        if (arch === "x64") {
+            return {
+                url: `https://github.com/llvm/llvm-project/releases/download/llvmorg-${LLVM_VERSION}/clang+llvm-${LLVM_VERSION}-x86_64-linux-gnu-ubuntu-18.04.tar.xz`,
+                archive: `clang+llvm-${LLVM_VERSION}-x86_64-linux-gnu.tar.xz`,
+                kind: "tar.xz",
+                stripComponents: 1,
+            };
+        }
+        if (arch === "arm64") {
+            return {
+                url: `https://github.com/llvm/llvm-project/releases/download/llvmorg-${LLVM_VERSION}/clang+llvm-${LLVM_VERSION}-aarch64-linux-gnu.tar.xz`,
+                archive: `clang+llvm-${LLVM_VERSION}-aarch64-linux-gnu.tar.xz`,
+                kind: "tar.xz",
+                stripComponents: 1,
+            };
+        }
+        return undefined;
+    }
+    if (platform === "win32" && arch === "x64") {
+        return {
+            url: `https://github.com/mstorsjo/llvm-mingw/releases/download/${LLVM_MINGW_VERSION}/llvm-mingw-${LLVM_MINGW_VERSION}-ucrt-x86_64.zip`,
+            archive: `llvm-mingw-${LLVM_MINGW_VERSION}-ucrt-x86_64.zip`,
+            kind: "zip",
+            stripComponents: 1,
+        };
+    }
+    // macOS (and any other host) uses the system SDK; nothing to bundle.
+    return undefined;
+}
+/**
+ * Extra shared libraries the bundled toolchain needs but that are not part of
+ * the OS C library. The official Linux LLVM build links the legacy
+ * `libtinfo.so.5` soname, which current distributions no longer ship, so we
+ * bundle it (from the Ubuntu `libtinfo5` package) into `vendor/<os>-<arch>/lib`
+ * and point `LD_LIBRARY_PATH` at that directory.
+ */
+export function toolchainSupportLibraries(platform = process.platform, arch = process.arch) {
+    if (platform === "linux" && arch === "x64") {
+        return [
+            {
+                urls: [
+                    "https://security.ubuntu.com/ubuntu/pool/main/n/ncurses/libtinfo5_6.1-1ubuntu1.18.04.1_amd64.deb",
+                    "https://archive.ubuntu.com/ubuntu/pool/main/n/ncurses/libtinfo5_6.1-1ubuntu1.18.04.1_amd64.deb",
+                ],
+                archive: "libtinfo5.deb",
+                member: "lib/x86_64-linux-gnu/libtinfo.so.5.9",
+                dest: "libtinfo.so.5",
+            },
+        ];
+    }
+    return [];
+}
+//# sourceMappingURL=toolchain-download.js.map

package/dist/src/driver/toolchain-download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolchain-download.js","sourceRoot":"","sources":["../../../src/driver/toolchain-download.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,qDAAqD;AACrD,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AACrC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAa7C;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,WAAmB,OAAO,CAAC,QAAQ,EACnC,OAAe,OAAO,CAAC,IAAI;IAE3B,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,OAAO;gBACL,GAAG,EAAE,kEAAkE,YAAY,eAAe,YAAY,uCAAuC;gBACrJ,OAAO,EAAE,cAAc,YAAY,0BAA0B;gBAC7D,IAAI,EAAE,QAAQ;gBACd,eAAe,EAAE,CAAC;aACnB,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,OAAO;gBACL,GAAG,EAAE,kEAAkE,YAAY,eAAe,YAAY,2BAA2B;gBACzI,OAAO,EAAE,cAAc,YAAY,2BAA2B;gBAC9D,IAAI,EAAE,QAAQ;gBACd,eAAe,EAAE,CAAC;aACnB,CAAC;QACJ,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,QAAQ,KAAK,OAAO,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QAC3C,OAAO;YACL,GAAG,EAAE,4DAA4D,kBAAkB,eAAe,kBAAkB,kBAAkB;YACtI,OAAO,EAAE,cAAc,kBAAkB,kBAAkB;YAC3D,IAAI,EAAE,KAAK;YACX,eAAe,EAAE,CAAC;SACnB,CAAC;IACJ,CAAC;IAED,qEAAqE;IACrE,OAAO,SAAS,CAAC;AACnB,CAAC;AAaD;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,WAAmB,OAAO,CAAC,QAAQ,EACnC,OAAe,OAAO,CAAC,IAAI;IAE3B,IAAI,QAAQ,KAAK,OAAO,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QAC3C,OAAO;YACL;gBACE,IAAI,EAAE;oBACJ,iGAAiG;oBACjG,gGAAgG;iBACjG;gBACD,OAAO,EAAE,eAAe;gBACxB,MAAM,EAAE,sCAAsC;gBAC9C,IAAI,EAAE,eAAe;aACtB;SACF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/src/driver/toolchain-provider.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Toolchain selection.
+ *
+ * xbintsc shells out to a clang-compatible driver for three jobs: lowering LLVM
+ * IR to an object, compiling the C runtime, and linking. This module decides
+ * *which* driver to use, in a fixed priority order, so a bundled toolchain can
+ * shadow the system one without touching the driver code:
+ *
+ *   1. an explicit `xbintsc_CLANG` / `xbintsc_TOOLCHAIN`
+ *   2. a toolchain shipped next to the package (`vendor/<os>-<arch>/bin`)
+ *   3. the system `PATH` (`findClang`)
+ *
+ * Extra linker arguments (for example `-fuse-ld=lld`) can be supplied through
+ * `xbintsc_LINKER_ARGS`.
+ */
+import { type Runner } from "./toolchain.js";
+export type ToolchainSource = "env" | "vendor" | "system";
+export interface ResolvedToolchain {
+    /** Path or name of the clang-compatible driver to invoke. */
+    readonly clang: string;
+    /** Where the driver came from. */
+    readonly source: ToolchainSource;
+    /** Extra arguments to pass to the link step. */
+    readonly linkerArgs: readonly string[];
+    /**
+     * Extra environment for the toolchain subprocesses, merged over the current
+     * environment. Used to point `LD_LIBRARY_PATH` at bundled shared libraries
+     * (for example the legacy `libtinfo.so.5` the official Linux build needs).
+     */
+    readonly env: Record<string, string>;
+}
+/** Resolve the toolchain that `build` should use. See the module docblock. */
+export declare function resolveToolchain(runner?: Runner): ResolvedToolchain;

package/dist/src/driver/toolchain-provider.js

@@ -0,0 +1,71 @@
+/**
+ * Toolchain selection.
+ *
+ * xbintsc shells out to a clang-compatible driver for three jobs: lowering LLVM
+ * IR to an object, compiling the C runtime, and linking. This module decides
+ * *which* driver to use, in a fixed priority order, so a bundled toolchain can
+ * shadow the system one without touching the driver code:
+ *
+ *   1. an explicit `xbintsc_CLANG` / `xbintsc_TOOLCHAIN`
+ *   2. a toolchain shipped next to the package (`vendor/<os>-<arch>/bin`)
+ *   3. the system `PATH` (`findClang`)
+ *
+ * Extra linker arguments (for example `-fuse-ld=lld`) can be supplied through
+ * `xbintsc_LINKER_ARGS`.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { findVendorDir } from "./paths.js";
+import { findClang, realRunner } from "./toolchain.js";
+function works(runner, command, env) {
+    try {
+        return runner.run(command, ["--version"], env ? { env } : undefined).status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+function linkerArgs(fallback) {
+    const raw = process.env.xbintsc_LINKER_ARGS;
+    if (raw)
+        return raw.split(" ").filter((part) => part.length > 0);
+    return [...fallback];
+}
+/**
+ * Environment overrides for a bundled toolchain. The official Linux build links
+ * the removed `libtinfo.so.5` soname, so when we ship it under `vendor/lib/` we
+ * prepend that directory to the dynamic linker search path.
+ */
+function vendorEnv(vendor) {
+    const libDir = join(vendor, "lib");
+    if (process.platform !== "linux" || !existsSync(libDir))
+        return {};
+    const existing = process.env.LD_LIBRARY_PATH;
+    return { LD_LIBRARY_PATH: existing ? libDir + ":" + existing : libDir };
+}
+/** Resolve the toolchain that `build` should use. See the module docblock. */
+export function resolveToolchain(runner = realRunner) {
+    const explicit = process.env.xbintsc_CLANG ?? process.env.xbintsc_TOOLCHAIN;
+    if (explicit && works(runner, explicit)) {
+        return { clang: explicit, source: "env", linkerArgs: linkerArgs([]), env: {} };
+    }
+    const vendor = findVendorDir();
+    if (vendor) {
+        const env = vendorEnv(vendor);
+        const names = process.platform === "win32" ? ["clang.exe", "clang"] : ["clang"];
+        for (const name of names) {
+            const candidate = join(vendor, "bin", name);
+            if (existsSync(candidate) && works(runner, candidate, env)) {
+                // A bundled toolchain ships `ld.lld`, so prefer lld over any system linker.
+                return {
+                    clang: candidate,
+                    source: "vendor",
+                    linkerArgs: linkerArgs(["-fuse-ld=lld"]),
+                    env,
+                };
+            }
+        }
+    }
+    return { clang: findClang(runner), source: "system", linkerArgs: linkerArgs([]), env: {} };
+}
+//# sourceMappingURL=toolchain-provider.js.map

package/dist/src/driver/toolchain-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolchain-provider.js","sourceRoot":"","sources":["../../../src/driver/toolchain-provider.ts"],"names":[],"mappings":"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"}

package/dist/src/driver/toolchain.d.ts

@@ -9,10 +9,13 @@ export interface CommandResult {
     readonly stdout: string;
     readonly stderr: string;
 }
+export interface RunOptions {
+    readonly cwd?: string;
+    /** Extra environment variables, merged over `process.env`. */
+    readonly env?: Record<string, string>;
+}
 export interface Runner {
-    run(command: string, args: readonly string[], options?: {
-        cwd?: string;
-    }): CommandResult;
+    run(command: string, args: readonly string[], options?: RunOptions): CommandResult;
 }
 export declare const realRunner: Runner;
 export declare class ToolchainError extends Error {
@@ -28,6 +31,7 @@ export interface CompileIrOptions {
     readonly irPath: string;
     readonly objectPath: string;
     readonly optimize: string;
+    readonly env?: Record<string, string>;
 }
 /** Compile an LLVM IR file to a native object file. */
 export declare function compileIr(runner: Runner, options: CompileIrOptions): void;
@@ -37,7 +41,8 @@ export interface LinkOptions {
     readonly outputPath: string;
     readonly linkerFlags: readonly string[];
     readonly optimize: string;
+    readonly env?: Record<string, string>;
 }
 export declare function link(runner: Runner, options: LinkOptions): void;
 /** Compile a C source to an object file (used for the runtime and extensions). */
-export declare function compileC(runner: Runner, clang: string, sourcePath: string, objectPath: string, includeDir: string): void;
+export declare function compileC(runner: Runner, clang: string, sourcePath: string, objectPath: string, includeDir: string, env?: Record<string, string>): void;

package/dist/src/driver/toolchain.js

@@ -12,6 +12,8 @@ export const realRunner = {
             encoding: "utf8",
             maxBuffer: 64 * 1024 * 1024,
         };
+        if (options.env)
+            spawnOptions.env = Object.assign({}, process.env, options.env);
         const result = spawnSync(command, [...args], spawnOptions);
         return {
             status: result.status ?? (result.error ? 1 : 0),
@@ -51,25 +53,19 @@ export function findClang(runner = realRunner) {
 }
 /** Compile an LLVM IR file to a native object file. */
 export function compileIr(runner, options) {
-    const result = runner.run(options.clang, [
-        `-O${options.optimize}`,
-        "-c",
-        options.irPath,
-        "-o",
-        options.objectPath,
-    ]);
+    const result = runner.run(options.clang, [`-O${options.optimize}`, "-c", options.irPath, "-o", options.objectPath], { env: options.env });
     if (result.status !== 0)
         throw new ToolchainError(`${options.clang} ${options.irPath}`, result.status, result.stderr);
 }
 export function link(runner, options) {
     const args = [`-O${options.optimize}`, ...options.objectPaths, "-o", options.outputPath, ...options.linkerFlags];
-    const result = runner.run(options.clang, args);
+    const result = runner.run(options.clang, args, { env: options.env });
     if (result.status !== 0)
         throw new ToolchainError(`${options.clang} link`, result.status, result.stderr);
 }
 /** Compile a C source to an object file (used for the runtime and extensions). */
-export function compileC(runner, clang, sourcePath, objectPath, includeDir) {
-    const result = runner.run(clang, ["-O2", "-D_CRT_SECURE_NO_WARNINGS", "-c", sourcePath, "-o", objectPath, `-I${includeDir}`]);
+export function compileC(runner, clang, sourcePath, objectPath, includeDir, env) {
+    const result = runner.run(clang, ["-O2", "-D_CRT_SECURE_NO_WARNINGS", "-c", sourcePath, "-o", objectPath, `-I${includeDir}`], { env });
     if (result.status !== 0)
         throw new ToolchainError(`${clang} ${sourcePath}`, result.status, result.stderr);
 }

package/dist/src/driver/toolchain.js.map

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

package/dist/src/extensions/node/child_process/index.d.ts

@@ -1,7 +1,9 @@
 /**
  * Node's `child_process` module: `spawnSync(command, args, options)`, backed by
- * `runtime/ext_node/child_process`. Captures stdout/stderr as UTF-8 strings and
- * honours `options.cwd`, which is all the compiler's toolchain wrapper needs.
+ * `runtime/ext_node/child_process`. Captures stdout/stderr as UTF-8 strings,
+ * honours `options.cwd`, and supports `options.stdio: "inherit"` (hand the
+ * child the parent's stdout/stderr) — which is all the compiler's toolchain
+ * wrapper and `xbintsc run` need.
  */
 import type { NodeModule } from "../module.js";
 export declare const childProcessModule: NodeModule;

package/dist/src/extensions/node/child_process/index.js

@@ -1,7 +1,9 @@
 /**
  * Node's `child_process` module: `spawnSync(command, args, options)`, backed by
- * `runtime/ext_node/child_process`. Captures stdout/stderr as UTF-8 strings and
- * honours `options.cwd`, which is all the compiler's toolchain wrapper needs.
+ * `runtime/ext_node/child_process`. Captures stdout/stderr as UTF-8 strings,
+ * honours `options.cwd`, and supports `options.stdio: "inherit"` (hand the
+ * child the parent's stdout/stderr) — which is all the compiler's toolchain
+ * wrapper and `xbintsc run` need.
  */
 import { resolveFrom } from "../module.js";
 const builtins = {

package/dist/src/extensions/node/child_process/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/extensions/node/child_process/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,QAAQ,GAAoC;IAChD,SAAS,EAAE,EAAE,MAAM,EAAE,6BAA6B,EAAE;CACrD,CAAC;AAEF,MAAM,OAAO,GAAkB;IAC7B,SAAS,EAAE,EAAE,MAAM,EAAE,6BAA6B,EAAE;CACrD,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,IAAI,EAAE,eAAe;IACrB,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,4DAA4D,CAAC,CAAC;IAClH,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ;IACxB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO;CACvB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/extensions/node/child_process/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,QAAQ,GAAoC;IAChD,SAAS,EAAE,EAAE,MAAM,EAAE,6BAA6B,EAAE;CACrD,CAAC;AAEF,MAAM,OAAO,GAAkB;IAC7B,SAAS,EAAE,EAAE,MAAM,EAAE,6BAA6B,EAAE;CACrD,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,IAAI,EAAE,eAAe;IACrB,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,4DAA4D,CAAC,CAAC;IAClH,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ;IACxB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO;CACvB,CAAC"}

package/dist/src/extensions/node/events/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Node's `events` module.
+ *
+ * Exposes the standalone `EventEmitter` class plus its statics. `EventEmitter`
+ * is provided both as a global constructor and as a named export, so
+ * `new EventEmitter()` and `import { EventEmitter } from "events"` both work.
+ * The implementation lives in `runtime/ext_node/events/events.c`.
+ */
+import type { NodeModule } from "../module.js";
+export declare const eventsModule: NodeModule;

package/dist/src/extensions/node/events/index.js

@@ -0,0 +1,22 @@
+/**
+ * Node's `events` module.
+ *
+ * Exposes the standalone `EventEmitter` class plus its statics. `EventEmitter`
+ * is provided both as a global constructor and as a named export, so
+ * `new EventEmitter()` and `import { EventEmitter } from "events"` both work.
+ * The implementation lives in `runtime/ext_node/events/events.c`.
+ */
+import { resolveFrom } from "../module.js";
+const methods = ["listenerCount", "getEventListeners", "getMaxListeners", "setMaxListeners", "once"];
+const exports = {
+    EventEmitter: { symbol: "xt_event_emitter_ctor", isConstructor: true },
+    ...Object.fromEntries(methods.map((method) => [method, { namespace: "events", method }])),
+};
+export const eventsModule = {
+    name: "events",
+    namespace: "events",
+    runtimeSources: () => [resolveFrom(import.meta.url, "../../../../runtime/ext_node/events/events.c")],
+    builtins: () => ({}),
+    exports: () => exports,
+};
+//# sourceMappingURL=index.js.map

package/dist/src/extensions/node/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/extensions/node/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,OAAO,GAAG,CAAC,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,CAAU,CAAC;AAE9G,MAAM,OAAO,GAAkB;IAC7B,YAAY,EAAE,EAAE,MAAM,EAAE,uBAAuB,EAAE,aAAa,EAAE,IAAI,EAAE;IACtE,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;CAC1F,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,QAAQ;IACnB,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,8CAA8C,CAAC,CAAC;IACpG,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;IACpB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO;CACvB,CAAC"}

package/dist/src/extensions/node/index.js

@@ -22,6 +22,9 @@ import { httpModule } from "./http/index.js";
 import { urlModule } from "./url/index.js";
 import { cryptoModule } from "./crypto/index.js";
 import { childProcessModule } from "./child_process/index.js";
+import { eventsModule } from "./events/index.js";
+import { utilModule } from "./util/index.js";
+import { querystringModule } from "./querystring/index.js";
 /** Every Node module the extension currently provides. */
 const modules = [
     fsModule,
@@ -37,6 +40,9 @@ const modules = [
     urlModule,
     cryptoModule,
     childProcessModule,
+    eventsModule,
+    utilModule,
+    querystringModule,
 ];
 export const nodeExtension = {
     name: "node",

package/dist/src/extensions/node/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/extensions/node/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,0DAA0D;AAC1D,MAAM,OAAO,GAA0B;IACrC,QAAQ;IACR,gBAAgB;IAChB,UAAU;IACV,QAAQ;IACR,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,SAAS;IACT,WAAW;IACX,UAAU;IACV,SAAS;IACT,YAAY;IACZ,kBAAkB;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,6EAA6E;IAC1F,2EAA2E;IAC3E,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;IACxF,2EAA2E;IAC3E,+DAA+D;IAC/D,uEAAuE;IACvE,yEAAyE;IACzE,uDAAuD;IACvD,OAAO,EAAE,GAAG,EAAE;QACZ,MAAM,OAAO,GAAoC,EAAE,CAAC;QACpD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAoB;gBAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE;aAC/D,CAAC;YACF,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YAC7B,OAAO,CAAC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC;QACzC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/extensions/node/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,0DAA0D;AAC1D,MAAM,OAAO,GAA0B;IACrC,QAAQ;IACR,gBAAgB;IAChB,UAAU;IACV,QAAQ;IACR,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,SAAS;IACT,WAAW;IACX,UAAU;IACV,SAAS;IACT,YAAY;IACZ,kBAAkB;IAClB,YAAY;IACZ,UAAU;IACV,iBAAiB;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,6EAA6E;IAC1F,2EAA2E;IAC3E,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;IACxF,2EAA2E;IAC3E,+DAA+D;IAC/D,uEAAuE;IACvE,yEAAyE;IACzE,uDAAuD;IACvD,OAAO,EAAE,GAAG,EAAE;QACZ,MAAM,OAAO,GAAoC,EAAE,CAAC;QACpD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAoB;gBAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE;aAC/D,CAAC;YACF,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YAC7B,OAAO,CAAC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC;QACzC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC"}

package/dist/src/extensions/node/querystring/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Node's `querystring` module.
+ *
+ * `parse` / `decode` and `stringify` / `encode` are the same functions under
+ * two names, alongside `escape` / `unescape`. Both named imports and namespace
+ * calls (`import qs from "querystring"`) are supported; the implementation
+ * lives in `runtime/ext_node/querystring/querystring.c`.
+ */
+import type { NodeModule } from "../module.js";
+export declare const querystringModule: NodeModule;

package/dist/src/extensions/node/querystring/index.js

@@ -0,0 +1,25 @@
+/**
+ * Node's `querystring` module.
+ *
+ * `parse` / `decode` and `stringify` / `encode` are the same functions under
+ * two names, alongside `escape` / `unescape`. Both named imports and namespace
+ * calls (`import qs from "querystring"`) are supported; the implementation
+ * lives in `runtime/ext_node/querystring/querystring.c`.
+ */
+import { resolveFrom } from "../module.js";
+const exports = {
+    parse: { symbol: "xt_querystring_parse" },
+    decode: { symbol: "xt_querystring_parse" },
+    stringify: { symbol: "xt_querystring_stringify" },
+    encode: { symbol: "xt_querystring_stringify" },
+    escape: { symbol: "xt_querystring_escape" },
+    unescape: { symbol: "xt_querystring_unescape" },
+};
+export const querystringModule = {
+    name: "querystring",
+    namespace: "querystring",
+    runtimeSources: () => [resolveFrom(import.meta.url, "../../../../runtime/ext_node/querystring/querystring.c")],
+    builtins: () => ({}),
+    exports: () => exports,
+};
+//# sourceMappingURL=index.js.map

package/dist/src/extensions/node/querystring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/extensions/node/querystring/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,OAAO,GAAkB;IAC7B,KAAK,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE;IACzC,MAAM,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE;IAC1C,SAAS,EAAE,EAAE,MAAM,EAAE,0BAA0B,EAAE;IACjD,MAAM,EAAE,EAAE,MAAM,EAAE,0BAA0B,EAAE;IAC9C,MAAM,EAAE,EAAE,MAAM,EAAE,uBAAuB,EAAE;IAC3C,QAAQ,EAAE,EAAE,MAAM,EAAE,yBAAyB,EAAE;CAChD,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,IAAI,EAAE,aAAa;IACnB,SAAS,EAAE,aAAa;IACxB,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,wDAAwD,CAAC,CAAC;IAC9G,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;IACpB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO;CACvB,CAAC"}

package/dist/src/extensions/node/util/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Node's `util` module.
+ *
+ * Exposes the commonly used helpers (`format`, `inspect`, `isDeepStrictEqual`,
+ * `inherits`, `deprecate`, `promisify`) and the `isX` type predicates. Both
+ * `import { format } from "util"` and `import util from "util"` (namespace
+ * calls) are supported; the implementation lives in
+ * `runtime/ext_node/util/util.c`.
+ */
+import type { NodeModule } from "../module.js";
+export declare const utilModule: NodeModule;