@scriptc/compiler 0.2.4 → 0.2.6

package/dist/backend/native/driver.js

@@ -0,0 +1,294 @@
+import { IPHONEOS_MIN_VERSION, ANDROID_MIN_API, isIosTarget, isAndroidTarget, mobileTargetRefusal, configuredTargetPlatform, } from "../target-platform.js";
+import { spawnSync } from "node:child_process";
+import { existsSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/**
+ * Per-target section-elimination recipe. This belongs beside the native
+ * driver rather than a particular build path: one-shot compilation, cached
+ * runtime objects, external object recipes, and runtime packs must all agree
+ * on what their final linker is allowed to discard.
+ *
+ * Executable recipes use both halves. Archive and compile-only recipes never
+ * use the link half, but `--lib` uses the compile half so its consumers retain
+ * the choice to eliminate unused sections when they perform the final link.
+ */
+export function executableSectionEliminationFlags(platform) {
+    switch (platform) {
+        case "darwin":
+            // ld64's symbol subsections make this sufficient for ordinary C/LLVM
+            // objects. Do not attach it only to --dynamic: static programs have the
+            // same unreachable runtime sections.
+            return { compile: [], link: ["-Wl,-dead_strip"] };
+        case "linux":
+            return {
+                compile: ["-ffunction-sections", "-fdata-sections"],
+                link: ["-Wl,--gc-sections"],
+            };
+        case "win32":
+            // clang's MinGW driver forwards this to GNU-flavor ld/lld. A direct
+            // local lld-link invocation instead uses /OPT:REF, but scriptc only
+            // drives the compiler's GNU-flavor route here.
+            return {
+                compile: ["-ffunction-sections", "-fdata-sections"],
+                link: ["-Wl,--gc-sections"],
+            };
+        // WASI has a distinct linker/runtime contract. Keep its existing object
+        // layout until its linker invocation is validated separately.
+        default:
+            return { compile: [], link: [] };
+    }
+}
+/** Whether the selected compiler driver is Zig. This is deliberately based on
+ * the executable prefix rather than target presence: targetless Zig is still
+ * a Zig build, while target presence is only the platform/target contract. */
+export function isZigDriver(driver) {
+    return driver.argv[0] === "zig";
+}
+/* ── mobile targets (library mode) ─────────────────────────────────────────
+ * Three mobile triples are admitted, and only for LIBRARY-MODE archive
+ * builds — the consuming pattern is an embedding app linking the archive,
+ * never a standalone executable (compile()/compileC refuse the executable
+ * lane with the pointer to --lib):
+ *
+ *   aarch64-apple-ios            device archives; zig `aarch64-ios.15.0`
+ *   aarch64-apple-ios-simulator  simulator archives; zig
+ *                                `aarch64-ios.15.0-simulator`
+ *   aarch64-linux-android        zig `aarch64-linux-android.26`
+ *
+ * The minimum-version floors are part of the target contract: iOS archives
+ * build for iOS 15.0 (IPHONEOS_MIN_VERSION), Android archives for API level
+ * 26 (ANDROID_MIN_API) — LC_BUILD_VERSION minos and the bionic stub level
+ * both come from the pinned zig spelling above, so an embedder's deployment
+ * target at or above the floor links cleanly.
+ *
+ * Zig bundles no Apple or bionic libc, so both families compile against an
+ * explicit sysroot discovered here and spelled into targetArgs (where every
+ * cache tier already keys it):
+ *
+ *   iOS      darwin hosts only — `xcrun --show-sdk-path` selects the
+ *            iPhoneOS/iPhoneSimulator SDK; compiles add `-isysroot <sdk>`
+ *            plus `-isystem <sdk>/usr/include` (zig's driver manages libc
+ *            header search itself and would otherwise find no headers).
+ *   Android  any host with an NDK — ANDROID_NDK_ROOT/ANDROID_NDK_HOME, or
+ *            the newest ndk/<version> under ANDROID_HOME/ANDROID_SDK_ROOT
+ *            or the platform-default SDK location; compiles add the NDK
+ *            sysroot's generic and per-triple include directories.
+ *
+ * Library archives never link, so the sysroot's LIBRARIES are the
+ * embedder's side of the contract: Xcode links iOS archives against the
+ * selected SDK, and Gradle/NDK builds link Android archives against the
+ * API-26+ bionic stubs. */
+/** The Apple SDK root for one mobile platform, discovered through xcrun the
+ * way Xcode's own build system selects it. Memoized per SDK name and
+ * selection environment: production rediscovers per process, and the two
+ * selection variables (DEVELOPER_DIR/SDKROOT) are already mutable-input
+ * keys that disable persistent caching. */
+const appleSdkMemos = new Map();
+function appleSdkRoot(sdk, env) {
+    const key = [sdk, env["PATH"] ?? "", env["DEVELOPER_DIR"] ?? "", env["SDKROOT"] ?? ""].join("\0");
+    const memo = appleSdkMemos.get(key);
+    if (memo !== undefined)
+        return memo;
+    const probe = spawnSync("xcrun", ["--sdk", sdk, "--show-sdk-path"], {
+        encoding: "utf8",
+        env,
+    });
+    const path = probe.status === 0 ? (probe.stdout ?? "").trim() : "";
+    if (path === "" || !existsSync(join(path, "usr", "include"))) {
+        throw new Error(`the ${sdk} SDK was not found (xcrun --sdk ${sdk} --show-sdk-path failed) — ` +
+            `iOS targets need Xcode with the ${sdk === "iphoneos" ? "iPhoneOS" : "iPhoneSimulator"} SDK installed`);
+    }
+    appleSdkMemos.set(key, path);
+    return path;
+}
+/** Compare dotted-numeric NDK version directory names, newest first. */
+function compareNdkVersionsDesc(a, b) {
+    const as = a.split(".").map((s) => Number.parseInt(s, 10));
+    const bs = b.split(".").map((s) => Number.parseInt(s, 10));
+    for (let i = 0; i < Math.max(as.length, bs.length); i++) {
+        const d = (bs[i] ?? 0) - (as[i] ?? 0);
+        if (d !== 0 && Number.isFinite(d))
+            return d;
+    }
+    return a < b ? 1 : a > b ? -1 : 0;
+}
+/** The Android NDK sysroot for the selected environment: an explicit
+ * ANDROID_NDK_ROOT/ANDROID_NDK_HOME wins; otherwise the newest ndk/<version>
+ * under ANDROID_HOME, ANDROID_SDK_ROOT, or the platform-default SDK
+ * location. The prebuilt host directory is discovered rather than guessed —
+ * the NDK ships exactly one per host OS. Memoized per selection
+ * environment. */
+const ndkSysrootMemos = new Map();
+function androidNdkSysroot(env) {
+    const key = ["ANDROID_NDK_ROOT", "ANDROID_NDK_HOME", "ANDROID_HOME", "ANDROID_SDK_ROOT"]
+        .map((name) => env[name] ?? "")
+        .join("\0");
+    const memo = ndkSysrootMemos.get(key);
+    if (memo !== undefined)
+        return memo;
+    const ndkRoots = [];
+    const explicit = [env["ANDROID_NDK_ROOT"], env["ANDROID_NDK_HOME"]].find((root) => root !== undefined && root !== "");
+    if (explicit !== undefined) {
+        ndkRoots.push(explicit);
+    }
+    else {
+        const sdkRoots = [
+            env["ANDROID_HOME"],
+            env["ANDROID_SDK_ROOT"],
+            process.platform === "darwin"
+                ? join(homedir(), "Library", "Android", "sdk")
+                : process.platform === "win32"
+                    ? join(env["LOCALAPPDATA"] ?? join(homedir(), "AppData", "Local"), "Android", "Sdk")
+                    : join(homedir(), "Android", "Sdk"),
+        ].filter((root) => root !== undefined && root !== "");
+        for (const root of sdkRoots) {
+            let versions = [];
+            try {
+                versions = readdirSync(join(root, "ndk")).filter((name) => /^\d/.test(name));
+            }
+            catch {
+                continue;
+            }
+            versions.sort(compareNdkVersionsDesc);
+            ndkRoots.push(...versions.map((version) => join(root, "ndk", version)));
+        }
+    }
+    for (const ndk of ndkRoots) {
+        const prebuilt = join(ndk, "toolchains", "llvm", "prebuilt");
+        let hosts = [];
+        try {
+            hosts = readdirSync(prebuilt).sort();
+        }
+        catch {
+            continue;
+        }
+        for (const host of hosts) {
+            const sysroot = join(prebuilt, host, "sysroot");
+            if (existsSync(join(sysroot, "usr", "include", "aarch64-linux-android"))) {
+                ndkSysrootMemos.set(key, sysroot);
+                return sysroot;
+            }
+        }
+    }
+    throw new Error("no Android NDK sysroot was found — install an NDK (sdkmanager 'ndk;<version>') and/or set " +
+        "ANDROID_NDK_ROOT to it (ANDROID_HOME with an ndk/ directory also works). " +
+        "aarch64-linux-android compiles against the NDK's bionic headers.");
+}
+/** Resolve native platform flags independently of the machine running tests,
+ * so the host-Linux contract remains pinned on every development host. */
+function nativePlatformArgs(platform) {
+    return platform === "linux"
+        ? { targetArgs: ["-D_GNU_SOURCE"], linkArgs: ["-lm"] }
+        : { targetArgs: [], linkArgs: [] };
+}
+export function resolveCc(env = process.env, hostPlatform = process.platform) {
+    const cc = env["SCRIPTC_CC"] ?? "";
+    const target = env["SCRIPTC_TARGET"] ?? "";
+    const hostArgs = nativePlatformArgs(hostPlatform);
+    if (cc === "" || cc === "clang") {
+        if (target !== "") {
+            throw new Error(`SCRIPTC_TARGET=${target} requires SCRIPTC_CC=zigcc — the default clang path has no cross-target sysroots.`);
+        }
+        return { argv: ["clang"], target: null, zigTarget: null, ...hostArgs };
+    }
+    if (cc !== "zigcc") {
+        throw new Error(`unknown SCRIPTC_CC '${cc}' (supported: clang, zigcc)`);
+    }
+    if (target === "")
+        return { argv: ["zig", "cc"], target: null, zigTarget: null, ...hostArgs };
+    // Validate the target spelling before any SDK/sysroot discovery. Source
+    // emission uses the same pure classifier without resolving this driver.
+    configuredTargetPlatform(env, hostPlatform);
+    const mobileRefusal = mobileTargetRefusal(target, hostPlatform);
+    if (mobileRefusal !== null)
+        throw new Error(mobileRefusal);
+    if (isIosTarget(target)) {
+        // Library-mode-only target (compile()/compileC own the executable-lane
+        // refusal). Zig bundles no Apple libc: the compile rides the selected
+        // SDK sysroot, with the libc header directory spelled explicitly
+        // because zig's driver manages libc search itself and consults no
+        // -isysroot for it. The zig spelling pins the iOS 15.0 floor into
+        // every object's LC_BUILD_VERSION minos.
+        const simulator = target === "aarch64-apple-ios-simulator";
+        const sdk = appleSdkRoot(simulator ? "iphonesimulator" : "iphoneos", env);
+        const zigTarget = `aarch64-ios.${IPHONEOS_MIN_VERSION}${simulator ? "-simulator" : ""}`;
+        return {
+            argv: ["zig", "cc"],
+            target,
+            zigTarget,
+            targetArgs: ["-target", zigTarget, "-isysroot", sdk, "-isystem", join(sdk, "usr", "include")],
+            linkArgs: [],
+        };
+    }
+    if (isAndroidTarget(target)) {
+        // Library-mode-only target. Zig bundles no bionic: compiles ride the
+        // NDK sysroot's generic and per-triple include directories. Bionic
+        // supports _GNU_SOURCE like glibc (and hides some POSIX declarations
+        // without it); the zig spelling pins the API 26 floor, which the NDK's
+        // versioned stub libraries enforce at the embedder's link. API 26
+        // bionic carries everything the library-lane units call (arc4random_buf
+        // included), so no shim TU joins the archive.
+        const sysroot = androidNdkSysroot(env);
+        const zigTarget = `aarch64-linux-android.${ANDROID_MIN_API}`;
+        return {
+            argv: ["zig", "cc"],
+            target,
+            zigTarget,
+            targetArgs: [
+                "-target",
+                zigTarget,
+                "-D_GNU_SOURCE",
+                "-isystem",
+                join(sysroot, "usr", "include"),
+                "-isystem",
+                join(sysroot, "usr", "include", "aarch64-linux-android"),
+            ],
+            linkArgs: ["-lm"],
+        };
+    }
+    const linux = target.includes("linux");
+    const wasi = target.includes("wasi");
+    const musl = target.includes("linux-musl");
+    return {
+        argv: ["zig", "cc"],
+        target,
+        zigTarget: target,
+        targetArgs: [
+            "-target",
+            target,
+            ...(linux || wasi ? ["-D_GNU_SOURCE"] : []),
+            ...(musl ? ["-DSCR_MUSL"] : []),
+            ...(wasi ? ["-D_WASI_EMULATED_SIGNAL", "-D_WASI_EMULATED_PROCESS_CLOCKS"] : []),
+        ],
+        linkArgs: linux
+            ? ["-lm"]
+            : wasi
+                ? ["-lwasi-emulated-signal", "-lwasi-emulated-process-clocks"]
+                : [],
+    };
+}
+/** Musl intentionally has no predefined libc macro. The explicit Zig target
+ * is therefore the source of truth for selecting its small runtime shim. */
+export function isMuslTarget(driver) {
+    return driver.target?.includes("linux-musl") ?? false;
+}
+/** The OS the produced binary runs on: the triple's OS under SCRIPTC_TARGET,
+ * the host's otherwise — so platform-conditional link flags follow the
+ * TARGET, not the machine running the compiler. Exported for compile()/
+ * analyze(): the FRONTEND consults it too (path.sep / os.EOL literals and
+ * the path-module binding follow the target — a win32 triple compiles
+ * Node-on-Windows semantics, path.win32 backing the bare module). */
+export function targetPlatform(driver) {
+    if (driver.target === null)
+        return process.platform;
+    return configuredTargetPlatform({ SCRIPTC_TARGET: driver.target });
+}
+/** Architecture identity for host-native cache entries. Explicit cross targets
+ * already name their complete target triple; native builds need the process
+ * architecture too because one per-user cache can serve both native and
+ * emulated processes (arm64 and Rosetta on macOS, for example). */
+export function cacheTargetIdentity(driver, hostPlatform = process.platform, hostArch = process.arch) {
+    return driver.target === null ? `native:${hostPlatform}:${hostArch}` : `cross:${driver.target}`;
+}
+//# sourceMappingURL=driver.js.map

package/dist/backend/native/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/backend/native/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;GASG;AACH,MAAM,UAAU,iCAAiC,CAAC,QAAgB;IAIhE,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,qEAAqE;YACrE,wEAAwE;YACxE,qCAAqC;YACrC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACpD,KAAK,OAAO;YACV,OAAO;gBACL,OAAO,EAAE,CAAC,qBAAqB,EAAE,iBAAiB,CAAC;gBACnD,IAAI,EAAE,CAAC,mBAAmB,CAAC;aAC5B,CAAC;QACJ,KAAK,OAAO;YACV,oEAAoE;YACpE,oEAAoE;YACpE,+CAA+C;YAC/C,OAAO;gBACL,OAAO,EAAE,CAAC,qBAAqB,EAAE,iBAAiB,CAAC;gBACnD,IAAI,EAAE,CAAC,mBAAmB,CAAC;aAC5B,CAAC;QACJ,wEAAwE;QACxE,8DAA8D;QAC9D;YACE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;AACH,CAAC;AAgED;;8EAE8E;AAC9E,MAAM,UAAU,WAAW,CAAC,MAA8B;IACxD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAiC2B;AAC3B;;;;2CAI2C;AAC3C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;AAChD,SAAS,YAAY,CAAC,GAAmC,EAAE,GAAsB;IAC/E,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClG,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,iBAAiB,CAAC,EAAE;QAClE,QAAQ,EAAE,MAAM;QAChB,GAAG;KACJ,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,IAAI,IAAI,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CACb,OAAO,GAAG,mCAAmC,GAAG,6BAA6B;YAC3E,mCAAmC,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,gBAAgB,CACzG,CAAC;IACJ,CAAC;IACD,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wEAAwE;AACxE,SAAS,sBAAsB,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACxD,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;;;kBAKkB;AAClB,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;AAClD,SAAS,iBAAiB,CAAC,GAAsB;IAC/C,MAAM,GAAG,GAAG,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,CAAC;SACrF,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC9B,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CACtE,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,CAC5D,CAAC;IACF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG;YACf,GAAG,CAAC,cAAc,CAAC;YACnB,GAAG,CAAC,kBAAkB,CAAC;YACvB,OAAO,CAAC,QAAQ,KAAK,QAAQ;gBAC3B,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC;gBAC9C,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO;oBAC5B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC;oBACpF,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC;SACxC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;QACtE,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,QAAQ,GAAa,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC/E,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QAC7D,IAAI,KAAK,GAAa,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;YAChD,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,uBAAuB,CAAC,CAAC,EAAE,CAAC;gBACzE,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBAClC,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CACb,4FAA4F;QAC1F,2EAA2E;QAC3E,kEAAkE,CACrE,CAAC;AACJ,CAAC;AAED;0EAC0E;AAC1E,SAAS,kBAAkB,CAAC,QAAyB;IACnD,OAAO,QAAQ,KAAK,OAAO;QACzB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE;QACtD,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,GAAG,GAAsB,OAAO,CAAC,GAAG,EACpC,YAAY,GAAoB,OAAO,CAAC,QAAQ;IAEhD,MAAM,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAClD,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;QAChC,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,mFAAmF,CAC5G,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC;IACzE,CAAC;IACD,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,uBAAuB,EAAE,6BAA6B,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC9F,wEAAwE;IACxE,wEAAwE;IACxE,wBAAwB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAChE,IAAI,aAAa,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IAC3D,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,uEAAuE;QACvE,sEAAsE;QACtE,iEAAiE;QACjE,kEAAkE;QAClE,kEAAkE;QAClE,yCAAyC;QACzC,MAAM,SAAS,GAAG,MAAM,KAAK,6BAA6B,CAAC;QAC3D,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC1E,MAAM,SAAS,GAAG,eAAe,oBAAoB,GAAG,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACxF,OAAO;YACL,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC;YACnB,MAAM;YACN,SAAS;YACT,UAAU,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;YAC7F,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IACD,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,qEAAqE;QACrE,mEAAmE;QACnE,qEAAqE;QACrE,uEAAuE;QACvE,kEAAkE;QAClE,wEAAwE;QACxE,8CAA8C;QAC9C,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,SAAS,GAAG,yBAAyB,eAAe,EAAE,CAAC;QAC7D,OAAO;YACL,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC;YACnB,MAAM;YACN,SAAS;YACT,UAAU,EAAE;gBACV,SAAS;gBACT,SAAS;gBACT,eAAe;gBACf,UAAU;gBACV,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC;gBAC/B,UAAU;gBACV,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,uBAAuB,CAAC;aACzD;YACD,QAAQ,EAAE,CAAC,KAAK,CAAC;SAClB,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC3C,OAAO;QACL,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC;QACnB,MAAM;QACN,SAAS,EAAE,MAAM;QACjB,UAAU,EAAE;YACV,SAAS;YACT,MAAM;YACN,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,yBAAyB,EAAE,iCAAiC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAChF;QACD,QAAQ,EAAE,KAAK;YACb,CAAC,CAAC,CAAC,KAAK,CAAC;YACT,CAAC,CAAC,IAAI;gBACJ,CAAC,CAAC,CAAC,wBAAwB,EAAE,gCAAgC,CAAC;gBAC9D,CAAC,CAAC,EAAE;KACT,CAAC;AACJ,CAAC;AAED;4EAC4E;AAC5E,MAAM,UAAU,YAAY,CAAC,MAAgC;IAC3D,OAAO,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC;AACxD,CAAC;AAED;;;;;qEAKqE;AACrE,MAAM,UAAU,cAAc,CAAC,MAAgB;IAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;IACpD,OAAO,wBAAwB,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AACrE,CAAC;AAED;;;mEAGmE;AACnE,MAAM,UAAU,mBAAmB,CACjC,MAAgC,EAChC,YAAY,GAAoB,OAAO,CAAC,QAAQ,EAChD,QAAQ,GAAW,OAAO,CAAC,IAAI;IAE/B,OAAO,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,YAAY,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC;AAClG,CAAC"}

package/dist/backend/native/executable.d.ts

@@ -0,0 +1,18 @@
+import { type CcOptions } from "./contracts.js";
+/** Compiles one C program together with the runtime sources.
+ * With caching disabled, the runtime (a dozen small files) is recompiled on
+ * every build — no cached-archive staleness bugs. Sanitized dev builds compile
+ * the program separately so its O0 setting does not slow the O1 runtime.
+ * Other builds use one clang invocation. --dynamic additionally compiles
+ * scr_island.c under SCR_DYNAMIC and links the cached engine archive (built
+ * lazily, see above); regex-using programs additionally compile scr_regex.c
+ * and link libregexp (the cached objects, or the archive's own copy under
+ * --dynamic). Executable links use the target's section-elimination recipe
+ * independently of those feature gates.
+ *
+ * With a caller-supplied dependency identity and an enabled cache root,
+ * unchanged programs skip payload code generation/linking via the binary
+ * cache after lightweight metadata probes, and misses link the program's own
+ * TU against cached per-flavor runtime objects. */
+export declare function compileCInternal(opts: CcOptions, cacheWarmOnly: boolean, cacheWarmPaths?: Set<string>): Promise<void>;
+export declare function compileC(opts: CcOptions): Promise<void>;