xbintsc 0.5.6 → 0.5.21

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

@@ -0,0 +1,37 @@
+/**
+ * Front end: source text in, LLVM IR out (no toolchain involved).
+ *
+ * `compileString` compiles one in-memory source text; `compileEntry` reads a
+ * file and first bundles every reachable module. `build` reuses the same
+ * `parseEntry` step so the module graph is resolved identically for `emit`,
+ * `run` and `build`.
+ */
+import { DiagnosticBag } from "../diagnostics/diagnostic.js";
+import { type SourceFileNode } from "../ast/nodes.js";
+import { type ExtensionRegistry } from "../extensions/registry.js";
+import type { CompileStringResult } from "./options.js";
+/** A parsed (and, for module entries, already bundled) entry file. */
+export interface ParsedEntry {
+    readonly absoluteEntry: string;
+    readonly sourceText: string;
+    readonly sourceFile: SourceFileNode;
+    /** The text the incremental cache hashes (the bundled text for modules). */
+    readonly cacheText: string;
+}
+/**
+ * Parse an entry file, bundling its module graph first when it uses
+ * `import`/`export`. The caller owns `diagnostics` and must not run code
+ * generation when it has errors (the tree would be missing nodes).
+ */
+export declare function parseEntry(entryPath: string, registry: ExtensionRegistry, diagnostics: DiagnosticBag): ParsedEntry;
+/** Compile TypeScript source text to LLVM IR without touching the toolchain. */
+export declare function compileString(source: string, fileName?: string, extensions?: ExtensionRegistry, options?: {
+    readonly debug?: boolean;
+}): CompileStringResult;
+/**
+ * Compile a file to LLVM IR, bundling every reachable relative module first so
+ * that imports from other TypeScript sources resolve exactly like `build`.
+ */
+export declare function compileEntry(entryPath: string, extensions?: ExtensionRegistry, options?: {
+    readonly debug?: boolean;
+}): CompileStringResult;

package/dist/src/driver/frontend.js

@@ -0,0 +1,92 @@
+/**
+ * Front end: source text in, LLVM IR out (no toolchain involved).
+ *
+ * `compileString` compiles one in-memory source text; `compileEntry` reads a
+ * file and first bundles every reachable module. `build` reuses the same
+ * `parseEntry` step so the module graph is resolved identically for `emit`,
+ * `run` and `build`.
+ */
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { DiagnosticBag } from "../diagnostics/diagnostic.js";
+import { SourceFile } from "../diagnostics/source.js";
+import { sourceTextBytes } from "../diagnostics/source-text.js";
+import { Parser } from "../parser/parser.js";
+import { generate } from "../codegen/llvm.js";
+import { SyntaxKind } from "../ast/nodes.js";
+import { bundleModules } from "./modules.js";
+import { createDefaultRegistry } from "../extensions/registry.js";
+/**
+ * Every module specifier the registry can resolve at code generation time (the
+ * registered platform modules plus the hints for known-but-disabled
+ * extensions). Bare imports outside this set are looked up in `node_modules`
+ * and bundled as source.
+ */
+function externalModuleSpecifiers(registry) {
+    return new Set([
+        ...Object.keys(registry.modules()),
+        ...Object.keys(registry.moduleHints()),
+    ]);
+}
+/**
+ * Parse an entry file, bundling its module graph first when it uses
+ * `import`/`export`. The caller owns `diagnostics` and must not run code
+ * generation when it has errors (the tree would be missing nodes).
+ */
+export function parseEntry(entryPath, registry, diagnostics) {
+    const absoluteEntry = resolve(entryPath);
+    const sourceText = sourceTextBytes(readFileSync(absoluteEntry, "utf8"));
+    const file = new SourceFile(absoluteEntry, sourceText);
+    const parser = new Parser(file, diagnostics);
+    let sourceFile = parser.parseSourceFile();
+    const isModule = sourceFile.statements.some((statement) => statement.kind === SyntaxKind.ImportDeclaration ||
+        statement.kind === SyntaxKind.ExportDeclaration ||
+        statement.kind === SyntaxKind.ExportAssignment);
+    let cacheText = sourceText;
+    if (isModule) {
+        const bundled = bundleModules(absoluteEntry, diagnostics, externalModuleSpecifiers(registry), registry.assetLoaders());
+        if (bundled) {
+            sourceFile = bundled.sourceFile;
+            cacheText = bundled.text;
+        }
+    }
+    return { absoluteEntry, sourceText, sourceFile, cacheText };
+}
+/** Compile TypeScript source text to LLVM IR without touching the toolchain. */
+export function compileString(source, fileName = "input.ts", extensions, options = {}) {
+    const file = new SourceFile(fileName, source);
+    const diagnostics = new DiagnosticBag();
+    const parser = new Parser(file, diagnostics);
+    const sourceFile = parser.parseSourceFile();
+    const registry = extensions ?? createDefaultRegistry();
+    /* Code generation assumes a well-formed tree (binder and codegen both read
+     * required children), so never lower a file that already failed to parse. */
+    if (diagnostics.hasErrors)
+        return { ir: "", diagnostics: diagnostics.diagnostics };
+    const { ir } = generate(sourceFile, diagnostics, {
+        builtins: registry.builtins(),
+        modules: registry.modules(),
+        moduleHints: registry.moduleHints(),
+        debug: options.debug === true,
+    });
+    return { ir, diagnostics: diagnostics.diagnostics };
+}
+/**
+ * Compile a file to LLVM IR, bundling every reachable relative module first so
+ * that imports from other TypeScript sources resolve exactly like `build`.
+ */
+export function compileEntry(entryPath, extensions, options = {}) {
+    const registry = extensions ?? createDefaultRegistry();
+    const diagnostics = new DiagnosticBag();
+    const parsed = parseEntry(entryPath, registry, diagnostics);
+    if (diagnostics.hasErrors)
+        return { ir: "", diagnostics: diagnostics.diagnostics };
+    const { ir } = generate(parsed.sourceFile, diagnostics, {
+        builtins: registry.builtins(),
+        modules: registry.modules(),
+        moduleHints: registry.moduleHints(),
+        debug: options.debug === true,
+    });
+    return { ir, diagnostics: diagnostics.diagnostics };
+}
+//# sourceMappingURL=frontend.js.map

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

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

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

@@ -6,5 +6,5 @@ export { findClang, realRunner, ToolchainError, type Runner, } from "./toolchain
 export { resolveToolchain, type ResolvedToolchain, type ToolchainSource } from "./toolchain-provider.js";
 export { CONFIG_FILE_NAME, findProjectConfig, loadProjectConfig, parseProjectConfig, resolveConfigPaths, ProjectConfigError, type AppConfig, type LoadedProjectConfig, type ProjectConfig, } from "./config.js";
 export { ensureIconObject, iconSource, readIcon, toIcoBytes, pngToIco, ICON_SYMBOLS, EMPTY_ICON, IconError, type IconFormat, type IconInfo, } from "./icon.js";
-export { ensureWindowsIconResource, resolveResourceCompiler, type ResourceCompiler, type ResourceCompilerKind, } from "./win-icon.js";
+export { ensureWindowsIconResource, resolveResourceCompiler, type ResourceCompiler, } from "./win-icon.js";
 export { bundlePathFor, infoPlist, packageMacApp, type MacBundleOptions } from "./mac-bundle.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/driver/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAsD,MAAM,eAAe,CAAC;AAC3H,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC/H,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACL,SAAS,EACT,UAAU,EACV,cAAc,GAEf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAgD,MAAM,yBAAyB,CAAC;AACzG,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GAInB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,SAAS,GAGV,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GAGxB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAyB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/driver/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAsD,MAAM,eAAe,CAAC;AAC3H,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC/H,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACL,SAAS,EACT,UAAU,EACV,cAAc,GAEf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAgD,MAAM,yBAAyB,CAAC;AACzG,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GAInB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,SAAS,GAGV,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GAExB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAyB,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,64 @@
+/**
+ * Public option and result types for the build driver.
+ *
+ * They live apart from the orchestration in `compiler.ts` so a feature that
+ * adds one option touches this file (and the phase that consumes it) without
+ * colliding with unrelated driver work.
+ */
+import type { Diagnostic } from "../diagnostics/diagnostic.js";
+import type { ExtensionRegistry } from "../extensions/registry.js";
+import type { AppConfig } from "./config.js";
+import type { PgoMode, Runner } from "./toolchain.js";
+/** What `build` produces: an executable, an object file or LLVM IR only. */
+export type EmitKind = "exe" | "obj" | "ir";
+export interface BuildOptions {
+    /** Explicit output path (defaults to the source base name in `outDir`). */
+    readonly output?: string;
+    readonly outDir?: string;
+    readonly optimize?: "0" | "1" | "2" | "3";
+    readonly emit?: EmitKind;
+    readonly force?: boolean;
+    readonly verbose?: boolean;
+    readonly cacheDir?: string;
+    readonly extensions?: ExtensionRegistry;
+    readonly runner?: Runner;
+    readonly clang?: string;
+    /** Prefer a prebuilt `runtime/lib/<os>-<arch>/*.a` archive when present (default true). */
+    readonly preferPrebuilt?: boolean;
+    readonly write?: boolean;
+    /** Application icon embedded into the binary (shorthand for `app.icon`). */
+    readonly icon?: string;
+    /** Application metadata: name, icon and macOS bundle settings. */
+    readonly app?: AppConfig;
+    /** Emit LLVM debug metadata so `-g` produces DWARF/CodeView (default false). */
+    readonly debug?: boolean;
+    /** Compile the program and runtime to LTO bitcode and link with lld. */
+    readonly lto?: boolean;
+    /**
+     * Profile-guided optimization. `generate` builds an instrumented binary that
+     * writes `.profraw` files into `pgoDir`; `use` consumes them.
+     */
+    readonly pgo?: PgoMode;
+    /** Profile directory (default: `<outDir>/pgo`). */
+    readonly pgoDir?: string;
+}
+/** One phase of a build, in milliseconds (reported by `--time`). */
+export interface PhaseTiming {
+    readonly phase: "frontend" | "codegen" | "runtime" | "clang" | "link";
+    readonly ms: number;
+}
+export interface BuildResult {
+    readonly outputPath: string;
+    readonly irPath?: string;
+    readonly cached: boolean;
+    readonly diagnostics: readonly Diagnostic[];
+    readonly ir?: string;
+    /** macOS `.app` bundle produced by `app.bundle` (darwin only). */
+    readonly bundlePath?: string;
+    /** Per-phase timings, collected for `xbintsc build --time`. */
+    readonly timings?: readonly PhaseTiming[];
+}
+export interface CompileStringResult {
+    readonly ir: string;
+    readonly diagnostics: readonly Diagnostic[];
+}

package/dist/src/driver/options.js

@@ -0,0 +1,9 @@
+/**
+ * Public option and result types for the build driver.
+ *
+ * They live apart from the orchestration in `compiler.ts` so a feature that
+ * adds one option touches this file (and the phase that consumes it) without
+ * colliding with unrelated driver work.
+ */
+export {};
+//# sourceMappingURL=options.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/driver/options.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

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

@@ -0,0 +1,38 @@
+/**
+ * Compiling the C runtime (and every extension's C sources) into linkable
+ * objects, reusing cached objects keyed by the source/header content hash.
+ *
+ * `RUNTIME_SOURCES` is the list of core translation units. A feature that adds
+ * a runtime file adds one line here and nowhere else.
+ */
+import type { ExtensionRegistry } from "../extensions/registry.js";
+import { type PgoMode, type Runner } from "./toolchain.js";
+/** Core runtime translation units (each compiled and cached independently). */
+export declare const RUNTIME_SOURCES: readonly ["xt_alloc.c", "xt_values.c", "xt_bigint.c", "xt_containers.c", "xt_weak.c", "xt_typed_array.c", "xt_stdlib.c", "xt_stdlib2.c", "xt_promise.c", "xt_async.c", "xt_loop.c", "xt_async_io.c", "xt_generator.c", "xt_coroutine.c", "xt_fetch.c", "xt_symbol.c", "xt_builtins.c", "xt_constructors.c", "xt_structured_clone.c", "xt_performance.c", "xt_text_codec.c", "xt_url.c", "xt_array_buffer.c", "xt_io.c"];
+export interface RuntimeObjects {
+    readonly runtimeObjects: readonly string[];
+    readonly extensionObjects: readonly string[];
+    /** Pre-built C++/Rust objects and archives contributed by native extensions. */
+    readonly nativeObjects: readonly string[];
+}
+export interface RuntimeObjectsOptions {
+    readonly runner: Runner;
+    readonly clang: string;
+    readonly runtimeDir: string;
+    readonly cacheDir: string;
+    readonly registry: ExtensionRegistry;
+    readonly preferPrebuilt: boolean;
+    readonly env: Record<string, string>;
+    readonly lto: boolean;
+    readonly pgo: PgoMode | undefined;
+    readonly pgoDir: string;
+}
+/**
+ * Compile the core runtime and every extension source, reusing cached object
+ * files keyed on the C source hash. Returns the object paths to link.
+ *
+ * When `preferPrebuilt` is set, a shipped static archive
+ * (`runtime/lib/<os>-<arch>/{core,ext_<name>}.a`) is used instead of compiling
+ * that group's C sources. Missing archives fall back to compiling the sources.
+ */
+export declare function ensureRuntimeObjects(options: RuntimeObjectsOptions): RuntimeObjects;

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

@@ -0,0 +1,112 @@
+/**
+ * Compiling the C runtime (and every extension's C sources) into linkable
+ * objects, reusing cached objects keyed by the source/header content hash.
+ *
+ * `RUNTIME_SOURCES` is the list of core translation units. A feature that adds
+ * a runtime file adds one line here and nowhere else.
+ */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { basename, join, resolve } from "node:path";
+import { hashParts } from "./cache.js";
+import { findRuntimeLibrary } from "./runtime-lib.js";
+import { compileC, optimizationFlags, RUNTIME_CFLAGS } from "./toolchain.js";
+import { COMPILER_VERSION } from "./version.js";
+/** Core runtime translation units (each compiled and cached independently). */
+export const RUNTIME_SOURCES = [
+    "xt_alloc.c",
+    "xt_values.c",
+    "xt_bigint.c",
+    "xt_containers.c",
+    "xt_weak.c",
+    "xt_typed_array.c",
+    "xt_stdlib.c",
+    "xt_stdlib2.c",
+    "xt_promise.c",
+    "xt_async.c",
+    "xt_loop.c",
+    "xt_async_io.c",
+    "xt_generator.c",
+    "xt_coroutine.c",
+    "xt_fetch.c",
+    "xt_symbol.c",
+    "xt_builtins.c",
+    "xt_constructors.c",
+    "xt_structured_clone.c",
+    "xt_performance.c",
+    "xt_text_codec.c",
+    "xt_url.c",
+    "xt_array_buffer.c",
+    "xt_io.c",
+];
+/**
+ * Compile the core runtime and every extension source, reusing cached object
+ * files keyed on the C source hash. Returns the object paths to link.
+ *
+ * When `preferPrebuilt` is set, a shipped static archive
+ * (`runtime/lib/<os>-<arch>/{core,ext_<name>}.a`) is used instead of compiling
+ * that group's C sources. Missing archives fall back to compiling the sources.
+ */
+export function ensureRuntimeObjects(options) {
+    const { runner, clang, runtimeDir, cacheDir, registry, preferPrebuilt, env, lto, pgo, pgoDir } = options;
+    const optimization = optimizationFlags(lto, pgo, pgoDir);
+    /* Runtime objects depend on the shared headers (rt.h/rt_internal.h/...) and
+       the `#include`d implementation fragments (`.inc`), so any change to them
+       must invalidate every cached object. Hash them all. */
+    const headerParts = [];
+    const collectHeaders = (dir) => {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            const full = join(dir, entry.name);
+            if (entry.isDirectory())
+                collectHeaders(full);
+            else if (entry.name.endsWith(".h") || entry.name.endsWith(".inc"))
+                headerParts.push(readFileSync(full, "utf8"));
+        }
+    };
+    collectHeaders(runtimeDir);
+    const headerStamp = hashParts(headerParts);
+    const compileOne = (sourcePath, tag) => {
+        const body = readFileSync(sourcePath, "utf8");
+        const key = hashParts([
+            "runtime",
+            COMPILER_VERSION,
+            RUNTIME_CFLAGS.join(" "),
+            optimization.join(" "),
+            tag,
+            headerStamp,
+            body,
+            clang,
+            process.platform,
+        ]);
+        const objectPath = join(cacheDir, `${tag}-${key}.o`);
+        if (!existsSync(objectPath)) {
+            compileC(runner, clang, sourcePath, objectPath, runtimeDir, env, optimization);
+        }
+        return objectPath;
+    };
+    const coreArchive = preferPrebuilt ? findRuntimeLibrary("core") : undefined;
+    const runtimeObjects = coreArchive
+        ? [coreArchive]
+        : RUNTIME_SOURCES.map((source) => compileOne(join(runtimeDir, source), basename(source, ".c")));
+    const extensionObjects = [];
+    const seen = new Set();
+    for (const extension of registry.all()) {
+        const sources = extension.runtimeSources ? extension.runtimeSources() : [];
+        if (sources.length === 0)
+            continue;
+        const archive = preferPrebuilt ? findRuntimeLibrary(`ext_${extension.name}`) : undefined;
+        if (archive) {
+            extensionObjects.push(archive);
+            continue;
+        }
+        for (const sourcePath of sources) {
+            const dedupeKey = resolve(sourcePath);
+            if (seen.has(dedupeKey))
+                continue;
+            seen.add(dedupeKey);
+            extensionObjects.push(compileOne(sourcePath, `ext_${extensionObjects.length}_${basename(sourcePath, ".c")}`));
+        }
+    }
+    // A native archive may be shared by several manifests; link each once.
+    return { runtimeObjects, extensionObjects, nativeObjects: [...new Set(registry.nativeObjects())] };
+}
+//# sourceMappingURL=runtime-objects.js.map

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

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

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

@@ -17,6 +17,10 @@
  * The version is checked here, not left to the first failed C compile: the
  * emitted IR needs LLVM 16+ (opaque pointers), and a "clang 15 is too old"
  * error up front is far more actionable than a wall of IR type errors later.
+ * On Windows the target is checked as well: only an MSVC-targeting clang can
+ * link against the runtime, so a compiler built for another Windows ABI is
+ * skipped (or rejected, when named explicitly) instead of producing objects
+ * the linker cannot mix.
  *
  * Extra linker arguments (for example `-fuse-ld=lld`) can be supplied through
  * `xbintsc_LINKER_ARGS`.

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

@@ -17,6 +17,10 @@
  * The version is checked here, not left to the first failed C compile: the
  * emitted IR needs LLVM 16+ (opaque pointers), and a "clang 15 is too old"
  * error up front is far more actionable than a wall of IR type errors later.
+ * On Windows the target is checked as well: only an MSVC-targeting clang can
+ * link against the runtime, so a compiler built for another Windows ABI is
+ * skipped (or rejected, when named explicitly) instead of producing objects
+ * the linker cannot mix.
  *
  * Extra linker arguments (for example `-fuse-ld=lld`) can be supplied through
  * `xbintsc_LINKER_ARGS`.

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

@@ -1 +1 @@
-{"version":3,"file":"toolchain-provider.js","sourceRoot":"","sources":["../../../src/driver/toolchain-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAkC,MAAM,gBAAgB,CAAC;AAkBzF,SAAS,UAAU,CAAC,QAA2B;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAC5C,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;AACvB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,SAAiB,UAAU;IAC1D,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,OAAO;QACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;QAC1B,GAAG,EAAE,EAAE;KACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"toolchain-provider.js","sourceRoot":"","sources":["../../../src/driver/toolchain-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAkC,MAAM,gBAAgB,CAAC;AAkBzF,SAAS,UAAU,CAAC,QAA2B;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAC5C,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;AACvB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,SAAiB,UAAU;IAC1D,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,OAAO;QACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;QAC1B,GAAG,EAAE,EAAE;KACR,CAAC;AACJ,CAAC"}

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

@@ -42,6 +42,8 @@ export interface ClangProbe {
     /** True when the command ran and exited 0. */
     readonly responds: boolean;
     readonly version?: ClangVersion;
+    /** The `Target:` triple clang was built for, when it prints one. */
+    readonly target?: string;
     /** First line of the version output, for diagnostics. */
     readonly summary: string;
 }
@@ -58,6 +60,15 @@ export interface ClangLocation {
  * gcc, which `cc` may resolve to).
  */
 export declare function parseClangVersion(output: string): ClangVersion | undefined;
+/**
+ * Extract the `Target:` triple from `clang --version` output. Windows builds
+ * must target the MSVC ABI; clang built for a GNU/Windows or other triple emits
+ * objects that cannot be linked into an xbintsc executable (see
+ * {@link isMsvcTarget}).
+ */
+export declare function parseClangTarget(output: string): string | undefined;
+/** True when a clang target triple uses the MSVC ABI on Windows. */
+export declare function isMsvcTarget(target: string): boolean;
 /** Run `<command> --version` and classify the result. Never throws. */
 export declare function probeClang(runner: Runner, command: string, env?: Record<string, string>): ClangProbe;
 /** Commands probed for a system compiler, in preference order. */
@@ -75,6 +86,10 @@ export declare function systemClangCandidates(): string[];
 export declare function locateClang(runner?: Runner): ClangLocation;
 /** Locate a supported clang-compatible C compiler, or throw a clear error. */
 export declare function findClang(runner?: Runner): string;
+/** Profile-guided optimization stage (`--pgo-generate` / `--pgo-use`). */
+export type PgoMode = "generate" | "use";
+/** clang flags for LTO and the selected PGO stage. */
+export declare function optimizationFlags(lto: boolean | undefined, pgo: PgoMode | undefined, pgoDir: string | undefined): string[];
 export interface CompileIrOptions {
     readonly clang: string;
     readonly irPath: string;
@@ -83,6 +98,11 @@ export interface CompileIrOptions {
     readonly env?: Record<string, string>;
     /** Emit debug info (`-g`) and keep frame pointers for crash backtraces. */
     readonly debug?: boolean;
+    /** Compile to LTO bitcode and let the linker optimize across units. */
+    readonly lto?: boolean;
+    /** Instrument (`generate`) or consume (`use`) an LLVM profile. */
+    readonly pgo?: PgoMode;
+    readonly pgoDir?: string;
 }
 /** Compile an LLVM IR file to a native object file. */
 export declare function compileIr(runner: Runner, options: CompileIrOptions): void;
@@ -93,6 +113,9 @@ export interface LinkOptions {
     readonly linkerFlags: readonly string[];
     readonly optimize: string;
     readonly env?: Record<string, string>;
+    readonly lto?: boolean;
+    readonly pgo?: PgoMode;
+    readonly pgoDir?: string;
 }
 export declare function link(runner: Runner, options: LinkOptions): void;
 /**
@@ -102,4 +125,12 @@ export declare function link(runner: Runner, options: LinkOptions): void;
  */
 export declare const RUNTIME_CFLAGS: readonly ["-O2", "-Wall", "-Wextra", "-D_CRT_SECURE_NO_WARNINGS", ...string[]];
 /** 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, env?: Record<string, string>): void;
+export declare function compileC(runner: Runner, clang: string, sourcePath: string, objectPath: string, includeDir: string, env?: Record<string, string>, extraFlags?: readonly string[]): void;
+/**
+ * Merge the `.profraw` files written by an instrumented binary into the
+ * `default.profdata` that `-fprofile-use=<dir>` expects. Clang's `-fprofile-use`
+ * does not read raw profiles directly; this runs `llvm-profdata merge`.
+ *
+ * `xbintsc_LLVM_PROFDATA` selects the tool when it is not on `PATH`.
+ */
+export declare function mergeProfileData(runner: Runner, directory: string, clang: string, env?: Record<string, string>): void;