@scriptc/compiler 0.1.7 → 0.2.1

package/dist/backend/native-link-info.test.js

@@ -1,157 +1,52 @@
-import { mkdtemp, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { describe, expect, test } from "vitest";
-import { loadFfiProfile } from "../ffi/ffi-manifest.js";
+import { describe, expect, test, vi } from "vitest";
 import { createNativeLinkInfo } from "./native-link-info.js";
 import { MACOS_ARM64_TARGET, WASM32_WASI_TARGET } from "./targets.js";
-const BASE = {
-    dynamic: false,
-    regex: false,
-    copying: false,
-    textDecoderLegacy: false,
-    fileHandle: false,
-    fetch: false,
-    netIsland: false,
-    zlib: false,
-    assert: false,
-    inspect: false,
-    dynInvoke: false,
-    dc: false,
-    dynAsync: false,
-    events: false,
-    emitter: false,
-    symbol: false,
-    bigint: false,
-    searchParams: false,
-    qs: false,
-    parseArgs: false,
-    stream: false,
-    net: false,
-    http: false,
-    http2: false,
-    dgram: false,
-    watch: false,
-    foreignFfi: false,
-    nodeTest: false,
-    tls: false,
-    tlsCa: false,
-};
-describe("native link info recipes", () => {
-    test("feature source sets reproduce runtime and vendor gates", async () => {
+import { loadRuntimePack } from "./runtime-pack.js";
+vi.mock("./runtime-pack.js", () => ({
+    loadRuntimePack: vi.fn(async ({ target, optimization }) => ({
+        root: "/installed/runtime", manifest: { package: target.runtimePackPackage, version: "1.2.3" },
+        flavor: optimization, runtimeObjects: ["/installed/runtime/base.o"], archives: ["/installed/runtime/vendor.a"],
+        selectedRuntimeArtifacts: [{ path: "base.o", sha256: "1".repeat(64), size: 42 }],
+        selectedArchiveArtifacts: [{ path: "vendor.a", sha256: "2".repeat(64), size: 84 }],
+        systemLibraries: [...target.runtimeSystemLibraries],
+    })),
+}));
+const features = {};
+describe("native link info", () => {
+    test("reports verified precompiled inputs with their integrity metadata and link order", async () => {
         const info = await createNativeLinkInfo({
-            programObject: "/out/app.o",
-            target: MACOS_ARM64_TARGET,
-            features: {
-                ...BASE,
-                dynamic: true,
-                regex: true,
-                assert: true,
-                inspect: true,
-                bigint: true,
-                zlib: true,
-                tls: true,
-            },
-            ffi: null,
+            programObject: "/out/app.o", target: MACOS_ARM64_TARGET, features,
+            ffi: { ffiFormat: 7, libraries: ["/ffi/native.a"], systemLibraries: ["sqlite3"], frameworks: ["Foundation"], functions: [
+                    { name: "native", symbol: "native", params: [], returns: "void" },
+                    { name: "release", symbol: "release", params: [], returns: "void", callbackOperation: "release" },
+                ] },
         });
-        const runtime = info.runtime_pack.source_sets.find((set) => set.name === "runtime");
-        expect(runtime.sources).toEqual(expect.arrayContaining([
-            "src/scr_regex.c",
-            "src/scr_assert.c",
-            "src/scr_inspect.c",
-            "src/scr_bigint.c",
-            "src/scr_bigint_assert.c",
-            "src/scr_zlib.c",
-            "src/scr_zlib_island.c",
-            "src/scr_tls.c",
-            "src/scr_tls_ca.c",
-            "src/scr_island.c",
-            "src/scr_web.c",
-            "src/scr_inspect_island.c",
-        ]));
-        expect(info.runtime_pack.source_sets.map((set) => set.name)).toEqual([
-            "runtime", "quickjs", "mbedtls",
-        ]);
-        expect(info.runtime_pack.source_sets.find((set) => set.name === "mbedtls").sources.length)
-            .toBeGreaterThan(100);
-        expect(info.link.system_libraries).toEqual(["System", "z", "m"]);
-    });
-    test("dev object recipes keep runtime optimization in lockstep", async () => {
-        const info = await createNativeLinkInfo({
-            programObject: "/out/app.o",
-            target: MACOS_ARM64_TARGET,
-            features: BASE,
-            ffi: null,
-            optimization: "dev",
+        expect(info.runtime_pack).toEqual({
+            kind: "precompiled", package: "@scriptc/runtime-darwin-arm64", version: "1.2.3", root: "/installed/runtime",
+            path_base: "runtime_pack.root", flavor: "release",
+            objects: [{ path: "base.o", sha256: "1".repeat(64), size: 42 }],
+            archives: [{ path: "vendor.a", sha256: "2".repeat(64), size: 84 }],
         });
-        expect(info.runtime_pack.source_sets[0]?.c_flags).toContain("-O0");
-        expect(info.runtime_pack.source_sets[0]?.c_flags).not.toContain("-O2");
-        // External objects are compiled separately and the driver recipe is an
-        // executable link. The two halves must not leak into each other's recipe.
-        expect(info.runtime_pack.source_sets[0]?.c_flags).not.toContain("-Wl,-dead_strip");
+        expect(info.ffi.symbols).toEqual(["native"]);
+        expect(info.link.input_order).toEqual(["/out/app.o", "/ffi/native.a", "/installed/runtime/base.o", "/installed/runtime/vendor.a"]);
+        expect(info.link.system_libraries).toEqual(["sqlite3", "System"]);
+        expect(info.link.frameworks).toEqual(["Foundation"]);
         expect(info.link.driver_flags).toContain("-Wl,-dead_strip");
+        expect(loadRuntimePack).toHaveBeenLastCalledWith({ target: MACOS_ARM64_TARGET, features, optimization: "release" });
     });
-    test("static external-object links dead-strip just like dynamic links", async () => {
-        const info = await createNativeLinkInfo({
-            programObject: "/out/app.o",
-            target: MACOS_ARM64_TARGET,
-            features: BASE,
-            ffi: null,
-        });
-        expect(info.link.driver_flags).toContain("-Wl,-dead_strip");
+    test("WASI release and dev select their runtime flavor and debug-link policy", async () => {
+        for (const optimization of ["release", "dev"]) {
+            const info = await createNativeLinkInfo({ programObject: "/out/app.o", target: WASM32_WASI_TARGET, features, ffi: null, optimization });
+            expect(info.runtime_pack.flavor).toBe(optimization);
+            expect(info.link.driver_flags.includes("-Wl,--strip-debug")).toBe(optimization === "release");
+        }
     });
-    test("WASI external link recipes strip DWARF only in release mode", async () => {
-        const release = await createNativeLinkInfo({
-            programObject: "/out/app.o",
-            target: WASM32_WASI_TARGET,
-            features: BASE,
-            ffi: null,
-            optimization: "release",
-        });
-        const dev = await createNativeLinkInfo({
-            programObject: "/out/app.o",
-            target: WASM32_WASI_TARGET,
-            features: BASE,
-            ffi: null,
-            optimization: "dev",
-        });
-        expect(release.link.driver_flags).toContain("-Wl,--strip-debug");
-        expect(dev.link.driver_flags).not.toContain("-Wl,--strip-debug");
-    });
-    test("FFI symbols and resolved inputs remain ordered before the runtime", async () => {
-        const dir = await mkdtemp(join(tmpdir(), "scriptc-native-link-info-unit-"));
-        const library = join(dir, "native.o");
-        const manifest = join(dir, "ffi.json");
-        await writeFile(library, "fixture");
-        await writeFile(manifest, JSON.stringify({
-            ffi_format: 1,
-            functions: [{
-                    name: "nativeScale",
-                    symbol: "native_scale",
-                    params: ["f64"],
-                    returns: "f64",
-                }],
-            libraries: ["./native.o"],
-            system_libraries: ["sqlite3"],
-        }));
-        const loaded = loadFfiProfile(manifest);
-        if (!loaded.ok)
-            throw new Error(loaded.diagnostics[0]?.message);
-        const info = await createNativeLinkInfo({
-            programObject: "/out/app.o",
-            target: MACOS_ARM64_TARGET,
-            features: BASE,
-            ffi: loaded.profile,
-        });
-        expect(info.ffi).toEqual({
-            format: 1,
-            symbols: ["native_scale"],
-            libraries: [library],
-        });
-        expect(info.link.input_order.slice(0, 3)).toEqual([
-            "/out/app.o", library, "runtime/*.o",
-        ]);
-        expect(info.link.system_libraries).toEqual(["sqlite3", "System"]);
+    test("rejects non-Darwin frameworks before selecting a pack", async () => {
+        vi.mocked(loadRuntimePack).mockClear();
+        await expect(createNativeLinkInfo({ programObject: "/out/app.o", target: WASM32_WASI_TARGET, features,
+            ffi: { ffiFormat: 7, libraries: [], systemLibraries: [], frameworks: ["Foundation"], functions: [] },
+        })).rejects.toThrow("Darwin");
+        expect(loadRuntimePack).not.toHaveBeenCalled();
     });
 });
 //# sourceMappingURL=native-link-info.test.js.map

package/dist/backend/native-link-info.test.js.map

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

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

@@ -1,6 +1,8 @@
+export { toolchainEnvironmentCachePolicy, toolchainEnvironmentFingerprint, type ToolchainEnvironmentCachePolicy } from "./toolchain-environment.js";
+export { IPHONEOS_MIN_VERSION, ANDROID_MIN_API, isIosTarget, isAndroidTarget, isMobileTarget, mobileLibraryTarget, mobileTargetRefusal, configuredTargetPlatform } from "./target-platform.js";
 import { type WindowsSubsystem } from "./targets.js";
 export { buildCacheRoot, prepareBuildCacheRoot, pruneBuildCache, resolveBuildCacheRoot, } from "./build-cache.js";
-export declare const EXECUTABLE_RUNTIME_SOURCES: readonly ["scr_number.c", "scr_string.c", "scr_array.c", "scr_bytes.c", "scr_bytes_io.c", "scr_map.c", "scr_closure.c", "scr_ffi.c", "scr_object.c", "scr_union.c", "scr_exception.c", "scr_error.c", "scr_console.c", "scr_lib.c", "scr_path.c", "scr_url.c", "scr_json.c", "scr_async.c", "scr_crypto_async.c", "scr_child.c", "scr_cycle.c"];
+export declare const EXECUTABLE_RUNTIME_SOURCES: readonly ["scr_number.c", "scr_bigint.c", "scr_string.c", "scr_grapheme.c", "scr_array.c", "scr_bytes.c", "scr_bytes_io.c", "scr_map.c", "scr_closure.c", "scr_ffi.c", "scr_object.c", "scr_union.c", "scr_exception.c", "scr_error.c", "scr_console.c", "scr_lib.c", "scr_path.c", "scr_url.c", "scr_url_params.c", "scr_json.c", "scr_node_builtin.c", "scr_async.c", "scr_crypto_async.c", "scr_child.c", "scr_cycle.c"];
 /**
  * Per-target section-elimination recipe. This belongs beside the native
  * driver rather than a particular build path: one-shot compilation, cached
@@ -15,12 +17,6 @@ export declare function executableSectionEliminationFlags(platform: string): {
     compile: string[];
     link: string[];
 };
-export interface ToolchainEnvironmentCachePolicy {
-    completeArtifacts: boolean;
-    runtimeObjects: boolean;
-}
-export declare function toolchainEnvironmentCachePolicy(env?: NodeJS.ProcessEnv): ToolchainEnvironmentCachePolicy;
-export declare function toolchainEnvironmentFingerprint(env?: NodeJS.ProcessEnv): string;
 /** 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
@@ -38,7 +34,7 @@ export interface CcOptions {
      * when omitted: arbitrary C can depend on same-path edited headers and on
      * compiler-visible source spelling (`__FILE__`), neither of which the
      * top-level bytes alone can safely represent. scriptc's frontend supplies
-     * this for its generated C/LLVM IR; `--from-c` deliberately does not. */
+     * this for its generated LLVM IR; caller-supplied C deliberately does not. */
     cacheIdentity?: string;
     /** Native optimization posture. Release preserves the historical -O2
      * executable lane; dev selects -O0 and may compile a caller-provided LLVM
@@ -70,6 +66,8 @@ export interface CcOptions {
      * their builds bypass the complete-executable cache while still reusing
      * cached runtime objects. */
     systemLibraries?: readonly string[];
+    /** Darwin framework names, emitted as distinct driver arguments. */
+    frameworks?: readonly string[];
     /** Embed the dynamic-island engine (--dynamic): compiles scr_island.c,
      * defines SCR_DYNAMIC, and links the cached libqjs.a. Off retains the
      * static runtime selection; executable section GC may still remove
@@ -173,11 +171,8 @@ export interface CcOptions {
      * Symbol-free binaries keep their exact link line. */
     symbol?: boolean;
     bigint?: boolean;
-    /** The program uses the URLSearchParams surface (moduleUsesSearchParams
-     * on the IR): compiles scr_url_params.c into the binary — the symbol
-     * gating precedent: pure data structure (no loop hooks, no install),
-     * cross-compiles everywhere. sp-free binaries keep their exact link
-     * line (scr_url.c never references the unit). */
+    /** Records URLSearchParams use in the build identity. Its runtime unit is
+     * part of the base sources because checked URL handles expose searchParams. */
     searchParams?: boolean;
     /** The program uses the node:querystring surface (moduleUsesQs on the
      * IR): compiles scr_qs.c into the binary — the searchParams gating
@@ -287,20 +282,6 @@ export interface CcDriver {
  * the executable prefix rather than target presence: targetless Zig is still
  * a Zig build, while target presence is only the platform/target contract. */
 export declare function isZigDriver(driver: Pick<CcDriver, "argv">): boolean;
-export declare const IPHONEOS_MIN_VERSION = "15.0";
-export declare const ANDROID_MIN_API = 26;
-export declare function isIosTarget(target: string | null): boolean;
-export declare function isAndroidTarget(target: string | null): boolean;
-export declare function isMobileTarget(target: string | null): boolean;
-/** The canonical mobile triple SCRIPTC_TARGET selects, or null when the
- * environment names none. Pure string inspection — safe to consult before
- * any toolchain discovery runs. */
-export declare function mobileLibraryTarget(env?: NodeJS.ProcessEnv): string | null;
-/** The admission verdict for a mobile-family triple: null when the spelling
- * and host pairing are supported, otherwise the refusal text (the same text
- * resolveCc throws and compileLibrary reports as SC3002). Pure string/host
- * inspection — no discovery, no subprocess. */
-export declare function mobileTargetRefusal(target: string, hostPlatform?: NodeJS.Platform): string | null;
 export declare function resolveCc(env?: NodeJS.ProcessEnv, hostPlatform?: NodeJS.Platform): CcDriver;
 /** 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
@@ -308,7 +289,6 @@ export declare function resolveCc(env?: NodeJS.ProcessEnv, hostPlatform?: NodeJS
  * 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 declare function configuredTargetPlatform(env?: NodeJS.ProcessEnv, hostPlatform?: NodeJS.Platform): string;
 export declare function targetPlatform(driver: CcDriver): string;
 /** Architecture identity for host-native cache entries. Explicit cross targets
  * already name their complete target triple; native builds need the process
@@ -333,11 +313,11 @@ export interface LibArchiveOptions {
     /** Canonical externally visible definitions retained while the shard merge
      * demotes generated cross-shard linkage back to local symbols. */
     programPublicSymbols?: readonly string[];
-    /** Tiny generated C source carrying volatile library identity getters.
+    /** Tiny LLVM module carrying volatile library identity getters.
      * Its bytes join the complete archive key, but the source itself exists
      * only in the invocation-private build directory and the large program-
      * object cache is keyed independently. */
-    identityCSource?: string;
+    identityLlvmSource?: string;
     /** The archive to produce (<name>.lib.a). */
     outPath: string;
     /** Caller-owned identity for the generated TU's complete non-system
@@ -371,6 +351,7 @@ export interface LibArchiveOptions {
      * archive, byte-for-byte. */
     threadInstances?: boolean;
     /** IR-detected link gates (the compileC precedent, refusal-narrowed). */
+    dynInvoke?: boolean;
     regex?: boolean;
     assert?: boolean;
     inspect?: boolean;
@@ -383,6 +364,7 @@ export interface LibArchiveOptions {
     textDecoderLegacy?: boolean;
 }
 export declare function compileLibArchive(opts: LibArchiveOptions): Promise<void>;
+export declare function localizeLibraryObjects(driver: CcDriver, arArgv: readonly string[], buildDir: string, rootObjects: readonly string[], supportObjects: readonly string[], keepSymbols: readonly string[], stem: string, platform?: string): Promise<string>;
 /** 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