@scriptc/compiler 0.0.34 → 0.0.36

package/ambient/scriptc-node-fallback.d.ts

@@ -800,7 +800,7 @@ declare module "timers/promises" {
  * the AsyncLocalStorage integration (dc.chan* libCalls).
  *
  * TracingChannel (tracingChannel) is the five-event-channel collection:
- * an f64 handle into the runtime's tracing registry (types.ts maps the
+ * an f64 handle into the runtime's tracing registry (type-mapper.ts maps the
  * name like Channel). subscribe/unsubscribe walk a handlers object;
  * traceSync/traceCallback run Node's publish choreography in the runtime
  * (context defaults to a fresh {}); tracePromise is declared (the member
@@ -992,7 +992,7 @@ declare module "node:fs" {
   export function readdirSync(path: string): string[];
   /* The withFileTypes form: Dirent rows (name + parentPath + the type
    * probes — the honest subset of Node's Dirent surface). The type is
-   * interned explicitly in types.ts (the record's hidden %dtype field
+   * interned explicitly in type-mapper.ts (the record's hidden %dtype field
    * carries the entry kind; isFile/isDirectory/isSymbolicLink lower as
    * reads of it in lower-builtins.ts). */
   export interface Dirent {
@@ -1239,7 +1239,7 @@ declare module "os" {
   /* The passwd-entry snapshot (uv_os_get_passwd): shell is `string |
    * null` to match @types/node (POSIX always answers the string arm);
    * homedir is pw_dir — NOT os.homedir()'s $HOME-first cascade. The type
-   * is interned explicitly in types.ts (the AddressInfo pattern — this
+   * is interned explicitly in type-mapper.ts (the AddressInfo pattern — this
    * concrete form and @types/node's UserInfo<string> both), and the call
    * assembles field-by-field in lowerOsUserInfoCall. */
   export interface UserInfo {
@@ -1570,7 +1570,7 @@ declare module "child_process" {
   /* The named options interface for the string-encoding exec form —
    * @types/node's ExecFileSyncOptionsWithStringEncoding, narrowed to the
    * honestly-implemented members. VALUES of this type are a real record
-   * (types.ts interns the shape), so a typed const or a runner function's
+   * (type-mapper.ts interns the shape), so a typed const or a runner function's
    * options parameter flows to execFileSync at runtime — the windows-ca
    * command-runner idiom. */
   export interface ExecFileSyncOptionsWithStringEncoding {
@@ -2036,8 +2036,9 @@ declare module "net" {
      * spelling). */
     listen(port: number, host: string, callback?: () => void): Server;
     /* The explicit-interface bind: host is an IP literal (absent = the
-     * host-less dual-stack any); ipv6Only sets IPV6_V6ONLY. */
-    listen(options: { port: number; host?: string; ipv6Only?: boolean }, callback?: () => void): Server;
+     * host-less dual-stack any); ipv6Only sets IPV6_V6ONLY and reusePort
+     * requests kernel connection distribution where Node supports it. */
+    listen(options: { port: number; host?: string; ipv6Only?: boolean; reusePort?: boolean }, callback?: () => void): Server;
     close(callback?: () => void): void;
     /* The bound AddressInfo (Node answers null before listen — this
      * surface answers the record with port 0 there, the serverPort

package/dist/backend/build-cache.d.ts

@@ -0,0 +1,44 @@
+export declare function fileExists(path: string): Promise<boolean>;
+export declare function protectCachedArtifact(paths: Set<string> | undefined, path: string): void;
+export declare function privateSiblingPath(destination: string, label: string): string;
+/** Copy an artifact through a private sibling name, then atomically install it.
+ * The source can live on another filesystem (cache/temp roots commonly do), so
+ * a direct rename is not portable. */
+export declare function installArtifact(source: string, destination: string, mode?: number): 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 cacheRootDir(): string | null;
+/** The production cache can contain complete user executables/archives with
+ * embedded source literals or comptime values. Its root is therefore private
+ * regardless of the caller's ordinary output umask. Windows inherits the
+ * per-user LOCALAPPDATA ACL. POSIX platform-default roots are hardened for
+ * upgrades; an arbitrary existing SCRIPTC_CACHE_DIR override is never chmod'd
+ * and participates only when its caller-provided mode is already private. */
+export declare function ensurePrivateCacheRoot(root: string, hardenExisting: boolean): Promise<void>;
+export declare function cacheDigestPath(path: string): string;
+export declare function fileDigest(path: string): Promise<string>;
+/** Cache entries are disposable data, not trusted compiler output. Atomic
+ * rename prevents ordinary partial writes, while the adjacent digest catches
+ * disk damage, manual truncation, and entries left by an interrupted/older
+ * publisher before they reach clang, the linker, or `ar`. */
+export declare function validCachedFile(object: string): Promise<boolean>;
+/** Copy a cache entry and verify the private copy before it can become a
+ * caller-visible artifact. Verifying after the copy closes the gap between a
+ * source-side digest check and a concurrent replacement/truncation. */
+export declare function copyValidCachedFile(source: string, destination: string): Promise<boolean>;
+/** Publish a complete executable/archive and its digest through private names.
+ * Data is installed before its verifier, so a racing reader can only observe
+ * an invalid/missing digest and take the fresh-build path. */
+export declare function publishCachedFile(source: string, destination: string): Promise<void>;
+export declare function pruneCache(root: string, protectedPaths?: ReadonlySet<string>): Promise<void>;

package/dist/backend/build-cache.js

@@ -0,0 +1,241 @@
+import { createHash } from "node:crypto";
+import { chmod, copyFile, mkdir, readdir, readFile, rename, rm, stat, unlink, utimes, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, dirname, join, resolve } from "node:path";
+export async function fileExists(path) {
+    return stat(path).then((s) => s.isFile(), () => false);
+}
+export function protectCachedArtifact(paths, path) {
+    paths?.add(path);
+    paths?.add(cacheDigestPath(path));
+}
+export function privateSiblingPath(destination, label) {
+    // Keep the temporary component independent of the caller's basename. A
+    // destination can validly consume the filesystem's entire NAME_MAX budget;
+    // appending or prepending that basename would make the atomic install fail.
+    return join(dirname(destination), `.scriptc-${label}-${process.pid}-${Math.random().toString(36).slice(2)}`);
+}
+/** Copy an artifact through a private sibling name, then atomically install it.
+ * The source can live on another filesystem (cache/temp roots commonly do), so
+ * a direct rename is not portable. */
+export async function installArtifact(source, destination, mode) {
+    await mkdir(dirname(destination), { recursive: true });
+    const tmp = privateSiblingPath(destination, "install");
+    try {
+        await copyFile(source, tmp);
+        if (mode !== undefined)
+            await chmod(tmp, mode);
+        await rename(tmp, destination);
+    }
+    finally {
+        await rm(tmp, { force: true }).catch(() => undefined);
+    }
+}
+/** Resolve the build cache without touching the filesystem. Exported from this
+ * internal module so its platform and override behavior can be pinned directly. */
+export function resolveBuildCacheRoot(env = process.env, platform = process.platform, userHome = homedir()) {
+    if (env["SCRIPTC_NO_CACHE"] === "1")
+        return null;
+    const configured = env["SCRIPTC_CACHE_DIR"];
+    if (configured !== undefined)
+        return configured === "" ? null : resolve(configured);
+    const xdg = env["XDG_CACHE_HOME"];
+    if (xdg !== undefined && xdg !== "")
+        return resolve(xdg, "scriptc", "build");
+    if (platform === "win32") {
+        const local = env["LOCALAPPDATA"];
+        if (local !== undefined && local !== "")
+            return resolve(local, "scriptc", "cache", "build");
+    }
+    return platform === "darwin"
+        ? resolve(userHome, "Library", "Caches", "scriptc", "build")
+        : resolve(userHome, ".cache", "scriptc", "build");
+}
+/** 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 function buildCacheRoot() {
+    return resolveBuildCacheRoot();
+}
+/** 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 async function prepareBuildCacheRoot(root) {
+    if (root === null)
+        return null;
+    try {
+        await ensurePrivateCacheRoot(root, process.env["SCRIPTC_CACHE_DIR"] === undefined);
+        return root;
+    }
+    catch {
+        return null;
+    }
+}
+/** Register a successful compiler-level cache write with the shared bounded
+ * LRU policy. */
+export async function pruneBuildCache(root) {
+    if (root !== null)
+        await pruneCache(root).catch(() => undefined);
+}
+export function cacheRootDir() {
+    return resolveBuildCacheRoot();
+}
+/** The production cache can contain complete user executables/archives with
+ * embedded source literals or comptime values. Its root is therefore private
+ * regardless of the caller's ordinary output umask. Windows inherits the
+ * per-user LOCALAPPDATA ACL. POSIX platform-default roots are hardened for
+ * upgrades; an arbitrary existing SCRIPTC_CACHE_DIR override is never chmod'd
+ * and participates only when its caller-provided mode is already private. */
+export async function ensurePrivateCacheRoot(root, hardenExisting) {
+    const existing = await stat(root).then((info) => info, (error) => {
+        if (error.code === "ENOENT")
+            return null;
+        throw error;
+    });
+    if (existing !== null && !existing.isDirectory()) {
+        throw new Error("native cache root is not a directory");
+    }
+    if (process.platform !== "win32" &&
+        existing !== null &&
+        !hardenExisting &&
+        (existing.mode & 0o077) !== 0) {
+        throw new Error("existing native cache override is not private");
+    }
+    await mkdir(root, { recursive: true, mode: 0o700 });
+    if (process.platform !== "win32" && (existing === null || hardenExisting)) {
+        await chmod(root, 0o700);
+    }
+}
+export function cacheDigestPath(path) {
+    return `${path}.sha256`;
+}
+export async function fileDigest(path) {
+    return createHash("sha256").update(await readFile(path)).digest("hex");
+}
+/** Cache entries are disposable data, not trusted compiler output. Atomic
+ * rename prevents ordinary partial writes, while the adjacent digest catches
+ * disk damage, manual truncation, and entries left by an interrupted/older
+ * publisher before they reach clang, the linker, or `ar`. */
+export async function validCachedFile(object) {
+    try {
+        const digestPath = cacheDigestPath(object);
+        const expected = (await readFile(digestPath, "utf8")).trim();
+        const valid = /^[0-9a-f]{64}$/.test(expected) && (await fileDigest(object)) === expected;
+        if (valid) {
+            const now = new Date();
+            await Promise.all([
+                utimes(object, now, now).catch(() => undefined),
+                utimes(digestPath, now, now).catch(() => undefined),
+            ]);
+        }
+        return valid;
+    }
+    catch {
+        return false;
+    }
+}
+/** Copy a cache entry and verify the private copy before it can become a
+ * caller-visible artifact. Verifying after the copy closes the gap between a
+ * source-side digest check and a concurrent replacement/truncation. */
+export async function copyValidCachedFile(source, destination) {
+    try {
+        const digestPath = cacheDigestPath(source);
+        const expected = (await readFile(digestPath, "utf8")).trim();
+        if (!/^[0-9a-f]{64}$/.test(expected))
+            return false;
+        await copyFile(source, destination);
+        if ((await fileDigest(destination)) !== expected) {
+            await rm(destination, { force: true }).catch(() => undefined);
+            return false;
+        }
+        const now = new Date();
+        await Promise.all([
+            utimes(source, now, now).catch(() => undefined),
+            utimes(digestPath, now, now).catch(() => undefined),
+        ]);
+        return true;
+    }
+    catch {
+        await rm(destination, { force: true }).catch(() => undefined);
+        return false;
+    }
+}
+/** Publish a complete executable/archive and its digest through private names.
+ * Data is installed before its verifier, so a racing reader can only observe
+ * an invalid/missing digest and take the fresh-build path. */
+export async function publishCachedFile(source, destination) {
+    const directory = dirname(destination);
+    await mkdir(directory, { recursive: true });
+    const nonce = `${process.pid}-${Math.random().toString(36).slice(2)}`;
+    const tmp = join(directory, `.tmp-${basename(destination).slice(0, 8)}-${nonce}`);
+    const tmpDigest = `${tmp}.sha256`;
+    try {
+        await copyFile(source, tmp);
+        await chmod(tmp, 0o600);
+        await writeFile(tmpDigest, `${await fileDigest(tmp)}\n`, { mode: 0o600 });
+        await rename(tmp, destination);
+        await rename(tmpDigest, cacheDigestPath(destination));
+    }
+    finally {
+        await Promise.all([
+            rm(tmp, { force: true }).catch(() => undefined),
+            rm(tmpDigest, { force: true }).catch(() => undefined),
+        ]);
+    }
+}
+/** Size-capped LRU sweep of the whole cache root. A caller-configured cap is
+ * enforced after every successful cache write. The 4 GiB default is checked on
+ * the first and every 64th write in a long-lived process: a full tree walk per
+ * corpus program would otherwise become quadratic as the cache grows. Oldest-
+ * mtime files go first until the tree is back under 75% of the cap; reads bump
+ * mtimes. Active links use private staged names/hard links, so cache names can
+ * be unlinked safely. */
+const rootWriteCounts = new Map();
+export async function pruneCache(root, protectedPaths) {
+    const configuredCap = process.env["SCRIPTC_CACHE_MAX_MB"];
+    const writes = (rootWriteCounts.get(root) ?? 0) + 1;
+    rootWriteCounts.set(root, writes);
+    if (configuredCap === undefined && writes !== 1 && writes % 64 !== 0)
+        return;
+    const capBytes = Number(configuredCap ?? "4096") * 1024 * 1024;
+    if (!Number.isFinite(capBytes) || capBytes <= 0)
+        return;
+    const files = [];
+    const walk = async (dir) => {
+        const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+        for (const ent of entries) {
+            const p = join(dir, ent.name);
+            if (ent.isDirectory())
+                await walk(p);
+            else if (ent.isFile()) {
+                // Atomic publishers use private names until their data/digest or
+                // metadata stamp is complete. They are active writes, not LRU entries.
+                if (ent.name.startsWith(".scriptc-") ||
+                    ent.name.startsWith(".tmp-") ||
+                    ent.name.includes(".tmp-"))
+                    continue;
+                if (protectedPaths?.has(p))
+                    continue;
+                const s = await stat(p).catch(() => null);
+                if (s !== null)
+                    files.push({ path: p, size: s.size, mtimeMs: s.mtimeMs });
+            }
+        }
+    };
+    await walk(root);
+    let total = files.reduce((n, f) => n + f.size, 0);
+    if (total <= capBytes)
+        return;
+    files.sort((a, b) => a.mtimeMs - b.mtimeMs);
+    for (const f of files) {
+        if (total <= capBytes * 0.75)
+            break;
+        try {
+            await unlink(f.path);
+            total -= f.size;
+        }
+        catch {
+            // A concurrent reader/publisher may already have moved the name.
+        }
+    }
+}
+//# sourceMappingURL=build-cache.js.map

package/dist/backend/build-cache.js.map

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

package/dist/backend/{emission/emit-async.d.ts → c/async.d.ts}

@@ -1,10 +1,10 @@
-import type { CEmitter } from "./emitter.js";
-import { IrType } from "../../ir/nodes.js";
+import type { CEmitter } from "./c-emitter.js";
+import { IrType } from "../../ir/ir.js";
 /** Per-async-function machinery: an argument pack, a fiber trampoline
    * (unpacks, runs the ordinary compiled body, settles the promise), and a
    * spawn wrapper call sites use. Lifted async lambdas additionally thread
    * their closure env through the pack (+1, released after the body). */
-export declare function emitAsyncScaffolding(E: CEmitter, out: string[]): void;
+export declare function emitAsyncScaffolding(emitter: CEmitter, out: string[]): void;
 /** Interned per-union child exit adapter: the runtime invokes
    * adapter(cb, has_code, code, signal_name); the adapter builds the
    * `number | null` union value (tags are program data — the frontend
@@ -12,19 +12,19 @@ export declare function emitAsyncScaffolding(E: CEmitter, out: string[]): void;
    * owns the union param per the universal convention (unit-arm
    * instances are immortal; their release is a no-op). The one-param
    * shape ignores the signal. */
-export declare function childExitThunkFor(E: CEmitter, param: IrType): string;
+export declare function childExitThunkFor(emitter: CEmitter, param: IrType): string;
 /** The TWO-parameter exit adapter — Node's `(code, signal)` listener:
    * the code union as above plus the signal as its own `string | null`
    * union (a fresh string from the runtime's static signal name when a
    * signal killed the child, the null arm otherwise). */
-export declare function childExitThunkFor2(E: CEmitter, codeParam: IrType, sigParam: IrType): string;
+export declare function childExitSignalThunkFor(emitter: CEmitter, codeParam: IrType, sigParam: IrType): string;
 /** Interned per-union child-stream data adapter: the runtime invokes
    * adapter(cb, chunk) with the chunk BORROWED; the adapter wraps a
    * retained chunk at the union's Buffer arm (the frontend guaranteed
    * the arm exists — the ngrok `Buffer | string` listener; strings never
    * fire from a pipe) and calls the listener, which owns the union param
    * per the universal convention. */
-export declare function childDataThunkFor(E: CEmitter, param: IrType): string;
+export declare function childDataThunkFor(emitter: CEmitter, param: IrType): string;
 /** Interned per-union bound-close adapter (`server.close.bind(server)`
    * as a value): invoked through the closure ABI with the callback-union
    * argument, it closes the server DIRECTLY (never through the override —
@@ -33,13 +33,13 @@ export declare function childDataThunkFor(E: CEmitter, param: IrType): string;
    * `(err?: Error) => void`) behind an emitted zero-arg trampoline that
    * fires it with the undefined arm (a clean close carries no error) —
    * and answers the +1 server (Node's chaining return). */
-export declare function closeBindThunkFor(E: CEmitter, cbUnion: IrType, retServer: boolean): string;
+export declare function closeBindThunkFor(emitter: CEmitter, cbUnion: IrType, retServer: boolean): string;
 /** Interned close-override zero-arg wrapper (`server.close = fn`): the
    * stored override must be invocable by the runtime WITHOUT program
    * types, so this wrapper carries the user function and fires it with
    * the undefined-arm callback argument (tags are program data),
    * releasing the chaining-return server when the signature answers one. */
-export declare function closeOverrideWrapFor(E: CEmitter, cbUnion: IrType, retServer: boolean): string;
+export declare function closeOverrideWrapFor(emitter: CEmitter, cbUnion: IrType, retServer: boolean): string;
 /** Interned per-shape dgram message adapter for the TWO-parameter
    * (msg: Buffer, rinfo) listener: the rinfo RECORD is program data, so
    * the adapter builds it from the runtime's parts (address/family
@@ -47,26 +47,26 @@ export declare function closeOverrideWrapFor(E: CEmitter, cbUnion: IrType, retSe
    * which owns both params per the universal convention (msg retains like
    * the net data thunk). Zero/one-param listeners take the runtime's own
    * scr_dgram_msg_thunk0/1. */
-export declare function dgramMsgThunkFor(E: CEmitter, param: IrType): string;
+export declare function dgramMsgThunkFor(emitter: CEmitter, param: IrType): string;
 /** Interned dns.lookup callback adapter, per (union id, param count):
    * the runtime invokes adapter(cb, errmsg-or-NULL, address, family) with
    * everything borrowed; the adapter builds the `Error | null` first
    * argument (tags are program data — the frontend pinned the union) and
    * calls the listener with as many arguments as it declared, each owned
    * per the universal convention. */
-export declare function dnsLookupThunkFor(E: CEmitter, cbT: IrType): string;
+export declare function dnsLookupThunkFor(emitter: CEmitter, cbT: IrType): string;
 /** Interned fs.rename callback adapter. The runtime supplies a borrowed
  * ScrError (or NULL); the adapter builds the callback's program-specific
  * Error | null union, or a dyn error/null for checkJs callbacks. */
-export declare function fsRenameThunkFor(E: CEmitter, cbT: IrType): string;
+export declare function fsRenameThunkFor(emitter: CEmitter, cbT: IrType): string;
 /** Interned CONNECT-listener adapter for a UNION socket slot — the h2
    * compat listener (`(req, resOrSocket: Http2ServerResponse | net.Socket)
    * => void`): the runtime fires (cb, req, sock, head) like an upgrade;
    * the adapter wraps the socket at the union's netSocket arm (its tag is
    * program data) and drops `head` when the listener declares two params.
    * All three runtime args arrive +1; the union takes the socket's. */
-export declare function connectSockThunkFor(E: CEmitter, cbT: IrType): string;
-export declare function connectResThunkFor(E: CEmitter, cbT: IrType): string;
+export declare function connectSockThunkFor(emitter: CEmitter, cbT: IrType): string;
+export declare function connectResThunkFor(emitter: CEmitter, cbT: IrType): string;
 /** Interned net.connect-lookup answer thunk: the fn of the runtime-minted
    * callback the caller's `lookup` option receives (the SNI-answer
    * pattern). COMPILED code calls it per its static type — `(err:
@@ -75,7 +75,7 @@ export declare function connectResThunkFor(E: CEmitter, cbT: IrType): string;
    * tag) and the addresses record's field layout down to the runtime's
    * (has_err, message, ip-list) answer. Params arrive +1 and release
    * here; the extracted message/ips hand over +1. */
-export declare function netLookupAnswerThunkFor(E: CEmitter, cbT: IrType): string;
+export declare function netLookupAnswerThunkFor(emitter: CEmitter, cbT: IrType): string;
 /** Interned SNI answer-closure thunk: the fn of the runtime-minted `cb`
    * a TLS server's SNICallback receives. COMPILED code calls cb per its
    * static type — `(err: Error | null, ctx?: SecureContext) => void`, or
@@ -84,7 +84,7 @@ export declare function netLookupAnswerThunkFor(E: CEmitter, cbT: IrType): strin
    * to the runtime's (has_err, ctx-or-NULL) answer. The thunk owns its
    * union params per the universal convention (the ctx payload retains
    * +1 before its union releases; ownership moves to the runtime). */
-export declare function sniAnswerThunkFor(E: CEmitter, cbT: IrType): string;
+export declare function sniAnswerThunkFor(emitter: CEmitter, cbT: IrType): string;
 /** Interned Promise.race fulfillment adapter: converts a settled entry's
    * payload (inner type `from`) into the result promise's inner type `to`
    * and fulfills the destination. Three shapes, mirroring the frontend's
@@ -93,7 +93,7 @@ export declare function sniAnswerThunkFor(E: CEmitter, cbT: IrType): string;
    * entry re-tags arm-wise (canonical arm order makes the mapping a
    * typeKey lookup). Rejections never reach adapters — the runtime copies
    * them raw. */
-export declare function raceAdapterFor(E: CEmitter, from: IrType, to: IrType): string;
+export declare function raceAdapterFor(emitter: CEmitter, from: IrType, to: IrType): string;
 /** Interned generator-resume result builder: reads the post-resume state
    * of a generator into a fresh IteratorResult record `{ done, value }`.
    * One helper per generator type (every next/return/throw on it shares
@@ -103,29 +103,20 @@ export declare function raceAdapterFor(E: CEmitter, from: IrType, to: IrType): s
    * a present completion value wraps the same way and an empty OUT is
    * JS's undefined (the interned undefined arm — or the dyn undefined
    * when V is dyn, the any/unknown channel). */
-export declare function genResultThunkFor(E: CEmitter, genT: IrType & {
+export declare function genResultThunkFor(emitter: CEmitter, genT: IrType & {
     kind: "generator";
 }, recT: IrType & {
     kind: "record";
 }): string;
 /** Interned per inner-type resolve thunk for ref-kind new Promise. */
-export declare function resolveThunkFor(E: CEmitter, inner: IrType): string;
+export declare function resolveThunkFor(emitter: CEmitter, inner: IrType): string;
 /** The EventEmitter listener invoke adapter for one listener signature:
  * `void (ScrClosure *, va_list)` — va_args exactly the listener's own
  * parameter prefix of the emit site's typed tail (the frontend unified
  * the tuple, so reads agree with writes), retains each refcounted value
  * (the callee owns +1 per the universal convention; f64/bool copy), and
  * calls cb->fn behind its exact C signature. Interned per func-type key. */
-export declare function emitterInvokeThunkFor(E: CEmitter, cbT: IrType): string;
-/** The stream completion-callback closure fn for one done func type: the
- * `callback` a user's write/final/destroy/transform/flush receives. The
- * closure's one capture box holds the stream (+1); calling it unwraps the
- * (optional) error/data union arguments and reports completion to the
- * runtime. Kind names the runtime entry: "w" scr_stream_write_done, "f"
- * scr_stream_final_done, "d" scr_stream_destroy_done, "t"
- * scr_stream_transform_done, "l" scr_stream_flush_done. Args arrive
- * callee-owned (+1) per the universal convention and are released here. */
-export declare function streamDoneFnFor(E: CEmitter, kind: "w" | "f" | "d" | "t" | "l", doneT: IrType): string;
+export declare function emitterInvokeThunkFor(emitter: CEmitter, cbT: IrType): string;
 /** The stream-'data' listener invoke adapter for one listener func type:
  * the runtime's 'data' emission carries BOTH payload slots (ScrBytes *b,
  * ScrStr *s — exactly one non-NULL; encoded streams deliver strings),
@@ -135,7 +126,7 @@ export declare function streamDoneFnFor(E: CEmitter, kind: "w" | "f" | "d" | "t"
  * just hand the value over — SEMANTICS.md). Zero-parameter listeners
  * ignore both slots; DYN-parameter listeners (the JS lane's adapter,
  * emitter.onDataDyn) box by tag, which is always right. */
-export declare function streamDataThunkFor(E: CEmitter, cbT: IrType): string;
+export declare function streamDataThunkFor(emitter: CEmitter, cbT: IrType): string;
 /** The stream option-callback invoke adapter for one (kind, callback
  * type): the runtime calls the user's read/write/final/destroy/transform/
  * flush closure through it. The stream rides first (the leading `this`
@@ -147,4 +138,4 @@ export declare function streamDataThunkFor(E: CEmitter, cbT: IrType): string;
  * never complete, exactly Node. Kinds: "r" read(size), "w" write(chunk,
  * enc, cb), "f" final(cb), "d" destroy(err, cb), "t" transform(chunk,
  * enc, cb), "l" flush(cb). */
-export declare function streamCbThunkFor(E: CEmitter, kind: "r" | "w" | "f" | "d" | "t" | "l" | "e", cbT: IrType): string;
+export declare function streamCbThunkFor(emitter: CEmitter, kind: "r" | "w" | "f" | "d" | "t" | "l" | "e", cbT: IrType): string;