@scriptc/compiler 0.2.4 → 0.2.6

package/dist/backend/native/tool-identity.js

@@ -0,0 +1,310 @@
+import { toolchainEnvironmentFingerprint } from "../toolchain-environment.js";
+import { createHash, randomUUID } from "node:crypto";
+import { constants as fsConstants } from "node:fs";
+import { access, mkdtemp, realpath, rm, stat, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { basename, delimiter, dirname, extname, isAbsolute, join, resolve } from "node:path";
+import { resolveCc } from "./driver.js";
+import { execFileAsync } from "./process.js";
+import { normalizedProbeInvocation, effectiveCompilerSpellings } from "./trace-paths.js";
+import { stableTestToolchainSession } from "./session.js";
+/** Inputs that can change which native tool/runtime implementation an
+ * executable build selects before compileC has a chance to rediscover it.
+ * The early whole-program cache keys this exact posture before restoring a
+ * final binary; compileC retains its deeper inode/content validation. */
+export async function executableNativeEnvironmentFingerprint(env = process.env) {
+    const configuredCompiler = env["SCRIPTC_CC"] ?? "";
+    let compilerIdentity;
+    try {
+        compilerIdentity = await effectiveCompilerEnvironmentIdentity(resolveCc(env), env);
+    }
+    catch {
+        // A failed trace cannot safely describe a reusable native posture. Keep
+        // the build working, but make this invocation miss every persistent early
+        // entry so compileC performs its full discovery and validation.
+        compilerIdentity = `<unavailable:${configuredCompiler}:${randomUUID()}>`;
+    }
+    const hash = createHash("sha256")
+        .update("executable-native-environment-v2\0")
+        .update(toolchainEnvironmentFingerprint(env))
+        .update("\0")
+        // PATH text alone is not a resolution proof, and on Darwin /usr/bin/clang
+        // is a stable shim whose selected Xcode compiler can change underneath it.
+        // Re-resolve and trace the effective driver on every early lookup.
+        .update(compilerIdentity)
+        .update("\0");
+    for (const name of [
+        "PATH",
+        "SCRIPTC_FETCH_CURL",
+        "SCRIPTC_TEST_RUNTIME_SRC_DIR",
+        "SCRIPTC_TEST_VENDOR_CACHE_DIR",
+        "SCRIPTC_TEST_TRUST_COMPILER_WRAPPER",
+    ]) {
+        const value = env[name];
+        hash
+            .update(name)
+            .update(value === undefined ? "\0unset\0" : "\0set\0")
+            .update(value ?? "")
+            .update("\0");
+    }
+    return hash.digest("hex");
+}
+const ccVersionMemos = new Map();
+/** Identity of the compiler implementation and configuration selected by a
+ * fresh driver invocation. In particular, Darwin's stable /usr/bin/clang shim
+ * exposes the currently selected Xcode clang only in its `-###` trace. The
+ * normalized trace also covers output-affecting default driver configuration
+ * that can change while argv[0] and PATH retain the same spelling. */
+async function effectiveCompilerEnvironmentIdentity(driver, env) {
+    const compiler = driver.argv[0] ?? "clang";
+    const resolvedDriver = await resolvedTool(compiler, env);
+    if (resolvedDriver === null)
+        return `<unresolved:${compiler}>`;
+    const probeDir = await mkdtemp(join(tmpdir(), "scriptc-early-cc-probe-"));
+    try {
+        const source = join(probeDir, "empty.c");
+        const object = join(probeDir, "empty.o");
+        await writeFile(source, "int scriptc_early_driver_probe;\n");
+        const trace = await execFileAsync(compiler, [
+            ...driver.argv.slice(1),
+            ...driver.targetArgs,
+            "-###",
+            "-std=c11",
+            "-c",
+            source,
+            "-o",
+            object,
+        ], { cwd: probeDir, env, maxBuffer: 16 * 1024 * 1024 });
+        const effectiveSpellings = effectiveCompilerSpellings(trace);
+        const effective = effectiveSpellings.length === 1 ? await resolvedTool(effectiveSpellings[0], env) : null;
+        return createHash("sha256")
+            .update("effective-compiler-environment-v1\0")
+            .update(resolvedDriver.cacheIdentity)
+            .update("\0")
+            .update(normalizedProbeInvocation(trace, probeDir))
+            .update("\0")
+            .update(effective?.cacheIdentity ?? `<unresolved-effective:${effectiveSpellings.join("\x1f")}>`)
+            .digest("hex");
+    }
+    finally {
+        await rm(probeDir, { recursive: true, force: true }).catch(() => undefined);
+    }
+}
+/** Resolve the executable the OS will select for an argv[0] spelling. The
+ * path and inode metadata join the version output below: two PATH postures
+ * must not share cache entries merely because both drivers call themselves
+ * `clang` or print the same upstream version. ctime catches an in-place tool
+ * replacement even when a package manager preserves its size and mtime. */
+export async function resolvedTool(command, env = process.env) {
+    const hasSeparator = command.includes("/") || command.includes("\\");
+    const configuredPath = (env["PATH"] ?? (process.platform === "win32" ? "" : "/usr/bin:/bin")).split(delimiter);
+    const pathEntries = hasSeparator
+        ? [""]
+        : process.platform === "win32"
+            ? ["", dirname(process.execPath), ...configuredPath]
+            : configuredPath;
+    const windowsExtensions = process.platform === "win32" && extname(command) === ""
+        ? (env["PATHEXT"] ?? ".COM;.EXE;.BAT;.CMD").split(";").filter((extension) => extension !== "")
+        : [""];
+    for (const entry of pathEntries) {
+        const directory = entry.startsWith('"') && entry.endsWith('"') ? entry.slice(1, -1) : entry;
+        const base = hasSeparator
+            ? isAbsolute(command)
+                ? command
+                : resolve(command)
+            : join(directory === "" ? process.cwd() : directory, command);
+        for (const extension of windowsExtensions) {
+            const candidate = `${base}${extension}`;
+            try {
+                await access(candidate, process.platform === "win32" ? fsConstants.F_OK : fsConstants.X_OK);
+                const [canonical, info] = await Promise.all([realpath(candidate), stat(candidate)]);
+                if (!info.isFile())
+                    continue;
+                const fileIdentity = [
+                    canonical,
+                    info.dev,
+                    info.ino,
+                    info.size,
+                    info.mtimeMs,
+                    info.ctimeMs,
+                ].join("\0");
+                return {
+                    canonicalPath: canonical,
+                    fileIdentity,
+                    cacheIdentity: [resolve(candidate), fileIdentity].join("\0"),
+                };
+            }
+            catch {
+                // Keep searching PATH/PATHEXT exactly as process spawning would.
+            }
+        }
+    }
+    return null;
+}
+export async function resolvedToolIdentity(command, env = process.env) {
+    return (await resolvedTool(command, env))?.cacheIdentity ?? null;
+}
+const directCompilerDriverMemos = new Map();
+export const directCompilerSelections = new Map();
+export function compilerDriverProbeKey(driver, environmentFingerprint) {
+    return [
+        environmentFingerprint,
+        driver.argv.join("\x1f"),
+        driver.target ?? "<native>",
+        driver.targetArgs.join("\x1f"),
+    ].join("\0");
+}
+/** `/usr/bin/clang` on Darwin is Apple's immutable driver shim: its `-###`
+ * trace names the selected Xcode/CommandLineTools clang rather than the shim
+ * itself. The ordinary implicit-toolchain fingerprint below captures that
+ * selected executable and its dependencies, so this trusted system handoff is
+ * the one intentional exception to the same-executable rule. */
+function isAppleSystemClangHandoff(driver, effectiveCompiler) {
+    return (process.platform === "darwin" &&
+        driver.canonicalPath === "/usr/bin/clang" &&
+        basename(effectiveCompiler.canonicalPath) === "clang");
+}
+/** Persistent caches require an inspectable compiler driver. A general
+ * wrapper can branch on the real source/object paths or argument topology and
+ * inject inputs only into the final invocation; no synthetic metadata probe
+ * can safely represent that behavior. Accept direct Clang/Zig drivers (plus
+ * Apple's system shim) and conservatively keep wrapper-driven builds on the
+ * uncached path. */
+export async function compilerDriverSupportsPersistentCache(driver, environmentFingerprint) {
+    // Cache-race tests exercise publication below an intentionally instrumented
+    // wrapper. This is deliberately undocumented and test-scoped.
+    if (process.env["SCRIPTC_TEST_TRUST_COMPILER_WRAPPER"] === "1")
+        return true;
+    const driverKey = compilerDriverProbeKey(driver, environmentFingerprint);
+    const compiler = driver.argv[0] ?? "clang";
+    const resolvedDriver = await resolvedTool(compiler);
+    // A prior dependency list cannot prove that name resolution is unchanged:
+    // a new header in an earlier search directory leaves every previously
+    // resolved file untouched. Require the driver to be present so each cache
+    // invocation can rediscover its complete dependency graph.
+    if (resolvedDriver === null)
+        return false;
+    const probeKey = `${driverKey}\0${resolvedDriver.fileIdentity}`;
+    const memoized = directCompilerDriverMemos.get(probeKey);
+    if (memoized !== undefined)
+        return memoized;
+    const probeDir = await mkdtemp(join(tmpdir(), "scriptc-driver-probe-"));
+    let direct = false;
+    try {
+        const source = join(probeDir, "empty.c");
+        const object = join(probeDir, "empty.o");
+        await writeFile(source, "int scriptc_driver_probe;\n");
+        const trace = await execFileAsync(compiler, [
+            ...driver.argv.slice(1),
+            ...driver.targetArgs,
+            "-###",
+            "-std=c11",
+            "-c",
+            source,
+            "-o",
+            object,
+        ], { cwd: probeDir, maxBuffer: 16 * 1024 * 1024 });
+        const effectiveSpellings = effectiveCompilerSpellings(trace);
+        if (effectiveSpellings.length === 1) {
+            const effectiveCompiler = await resolvedTool(effectiveSpellings[0]);
+            direct =
+                effectiveCompiler !== null &&
+                    (effectiveCompiler.fileIdentity === resolvedDriver.fileIdentity ||
+                        isAppleSystemClangHandoff(resolvedDriver, effectiveCompiler));
+            if (direct)
+                directCompilerSelections.set(driverKey, effectiveCompiler);
+        }
+    }
+    catch {
+        direct = false;
+    }
+    finally {
+        await rm(probeDir, { recursive: true, force: true }).catch(() => undefined);
+    }
+    directCompilerDriverMemos.set(probeKey, direct);
+    if (!direct)
+        directCompilerSelections.delete(driverKey);
+    return direct;
+}
+/** Complete library archives may skip `ar`, so the selected archiver must be
+ * as inspectable as the compiler. `zig ar` is the already-validated Zig
+ * executable. For the host spelling, accept only the immutable platform
+ * tool locations; a PATH wrapper can branch on the real member topology or
+ * inject mutable inputs that `ar --version` cannot expose. Other archivers
+ * retain runtime-object reuse but rebuild the program member and archive. */
+export async function archiverSupportsPersistentCache(arArgv, driver) {
+    if (arArgv.length === 2 &&
+        arArgv[0] === driver.argv[0] &&
+        arArgv[1] === "ar" &&
+        driver.argv[0] === "zig") {
+        return true;
+    }
+    if (arArgv.length !== 1)
+        return false;
+    const archiver = await resolvedTool(arArgv[0] ?? "ar");
+    if (archiver === null || !/(?:^|-)ar$/.test(basename(archiver.canonicalPath))) {
+        return false;
+    }
+    if (archiver.canonicalPath.startsWith("/usr/bin/") ||
+        archiver.canonicalPath.startsWith("/bin/")) {
+        return true;
+    }
+    return (process.platform === "darwin" &&
+        /^\/Applications\/Xcode[^/]*\.app\/Contents\/Developer\/Toolchains\/[^/]+\.xctoolchain\/usr\/bin\/[^/]*ar$/.test(archiver.canonicalPath));
+}
+export async function ccVersion(argv, environmentFingerprint = toolchainEnvironmentFingerprint(), fresh = false) {
+    const spellingKey = `${environmentFingerprint}\0${argv.join("\x1f")}`;
+    const executableIdentity = await resolvedToolIdentity(argv[0] ?? "clang");
+    const key = `${spellingKey}\0${executableIdentity ?? "<unresolved>"}`;
+    const probe = () => 
+    // `zig cc --version` (zig 0.16) drops an empty a.o in its cwd. A private
+    // probe directory avoids both caller pollution and the cross-process /
+    // cross-user collision a fixed tmpdir()/a.o would create on Linux.
+    (async () => {
+        const probeDir = await mkdtemp(join(tmpdir(), "scriptc-cc-version-"));
+        try {
+            const r = await execFileAsync(argv[0] ?? "clang", [...argv.slice(1), "--version"], {
+                cwd: probeDir,
+            });
+            return `${executableIdentity ?? "<unresolved>"}\0${`${r.stdout}\n${r.stderr}`.trim()}`;
+        }
+        finally {
+            await rm(probeDir, { recursive: true, force: true }).catch(() => undefined);
+        }
+    })();
+    const requireFreshProbe = fresh && !stableTestToolchainSession();
+    let memo = requireFreshProbe && executableIdentity !== null ? probe() : ccVersionMemos.get(key);
+    if (memo === undefined) {
+        memo = probe();
+        ccVersionMemos.set(key, memo);
+    }
+    else if (requireFreshProbe) {
+        ccVersionMemos.set(key, memo);
+    }
+    return memo;
+}
+const toolVersionMemos = new Map();
+const toolVersionFallbacks = new Map();
+export async function toolVersionOnce(argv, environmentFingerprint = toolchainEnvironmentFingerprint(), fresh = false) {
+    const spellingKey = `${environmentFingerprint}\0${argv.join("\x1f")}`;
+    const executableIdentity = await resolvedToolIdentity(argv[0] ?? "ar");
+    if (executableIdentity === null) {
+        const fallback = toolVersionFallbacks.get(spellingKey);
+        if (fallback !== undefined)
+            return fallback;
+    }
+    const key = `${spellingKey}\0${executableIdentity ?? "<unresolved>"}`;
+    const probe = () => execFileAsync(argv[0] ?? "ar", [...argv.slice(1), "--version"]).then((r) => `${executableIdentity ?? "<unresolved>"}\0${`${r.stdout}\n${r.stderr}`.trim()}`, (err) => `${executableIdentity ?? "<unresolved>"}\0${`${err.stdout ?? ""}\n${err.stderr ?? ""}`.trim() || err.message || key}`);
+    let memo = fresh && executableIdentity !== null ? probe() : toolVersionMemos.get(key);
+    if (memo === undefined) {
+        memo = probe();
+        toolVersionMemos.set(key, memo);
+    }
+    else if (fresh) {
+        toolVersionMemos.set(key, memo);
+    }
+    if (executableIdentity !== null)
+        toolVersionFallbacks.set(spellingKey, memo);
+    return memo;
+}
+//# sourceMappingURL=tool-identity.js.map

package/dist/backend/native/tool-identity.js.map

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

package/dist/backend/native/trace-paths.d.ts

@@ -0,0 +1,12 @@
+export declare function existingDriverTracePaths(output: string, cwd: string, excludedRoot: string): Promise<string[]>;
+export declare function normalizedProbeInvocation(result: {
+    stdout: string;
+    stderr: string;
+}, probeDir: string): string;
+/** Extract cc1 executable spellings without resolving them. Multiple compiler
+ * commands remain ambiguous; the identity callers decide whether to refuse or
+ * fingerprint that posture. */
+export declare function effectiveCompilerSpellings(result: {
+    stdout: string;
+    stderr: string;
+}): string[];

package/dist/backend/native/trace-paths.js

@@ -0,0 +1,73 @@
+import { driverTraceCandidates } from "../link-trace.js";
+import { lstat } from "node:fs/promises";
+import { isAbsolute, resolve } from "node:path";
+export async function existingDriverTracePaths(output, cwd, excludedRoot) {
+    const candidates = new Set();
+    for (const line of output.split(/\r?\n/)) {
+        const tokens = driverTraceCandidates(line);
+        for (let index = 0; index < tokens.length; index++) {
+            const token = tokens[index];
+            const joinedPathOption = ["-I", "-L", "-F"].find((option) => token.startsWith(option) && token.length > option.length);
+            const equalsPathOption = ["--sysroot=", "-resource-dir="].find((option) => token.startsWith(option));
+            const separatePathOptions = [
+                "-I",
+                "-L",
+                "-F",
+                "--sysroot",
+                "-isysroot",
+                "-resource-dir",
+                "-isystem",
+                "-iquote",
+                "-internal-isystem",
+                "-internal-externc-isystem",
+                "-internal-iframework",
+            ];
+            const optionPath = joinedPathOption !== undefined
+                ? token.slice(joinedPathOption.length)
+                : equalsPathOption !== undefined
+                    ? token.slice(equalsPathOption.length)
+                    : separatePathOptions.includes(token)
+                        ? (tokens[index + 1] ?? "")
+                        : token;
+            if (!isAbsolute(optionPath))
+                continue;
+            const path = resolve(cwd, optionPath);
+            if (path === excludedRoot ||
+                path.startsWith(`${excludedRoot}/`) ||
+                path.startsWith(`${excludedRoot}\\`)) {
+                continue;
+            }
+            candidates.add(path);
+        }
+    }
+    const existing = await Promise.all([...candidates].map(async (path) => [path, await lstat(path).catch(() => null)]));
+    return existing
+        .filter((entry) => entry[1] !== null)
+        .map(([path]) => path)
+        .sort();
+}
+export function normalizedProbeInvocation(result, probeDir) {
+    return (`${result.stdout}\n${result.stderr}`
+        // Probe-local paths vary on every invocation and carry no toolchain
+        // identity. Both ordinary and shell-escaped Windows spellings can appear
+        // in a driver's quoted trace.
+        .split(probeDir)
+        .join("<probe>")
+        .split(probeDir.replace(/\\/g, "\\\\"))
+        .join("<probe>")
+        .trim());
+}
+/** Extract cc1 executable spellings without resolving them. Multiple compiler
+ * commands remain ambiguous; the identity callers decide whether to refuse or
+ * fingerprint that posture. */
+export function effectiveCompilerSpellings(result) {
+    const spellings = [];
+    for (const line of `${result.stdout}\n${result.stderr}`.split(/\r?\n/)) {
+        const tokens = driverTraceCandidates(line);
+        const cc1 = tokens.indexOf("-cc1");
+        if (cc1 > 0)
+            spellings.push(tokens[cc1 - 1]);
+    }
+    return spellings;
+}
+//# sourceMappingURL=trace-paths.js.map

package/dist/backend/native/trace-paths.js.map

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

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

@@ -0,0 +1 @@
+export declare const vendorEngineDir: () => string, vendorTlsDir: () => string, vendorCurlDir: () => string, vendorBuildCacheRoot: (buildRoot?: string) => string, vendorCacheTargetFlavor: (driver: Pick<import("./driver.js").CcDriver, "target">, hostPlatform?: NodeJS.Platform, hostArch?: string) => string, vendorCacheBuildIdentity: (environmentFingerprint: string, compilerIdentity: string, nativeSourceIdentity: string) => string, currentVendorCacheBuildIdentity: (driver: Pick<import("./driver.js").CcDriver, "argv" | "target">, environmentFingerprint: string) => Promise<string>, engineArchivePath: (sanitize: boolean, driver: import("./driver.js").CcDriver, buildIdentity: string, cacheRoot?: string) => string, stageVendorInputs: (materialize: () => Promise<string[]>, stageDir: string) => Promise<string[]>, ensureEngineArchive: (sanitize: boolean, driver: import("./driver.js").CcDriver, buildIdentity: string, cacheRoot?: string) => Promise<string>, lreObjectPaths: (sanitize: boolean, driver: import("./driver.js").CcDriver, buildIdentity: string, cacheRoot?: string) => string[], ensureLreObjects: (sanitize: boolean, driver: import("./driver.js").CcDriver, buildIdentity: string, cacheRoot?: string) => Promise<string[]>, vendorZlibDir: () => string, zlibObjectPaths: (sanitize: boolean, driver: import("./driver.js").CcDriver, buildIdentity: string, cacheRoot?: string) => string[], ensureZlibObjects: (sanitize: boolean, driver: import("./driver.js").CcDriver, buildIdentity: string, cacheRoot?: string) => Promise<string[]>, curlStubDirPath: (driver: import("./driver.js").CcDriver, buildIdentity: string, cacheRoot?: string) => string, ensureCurlStub: (driver: import("./driver.js").CcDriver, buildIdentity: string, cacheRoot?: string) => Promise<string>, tlsArchivePath: (sanitize: boolean, driver: import("./driver.js").CcDriver, buildIdentity: string, cacheRoot?: string) => string, ensureTlsArchive: (sanitize: boolean, driver: import("./driver.js").CcDriver, buildIdentity: string, cacheRoot?: string) => Promise<string>, QJS_ENGINE_SOURCES: readonly ["dtoa.c", "libregexp.c", "libunicode.c", "quickjs.c"], LRE_SOURCES: readonly ["libregexp.c", "libunicode.c"], ZLIB_SOURCES: readonly ["adler32.c", "compress.c", "crc32.c", "deflate.c", "infback.c", "inffast.c", "inflate.c", "inftrees.c", "trees.c", "uncompr.c", "zutil.c"];

package/dist/backend/native/vendor.js

@@ -0,0 +1,12 @@
+import { createVendorArchives } from "../vendor-archives.js";
+import { runtimeSrcDir, runtimeFingerprint } from "./runtime-inputs.js";
+import { targetPlatform, isZigDriver } from "./driver.js";
+import { resolvedToolIdentity } from "./tool-identity.js";
+export const { vendorEngineDir, vendorTlsDir, vendorCurlDir, vendorBuildCacheRoot, vendorCacheTargetFlavor, vendorCacheBuildIdentity, currentVendorCacheBuildIdentity, engineArchivePath, stageVendorInputs, ensureEngineArchive, lreObjectPaths, ensureLreObjects, vendorZlibDir, zlibObjectPaths, ensureZlibObjects, curlStubDirPath, ensureCurlStub, tlsArchivePath, ensureTlsArchive, QJS_ENGINE_SOURCES, LRE_SOURCES, ZLIB_SOURCES, } = createVendorArchives({
+    runtimeSrcDir,
+    targetPlatform,
+    isZigDriver,
+    resolvedToolIdentity,
+    runtimeFingerprint,
+});
+//# sourceMappingURL=vendor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vendor.js","sourceRoot":"","sources":["../../../src/backend/native/vendor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,CAAC,MAAM,EACX,eAAe,EACf,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,+BAA+B,EAC/B,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,YAAY,GACb,GAAG,oBAAoB,CAAC;IACvB,aAAa;IACb,cAAc;IACd,WAAW;IACX,oBAAoB;IACpB,kBAAkB;CACnB,CAAC,CAAC"}

package/dist/backend/native-codegen-core.d.ts

@@ -3,6 +3,12 @@ import type { NativeHelperSpec, NativeTargetSpec } from "./targets.js";
 export declare const NATIVE_CODEGEN_PROTOCOL_VERSION = "1";
 export declare const NATIVE_CODEGEN_LLVM_VERSION = "22.1.8";
 export type NativeCodegenOutputKind = "asm" | "obj";
+/** Optimized executable objects this large keep whole-program simplification
+ * and inlining, then optimize and generate code in concurrent partitions. The
+ * count depends only on the module, so artifacts never vary with the host. */
+export declare function nativeProgramPartitions(target: NativeTargetSpec, optimization: "release" | "dev", llvmBytes: number): number;
+/** Output paths for each partition; the first is the requested path. */
+export declare function nativePartitionPaths(path: string, count: number): string[];
 export declare class NativeCodegenError extends Error {
     readonly diagnosticCode: "SC3002" | "SC3003" | "SC3004";
     readonly detailCode?: string | undefined;

package/dist/backend/native-codegen-core.js

@@ -1,5 +1,26 @@
 export const NATIVE_CODEGEN_PROTOCOL_VERSION = "1";
 export const NATIVE_CODEGEN_LLVM_VERSION = "22.1.8";
+/** LLVM text per partition, and the most partitions one executable uses. */
+const PROGRAM_PARTITION_BYTES = 1024 * 1024;
+const MAX_PROGRAM_PARTITIONS = 8;
+/** Optimized executable objects this large keep whole-program simplification
+ * and inlining, then optimize and generate code in concurrent partitions. The
+ * count depends only on the module, so artifacts never vary with the host. */
+export function nativeProgramPartitions(target, optimization, llvmBytes) {
+    if (optimization === "dev" || target.platform === "wasi")
+        return 1;
+    const count = Math.floor(llvmBytes / PROGRAM_PARTITION_BYTES);
+    return Math.max(1, Math.min(MAX_PROGRAM_PARTITIONS, count));
+}
+/** Output paths for each partition; the first is the requested path. */
+export function nativePartitionPaths(path, count) {
+    const dot = path.lastIndexOf(".");
+    const stem = dot > Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\")) ? dot : path.length;
+    const paths = [path];
+    for (let index = 1; index < count; index++)
+        paths.push(`${path.slice(0, stem)}.part${index}${path.slice(stem)}`);
+    return paths;
+}
 export class NativeCodegenError extends Error {
     diagnosticCode;
     detailCode;
@@ -34,7 +55,8 @@ export function validateNativeCodegenVersion(value, target, helper, expectedPack
     if (!Array.isArray(value["targets"]) || !value["targets"].includes(target.llvmBackend)) {
         mismatch("targets", `an array containing ${target.llvmBackend}`);
     }
-    if (!Array.isArray(value["supported_targets"]) || !value["supported_targets"].includes(target.llvmTriple)) {
+    if (!Array.isArray(value["supported_targets"]) ||
+        !value["supported_targets"].includes(target.llvmTriple)) {
         mismatch("supported_targets", `an array containing ${target.llvmTriple}`);
     }
     if (typeof value["host_triple"] !== "string")

package/dist/backend/native-codegen-core.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-codegen-core.js","sourceRoot":"","sources":["../../src/backend/native-codegen-core.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AACnD,MAAM,CAAC,MAAM,2BAA2B,GAAG,QAAQ,CAAC;AAIpD,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAEhC,cAAc;IAEd,UAAU;IAHrB,YACW,cAA8C,EACvD,OAAe,EACN,UAAmB;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;8BAJN,cAAc;0BAEd,UAAU;QAGnB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAcD,MAAM,UAAU,4BAA4B,CAC1C,KAA8B,EAC9B,MAAwB,EACxB,MAAwB,EACxB,sBAA8B;IAE9B,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,QAAgB,EAAS,EAAE;QAC1D,MAAM,IAAI,kBAAkB,CAC1B,QAAQ,EACR,uCAAuC,KAAK,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,2CAA2C,MAAM,CAAC,WAAW,kCAAkC,EACpN,kBAAkB,CACnB,CAAC;IACJ,CAAC,CAAC;IACF,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,kBAAkB,CAAC,KAAK,+BAA+B,EAAE,CAAC;QAClE,QAAQ,CAAC,kBAAkB,EAAE,+BAA+B,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,KAAK,CAAC,yBAAyB,CAAC,KAAK,sBAAsB,EAAE,CAAC;QAChE,QAAQ,CAAC,yBAAyB,EAAE,sBAAsB,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,KAAK,CAAC,cAAc,CAAC,KAAK,2BAA2B,EAAE,CAAC;QAC1D,QAAQ,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC,aAAa,EAAE,CAAC;QACrD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,CAAC,KAAK,MAAM,CAAC,iBAAiB,EAAE,CAAC;QACtD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACvF,QAAQ,CAAC,SAAS,EAAE,uBAAuB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1G,QAAQ,CAAC,mBAAmB,EAAE,uBAAuB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,QAAQ;QAAE,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAClF,OAAO,KAAwC,CAAC;AAClD,CAAC"}
+{"version":3,"file":"native-codegen-core.js","sourceRoot":"","sources":["../../src/backend/native-codegen-core.ts"],"names":[],"mappings":"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"}

package/dist/backend/native-codegen.d.ts

@@ -1,10 +1,12 @@
-import { type NativeArtifactDependency } from "./native-toolchain.js";
+import { type NativeArtifactDependency } from "./native/contracts.js";
 import { type NativeHelperSpec, type NativeTargetSpec } from "./targets.js";
 import { type NativeCodegenVersion, type NativeCodegenOutputKind } from "./native-codegen-core.js";
 export { NATIVE_CODEGEN_PROTOCOL_VERSION, NATIVE_CODEGEN_LLVM_VERSION, NativeCodegenError, type NativeCodegenVersion, type NativeCodegenOutputKind, } from "./native-codegen-core.js";
 export interface NativeCodegenArtifact {
     /** Exact installed inputs observed before the helper identity and emission. */
     dependencies: NativeArtifactDependency[];
+    /** Every emitted file, starting with the requested output path. */
+    outputPaths: string[];
 }
 export interface NativeCodegenOptions {
     outputPath: string;
@@ -24,6 +26,8 @@ export interface NativeCodegenOptions {
     resolvePackageJson?: (specifier: string) => string;
     /** Internal/test override; omitted production calls use the shared cache. */
     cacheRoot?: string | null;
+    /** Program partitions, written to nativePartitionPaths(outputPath). */
+    partitions?: number;
 }
 export declare function validateNativeCodegenVersion(value: Record<string, unknown>, target: NativeTargetSpec, helper: NativeHelperSpec): NativeCodegenVersion;
 export declare function emitNativeArtifact(options: NativeCodegenOptions): Promise<NativeCodegenArtifact>;