xbintsc 0.3.18 → 0.3.35

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

@@ -0,0 +1,62 @@
+/**
+ * Compile-time application icons.
+ *
+ * `--icon <file>` (or `app.icon` in `xbintsc.config.json`) reads an icon,
+ * validates it and embeds the raw bytes into the produced binary as a small
+ * linkable object. The `gui` extension picks the symbols up (weakly) to set the
+ * window / Dock icon; the Windows driver additionally turns the icon into a PE
+ * resource so Explorer and the taskbar show it. The core compiler never sees
+ * any of this — it is a driver concern, exactly like the per-platform linker
+ * flags.
+ *
+ * Supported inputs: `.png` (canonical), `.ico` and `.icns` (best effort on their
+ * home platform).
+ */
+import { type Runner } from "./toolchain.js";
+export type IconFormat = "png" | "ico" | "icns";
+export interface IconInfo {
+    /** Absolute path the icon was read from. */
+    readonly path: string;
+    readonly format: IconFormat;
+    readonly bytes: Uint8Array;
+    /** Intrinsic size where it is cheap to sniff (0 when unknown, e.g. `.icns`). */
+    readonly width: number;
+    readonly height: number;
+}
+export declare class IconError extends Error {
+    constructor(message: string);
+}
+/**
+ * Sniff the format from the magic bytes and validate the file. Throws
+ * {@link IconError} with an actionable message for missing, empty or
+ * unsupported files.
+ */
+export declare function readIcon(path: string): IconInfo;
+/** The C symbols the embedded icon exposes to the runtime (and native code). */
+export declare const ICON_SYMBOLS: {
+    readonly data: "xt_app_icon_data";
+    readonly size: "xt_app_icon_size";
+    readonly format: "xt_app_icon_format";
+    readonly width: "xt_app_icon_width";
+    readonly height: "xt_app_icon_height";
+};
+/**
+ * A zero-length icon. The GUI extension references {@link ICON_SYMBOLS}
+ * unconditionally, so the driver links this object into GUI programs even when
+ * no icon is configured; `size == 0` tells the runtime to skip it.
+ */
+export declare const EMPTY_ICON: IconInfo;
+/** Generate the C translation unit embedding the icon bytes. */
+export declare function iconSource(icon: IconInfo): string;
+/**
+ * Compile the icon into an object exposing {@link ICON_SYMBOLS}. Cached by the
+ * icon contents, so an unchanged icon is never recompiled.
+ */
+export declare function ensureIconObject(runner: Runner, clang: string, cacheDir: string, icon: IconInfo, env?: Record<string, string>): string;
+/**
+ * Wrap a PNG in a minimal ICO container. Vista+ accepts a PNG payload directly,
+ * so the PE resource path needs no BMP encoder.
+ */
+export declare function pngToIco(png: Uint8Array, width: number, height: number): Uint8Array;
+/** Normalize any supported icon to ICO bytes (used for the PE resource). */
+export declare function toIcoBytes(icon: IconInfo): Uint8Array;

package/dist/src/driver/icon.js

@@ -0,0 +1,151 @@
+/**
+ * Compile-time application icons.
+ *
+ * `--icon <file>` (or `app.icon` in `xbintsc.config.json`) reads an icon,
+ * validates it and embeds the raw bytes into the produced binary as a small
+ * linkable object. The `gui` extension picks the symbols up (weakly) to set the
+ * window / Dock icon; the Windows driver additionally turns the icon into a PE
+ * resource so Explorer and the taskbar show it. The core compiler never sees
+ * any of this — it is a driver concern, exactly like the per-platform linker
+ * flags.
+ *
+ * Supported inputs: `.png` (canonical), `.ico` and `.icns` (best effort on their
+ * home platform).
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { hashParts } from "./cache.js";
+import { compileC } from "./toolchain.js";
+export class IconError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "IconError";
+    }
+}
+const PNG_MAGIC = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];
+function startsWith(bytes, magic) {
+    if (bytes.length < magic.length)
+        return false;
+    return magic.every((value, index) => bytes[index] === value);
+}
+function readUInt32BE(bytes, offset) {
+    return (((bytes[offset] << 24) | (bytes[offset + 1] << 16) | (bytes[offset + 2] << 8) | bytes[offset + 3]) >>> 0);
+}
+/**
+ * Sniff the format from the magic bytes and validate the file. Throws
+ * {@link IconError} with an actionable message for missing, empty or
+ * unsupported files.
+ */
+export function readIcon(path) {
+    const absolute = resolve(path);
+    if (!existsSync(absolute)) {
+        throw new IconError(`Icon file not found: ${absolute}`);
+    }
+    const bytes = readFileSync(absolute);
+    if (bytes.length === 0) {
+        throw new IconError(`Icon file is empty: ${absolute}`);
+    }
+    if (startsWith(bytes, PNG_MAGIC)) {
+        // IHDR: width/height are big-endian at offsets 16 and 20.
+        const width = bytes.length >= 24 ? readUInt32BE(bytes, 16) : 0;
+        const height = bytes.length >= 24 ? readUInt32BE(bytes, 20) : 0;
+        return { path: absolute, format: "png", bytes, width, height };
+    }
+    // ICO / CUR: reserved(2) type(2) count(2), then ICONDIRENTRY[].
+    if (bytes.length >= 6 && bytes[0] === 0 && bytes[1] === 0 && bytes[2] === 1 && bytes[3] === 0) {
+        const width = bytes.length >= 7 ? bytes[6] || 256 : 0;
+        const height = bytes.length >= 8 ? bytes[7] || 256 : 0;
+        return { path: absolute, format: "ico", bytes, width, height };
+    }
+    if (startsWith(bytes, [0x69, 0x63, 0x6e, 0x73])) {
+        return { path: absolute, format: "icns", bytes, width: 0, height: 0 };
+    }
+    throw new IconError(`Unsupported icon format: ${absolute} (expected a PNG, ICO or ICNS file)`);
+}
+/** The C symbols the embedded icon exposes to the runtime (and native code). */
+export const ICON_SYMBOLS = {
+    data: "xt_app_icon_data",
+    size: "xt_app_icon_size",
+    format: "xt_app_icon_format",
+    width: "xt_app_icon_width",
+    height: "xt_app_icon_height",
+};
+/**
+ * A zero-length icon. The GUI extension references {@link ICON_SYMBOLS}
+ * unconditionally, so the driver links this object into GUI programs even when
+ * no icon is configured; `size == 0` tells the runtime to skip it.
+ */
+export const EMPTY_ICON = {
+    path: "",
+    format: "png",
+    bytes: Buffer.alloc(0),
+    width: 0,
+    height: 0,
+};
+/** Generate the C translation unit embedding the icon bytes. */
+export function iconSource(icon) {
+    const lines = [];
+    const bytes = icon.bytes;
+    for (let offset = 0; offset < bytes.length; offset += 16) {
+        const chunk = Array.from(bytes.subarray(offset, offset + 16), (byte) => `0x${byte.toString(16).padStart(2, "0")}`);
+        lines.push("  " + chunk.join(", ") + ",");
+    }
+    // A zero-length array is not portable C, so an empty icon still emits one
+    // placeholder byte while reporting `size == 0`.
+    if (lines.length === 0)
+        lines.push("  0x00,");
+    return [
+        "/* Generated by xbintsc - embedded application icon. Do not edit. */",
+        `const unsigned char ${ICON_SYMBOLS.data}[] = {`,
+        ...lines,
+        "};",
+        `const unsigned long long ${ICON_SYMBOLS.size} = ${bytes.length}ull;`,
+        `const char ${ICON_SYMBOLS.format}[] = "${icon.format}";`,
+        `const unsigned int ${ICON_SYMBOLS.width} = ${icon.width}u;`,
+        `const unsigned int ${ICON_SYMBOLS.height} = ${icon.height}u;`,
+        "",
+    ].join("\n");
+}
+/**
+ * Compile the icon into an object exposing {@link ICON_SYMBOLS}. Cached by the
+ * icon contents, so an unchanged icon is never recompiled.
+ */
+export function ensureIconObject(runner, clang, cacheDir, icon, env) {
+    const key = hashParts(["icon", process.platform, Buffer.from(icon.bytes).toString("base64")]);
+    const sourcePath = join(cacheDir, `icon-${key}.c`);
+    const objectPath = join(cacheDir, `icon-${key}.o`);
+    if (!existsSync(objectPath)) {
+        mkdirSync(cacheDir, { recursive: true });
+        writeFileSync(sourcePath, iconSource(icon));
+        compileC(runner, clang, sourcePath, objectPath, cacheDir, env);
+    }
+    return objectPath;
+}
+/**
+ * Wrap a PNG in a minimal ICO container. Vista+ accepts a PNG payload directly,
+ * so the PE resource path needs no BMP encoder.
+ */
+export function pngToIco(png, width, height) {
+    const header = Buffer.alloc(22);
+    header.writeUInt16LE(0, 0); // reserved
+    header.writeUInt16LE(1, 2); // type: icon
+    header.writeUInt16LE(1, 4); // image count
+    header.writeUInt8(width >= 256 || width <= 0 ? 0 : width, 6);
+    header.writeUInt8(height >= 256 || height <= 0 ? 0 : height, 7);
+    header.writeUInt8(0, 8); // palette size
+    header.writeUInt8(0, 9); // reserved
+    header.writeUInt16LE(1, 10); // color planes
+    header.writeUInt16LE(32, 12); // bits per pixel
+    header.writeUInt32LE(png.length, 14);
+    header.writeUInt32LE(22, 18); // payload offset
+    return Buffer.concat([header, Buffer.from(png)]);
+}
+/** Normalize any supported icon to ICO bytes (used for the PE resource). */
+export function toIcoBytes(icon) {
+    if (icon.format === "ico")
+        return icon.bytes;
+    if (icon.format === "png")
+        return pngToIco(icon.bytes, icon.width, icon.height);
+    throw new IconError(`Cannot embed a .${icon.format} icon as a Windows PE resource; use a PNG or ICO.`);
+}
+//# sourceMappingURL=icon.js.map

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

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

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

@@ -4,3 +4,7 @@ export { findRuntimeDir, platformSlug, releaseArchiveBase, releaseArchiveFileNam
 export { findRuntimeLibrary, runtimeLibDir } from "./runtime-lib.js";
 export { findClang, realRunner, ToolchainError, type Runner, } from "./toolchain.js";
 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 { bundlePathFor, infoPlist, packageMacApp, type MacBundleOptions } from "./mac-bundle.js";

package/dist/src/driver/index.js

@@ -4,4 +4,8 @@ export { findRuntimeDir, platformSlug, releaseArchiveBase, releaseArchiveFileNam
 export { findRuntimeLibrary, runtimeLibDir } from "./runtime-lib.js";
 export { findClang, realRunner, ToolchainError, } from "./toolchain.js";
 export { resolveToolchain } from "./toolchain-provider.js";
+export { CONFIG_FILE_NAME, findProjectConfig, loadProjectConfig, parseProjectConfig, resolveConfigPaths, ProjectConfigError, } from "./config.js";
+export { ensureIconObject, iconSource, readIcon, toIcoBytes, pngToIco, ICON_SYMBOLS, EMPTY_ICON, IconError, } from "./icon.js";
+export { ensureWindowsIconResource, resolveResourceCompiler, } from "./win-icon.js";
+export { bundlePathFor, infoPlist, packageMacApp } from "./mac-bundle.js";
 //# sourceMappingURL=index.js.map

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"}
+{"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"}

package/dist/src/driver/mac-bundle.d.ts

@@ -0,0 +1,41 @@
+/**
+ * macOS `.app` bundle generation.
+ *
+ * A bare Mach-O executable cannot carry a Finder icon, so when `app.bundle` is
+ * enabled on macOS the driver lays out a minimal bundle next to the executable:
+ *
+ *     Demo.app/Contents/Info.plist
+ *     Demo.app/Contents/MacOS/Demo
+ *     Demo.app/Contents/Resources/AppIcon.icns
+ *
+ * An `.icns` input is copied verbatim; a `.png` is converted with the system
+ * `sips` + `iconutil` tools when available, otherwise the PNG is shipped and the
+ * app relies on the runtime Dock icon (set by the `gui` extension).
+ */
+import type { IconInfo } from "./icon.js";
+import type { Runner } from "./toolchain.js";
+export interface MacBundleOptions {
+    readonly executablePath: string;
+    /** Display name; also the executable name inside the bundle. */
+    readonly name: string;
+    readonly bundleId: string;
+    readonly icon?: IconInfo;
+    readonly runner: Runner;
+    readonly env?: Record<string, string>;
+}
+/** `<dir>/<name>.app` for an executable at `<dir>/<name>`. */
+export declare function bundlePathFor(executablePath: string, name: string): string;
+export interface PlistOptions {
+    readonly name: string;
+    readonly bundleId: string;
+    readonly executable: string;
+    readonly iconFile?: string;
+}
+/** Render a minimal `Info.plist` for a GUI application bundle. */
+export declare function infoPlist(options: PlistOptions): string;
+/**
+ * Lay out the `.app` bundle containing a copy of `executablePath` and, when
+ * available, the icon. Returns the bundle path. Never throws for a missing
+ * image-conversion tool: it falls back to shipping the PNG.
+ */
+export declare function packageMacApp(options: MacBundleOptions): string;

package/dist/src/driver/mac-bundle.js

@@ -0,0 +1,123 @@
+/**
+ * macOS `.app` bundle generation.
+ *
+ * A bare Mach-O executable cannot carry a Finder icon, so when `app.bundle` is
+ * enabled on macOS the driver lays out a minimal bundle next to the executable:
+ *
+ *     Demo.app/Contents/Info.plist
+ *     Demo.app/Contents/MacOS/Demo
+ *     Demo.app/Contents/Resources/AppIcon.icns
+ *
+ * An `.icns` input is copied verbatim; a `.png` is converted with the system
+ * `sips` + `iconutil` tools when available, otherwise the PNG is shipped and the
+ * app relies on the runtime Dock icon (set by the `gui` extension).
+ */
+import { chmodSync, copyFileSync, existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+/** `<dir>/<name>.app` for an executable at `<dir>/<name>`. */
+export function bundlePathFor(executablePath, name) {
+    return join(dirname(executablePath), `${name}.app`);
+}
+/** Escape the five XML predefined entities for the plist values. */
+function xmlEscape(text) {
+    return text
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+/** Render a minimal `Info.plist` for a GUI application bundle. */
+export function infoPlist(options) {
+    const entries = [
+        ["CFBundleName", options.name],
+        ["CFBundleDisplayName", options.name],
+        ["CFBundleIdentifier", options.bundleId],
+        ["CFBundleExecutable", options.executable],
+        ["CFBundlePackageType", "APPL"],
+        ["CFBundleInfoDictionaryVersion", "6.0"],
+        ["CFBundleShortVersionString", "1.0.0"],
+        ["CFBundleVersion", "1"],
+        ["LSMinimumSystemVersion", "10.13"],
+        ["NSHighResolutionCapable", "true"],
+    ];
+    if (options.iconFile)
+        entries.push(["CFBundleIconFile", options.iconFile]);
+    const body = entries
+        .map(([key, value]) => `\t<key>${key}</key>\n\t<string>${xmlEscape(value)}</string>`)
+        .join("\n");
+    return [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">',
+        '<plist version="1.0">',
+        "<dict>",
+        body,
+        "</dict>",
+        "</plist>",
+        "",
+    ].join("\n");
+}
+const ICONSET_SIZES = [16, 32, 64, 128, 256, 512];
+/** Convert a PNG to `.icns` via `sips` + `iconutil`; false when unavailable. */
+function convertPngToIcns(runner, pngPath, outIcns, env) {
+    const iconsetDir = join(dirname(outIcns), "AppIcon.iconset");
+    mkdirSync(iconsetDir, { recursive: true });
+    try {
+        for (const size of ICONSET_SIZES) {
+            for (const scale of [1, 2]) {
+                const pixels = size * scale;
+                if (pixels > 1024)
+                    continue;
+                const suffix = scale === 1 ? "" : "@2x";
+                const out = join(iconsetDir, `icon_${size}x${size}${suffix}.png`);
+                const result = runner.run("sips", ["-z", String(pixels), String(pixels), pngPath, "--out", out], { env });
+                if (result.status !== 0)
+                    return false;
+            }
+        }
+        const result = runner.run("iconutil", ["-c", "icns", iconsetDir, "-o", outIcns], { env });
+        return result.status === 0 && existsSync(outIcns);
+    }
+    catch {
+        return false;
+    }
+    finally {
+        rmSync(iconsetDir, { recursive: true, force: true });
+    }
+}
+/**
+ * Lay out the `.app` bundle containing a copy of `executablePath` and, when
+ * available, the icon. Returns the bundle path. Never throws for a missing
+ * image-conversion tool: it falls back to shipping the PNG.
+ */
+export function packageMacApp(options) {
+    const { executablePath, name, bundleId, icon, runner } = options;
+    const bundleDir = bundlePathFor(executablePath, name);
+    const contents = join(bundleDir, "Contents");
+    const macosDir = join(contents, "MacOS");
+    const resourcesDir = join(contents, "Resources");
+    mkdirSync(macosDir, { recursive: true });
+    mkdirSync(resourcesDir, { recursive: true });
+    const innerExecutable = join(macosDir, name);
+    copyFileSync(executablePath, innerExecutable);
+    chmodSync(innerExecutable, 0o755);
+    let iconFile;
+    if (icon) {
+        const icnsPath = join(resourcesDir, "AppIcon.icns");
+        if (icon.format === "icns") {
+            copyFileSync(icon.path, icnsPath);
+            iconFile = "AppIcon";
+        }
+        else if (icon.format === "png") {
+            if (convertPngToIcns(runner, icon.path, icnsPath, options.env)) {
+                iconFile = "AppIcon";
+            }
+            else {
+                copyFileSync(icon.path, join(resourcesDir, "AppIcon.png"));
+                iconFile = "AppIcon.png";
+            }
+        }
+    }
+    writeFileSync(join(contents, "Info.plist"), infoPlist({ name, bundleId, executable: name, ...(iconFile ? { iconFile } : {}) }));
+    return bundleDir;
+}
+//# sourceMappingURL=mac-bundle.js.map

package/dist/src/driver/mac-bundle.js.map

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

package/dist/src/driver/win-icon.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Windows PE icon resource.
+ *
+ * Windows reads the application icon from a resource section in the `.exe`, so
+ * an embedded blob is not enough: the icon is wrapped in a `.rc` script and
+ * compiled to a resource object that is linked into the executable. `llvm-rc`
+ * (shipping with clang) is preferred; MinGW `windres` is the fallback. Both are
+ * optional — a missing resource compiler degrades to the runtime window icon
+ * instead of failing the build.
+ */
+import { type IconInfo } from "./icon.js";
+import type { Runner } from "./toolchain.js";
+export type ResourceCompilerKind = "llvm-rc" | "windres";
+export interface ResourceCompiler {
+    readonly tool: string;
+    readonly kind: ResourceCompilerKind;
+}
+/**
+ * Locate a resource compiler. `xbintsc_RC` wins, then `llvm-rc` next to the
+ * resolved clang, then `llvm-rc` and `windres` on `PATH`.
+ */
+export declare function resolveResourceCompiler(runner: Runner, clang: string): ResourceCompiler | undefined;
+/**
+ * Compile the icon into a linkable PE resource object (`.res` for llvm-rc, a
+ * COFF `.o` for windres). Cached by contents and compiler kind.
+ */
+export declare function ensureWindowsIconResource(runner: Runner, cacheDir: string, icon: IconInfo, compiler: ResourceCompiler, env?: Record<string, string>): string;

package/dist/src/driver/win-icon.js

@@ -0,0 +1,80 @@
+/**
+ * Windows PE icon resource.
+ *
+ * Windows reads the application icon from a resource section in the `.exe`, so
+ * an embedded blob is not enough: the icon is wrapped in a `.rc` script and
+ * compiled to a resource object that is linked into the executable. `llvm-rc`
+ * (shipping with clang) is preferred; MinGW `windres` is the fallback. Both are
+ * optional — a missing resource compiler degrades to the runtime window icon
+ * instead of failing the build.
+ */
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { hashParts } from "./cache.js";
+import { IconError, toIcoBytes } from "./icon.js";
+/**
+ * Locate a resource compiler. `xbintsc_RC` wins, then `llvm-rc` next to the
+ * resolved clang, then `llvm-rc` and `windres` on `PATH`.
+ */
+export function resolveResourceCompiler(runner, clang) {
+    const exe = process.platform === "win32" ? ".exe" : "";
+    // An explicit override is trusted: probe it and fall back rather than
+    // rejecting it on a path prefix check (it may be a bare command on PATH).
+    const override = process.env.xbintsc_RC;
+    if (override) {
+        const kind = /windres/i.test(override) ? "windres" : "llvm-rc";
+        try {
+            if (runner.run(override, ["--version"]).status === 0)
+                return { tool: override, kind };
+        }
+        catch {
+            // Fall through to the discovered compilers.
+        }
+    }
+    const candidates = [];
+    if (clang && (clang.includes("/") || clang.includes("\\"))) {
+        candidates.push({ tool: join(dirname(clang), `llvm-rc${exe}`), kind: "llvm-rc" });
+    }
+    candidates.push({ tool: `llvm-rc${exe}`, kind: "llvm-rc" });
+    candidates.push({ tool: `windres${exe}`, kind: "windres" });
+    for (const candidate of candidates) {
+        if ((candidate.tool.includes("/") || candidate.tool.includes("\\")) && !existsSync(candidate.tool))
+            continue;
+        try {
+            if (runner.run(candidate.tool, ["--version"]).status === 0)
+                return candidate;
+        }
+        catch {
+            // Not runnable; try the next candidate.
+        }
+    }
+    return undefined;
+}
+/**
+ * Compile the icon into a linkable PE resource object (`.res` for llvm-rc, a
+ * COFF `.o` for windres). Cached by contents and compiler kind.
+ */
+export function ensureWindowsIconResource(runner, cacheDir, icon, compiler, env) {
+    const icoBytes = toIcoBytes(icon);
+    const key = hashParts(["icon-res", compiler.kind, Buffer.from(icoBytes).toString("base64")]);
+    const icoName = `icon-${key}.ico`;
+    const icoPath = join(cacheDir, icoName);
+    const rcPath = join(cacheDir, `icon-${key}.rc`);
+    const objectPath = join(cacheDir, `icon-${key}.${compiler.kind === "windres" ? "o" : "res"}`);
+    if (existsSync(objectPath))
+        return objectPath;
+    mkdirSync(cacheDir, { recursive: true });
+    writeFileSync(icoPath, icoBytes);
+    // The .rc references the .ico by name; the compiler runs with `cacheDir` as
+    // its working directory so the relative path resolves.
+    writeFileSync(rcPath, `1 ICON "${icoName}"\n`);
+    const args = compiler.kind === "windres"
+        ? [rcPath, "-O", "coff", "-o", objectPath]
+        : ["/fo", objectPath, rcPath];
+    const result = runner.run(compiler.tool, args, { cwd: cacheDir, env });
+    if (result.status !== 0 || !existsSync(objectPath)) {
+        throw new IconError(`Failed to compile the Windows icon resource with ${compiler.tool}:\n${result.stderr || result.stdout}`);
+    }
+    return objectPath;
+}
+//# sourceMappingURL=win-icon.js.map

package/dist/src/driver/win-icon.js.map

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

package/dist/src/extensions/gui/html.d.ts

@@ -0,0 +1,25 @@
+/**
+ * GUI `.html` asset loader.
+ *
+ * `import html from "./index.html"` normally yields the file contents as a
+ * string. When the file contains scripts, the loader also compiles them: each
+ * script body is wrapped in a function `(window, document) => { … }`,
+ * registered through the `__registerScript` builtin, and the element is
+ * replaced by an inert `<script data-xt-id="<hash>"></script>` marker. The
+ * engine runs the matching functions once the document has been parsed (see
+ * `runtime/ext_gui/script.cpp`).
+ *
+ * This is how xbintsc supports `<script>` without a JavaScript engine: the body
+ * is ordinary TypeScript compiled by the existing front end, ahead of time.
+ *
+ * Inline `<script lang="ts">body</script>` bodies are wrapped directly. External
+ * `<script src="./app.ts">` files are read, their top-level `import`/`export
+ * … from` statements are hoisted to the generated module (with relative
+ * specifiers rewritten so they resolve from the HTML file), and the remaining
+ * statements are wrapped in the script function. All scripts run in document
+ * order after parsing (there is no "eager" execution point), i.e. every script
+ * is effectively `defer`red.
+ */
+import type { AssetLoadResult } from "../registry.js";
+/** Rewrite `<script>` bodies into registered AOT functions + an HTML string. */
+export declare function loadHtmlAsset(path: string, source: string): AssetLoadResult;