@scriptc/compiler 0.0.32 → 0.0.34

package/dist/backend/cc.d.ts

@@ -173,6 +173,10 @@ export interface CcOptions {
      * scr_watch.c into the binary — the net gating precedent, so watch-free
      * binaries keep their exact link line. */
     watch?: boolean;
+    /** The executable manifest has a format-5 foreign callback descriptor:
+     * compiles the MPSC queue/self-pipe unit. Other FFI and non-FFI binaries
+     * keep their existing runtime size class. */
+    foreignFfi?: boolean;
     /** The program uses node:test (moduleUsesNodeTest on the IR): compiles
      * scr_test.c into the binary — the net gating precedent, so test-free
      * binaries keep their exact link line. */
@@ -267,6 +271,15 @@ export declare function vendorCacheBuildIdentity(environmentFingerprint: string,
 export interface LibArchiveOptions {
     /** The program TU (.c or .ll — clang compiles either with -c). */
     cPath: string;
+    /** Invocation-owned program source to compile under `cPath`'s public
+     * spelling. Library assembly uses this for the identity-free projection of
+     * a complete caller-visible TU; its bytes drive every native cache key. */
+    programSource?: string;
+    /** Tiny generated C source 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;
     /** The archive to produce (<name>.lib.a). */
     outPath: string;
     /** Caller-owned identity for the generated TU's complete non-system
@@ -274,6 +287,8 @@ export interface LibArchiveOptions {
      * matching compileC's arbitrary-input safety boundary. */
     cacheIdentity?: string;
     sanitize?: boolean;
+    /** Native optimization posture: release = -O2, dev = -O0. */
+    optimization?: "release" | "dev";
     /** Multi-instance library mode (the profile's abi.localize_runtime): the
      * external symbols to KEEP global — every other scriptc external
      * definition in the archive (the runtime's internals, the program TU's
@@ -312,6 +327,16 @@ export declare function compileLibArchive(opts: LibArchiveOptions): Promise<void
 /** Resolve the build cache without touching the filesystem. Exported from this
  * internal module so its platform and override behavior can be pinned directly. */
 export declare function resolveBuildCacheRoot(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform, userHome?: string): string | null;
+/** Shared persistent-cache root for compiler-level tiers.  The early library
+ * cache deliberately follows the native cache's activation and hard-disable
+ * contract, while native compilation retains ownership of toolchain safety. */
+export declare function buildCacheRoot(): string | null;
+/** Harden/create a compiler-level cache root using the same privacy policy as
+ * the artifact caches.  Failure disables only the optional caller's tier. */
+export declare function prepareBuildCacheRoot(root: string | null): Promise<string | null>;
+/** Register a successful compiler-level cache write with the shared bounded
+ * LRU policy. */
+export declare function pruneBuildCache(root: string | null): Promise<void>;
 export declare function ccVersionOnce(argv: string[], environmentFingerprint?: string, fresh?: boolean): Promise<string>;
 /** Every system-header spelling consumed by a source tree scriptc owns. The
  * dependency probe preprocesses these spellings with the selected driver and