@scriptc/compiler 0.1.6 → 0.2.0

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_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
@@ -287,20 +285,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 +292,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 +316,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 +354,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 +367,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