@scriptc/compiler 0.4.5 → 0.4.6

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

@@ -0,0 +1,58 @@
+/* node:dgram — UDP sockets over the event loop (scr_dgram.c, linked only
+ * into using binaries). createSocket takes "udp4" or the
+ * { type: "udp4", reuseAddr? } literal; bind/connect bind NOW and defer
+ * 'listening'/'connect' to the next loop turn; send takes one string or
+ * Buffer datagram with an explicit port + address (the connected-send
+ * and callback forms have no lowering); address() returns the real
+ * {address, family, port} record and THROWS "Not running" before bind,
+ * like Node. The socket options throw Node's errors (EBADF before bind);
+ * add/dropMembership before bind is refused at run time (SC2020). 'error'
+ * with no listener exits 1 (the unhandled EventEmitter 'error' behavior). */
+declare module "dgram" {
+  export interface AddressInfo {
+    address: string;
+    family: string;
+    port: number;
+  }
+  export interface RemoteInfo {
+    address: string;
+    family: string;
+    port: number;
+    size: number;
+  }
+  export interface Socket {
+    bind(port: number, address?: string, callback?: () => void): void;
+    connect(port: number, address?: string, callback?: () => void): void;
+    send(msg: string | Uint8Array, port: number, address: string): void;
+    address(): AddressInfo;
+    close(callback?: () => void): void;
+    disconnect(): void;
+    unref(): void;
+    ref(): void;
+    setBroadcast(flag: boolean): void;
+    setTTL(ttl: number): number;
+    setMulticastTTL(ttl: number): number;
+    setMulticastLoopback(flag: boolean): boolean;
+    setMulticastInterface(multicastInterface: string): void;
+    addMembership(multicastAddress: string, multicastInterface?: string): void;
+    dropMembership(multicastAddress: string, multicastInterface?: string): void;
+    getRecvBufferSize(): number;
+    getSendBufferSize(): number;
+    setRecvBufferSize(size: number): void;
+    setSendBufferSize(size: number): void;
+    getSendQueueSize(): number;
+    getSendQueueCount(): number;
+    on(event: "message", listener: (msg: Buffer, rinfo: RemoteInfo) => void): void;
+    on(event: "listening" | "close" | "connect", listener: () => void): void;
+    on(event: "error", listener: (err: Error) => void): void;
+    once(event: "message", listener: (msg: Buffer, rinfo: RemoteInfo) => void): void;
+    once(event: "listening" | "close" | "connect", listener: () => void): void;
+    once(event: "error", listener: (err: Error) => void): void;
+  }
+  export function createSocket(type: "udp4"): Socket;
+  export function createSocket(options: { type: "udp4"; reuseAddr?: boolean }): Socket;
+}
+
+declare module "node:dgram" {
+  export * from "dgram";
+}

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

@@ -0,0 +1,87 @@
+/// <reference path="./async_hooks.d.ts" />
+
+/* node:diagnostics_channel — the in-process pub/sub core: named channels,
+ * subscribe/unsubscribe (module-level and channel-level), publish with any
+ * dyn-convertible message. Channel values are f64 handles into the
+ * runtime's channel registry (the readline.Interface precedent — channels
+ * are process-lived in Node too, its WeakRef machinery aside).
+ * The store-binding surface (bindStore/unbindStore/runStores) lowers onto
+ * the AsyncLocalStorage integration (dc.chan* libCalls).
+ *
+ * TracingChannel (tracingChannel) is the five-event-channel collection:
+ * 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
+ * exists in Node) but fences at the call site — the traced function's
+ * promise cannot cross the checked-dynamic tree boundary yet. */
+declare module "node:diagnostics_channel" {
+  export type ChannelListener = (message: unknown, name: string) => void;
+  export interface Channel {
+    readonly name: string;
+    readonly hasSubscribers: boolean;
+    publish(message: unknown): void;
+    subscribe(onMessage: ChannelListener): void;
+    unsubscribe(onMessage: ChannelListener): boolean;
+    bindStore(
+      store: import("async_hooks").AsyncLocalStorage<any>,
+      transform?: (context: any) => any,
+    ): void;
+    unbindStore(store: import("async_hooks").AsyncLocalStorage<any>): boolean;
+    runStores(context: unknown, fn: (...args: any[]) => any, thisArg?: any, ...args: any[]): any;
+  }
+  export function channel(name: string): Channel;
+  export function subscribe(name: string, onMessage: ChannelListener): void;
+  export function unsubscribe(name: string, onMessage: ChannelListener): boolean;
+  export function hasSubscribers(name: string): boolean;
+  export interface TracingChannelSubscribers {
+    start?: (message: any) => void;
+    end?: (message: any) => void;
+    asyncStart?: (message: any) => void;
+    asyncEnd?: (message: any) => void;
+    error?: (message: any) => void;
+  }
+  export interface TracingChannelCollection {
+    start: Channel;
+    end: Channel;
+    asyncStart: Channel;
+    asyncEnd: Channel;
+    error: Channel;
+  }
+  export interface TracingChannel {
+    start: Channel;
+    end: Channel;
+    asyncStart: Channel;
+    asyncEnd: Channel;
+    error: Channel;
+    readonly hasSubscribers: boolean;
+    subscribe(subscribers: TracingChannelSubscribers): void;
+    /** True when every present handler was found and removed (Node's
+     * all-found conjunction; @types/node under-declares this as void). */
+    unsubscribe(subscribers: TracingChannelSubscribers): boolean;
+    traceSync<ThisArg = any, Args extends any[] = any[], Result = any>(
+      fn: (this: ThisArg, ...args: Args) => Result,
+      context?: object,
+      thisArg?: ThisArg,
+      ...args: Args
+    ): Result;
+    tracePromise<ThisArg = any, Args extends any[] = any[], Result = any>(
+      fn: (this: ThisArg, ...args: Args) => Promise<Result>,
+      context?: object,
+      thisArg?: ThisArg,
+      ...args: Args
+    ): Promise<Result>;
+    traceCallback<ThisArg = any, Args extends any[] = any[], Result = any>(
+      fn: (this: ThisArg, ...args: Args) => Result,
+      position?: number,
+      context?: object,
+      thisArg?: ThisArg,
+      ...args: Args
+    ): Result;
+  }
+  export function tracingChannel(nameOrChannels: string | TracingChannelCollection): TracingChannel;
+}
+
+declare module "diagnostics_channel" {
+  export * from "node:diagnostics_channel";
+}

package/ambient/node-fallback/dns-promises.d.ts

@@ -0,0 +1,27 @@
+/// <reference path="./dns.d.ts" />
+
+/* node:dns/promises — lookup and lookupService as promises over the same
+ * resolution as the callback forms: argument errors throw synchronously,
+ * failures reject with the callbacks' errors. */
+declare module "dns/promises" {
+  import type { LookupAddress, LookupAllOptions, LookupOneOptions, LookupOptions } from "dns";
+  export function lookup(hostname: string, family: number): Promise<LookupAddress>;
+  export function lookup(hostname: string, options: LookupOneOptions): Promise<LookupAddress>;
+  export function lookup(hostname: string, options: LookupAllOptions): Promise<LookupAddress[]>;
+  export function lookup(
+    hostname: string,
+    options: LookupOptions,
+  ): Promise<LookupAddress | LookupAddress[]>;
+  export function lookup(hostname: string): Promise<LookupAddress>;
+  export function lookupService(
+    address: string,
+    port: number,
+  ): Promise<{ hostname: string; service: string }>;
+  export function getServers(): string[];
+  export function getDefaultResultOrder(): "ipv4first" | "ipv6first" | "verbatim";
+  export function setDefaultResultOrder(order: "ipv4first" | "ipv6first" | "verbatim"): void;
+}
+
+declare module "node:dns/promises" {
+  export * from "dns/promises";
+}

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

@@ -0,0 +1,65 @@
+/// <reference path="./dns-promises.d.ts" />
+
+/* node:dns — the lookup slice (scr_dgram.c hosts it; getaddrinfo runs AT
+ * CALL TIME and the callback defers to the next loop turn — SEMANTICS.md
+ * documents the blocking divergence). Only the { family: 4 } options
+ * form lowers; failures deliver Node's error shape ("getaddrinfo
+ * ENOTFOUND <hostname>") as the callback's Error argument, with "" for
+ * the address where Node passes undefined. */
+declare module "dns" {
+  export interface LookupAddress {
+    address: string;
+    family: number;
+  }
+  export interface LookupOptions {
+    family?: number | "IPv4" | "IPv6";
+    hints?: number;
+    all?: boolean;
+    order?: "ipv4first" | "ipv6first" | "verbatim";
+    verbatim?: boolean;
+  }
+  export interface LookupOneOptions extends LookupOptions {
+    all?: false;
+  }
+  export interface LookupAllOptions extends LookupOptions {
+    all: true;
+  }
+  /* The callback comes with the other lookup deliveries (literal
+   * addresses on the next tick); the options follow lib/dns.js. */
+  export function lookup(
+    hostname: string,
+    callback: (err: NodeJS.ErrnoException | null, address: string, family: number) => void,
+  ): void;
+  export function lookup(
+    hostname: string,
+    family: number,
+    callback: (err: NodeJS.ErrnoException | null, address: string, family: number) => void,
+  ): void;
+  export function lookup(
+    hostname: string,
+    options: LookupOneOptions,
+    callback: (err: NodeJS.ErrnoException | null, address: string, family: number) => void,
+  ): void;
+  export function lookup(
+    hostname: string,
+    options: LookupAllOptions,
+    callback: (err: NodeJS.ErrnoException | null, addresses: LookupAddress[]) => void,
+  ): void;
+  /* getnameinfo with NI_NAMEREQD: the host's name and the port's service
+   * name (the number when it has none). */
+  export function lookupService(
+    address: string,
+    port: number,
+    callback: (err: NodeJS.ErrnoException | null, hostname: string, service: string) => void,
+  ): void;
+  /* The nameservers /etc/resolv.conf lists. */
+  export function getServers(): string[];
+  export function getDefaultResultOrder(): "ipv4first" | "ipv6first" | "verbatim";
+  export function setDefaultResultOrder(order: "ipv4first" | "ipv6first" | "verbatim"): void;
+  /* The promise forms (node:dns/promises). */
+  export const promises: typeof import("dns/promises");
+}
+
+declare module "node:dns" {
+  export * from "dns";
+}

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

@@ -0,0 +1,60 @@
+/* node:events — the EventEmitter class (the module object IS the class,
+ * like Node's `module.exports = EventEmitter`). Listener/emit signatures
+ * mirror @types/node's untyped `...args: any[]` surface; the compiler's
+ * lowering unifies each event name's argument tuple program-wide and
+ * checks annotated listener parameters against it (unannotated non-empty
+ * parameter lists have no static types and fence at the registration). */
+declare module "events" {
+  class EventEmitter {
+    constructor();
+    static defaultMaxListeners: number;
+    /* Listeners registered under this symbol observe 'error' emits first
+     * (an emit with no 'error' listener still throws). */
+    static readonly errorMonitor: unique symbol;
+    static addAbortListener(signal: AbortSignal, listener: (event: Event) => void): Disposable;
+    on(eventName: string | symbol, listener: (...args: any[]) => void): this;
+    addListener(eventName: string | symbol, listener: (...args: any[]) => void): this;
+    once(eventName: string | symbol, listener: (...args: any[]) => void): this;
+    prependListener(eventName: string | symbol, listener: (...args: any[]) => void): this;
+    prependOnceListener(eventName: string | symbol, listener: (...args: any[]) => void): this;
+    off(eventName: string | symbol, listener: (...args: any[]) => void): this;
+    removeListener(eventName: string | symbol, listener: (...args: any[]) => void): this;
+    removeAllListeners(eventName?: string | symbol): this;
+    emit(eventName: string | symbol, ...args: any[]): boolean;
+    listenerCount(eventName: string | symbol, listener?: (...args: any[]) => void): number;
+    /* Declared as zero-parameter closures so the RESULT is statically
+     * consumable (.length, indexing, identity): the lowering only admits
+     * these calls for events whose argument tuple is empty — a listener
+     * pulled from the array is then safely callable too. Events with
+     * arguments fence (their element type would lie). */
+    listeners(eventName: string): Array<() => void>;
+    rawListeners(eventName: string): Array<() => void>;
+    eventNames(): string[];
+    setMaxListeners(n: number): this;
+    getMaxListeners(): number;
+  }
+  import internal = require("node:events");
+  namespace EventEmitter {
+    // The class under its own name, so `import { EventEmitter }` resolves
+    // (the @types/node namespace-alias pattern).
+    export { internal as EventEmitter };
+    // The event's arguments, as checked-dynamic values.
+    export function once(
+      emitter: EventEmitter | NodeJS.ReadableStream | NodeJS.WritableStream,
+      eventName: string,
+      options?: { signal?: AbortSignal },
+    ): Promise<unknown[]>;
+    /* The emitter's own listenerCount/getMaxListeners/setMaxListeners/
+     * listeners, over EventEmitter instances. */
+    export function listenerCount(emitter: EventEmitter, eventName: string | symbol): number;
+    export function getMaxListeners(emitter: EventEmitter): number;
+    export function setMaxListeners(n?: number, ...eventTargets: EventEmitter[]): void;
+    export function getEventListeners(emitter: EventEmitter, name: string): Array<() => void>;
+  }
+  export = EventEmitter;
+}
+
+declare module "node:events" {
+  import events = require("events");
+  export = events;
+}

package/ambient/node-fallback/fs-promises.d.ts

@@ -0,0 +1,225 @@
+/// <reference path="./fs.d.ts" />
+
+/* fs/promises — the SAME synchronous operations behind already-settled
+ * promises: success fulfills, failure REJECTS with the would-be thrown
+ * error (catchable at the await, like Node). DOCUMENTED DIVERGENCE
+ * (SEMANTICS.md): the syscall blocks the event loop, so I/O never
+ * interleaves with timers or other fibers — observable only in concurrent
+ * code. readFile is utf8-only, like readFileSync. */
+declare module "fs/promises" {
+  export interface FileReadResult<T extends Uint8Array> {
+    bytesRead: number;
+    buffer: T;
+  }
+  export interface FileWriteResult<T> {
+    bytesWritten: number;
+    buffer: T;
+  }
+  export interface FileReadvResult<T extends Uint8Array[]> {
+    bytesRead: number;
+    buffers: T;
+  }
+  export interface FileWritevResult<T extends Uint8Array[]> {
+    bytesWritten: number;
+    buffers: T;
+  }
+  export interface FileReadOptions<T extends Uint8Array = Buffer> {
+    buffer?: T;
+    offset?: number | null;
+    length?: number | null;
+    position?: number | null;
+  }
+  /* The streams over a FileHandle (createReadStream, createWriteStream,
+   * readLines): fs streams that hold the handle until they close; closing
+   * the stream closes the handle unless autoClose is false. */
+  export interface CreateReadStreamOptions {
+    encoding?: BufferEncoding | null;
+    autoClose?: boolean;
+    emitClose?: boolean;
+    start?: number;
+    end?: number;
+    highWaterMark?: number;
+  }
+  export interface CreateWriteStreamOptions {
+    encoding?: BufferEncoding | null;
+    autoClose?: boolean;
+    emitClose?: boolean;
+    start?: number;
+    highWaterMark?: number;
+    flush?: boolean;
+  }
+  export interface FileHandle extends AsyncDisposable {
+    readonly fd: number;
+    close(): Promise<void>;
+    createReadStream(options?: CreateReadStreamOptions): import("node:fs").ReadStream;
+    createWriteStream(options?: CreateWriteStreamOptions): import("node:fs").WriteStream;
+    readLines(options?: CreateReadStreamOptions): import("node:readline").Interface;
+    sync(): Promise<void>;
+    datasync(): Promise<void>;
+    truncate(len?: number): Promise<void>;
+    chmod(mode: number): Promise<void>;
+    utimes(atime: number | string | Date, mtime: number | string | Date): Promise<void>;
+    readv<T extends Uint8Array[]>(
+      buffers: T,
+      position?: number | null,
+    ): Promise<FileReadvResult<T>>;
+    writev<T extends Uint8Array[]>(
+      buffers: T,
+      position?: number | null,
+    ): Promise<FileWritevResult<T>>;
+    read<T extends Uint8Array = Buffer>(
+      options?: FileReadOptions<T> | null,
+    ): Promise<FileReadResult<T>>;
+    read<T extends Uint8Array>(
+      buffer: T,
+      options: Omit<FileReadOptions<T>, "buffer">,
+    ): Promise<FileReadResult<T>>;
+    read<T extends Uint8Array>(
+      buffer: T,
+      offset?: number | null,
+      length?: number | null,
+      position?: number | null,
+    ): Promise<FileReadResult<T>>;
+    write<T extends Uint8Array>(
+      buffer: T,
+      offset?: number | null,
+      length?: number | null,
+      position?: number | null,
+    ): Promise<FileWriteResult<T>>;
+    write<T extends Uint8Array>(
+      buffer: T,
+      options: Omit<FileReadOptions<T>, "buffer">,
+    ): Promise<FileWriteResult<T>>;
+    write(
+      data: string,
+      position?: number | null,
+      encoding?: "utf8" | "utf-8" | null,
+    ): Promise<FileWriteResult<string>>;
+    readFile(options?: null): Promise<Buffer>;
+    readFile(encoding: "utf8" | "utf-8"): Promise<string>;
+    writeFile(data: string | Uint8Array, encoding?: "utf8" | "utf-8" | null): Promise<void>;
+    appendFile(data: string | Uint8Array, encoding?: "utf8" | "utf-8" | null): Promise<void>;
+    stat(): Promise<import("node:fs").Stats>;
+    [Symbol.asyncDispose](): Promise<void>;
+  }
+  export function open(path: string | URL, flags?: string, mode?: number): Promise<FileHandle>;
+  export function link(
+    existingPath: string | Uint8Array | URL,
+    newPath: string | Uint8Array | URL,
+  ): Promise<void>;
+  export function symlink(
+    target: string | Uint8Array | URL,
+    path: string | Uint8Array | URL,
+    type?: string | null,
+  ): Promise<void>;
+  export function cp(
+    source: string | URL,
+    destination: string | URL,
+    options?: import("node:fs").CopyOptions,
+  ): Promise<void>;
+  export function readlink(
+    path: string | Uint8Array | URL,
+    options: "buffer" | { encoding: "buffer" },
+  ): Promise<Buffer>;
+  export function readlink(
+    path: string | Uint8Array | URL,
+    options?: BufferEncoding | { encoding?: BufferEncoding | null } | null,
+  ): Promise<string>;
+  export function readlink(
+    path: string | Uint8Array | URL,
+    options: string | { encoding?: string | null } | null,
+  ): Promise<string | Buffer>;
+  export function utimes(
+    path: string | Uint8Array | URL,
+    atime: number | string | Date,
+    mtime: number | string | Date,
+  ): Promise<void>;
+  export function lutimes(
+    path: string | Uint8Array | URL,
+    atime: number | string | Date,
+    mtime: number | string | Date,
+  ): Promise<void>;
+  export function readFile(path: string | URL, encoding: "utf8" | "utf-8"): Promise<string>;
+  export function readFile(
+    path: string | URL,
+    options: BufferEncoding | { encoding: BufferEncoding },
+  ): Promise<string>;
+  export function readFile(path: string | URL): Promise<Buffer>;
+  export function writeFile(
+    path: string | URL,
+    data: string,
+    options?: {
+      mode?: number;
+      encoding?: "utf8" | "utf-8";
+      flag?: string;
+      [option: string]: unknown;
+    },
+  ): Promise<void>;
+  export function writeFile(
+    path: string | URL,
+    data: string,
+    encoding: "utf8" | "utf-8",
+  ): Promise<void>;
+  export function mkdir(
+    path: string | URL,
+    options?: { recursive?: boolean; mode?: number },
+  ): Promise<void>;
+  export function readdir(path: string | URL): Promise<string[]>;
+  export function readdir(
+    path: string | URL,
+    options: {
+      encoding?: "utf8" | "utf-8";
+      withFileTypes: true;
+      recursive?: boolean;
+      [option: string]: unknown;
+    },
+  ): Promise<import("node:fs").Dirent[]>;
+  /* The async iterator form of fs.globSync: iterate it with for await. */
+  export function glob(
+    pattern: string | readonly string[],
+    options?: import("node:fs").GlobOptions,
+  ): AsyncIterableIterator<string>;
+  export function glob(
+    pattern: string | readonly string[],
+    options: import("node:fs").GlobOptionsWithFileTypes,
+  ): AsyncIterableIterator<import("node:fs").Dirent>;
+  export function rm(path: string | URL): Promise<void>;
+  export function rm(
+    path: string | URL,
+    options: { recursive?: boolean; force?: boolean; maxRetries?: number; retryDelay?: number },
+  ): Promise<void>;
+  export function stat(path: string | URL): Promise<import("node:fs").Stats>;
+  export function statfs(
+    path: string | Uint8Array | URL,
+    options?: import("node:fs").StatFsOptions & { bigint?: false },
+  ): Promise<import("node:fs").StatsFs>;
+  export function statfs(
+    path: string | Uint8Array | URL,
+    options: import("node:fs").StatFsOptions & { bigint: true },
+  ): Promise<import("node:fs").BigIntStatsFs>;
+  export function statfs(
+    path: string | Uint8Array | URL,
+    options?: import("node:fs").StatFsOptions,
+  ): Promise<import("node:fs").StatsFs | import("node:fs").BigIntStatsFs>;
+  export function realpath(path: string | URL): Promise<string>;
+  export function lstat(path: string | URL): Promise<import("node:fs").Stats>;
+  export function unlink(path: string | URL): Promise<void>;
+  export function chmod(path: string | URL, mode: number): Promise<void>;
+  export function chown(path: string | URL, uid: number, gid: number): Promise<void>;
+  export function lchown(path: string | URL, uid: number, gid: number): Promise<void>;
+  export function access(path: string | URL, mode?: number): Promise<void>;
+  export function truncate(path: string | URL, len?: number): Promise<void>;
+  export function appendFile(path: string | URL, data: string | Uint8Array): Promise<void>;
+  export function copyFile(src: string | URL, dest: string | URL): Promise<void>;
+  export function mkdtemp(prefix: string | URL): Promise<string>;
+  export function rmdir(path: string | URL): Promise<void>;
+  export function rename(oldPath: string | URL, newPath: string | URL): Promise<void>;
+  export function opendir(
+    path: string | URL,
+    options?: import("node:fs").OpenDirOptions,
+  ): Promise<import("node:fs").Dir>;
+}
+
+declare module "node:fs/promises" {
+  export * from "fs/promises";
+}