@scriptc/compiler 0.1.7 → 0.2.0

package/dist/native/file-identity.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/native/file-identity.test.js

@@ -0,0 +1,43 @@
+import { mkdtempSync, renameSync, rmSync, symlinkSync, utimesSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { expect, test } from "vitest";
+import { nativeFileIdentity } from "./file-identity.js";
+test("native tool identity invalidates same-size replacements with preserved mtime", () => {
+    const root = mkdtempSync(join(tmpdir(), "scriptc-file-identity-"));
+    try {
+        const path = join(root, "compiler");
+        writeFileSync(path, "original");
+        utimesSync(path, new Date(0), new Date(0));
+        const first = nativeFileIdentity(path);
+        expect(nativeFileIdentity(path)).toBe(first);
+        const replacement = join(root, "new");
+        writeFileSync(replacement, "replaced");
+        utimesSync(replacement, new Date(0), new Date(0));
+        renameSync(replacement, path);
+        expect(nativeFileIdentity(path)).not.toBe(first);
+        expect(() => nativeFileIdentity(root)).toThrow("not a file");
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test.skipIf(process.platform === "win32")("native tool identity follows a retargeted symlink", () => {
+    const root = mkdtempSync(join(tmpdir(), "scriptc-file-symlink-"));
+    try {
+        const current = join(root, "current");
+        const first = join(root, "first");
+        const second = join(root, "second");
+        writeFileSync(first, "same");
+        writeFileSync(second, "same");
+        symlinkSync(first, current);
+        const before = nativeFileIdentity(current);
+        rmSync(current);
+        symlinkSync(second, current);
+        expect(nativeFileIdentity(current)).not.toBe(before);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+//# sourceMappingURL=file-identity.test.js.map

package/dist/native/file-identity.test.js.map

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

package/dist/native/library.d.ts

@@ -0,0 +1,22 @@
+import type { NativeRuntimePack } from "../backend/runtime-pack-native.js";
+import type { NativeToolchain } from "./toolchain.js";
+/** Archive member names are untrusted package data, even after digest verification. */
+export declare function runtimeArchiveMembers(listing: string): string[];
+/** Localize the runtime without changing the library's declared C ABI. */
+export declare function localizeNativeLibrary(toolchain: NativeToolchain, stage: string, roots: string[], support: string[], keep: string[]): string;
+export declare function archiveNativeLibrary(options: {
+    toolchain: NativeToolchain;
+    programObject: string;
+    outputPath: string;
+    stage: string;
+    runtime: NativeRuntimePack;
+    localizeSymbols?: string[];
+}): void;
+export declare function linkNativeWasmLibrary(options: {
+    toolchain: NativeToolchain;
+    programObject: string;
+    outputPath: string;
+    runtime: NativeRuntimePack;
+    optimization: "release" | "dev";
+    exports: string[];
+}): void;

package/dist/native/library.js

@@ -0,0 +1,83 @@
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { requireNativeArtifact, runNativeTool } from "../backend/native-tools.js";
+import { localizeElfObject, mergeAndLocalizeCoffObjects } from "../backend/object-localize.js";
+import { RuntimePackError } from "../backend/runtime-pack-core.js";
+import { executableOptimizationLinkerArgs } from "../backend/targets.js";
+function archiver(toolchain) {
+    if (toolchain.archiver !== undefined)
+        return { executable: toolchain.archiver, args: toolchain.archiverArgs ?? [] };
+    const zig = /(?:^|[\\/])zig(?:\.exe)?$/.test(toolchain.linker);
+    return zig ? { executable: toolchain.linker, args: ["ar"] } : { executable: "ar", args: [] };
+}
+/** Archive member names are untrusted package data, even after digest verification. */
+export function runtimeArchiveMembers(listing) {
+    const names = listing.trim().split(/\r?\n/).filter((name) => name !== "" && name !== "__.SYMDEF" && name !== "__.SYMDEF SORTED");
+    if (new Set(names).size !== names.length || names.some((name) => !/^[A-Za-z0-9_.-]+\.o$/.test(name))) {
+        throw new RuntimePackError("runtime vendor archive has invalid or duplicate object members", "invalid");
+    }
+    return names;
+}
+/** Localize the runtime without changing the library's declared C ABI. */
+export function localizeNativeLibrary(toolchain, stage, roots, support, keep) {
+    const combined = join(stage, "library.localized.o");
+    const platform = toolchain.target.platform;
+    if (platform === "win32") {
+        writeFileSync(combined, mergeAndLocalizeCoffObjects(roots.map((path) => readFileSync(path)), support.map((path) => readFileSync(path)), new Set(keep), { roots: roots.map((path) => basename(path)), support: support.map((path) => basename(path)) }));
+        return combined;
+    }
+    const ar = archiver(toolchain);
+    const supportArgs = [];
+    if (support.length > 0) {
+        const archive = join(stage, "support.a");
+        runNativeTool(ar.executable, [...ar.args, "rcs", archive, ...support], undefined, { ...process.env, ZERO_AR_DATE: "1" });
+        supportArgs.push(archive);
+    }
+    if (platform === "darwin") {
+        if (process.platform !== "darwin")
+            throw new Error("Mach-O library localization requires a macOS host");
+        const symbols = join(stage, "public.syms");
+        writeFileSync(symbols, keep.map((name) => `_${name}\n`).join(""));
+        runNativeTool(toolchain.relocatableLinker ?? "ld", ["-r", ...roots, ...supportArgs, "-o", combined, "-exported_symbols_list", symbols]);
+    }
+    else if (platform === "linux") {
+        runNativeTool(toolchain.linker, [...toolchain.linkerArgs, "-target", toolchain.target.linkerTargetTriple,
+            "-nostdlib", "-r", ...roots, ...supportArgs, "-o", combined]);
+        writeFileSync(combined, localizeElfObject(readFileSync(combined), new Set(keep)));
+    }
+    else
+        throw new Error(`library localization is unavailable for ${toolchain.target.name}`);
+    requireNativeArtifact(combined);
+    return combined;
+}
+export function archiveNativeLibrary(options) {
+    const { toolchain, stage } = options;
+    const ar = archiver(toolchain);
+    const program = options.programObject;
+    const support = [...options.runtime.runtimeObjects];
+    for (let index = 0; index < options.runtime.archives.length; index++) {
+        const archive = options.runtime.archives[index];
+        const members = runtimeArchiveMembers(runNativeTool(ar.executable, [...ar.args, "t", archive]));
+        const directory = join(stage, `vendor-${index}`);
+        mkdirSync(directory);
+        if (members.length > 0)
+            runNativeTool(ar.executable, [...ar.args, "x", archive, ...members], directory);
+        support.push(...members.map((name) => join(directory, name)));
+    }
+    const objects = options.localizeSymbols === undefined ? [program, ...support]
+        : [localizeNativeLibrary(toolchain, stage, [program], support, options.localizeSymbols)];
+    runNativeTool(ar.executable, [...ar.args, "rcs", options.outputPath, ...objects], undefined, { ...process.env, ZERO_AR_DATE: "1" });
+    requireNativeArtifact(options.outputPath);
+}
+export function linkNativeWasmLibrary(options) {
+    const { toolchain, runtime } = options;
+    runNativeTool(toolchain.linker, [
+        ...toolchain.linkerArgs, "-target", toolchain.target.linkerTargetTriple, "-mexec-model=reactor",
+        ...executableOptimizationLinkerArgs("wasi", options.optimization),
+        ...options.exports.map((name) => `-Wl,--export=${name}`),
+        options.programObject, ...runtime.runtimeObjects, ...runtime.archives,
+        ...runtime.systemLibraries.map((name) => `-l${name}`), "-o", options.outputPath,
+    ]);
+    requireNativeArtifact(options.outputPath);
+}
+//# sourceMappingURL=library.js.map

package/dist/native/library.js.map

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

package/dist/native/prepare.d.ts

@@ -0,0 +1,21 @@
+import type { CompilationTiming } from "../timing.js";
+import type { CompileFailure, CompileLibraryOptions, CompileRequestOptions } from "../compile-types.js";
+import type { NativeLinkFeatures } from "../backend/native-link-info-core.js";
+import type { FfiProfile } from "../ffi/ffi-manifest.js";
+import type { FrontendFactory } from "../frontend/pipeline.js";
+import type { LibraryProfile } from "../library/library-profile.js";
+import { type NativeCache } from "./cache.js";
+import type { NativeToolchain } from "./toolchain.js";
+export interface NativeExecutableInput {
+    ok: true;
+    llvm: string;
+    ir: string | null;
+    sidecarJson: string | null;
+    features: NativeLinkFeatures;
+    sources: [string, string][];
+}
+/** Keep the checker and typed IR out of the native optimizer's live heap. */
+export declare function prepareNativeExecutable(entry: string, options: CompileRequestOptions, ffi: FfiProfile | null, toolchain: NativeToolchain, frontend: FrontendFactory, cache: NativeCache | null, timing?: CompilationTiming): NativeExecutableInput | CompileFailure;
+/** Library preparation also ends before the native optimizer starts. The
+ * cached form contains emitted artifacts, source frames, and the sidecar. */
+export declare function prepareNativeLibrary(profile: LibraryProfile, options: CompileLibraryOptions, archivePath: string, toolchain: NativeToolchain, frontend: FrontendFactory, cache: NativeCache | null, timing?: CompilationTiming): NativeExecutableInput | CompileFailure;

package/dist/native/prepare.js

@@ -0,0 +1,174 @@
+import { basename, dirname, join, resolve } from "node:path";
+import { emitLlvmModule } from "../backend/llvm/emitter.js";
+import { executableLinkFeatures } from "../backend/executable-features.js";
+import { prepareExecutableModule } from "../executable/prepare.js";
+import { FrontendInputTracker, frontendInputsStillMatch, validFrontendInputSnapshot, trackedReadFile } from "../frontend/input-tracker.js";
+import { provenanceSources } from "../frontend/provenance-registry.js";
+import { prepareLibrary } from "../library/prepare.js";
+import { serializeModule } from "../ir/serialize.js";
+import { contentDigest } from "./cache.js";
+import { nativeFileIdentity } from "./file-identity.js";
+function implementationIdentity(toolchain) {
+    // Release versions alone cannot distinguish two development builds.
+    return contentDigest(JSON.stringify({
+        compiler: nativeFileIdentity(process.execPath),
+        checker: nativeFileIdentity(toolchain.ts7Executable),
+        evaluator: toolchain.comptimeExecutable === undefined ? null : nativeFileIdentity(toolchain.comptimeExecutable),
+        version: toolchain.compilerVersion,
+    }));
+}
+function validFeatures(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const features = value;
+    return ["dynamic", "regex", "copying", "textDecoderLegacy", "fileHandle", "fetch", "netIsland", "zlib",
+        "assert", "inspect", "dynInvoke", "dc", "dynAsync", "events", "emitter", "symbol", "bigint", "searchParams",
+        "qs", "parseArgs", "stream", "net", "http", "http2", "dgram", "watch", "foreignFfi", "nodeTest", "tls", "tlsCa"]
+        .every((name) => typeof features[name] === "boolean");
+}
+function validCachedInput(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    const entry = value;
+    const input = entry.input;
+    if (entry.schema !== "scriptc.native-frontend.v2" || !validFrontendInputSnapshot(entry.probes) ||
+        input === undefined || input === null || typeof input !== "object")
+        return false;
+    return input.ok === true && typeof input.llvm === "string" && (input.ir === null || typeof input.ir === "string") &&
+        (input.sidecarJson === null || typeof input.sidecarJson === "string") &&
+        validFeatures(input.features) &&
+        Array.isArray(input.sources) && input.sources.every((pair) => Array.isArray(pair) && pair.length === 2 &&
+        typeof pair[0] === "string" && typeof pair[1] === "string");
+}
+/** Keep the checker and typed IR out of the native optimizer's live heap. */
+export function prepareNativeExecutable(entry, options, ffi, toolchain, frontend, cache, timing = () => { }) {
+    const outputKind = options.outputKind ?? "exe";
+    const stem = basename(entry).replace(/\.(ts|mts|cts|js|mjs|cjs)$/, "");
+    const outputPaths = [resolve(options.outPath), resolve(options.outPath) + ".dSYM",
+        resolve(options.outDir, stem + ".ll"), resolve(options.outDir, stem + ".ir.json")];
+    const directories = new Set();
+    for (const output of outputPaths) {
+        for (let directory = dirname(output);; directory = dirname(directory)) {
+            directories.add(directory);
+            if (dirname(directory) === directory)
+                break;
+        }
+    }
+    const exclusions = { outputPaths, outputDirectories: [...directories] };
+    let key = null;
+    if (cache !== null && provenanceSources() === null) {
+        try {
+            key = contentDigest(JSON.stringify({ schema: 1, entry, options, ffi, implementation: implementationIdentity(toolchain),
+                target: toolchain.target.name, declarations: toolchain.declarationsRoot ?? null,
+                environment: Object.entries(process.env).filter(([name]) => name.startsWith("SCRIPTC_")).sort(([a], [b]) => a.localeCompare(b)),
+            }));
+            const bytes = cache.read("frontend", key);
+            if (bytes !== null) {
+                const cached = JSON.parse(bytes.toString("utf8"));
+                if (validCachedInput(cached) && frontendInputsStillMatch(cached.probes, exclusions)) {
+                    const input = cached.input;
+                    timing("frontend-cache-hit");
+                    return input;
+                }
+            }
+        }
+        catch {
+            key = null;
+        }
+    }
+    timing("frontend-cache-miss");
+    const tracker = new FrontendInputTracker();
+    const prepared = tracker.runSynchronous(() => prepareExecutableModule(entry, options, ffi, toolchain.target.platform, frontend, timing));
+    if (!prepared.ok)
+        return prepared;
+    const ir = outputKind === "ir" || options.emitIr ? serializeModule(prepared.mod, true) : null;
+    timing("ir-serialize");
+    const llvm = outputKind === "ir" ? "" : emitLlvmModule(prepared.mod, {
+        targetTriple: toolchain.target.llvmTriple, pointerBits: toolchain.target.pointerBits,
+        wasi: toolchain.target.platform === "wasi", runtimeAbiMarker: outputKind === "obj" || outputKind === "exe",
+        ...(options.optimization === "dev" && !options.strip ? { debugSources: prepared.sourceTexts } : {}),
+    });
+    timing("llvm-emit");
+    const input = { ok: true, llvm, ir, sidecarJson: null,
+        features: executableLinkFeatures(prepared.mod, options.dynamic ?? false), sources: [...prepared.sourceTexts] };
+    timing("link-features");
+    const probes = tracker.snapshot();
+    if (cache !== null && key !== null && probes.stable && frontendInputsStillMatch(probes, exclusions)) {
+        const saved = { schema: "scriptc.native-frontend.v2", probes, input };
+        cache.write("frontend", key, JSON.stringify(saved));
+    }
+    timing("frontend-cache-publish");
+    return input;
+}
+/** Library preparation also ends before the native optimizer starts. The
+ * cached form contains emitted artifacts, source frames, and the sidecar. */
+export function prepareNativeLibrary(profile, options, archivePath, toolchain, frontend, cache, timing = () => { }) {
+    const stem = basename(profile.entry).replace(/\.(ts|mts|cts|js|mjs|cjs)$/, "");
+    const outputPaths = [archivePath, resolve(options.outDir, stem + ".lib.ll"), resolve(options.outDir, stem + ".lib.ir.json")];
+    if (profile.sidecar !== null)
+        outputPaths.push(profile.sidecar.path === null
+            ? archivePath + ".contract.json" : resolve(dirname(archivePath), profile.sidecar.path));
+    const directories = new Set();
+    for (const output of outputPaths) {
+        for (let directory = dirname(output);; directory = dirname(directory)) {
+            directories.add(directory);
+            if (dirname(directory) === directory)
+                break;
+        }
+    }
+    const exclusions = { outputPaths, outputDirectories: [...directories] };
+    let key = null;
+    if (cache !== null && provenanceSources() === null) {
+        try {
+            key = contentDigest(JSON.stringify({ schema: 1, kind: "library", entry: profile.entry, profile: profile.profileBytes,
+                options, implementation: implementationIdentity(toolchain), target: toolchain.target.name,
+                declarations: toolchain.declarationsRoot ?? null,
+                environment: Object.entries(process.env).filter(([name]) => name.startsWith("SCRIPTC_")).sort(([a], [b]) => a.localeCompare(b)),
+            }));
+            const bytes = cache.read("frontend", key);
+            if (bytes !== null) {
+                const cached = JSON.parse(bytes.toString("utf8"));
+                if (validCachedInput(cached) && frontendInputsStillMatch(cached.probes, exclusions)) {
+                    const input = cached.input;
+                    timing("frontend-cache-hit");
+                    return input;
+                }
+            }
+        }
+        catch {
+            key = null;
+        }
+    }
+    timing("frontend-cache-miss");
+    const tracker = new FrontendInputTracker();
+    const prepared = tracker.runSynchronous(() => {
+        for (let directory = dirname(profile.entry);; directory = dirname(directory)) {
+            trackedReadFile(join(directory, "tsconfig.json"));
+            trackedReadFile(join(directory, "package.json"));
+            if (directory === dirname(resolve(options.profilePath)) || dirname(directory) === directory)
+                break;
+        }
+        return prepareLibrary(profile, options.profilePath, toolchain.compilerVersion, toolchain.target.platform, frontend, timing);
+    });
+    if (!prepared.ok)
+        return prepared;
+    const llvm = emitLlvmModule(prepared.mod, {
+        targetTriple: toolchain.target.llvmTriple, pointerBits: toolchain.target.pointerBits,
+        wasi: toolchain.target.platform === "wasi",
+    });
+    timing("llvm-emit");
+    const input = {
+        ok: true, llvm,
+        ir: options.emitIr ? serializeModule(prepared.mod, true) : null, sidecarJson: prepared.sidecarJson,
+        features: executableLinkFeatures(prepared.mod, false), sources: [...prepared.sourceTexts],
+    };
+    timing("link-features");
+    const probes = tracker.snapshot();
+    if (cache !== null && key !== null && probes.stable && frontendInputsStillMatch(probes, exclusions)) {
+        const saved = { schema: "scriptc.native-frontend.v2", probes, input };
+        cache.write("frontend", key, JSON.stringify(saved));
+    }
+    timing("frontend-cache-publish");
+    return input;
+}
+//# sourceMappingURL=prepare.js.map

package/dist/native/prepare.js.map

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

package/dist/native/prepare.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/native/prepare.test.js

@@ -0,0 +1,70 @@
+import { mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, expect, test } from "vitest";
+import { nativeCodegenTarget } from "../backend/targets.js";
+import { runFrontend } from "../frontend/pipeline.js";
+import { loadProgram } from "../frontend/program-node.js";
+import { ts7Executable } from "../frontend/ts7/rpc-api.js";
+import { NativeCache } from "./cache.js";
+import { prepareNativeExecutable } from "./prepare.js";
+const scratch = [];
+afterEach(() => { for (const path of scratch.splice(0))
+    rmSync(path, { recursive: true, force: true }); });
+function fixture() {
+    const temporary = mkdtempSync(join(tmpdir(), "scriptc-native-frontend-"));
+    scratch.push(temporary);
+    const root = join(temporary, "project");
+    mkdirSync(root);
+    const entry = join(root, "main.ts");
+    const dependency = join(root, "value.ts");
+    writeFileSync(entry, 'import { value } from "./value.js"; console.log(value);\n');
+    writeFileSync(dependency, 'export const value = "first";\n');
+    writeFileSync(join(root, "tsconfig.json"), JSON.stringify({ compilerOptions: { strict: true, types: [], target: "esnext", module: "nodenext" } }));
+    writeFileSync(join(root, "package.json"), '{"type":"module"}');
+    const target = nativeCodegenTarget();
+    const toolchain = {
+        compilerVersion: "test", target, helper: target.helper, helperExecutable: "unused", helperPackageRoot: "unused",
+        runtimePackRoot: "unused", linker: "unused", linkerArgs: [], dsymutil: "unused", ts7Executable: ts7Executable(),
+    };
+    const cache = new NativeCache(join(temporary, "cache"));
+    const options = { outPath: join(root, ".scriptc", "main"), outDir: join(root, ".scriptc"), optimization: "release" };
+    let loads = 0;
+    const frontend = (path, npmStatic, externalTypes) => {
+        loads++;
+        return runFrontend(path, loadProgram, npmStatic, externalTypes);
+    };
+    const prepare = () => prepareNativeExecutable(entry, options, null, toolchain, frontend, cache);
+    return { root, entry, dependency, cache, options, prepare, loads: () => loads };
+}
+test("warm frontend reuse survives output creation and invalidates imported source edits", () => {
+    const f = fixture();
+    const first = f.prepare();
+    expect(first.ok, JSON.stringify(first)).toBe(true);
+    if (!first.ok)
+        return;
+    mkdirSync(f.options.outDir);
+    writeFileSync(f.options.outPath, "binary placeholder");
+    writeFileSync(join(f.options.outDir, "main.ll"), first.llvm);
+    const warm = f.prepare();
+    expect(warm).toEqual(first);
+    expect(f.loads()).toBe(1);
+    writeFileSync(f.dependency, 'export const value = "second";\n');
+    const edited = f.prepare();
+    expect(edited.ok).toBe(true);
+    if (edited.ok)
+        expect(edited.llvm).not.toBe(first.llvm);
+    expect(f.loads()).toBe(2);
+});
+test("structurally invalid cached features cause a rebuild even with a valid digest", () => {
+    const f = fixture();
+    expect(f.prepare().ok).toBe(true);
+    const family = join(f.cache.root, "frontend");
+    const key = readdirSync(family).find((name) => /^[0-9a-f]{64}$/.test(name));
+    const payload = JSON.parse(readFileSync(join(family, key), "utf8"));
+    payload.input.features = {};
+    f.cache.write("frontend", key, JSON.stringify(payload));
+    expect(f.prepare().ok).toBe(true);
+    expect(f.loads()).toBe(2);
+});
+//# sourceMappingURL=prepare.test.js.map

package/dist/native/prepare.test.js.map

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

package/dist/native/sanitizer.d.ts

@@ -0,0 +1,11 @@
+import type { NativeRuntimePack, NativeRuntimeSelection } from "../backend/runtime-pack-native.js";
+import type { RuntimePackMode } from "../backend/runtime-pack-core.js";
+import { type NativeCache } from "./cache.js";
+import type { NativeToolchain } from "./toolchain.js";
+/** Sanitizers retain the documented external Clang requirement. Normal
+ * builds use the installed precompiled runtime pack without compiling C. */
+export declare function sanitizerDriver(toolchain: NativeToolchain): string;
+export declare function sanitizerFlags(toolchain: NativeToolchain, optimization: "release" | "dev"): string[];
+/** The installed pack's matrix also selects sanitizer source units and
+ * feature defines, keeping native and seed runtime reachability aligned. */
+export declare function buildSanitizedRuntime(toolchain: NativeToolchain, selection: NativeRuntimeSelection, stage: string, mode: RuntimePackMode, cache: NativeCache | null): NativeRuntimePack;

package/dist/native/sanitizer.js

@@ -0,0 +1,135 @@
+import { createHash } from "node:crypto";
+import { mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { NativeCodegenError } from "../backend/native-codegen-core.js";
+import { requireNativeArtifact, runNativeTool } from "../backend/native-tools.js";
+import { QJS_ENGINE_SOURCES, LRE_SOURCES, ZLIB_SOURCES } from "../backend/vendor-inputs.js";
+import { contentDigest } from "./cache.js";
+/** Sanitizers retain the documented external Clang requirement. Normal
+ * builds use the installed precompiled runtime pack without compiling C. */
+export function sanitizerDriver(toolchain) {
+    if (toolchain.target.platform !== process.platform || toolchain.target.architecture !== process.arch ||
+        toolchain.target.name.startsWith("ios-") || toolchain.target.name.startsWith("android-")) {
+        throw new NativeCodegenError("SC3002", "--sanitize requires a native host target");
+    }
+    return process.env["SCRIPTC_CC"] ?? "clang";
+}
+export function sanitizerFlags(toolchain, optimization) {
+    return ["-target", toolchain.target.llvmTriple, optimization === "dev" ? "-O0" : "-O1", "-g", "-fsanitize=address"];
+}
+function sourceFingerprint(root) {
+    const hash = createHash("sha256");
+    const visit = (directory) => {
+        for (const entry of readdirSync(directory, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+            if (entry.name.startsWith("."))
+                continue;
+            const path = join(directory, entry.name);
+            if (entry.isDirectory())
+                visit(path);
+            else if (/\.(?:c|h|inc|def)$/.test(entry.name))
+                hash.update(path).update("\0").update(readFileSync(path)).update("\0");
+        }
+    };
+    visit(join(root, "src"));
+    visit(join(root, "vendor"));
+    return hash.digest("hex");
+}
+/** The installed pack's matrix also selects sanitizer source units and
+ * feature defines, keeping native and seed runtime reachability aligned. */
+export function buildSanitizedRuntime(toolchain, selection, stage, mode, cache) {
+    const driver = sanitizerDriver(toolchain);
+    const sourceRoot = toolchain.runtimeSourceRoot;
+    if (sourceRoot === undefined)
+        throw new NativeCodegenError("SC3003", "runtime development sources are missing from this installation");
+    const identity = JSON.parse(readFileSync(join(sourceRoot, "package.json"), "utf8"));
+    if (identity.name !== "@scriptc/runtime" || identity.version !== toolchain.compilerVersion) {
+        throw new NativeCodegenError("SC3003", "runtime development source version does not match this compiler");
+    }
+    const sourceIdentity = sourceFingerprint(sourceRoot);
+    const compilerIdentity = runNativeTool(driver, ["--version"]);
+    const flags = [...sanitizerFlags(toolchain, selection.flavor),
+        ...toolchain.target.runtimeCompileDefines.map((define) => "-D" + define)];
+    const src = join(sourceRoot, "src");
+    const vendor = join(sourceRoot, "vendor");
+    const quickjs = join(vendor, "quickjs-ng");
+    const zlib = join(vendor, "zlib");
+    const mbedtls = join(vendor, "mbedtls");
+    const cacheIdentity = contentDigest(JSON.stringify({ schema: 1, sourceIdentity, compilerIdentity, driver,
+        target: toolchain.target, environment: process.env }));
+    mkdirSync(stage, { recursive: true });
+    const pending = [];
+    const compile = (source, name, args) => {
+        const output = join(stage, name);
+        const key = contentDigest(JSON.stringify({ cacheIdentity, source, args: [...flags, ...args] }));
+        const cached = cache?.read("sanitizer", key);
+        if (cached !== null && cached !== undefined)
+            writeFileSync(output, cached);
+        else {
+            runNativeTool(driver, [...flags, ...args, "-c", source, "-o", output]);
+            requireNativeArtifact(output);
+            pending.push({ key, output });
+        }
+        return output;
+    };
+    const key = mode === "executable" ? selection.flavor : mode + "-" + selection.flavor;
+    const flavors = selection.manifest.flavors;
+    const flavor = mode === "library"
+        ? selection.flavor === "dev" ? flavors["library-dev"] : flavors["library-release"]
+        : mode === "library-thread"
+            ? selection.flavor === "dev" ? flavors["library-thread-dev"] : flavors["library-thread-release"]
+            : selection.flavor === "dev" ? flavors.dev : flavors.release;
+    if (flavor === undefined)
+        throw new NativeCodegenError("SC3003", `runtime pack lacks ${key}`);
+    const wanted = new Set(selection.selected.runtime.map((artifact) => artifact.path));
+    const common = ["-std=c11", "-pthread", "-DSCR_RC_AUDIT", "-fno-math-errno", "-fno-strict-aliasing",
+        "-Wno-deprecated-declarations", "-I", src, "-I", quickjs, "-I", zlib, "-I", join(mbedtls, "include"),
+        ...(toolchain.target.platform === "linux" ? ["-ffunction-sections", "-fdata-sections"] : [])];
+    const runtimeObjects = [];
+    for (const unit of flavor.runtime_units) {
+        for (const variant of unit.variants) {
+            if (wanted.has(variant.path))
+                runtimeObjects.push(compile(join(src, unit.source), unit.source.replace(/\.c$/, ".o"), [...common, ...variant.defines.map((define) => "-D" + define)]));
+        }
+    }
+    const archives = [];
+    for (const archive of selection.selected.archives) {
+        const name = basename(archive.path).replace(/^libscriptc-/, "").replace(/\.a$/, "");
+        let sources;
+        let directory;
+        let args;
+        if (name === "quickjs") {
+            sources = QJS_ENGINE_SOURCES;
+            directory = quickjs;
+            args = ["-std=gnu11", "-fvisibility=hidden", "-funsigned-char", "-DQUICKJS_NG_BUILD", "-D_GNU_SOURCE", "-DNDEBUG", "-I", quickjs];
+        }
+        else if (name === "libregexp") {
+            sources = LRE_SOURCES;
+            directory = quickjs;
+            args = ["-std=c11", "-I", quickjs];
+        }
+        else if (name === "zlib") {
+            sources = ZLIB_SOURCES;
+            directory = zlib;
+            args = ["-std=c11", "-I", zlib];
+        }
+        else if (name === "mbedtls") {
+            directory = join(mbedtls, "library");
+            sources = readdirSync(directory).filter((file) => file.endsWith(".c") && !file.startsWith(".")).sort();
+            args = ["-std=c11", "-I", join(mbedtls, "include"), "-I", directory];
+        }
+        else
+            throw new NativeCodegenError("SC3003", `unsupported runtime vendor archive: ${name}`);
+        const objects = sources.map((source) => compile(join(directory, source), name + "-" + source.replace(/\.c$/, ".o"), args));
+        const output = join(stage, "libscriptc-" + name + ".a");
+        runNativeTool(toolchain.archiver ?? "ar", [...(toolchain.archiverArgs ?? []), "rcs", output, ...objects], undefined, { ...process.env, ZERO_AR_DATE: "1" });
+        requireNativeArtifact(output);
+        archives.push(output);
+    }
+    if (sourceFingerprint(sourceRoot) !== sourceIdentity || runNativeTool(driver, ["--version"]) !== compilerIdentity) {
+        throw new NativeCodegenError("SC3004", "runtime sources or sanitizer compiler changed during the build; retry");
+    }
+    for (const item of pending)
+        cache?.write("sanitizer", item.key, readFileSync(item.output));
+    return { runtimeObjects, archives, systemLibraries: selection.selected.systemLibraries };
+}
+//# sourceMappingURL=sanitizer.js.map