xbintsc 0.1.0

package/dist/src/driver/compiler.js

@@ -0,0 +1,128 @@
+/**
+ * The build driver: source file in, native binary out.
+ *
+ * Pipeline: read -> parse -> bind/check -> LLVM IR -> object -> link.
+ * The runtime (and any registered extension sources) are compiled once and
+ * cached, and the whole build is skipped when the incremental cache says
+ * nothing relevant changed.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, extname, join, resolve } from "node:path";
+import { DiagnosticBag } from "../diagnostics/diagnostic.js";
+import { SourceFile } from "../diagnostics/source.js";
+import { Parser } from "../parser/parser.js";
+import { generate } from "../codegen/llvm.js";
+import { createDefaultRegistry } from "../extensions/registry.js";
+import { BuildCache, hashParts } from "./cache.js";
+import { findRuntimeDir } from "./paths.js";
+import { compileC, compileIr, findClang, link, realRunner, } from "./toolchain.js";
+export const COMPILER_VERSION = "0.1.0";
+/** Compile TypeScript source text to LLVM IR without touching the toolchain. */
+export function compileString(source, fileName = "input.ts", extensions) {
+    const file = new SourceFile(fileName, source);
+    const diagnostics = new DiagnosticBag();
+    const parser = new Parser(file, diagnostics);
+    const sourceFile = parser.parseSourceFile();
+    const registry = extensions ?? createDefaultRegistry();
+    const { ir } = generate(sourceFile, diagnostics, { builtins: registry.builtins() });
+    return { ir, diagnostics: diagnostics.diagnostics };
+}
+function executableName(entry, outDir, explicit) {
+    if (explicit)
+        return resolve(explicit);
+    const base = basename(entry, extname(entry));
+    const suffix = process.platform === "win32" ? ".exe" : "";
+    return resolve(outDir, base + suffix);
+}
+export function build(entryPath, options = {}) {
+    const runner = options.runner ?? realRunner;
+    const registry = options.extensions ?? createDefaultRegistry();
+    const outDir = resolve(options.outDir ?? join(process.cwd(), "build"));
+    const cacheDir = resolve(options.cacheDir ?? join(process.cwd(), ".xbintsc"));
+    const emit = options.emit ?? "exe";
+    const optimize = options.optimize ?? "2";
+    const absoluteEntry = resolve(entryPath);
+    const sourceText = readFileSync(absoluteEntry, "utf8");
+    const baseName = basename(absoluteEntry, extname(absoluteEntry));
+    const outputPath = emit === "ir"
+        ? resolve(options.output ?? join(outDir, baseName + ".ll"))
+        : emit === "obj"
+            ? resolve(options.output ?? join(outDir, baseName + ".o"))
+            : executableName(absoluteEntry, outDir, options.output);
+    const cacheKey = hashParts([
+        COMPILER_VERSION,
+        sourceText,
+        emit,
+        optimize,
+        process.platform,
+        registry.all().map((e) => e.name).join(","),
+    ]);
+    const cache = new BuildCache(cacheDir);
+    const outputs = [outputPath];
+    if (!options.force && cache.isFresh(cacheKey, outputs)) {
+        return { outputPath, cached: true, diagnostics: [] };
+    }
+    // -- front end -----------------------------------------------------------
+    const file = new SourceFile(absoluteEntry, sourceText);
+    const diagnostics = new DiagnosticBag();
+    const parser = new Parser(file, diagnostics);
+    const sourceFile = parser.parseSourceFile();
+    const { ir } = generate(sourceFile, diagnostics, { builtins: registry.builtins() });
+    if (options.verbose) {
+        process.stderr.write(`xbintsc: generated ${ir.length} bytes of LLVM IR\n`);
+    }
+    if (diagnostics.hasErrors) {
+        return { outputPath, cached: false, diagnostics: diagnostics.diagnostics, ir };
+    }
+    mkdirSync(outDir, { recursive: true });
+    const irPath = resolve(outDir, basename(absoluteEntry, extname(absoluteEntry)) + ".ll");
+    writeFileSync(irPath, ir);
+    if (emit === "ir") {
+        cache.record(cacheKey, outputs);
+        cache.save();
+        return { outputPath, irPath, cached: false, diagnostics: [], ir };
+    }
+    // -- toolchain -----------------------------------------------------------
+    const clang = options.clang ?? findClang(runner);
+    const runtimeDir = findRuntimeDir();
+    mkdirSync(cacheDir, { recursive: true });
+    const { runtimeObject, extensionObjects } = ensureRuntimeObjects(runner, clang, runtimeDir, cacheDir, registry);
+    const objectPath = emit === "obj" ? outputPath : resolve(outDir, baseName + ".o");
+    compileIr(runner, { clang, irPath, objectPath, optimize });
+    if (emit === "obj") {
+        cache.record(cacheKey, outputs);
+        cache.save();
+        return { outputPath, irPath, cached: false, diagnostics: [], ir };
+    }
+    link(runner, {
+        clang,
+        objectPaths: [objectPath, runtimeObject, ...extensionObjects],
+        outputPath,
+        linkerFlags: [...(process.platform === "win32" ? [] : ["-lm"]), ...registry.linkerFlags()],
+        optimize,
+    });
+    cache.record(cacheKey, outputs);
+    cache.save();
+    return { outputPath, irPath, cached: false, diagnostics: [], ir };
+}
+/**
+ * Compile the core runtime and every extension source, reusing cached object
+ * files keyed on the C source hash. Returns the object paths to link.
+ */
+function ensureRuntimeObjects(runner, clang, runtimeDir, cacheDir, registry) {
+    const compileOne = (sourcePath, tag) => {
+        const body = readFileSync(sourcePath, "utf8");
+        const key = hashParts(["runtime", COMPILER_VERSION, tag, body, clang, process.platform]);
+        const objectPath = join(cacheDir, `${tag}-${key}.o`);
+        if (!existsSync(objectPath)) {
+            compileC(runner, clang, sourcePath, objectPath, runtimeDir);
+        }
+        return objectPath;
+    };
+    const runtimeObject = compileOne(join(runtimeDir, "xt_runtime.c"), "xt_runtime");
+    const extensionObjects = registry
+        .runtimeSources()
+        .map((sourcePath, index) => compileOne(sourcePath, `ext_${index}_${basename(sourcePath, ".c")}`));
+    return { runtimeObject, extensionObjects };
+}
+//# sourceMappingURL=compiler.js.map

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

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

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

@@ -0,0 +1,4 @@
+export { build, compileString, COMPILER_VERSION, type BuildOptions, type BuildResult, type EmitKind } from "./compiler.js";
+export { BuildCache, hashParts, hashString } from "./cache.js";
+export { findRuntimeDir, findPackageRoot } from "./paths.js";
+export { findClang, realRunner, ToolchainError, type Runner } from "./toolchain.js";

package/dist/src/driver/index.js

@@ -0,0 +1,5 @@
+export { build, compileString, COMPILER_VERSION } from "./compiler.js";
+export { BuildCache, hashParts, hashString } from "./cache.js";
+export { findRuntimeDir, findPackageRoot } from "./paths.js";
+export { findClang, realRunner, ToolchainError } from "./toolchain.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAe,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,4 @@
+/** Filesystem locations owned by the compiler package. */
+/** Directory containing `rt.h` and the runtime/ext C sources. */
+export declare function findRuntimeDir(): string;
+export declare function findPackageRoot(): string;

package/dist/src/driver/paths.js

@@ -0,0 +1,22 @@
+/** Filesystem locations owned by the compiler package. */
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const here = dirname(fileURLToPath(import.meta.url));
+/** Directory containing `rt.h` and the runtime/ext C sources. */
+export function findRuntimeDir() {
+    const candidates = [
+        resolve(here, "../../runtime"),
+        resolve(here, "../../../runtime"),
+        resolve(process.cwd(), "runtime"),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(join(candidate, "rt.h")))
+            return candidate;
+    }
+    throw new Error("Unable to locate the xbintsc runtime directory (missing runtime/rt.h)");
+}
+export function findPackageRoot() {
+    return resolve(findRuntimeDir(), "..");
+}
+//# sourceMappingURL=paths.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,43 @@
+/**
+ * Thin wrappers around the external toolchain (clang) and process execution.
+ *
+ * Everything that shells out lives here so the rest of the driver stays
+ * testable: unit tests can pass a fake `Runner` and never touch the host.
+ */
+export interface CommandResult {
+    readonly status: number;
+    readonly stdout: string;
+    readonly stderr: string;
+}
+export interface Runner {
+    run(command: string, args: readonly string[], options?: {
+        cwd?: string;
+    }): CommandResult;
+}
+export declare const realRunner: Runner;
+export declare class ToolchainError extends Error {
+    readonly command: string;
+    readonly status: number;
+    readonly stderr: string;
+    constructor(command: string, status: number, stderr: string);
+}
+/** Locate a clang-compatible C compiler, honouring `xbintsc_CLANG`. */
+export declare function findClang(runner?: Runner): string;
+export interface CompileIrOptions {
+    readonly clang: string;
+    readonly irPath: string;
+    readonly objectPath: string;
+    readonly optimize: string;
+}
+/** Compile an LLVM IR file to a native object file. */
+export declare function compileIr(runner: Runner, options: CompileIrOptions): void;
+export interface LinkOptions {
+    readonly clang: string;
+    readonly objectPaths: readonly string[];
+    readonly outputPath: string;
+    readonly linkerFlags: readonly string[];
+    readonly optimize: 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;

package/dist/src/driver/toolchain.js

@@ -0,0 +1,76 @@
+/**
+ * Thin wrappers around the external toolchain (clang) and process execution.
+ *
+ * Everything that shells out lives here so the rest of the driver stays
+ * testable: unit tests can pass a fake `Runner` and never touch the host.
+ */
+import { spawnSync } from "node:child_process";
+export const realRunner = {
+    run(command, args, options = {}) {
+        const spawnOptions = {
+            cwd: options.cwd,
+            encoding: "utf8",
+            maxBuffer: 64 * 1024 * 1024,
+        };
+        const result = spawnSync(command, [...args], spawnOptions);
+        return {
+            status: result.status ?? (result.error ? 1 : 0),
+            stdout: result.stdout?.toString() ?? "",
+            stderr: result.stderr?.toString() ?? (result.error ? String(result.error.message) : ""),
+        };
+    },
+};
+export class ToolchainError extends Error {
+    command;
+    status;
+    stderr;
+    constructor(command, status, stderr) {
+        super(`Command failed (${status}): ${command}\n${stderr}`);
+        this.name = "ToolchainError";
+        this.command = command;
+        this.status = status;
+        this.stderr = stderr;
+    }
+}
+/** Locate a clang-compatible C compiler, honouring `xbintsc_CLANG`. */
+export function findClang(runner = realRunner) {
+    const candidates = [
+        process.env.xbintsc_CLANG,
+        "clang",
+        "clang-18",
+        "clang-17",
+        "clang-16",
+        "cc",
+    ].filter((candidate) => Boolean(candidate));
+    for (const candidate of candidates) {
+        const result = runner.run(candidate, ["--version"]);
+        if (result.status === 0)
+            return candidate;
+    }
+    throw new ToolchainError("clang --version", 1, "No C compiler found. Set xbintsc_CLANG to a clang binary.");
+}
+/** 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,
+    ]);
+    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);
+    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", "-c", sourcePath, "-o", objectPath, `-I${includeDir}`]);
+    if (result.status !== 0)
+        throw new ToolchainError(`${clang} ${sourcePath}`, result.status, result.stderr);
+}
+//# sourceMappingURL=toolchain.js.map

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * Node.js compatibility extension.
+ *
+ * Registering it links `runtime/ext_node.c` and exposes the builtins it
+ * implements, so `readFileSync("...")` in TypeScript resolves to the C
+ * implementation without the core compiler knowing anything about Node.
+ */
+import type { Extension } from "./registry.js";
+export declare const nodeExtension: Extension;

package/dist/src/extensions/node.js

@@ -0,0 +1,20 @@
+/**
+ * Node.js compatibility extension.
+ *
+ * Registering it links `runtime/ext_node.c` and exposes the builtins it
+ * implements, so `readFileSync("...")` in TypeScript resolves to the C
+ * implementation without the core compiler knowing anything about Node.
+ */
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+const here = dirname(fileURLToPath(import.meta.url));
+export const nodeExtension = {
+    name: "node",
+    description: "Node.js host APIs (readFileSync, ...)",
+    runtimeSources: () => [resolve(here, "../../runtime/ext_node.c")],
+    builtins: () => ({
+        readFileSync: { symbol: "xt_node_read_text_file" },
+        readTextFile: { symbol: "xt_node_read_text_file" },
+    }),
+};
+//# sourceMappingURL=node.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../src/extensions/node.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG7C,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAErD,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,uCAAuC;IACpD,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAC;IACjE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;QACf,YAAY,EAAE,EAAE,MAAM,EAAE,wBAAwB,EAAE;QAClD,YAAY,EAAE,EAAE,MAAM,EAAE,wBAAwB,EAAE;KACnD,CAAC;CACH,CAAC"}

package/dist/src/extensions/registry.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Pluggable compile modules ("extensions").
+ *
+ * An extension teaches xbintsc about a host platform: additional C runtime
+ * sources to link, libraries to pass to the linker, and global functions that
+ * resolve to runtime symbols. Node's `fs`, Bun's `Bun.file`, ... all fit this
+ * shape, so the core compiler never has to grow platform specific branches.
+ *
+ * The default registry ships an empty baseline; callers register the
+ * extensions they need before invoking the driver.
+ */
+export interface BuiltinFunction {
+    /** Exported C symbol, called as `xt_value symbol(int32_t argc, xt_value *argv)`. */
+    readonly symbol: string;
+    readonly returnVoid?: boolean;
+}
+export interface Extension {
+    readonly name: string;
+    /** Description shown by `xbintsc ext list`. */
+    readonly description?: string;
+    /** C/asm sources compiled and linked alongside the generated module. */
+    runtimeSources?(): readonly string[];
+    /** Extra linker flags (e.g. `["-lm"]`, `["-framework", "CoreFoundation"]`). */
+    linkerFlags?(): readonly string[];
+    /** Global identifiers that resolve to runtime symbols when called. */
+    builtins?(): Readonly<Record<string, BuiltinFunction>>;
+}
+export declare class ExtensionRegistry {
+    private readonly extensions;
+    register(extension: Extension): this;
+    unregister(name: string): boolean;
+    get(name: string): Extension | undefined;
+    has(name: string): boolean;
+    all(): readonly Extension[];
+    /** Flatten every registered builtin into one lookup table. */
+    builtins(): Readonly<Record<string, BuiltinFunction>>;
+    runtimeSources(): readonly string[];
+    linkerFlags(): readonly string[];
+}
+/**
+ * A built-in extension that exposes the runtime's own console/IO helpers. It is
+ * always present so `console.log` works even without a platform extension.
+ */
+export declare const coreExtension: Extension;
+export declare function createDefaultRegistry(): ExtensionRegistry;

package/dist/src/extensions/registry.js

@@ -0,0 +1,76 @@
+/**
+ * Pluggable compile modules ("extensions").
+ *
+ * An extension teaches xbintsc about a host platform: additional C runtime
+ * sources to link, libraries to pass to the linker, and global functions that
+ * resolve to runtime symbols. Node's `fs`, Bun's `Bun.file`, ... all fit this
+ * shape, so the core compiler never has to grow platform specific branches.
+ *
+ * The default registry ships an empty baseline; callers register the
+ * extensions they need before invoking the driver.
+ */
+export class ExtensionRegistry {
+    extensions = new Map();
+    register(extension) {
+        if (this.extensions.has(extension.name)) {
+            throw new Error(`Extension '${extension.name}' is already registered`);
+        }
+        this.extensions.set(extension.name, extension);
+        return this;
+    }
+    unregister(name) {
+        return this.extensions.delete(name);
+    }
+    get(name) {
+        return this.extensions.get(name);
+    }
+    has(name) {
+        return this.extensions.has(name);
+    }
+    all() {
+        return [...this.extensions.values()];
+    }
+    /** Flatten every registered builtin into one lookup table. */
+    builtins() {
+        const merged = {};
+        for (const extension of this.extensions.values()) {
+            const builtins = extension.builtins?.();
+            if (builtins)
+                Object.assign(merged, builtins);
+        }
+        return merged;
+    }
+    runtimeSources() {
+        const sources = [];
+        for (const extension of this.extensions.values()) {
+            const extra = extension.runtimeSources?.();
+            if (extra)
+                sources.push(...extra);
+        }
+        return sources;
+    }
+    linkerFlags() {
+        const flags = [];
+        for (const extension of this.extensions.values()) {
+            const extra = extension.linkerFlags?.();
+            if (extra)
+                flags.push(...extra);
+        }
+        return flags;
+    }
+}
+/**
+ * A built-in extension that exposes the runtime's own console/IO helpers. It is
+ * always present so `console.log` works even without a platform extension.
+ */
+export const coreExtension = {
+    name: "core",
+    description: "Core runtime helpers (console, print)",
+    builtins: () => ({
+        print: { symbol: "xt_println" },
+    }),
+};
+export function createDefaultRegistry() {
+    return new ExtensionRegistry().register(coreExtension);
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/extensions/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/extensions/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAoBH,MAAM,OAAO,iBAAiB;IACX,UAAU,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE3D,QAAQ,CAAC,SAAoB;QAC3B,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,cAAc,SAAS,CAAC,IAAI,yBAAyB,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,8DAA8D;IAC9D,QAAQ;QACN,MAAM,MAAM,GAAoC,EAAE,CAAC;QACnD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YACjD,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC;YACxC,IAAI,QAAQ;gBAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,cAAc;QACZ,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,SAAS,CAAC,cAAc,EAAE,EAAE,CAAC;YAC3C,IAAI,KAAK;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,WAAW;QACT,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;YACxC,IAAI,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,uCAAuC;IACpD,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;QACf,KAAK,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE;KAChC,CAAC;CACH,CAAC;AAEF,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,iBAAiB,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;AACzD,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * xbintsc public API surface.
+ *
+ * Re-exports the compiler pipeline so the CLI, tests and embedding tools can
+ * compose stages (lex, parse, bind, generate) without depending on internals.
+ */
+export { SourceFile, hashText, combineHashes } from "./diagnostics/source.js";
+export { DiagnosticBag, DiagnosticCode, DiagnosticError, formatDiagnostic, formatDiagnostics, type Diagnostic, } from "./diagnostics/diagnostic.js";
+export { Scanner } from "./lexer/scanner.js";
+export { TokenKind, KEYWORDS, type Token } from "./lexer/token.js";
+export * from "./ast/nodes.js";
+export { Parser } from "./parser/parser.js";
+export { bind, SymbolKind, ScopeKind, type BindResult, type FunctionInfo, type SymbolInfo } from "./binder/binder.js";
+export { generate, type CodegenResult, type CodegenOptions } from "./codegen/llvm.js";
+export { XT_UNDEFINED, XT_NULL, XT_TRUE, XT_FALSE, numberLiteral, booleanLiteral, } from "./codegen/values.js";
+export { ExtensionRegistry, createDefaultRegistry, coreExtension, type Extension } from "./extensions/registry.js";
+export { nodeExtension } from "./extensions/node.js";
+export * from "./driver/index.js";

package/dist/src/index.js

@@ -0,0 +1,19 @@
+/**
+ * xbintsc public API surface.
+ *
+ * Re-exports the compiler pipeline so the CLI, tests and embedding tools can
+ * compose stages (lex, parse, bind, generate) without depending on internals.
+ */
+export { SourceFile, hashText, combineHashes } from "./diagnostics/source.js";
+export { DiagnosticBag, DiagnosticCode, DiagnosticError, formatDiagnostic, formatDiagnostics, } from "./diagnostics/diagnostic.js";
+export { Scanner } from "./lexer/scanner.js";
+export { TokenKind, KEYWORDS } from "./lexer/token.js";
+export * from "./ast/nodes.js";
+export { Parser } from "./parser/parser.js";
+export { bind, SymbolKind, ScopeKind } from "./binder/binder.js";
+export { generate } from "./codegen/llvm.js";
+export { XT_UNDEFINED, XT_NULL, XT_TRUE, XT_FALSE, numberLiteral, booleanLiteral, } from "./codegen/values.js";
+export { ExtensionRegistry, createDefaultRegistry, coreExtension } from "./extensions/registry.js";
+export { nodeExtension } from "./extensions/node.js";
+export * from "./driver/index.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EACL,aAAa,EACb,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAElB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAc,MAAM,kBAAkB,CAAC;AACnE,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAuD,MAAM,oBAAoB,CAAC;AACtH,OAAO,EAAE,QAAQ,EAA2C,MAAM,mBAAmB,CAAC;AACtF,OAAO,EACL,YAAY,EACZ,OAAO,EACP,OAAO,EACP,QAAQ,EACR,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,aAAa,EAAkB,MAAM,0BAA0B,CAAC;AACnH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,cAAc,mBAAmB,CAAC"}

package/dist/src/lexer/scanner.d.ts

@@ -0,0 +1,48 @@
+import { DiagnosticBag } from "../diagnostics/diagnostic.js";
+import type { SourceFile } from "../diagnostics/source.js";
+import { Token } from "./token.js";
+/**
+ * Hand-written scanner for the TypeScript language. It produces a flat token
+ * stream consumed by the parser. Comments and trivia are skipped, but line
+ * breaks are tracked so the parser can implement ASI (automatic semicolon
+ * insertion) correctly.
+ */
+export declare class Scanner {
+    private readonly text;
+    private pos;
+    private readonly diagnostics;
+    private readonly source;
+    private _token;
+    constructor(source: SourceFile, diagnostics: DiagnosticBag);
+    get token(): Token;
+    get position(): number;
+    /**
+     * Reset the scanner read head. Used by the parser to re-scan the `}` that
+     * terminates a template substitution as template text instead of a brace.
+     */
+    seek(offset: number): void;
+    /** Advance to the next token. */
+    nextToken(): Token;
+    /** Scan everything, useful for lexer tests. */
+    tokenize(): Token[];
+    private error;
+    private scan;
+    private makeToken;
+    private scanIdentifier;
+    private scanNumber;
+    private finishNumber;
+    private scanString;
+    private scanEscapeSequence;
+    /** Scans a template literal chunk starting at a backtick or after `}`. */
+    scanTemplate(start: number, precededByLineBreak: boolean, isHead: boolean): Token;
+    /** Called by the parser after a template substitution expression. */
+    continueTemplate(offset: number): Token;
+    /**
+     * True when a `/` in this position starts a regular expression rather than a
+     * division. The decision is made from the previous significant token.
+     */
+    private regexAllowed;
+    /** Scan a `/pattern/flags` literal, starting at the leading slash. */
+    private scanRegex;
+    private scanPunctuation;
+}