@scriptc/compiler 0.1.3 → 0.1.5

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

@@ -62,15 +62,14 @@ declare namespace NodeJS {
    * keeps the loop alive. */
   interface ReadableStream {
     on(event: "data", listener: (chunk: Buffer) => void): void;
+    on(event: "data", listener: (chunk: string) => void): void;
     on(event: "end", listener: () => void): void;
     once(event: "data", listener: (chunk: Buffer) => void): void;
+    once(event: "data", listener: (chunk: string) => void): void;
     once(event: "end", listener: () => void): void;
-    /* Declared surface without a lowering (chunks stay bytes; decode
-     * with TextDecoder) — string-mode consumers typecheck and fence at
-     * the reached site. With setEncoding in force Node hands strings to
-     * 'data', hence the string arm on the listener above being absent:
-     * the lowered surface is bytes-only. */
-    setEncoding(encoding: string): void;
+    /* setEncoding('utf8') makes subsequent data chunks strings, including
+     * multibyte sequences split across native pipe reads. */
+    setEncoding(encoding: string): this;
   }
 }
 
@@ -181,11 +180,13 @@ declare var process: {
    * callers forward a `string | null` result field. */
   kill(pid: number, signal?: string | number | null): true;
   env: { [name: string]: string | undefined };
+  /** Numeric writes set the status returned by ordinary program exit. */
+  exitCode?: number;
   /* `never`, like @types/node: code behind an early-exit guard narrows
    * (`if (!x) process.exit(1)` proves x afterwards) — typed `void` the
    * guard narrows nothing and correct programs fail preflight. The
-   * lowering already handles the optional code (bare exit() is exit(0),
-   * Node's behavior when exitCode was never set). */
+   * lowering already handles the optional code (bare exit() uses exitCode,
+   * or zero when it was never set). */
   exit(code?: number | null): never;
   cwd(): string;
   /* The user tick queue: callbacks run before promise jobs at every loop
@@ -280,6 +281,14 @@ declare var process: {
   /* emitWarning — Node's full grammar (string or Error warning; type/
    * ctor/options second; code/ctor third). */
   emitWarning(warning: string | Error, ...args: any[]): void;
+  /** Present in a child created by child_process.fork(). */
+  readonly connected: boolean;
+  send?(message: object, callback?: (error: Error | null) => void): boolean;
+  disconnect(): void;
+  on(event: "message", listener: (message: any) => void): void;
+  on(event: "disconnect", listener: () => void): void;
+  once(event: "message", listener: (message: any) => void): void;
+  once(event: "disconnect", listener: () => void): void;
 };
 
 /* Node's process module default export is the global process object. These
@@ -770,6 +779,7 @@ interface Request {
   arrayBuffer(): Promise<ArrayBuffer>;
   bytes(): Promise<Uint8Array>;
 }
+type RequestInfo = string | URL | Request;
 interface RequestInit {
   method?: string;
   headers?:
@@ -782,7 +792,7 @@ interface RequestInit {
   signal?: AbortSignal;
 }
 declare var Request: {
-  new (input: string | URL | Request, init?: RequestInit): Request;
+  new (input: RequestInfo, init?: RequestInit): Request;
   readonly prototype: Request;
 };
 declare function fetch(input: string | URL, init?: RequestInit): Promise<Response>;
@@ -947,15 +957,19 @@ declare var performance: import("node:perf_hooks").Performance;
  * createRequire(import.meta.url) (or __filename) whose require calls
  * take STATIC string literals — the indirection erases at compile time.
  * A builtin spec makes the binding a namespace import in const clothing;
- * a relative .json document bakes and parses (JSON.parse's `unknown`
- * stance — validate with a checked cast); an installed npm package loads
- * through the island's require-condition entry under --dynamic; a bare
- * name nothing installed resolves compiles to Node's catchable
- * MODULE_NOT_FOUND throw (the optional-dependency try/require pattern).
+ * relative and package-import program modules use the compiled module
+ * graph; a relative .json document bakes and parses (JSON.parse's
+ * `unknown` stance — validate with a checked cast); an installed npm
+ * package loads through the island's require-condition entry under
+ * --dynamic, or through the compiled graph under --npm-static; a bare name
+ * nothing installed resolves compiles to Node's catchable MODULE_NOT_FOUND
+ * throw (the optional-dependency try/require pattern).
  * Dynamic specifiers fence: a compiled binary's module graph is fixed at
  * build time. builtinModules is the baked Node v24 list (a fresh
  * mutable array per read where Node ships one frozen singleton);
- * isBuiltin and syncBuiltinESMExports fence per site. Both spellings
+ * isBuiltin checks runtime strings against that pinned list, and
+ * syncBuiltinESMExports is a no-op because the static builtin surface is
+ * immutable. Both spellings
  * name the builtin, like in Node (the builtin wins over the npm package
  * named "module" for the bare specifier there too). */
 declare module "node:module" {
@@ -1007,6 +1021,15 @@ declare module "node:fs" {
   export function readFileSync(fd: number): Buffer;
   /* The options-object spelling of the utf8 form. */
   export function readFileSync(path: string, options: { encoding: "utf8" | "utf-8" }): string;
+  /* Error-first callback target used by the static util.promisify
+   * projection. Its options stay unknown because direct calls remain
+   * outside the typed fs slice; this also lets checked-JS validation
+   * ladders observe invalid runtime encodings without contextual narrowing. */
+  export function readFile(
+    path: string,
+    options: unknown,
+    callback: (error: Error | null, data: string) => void,
+  ): void;
   /* The options form carries the mode (applied at CREATION only, like
    * Node — an existing file keeps its permissions) and/or the utf8
    * encoding spelling. */
@@ -1026,6 +1049,9 @@ declare module "node:fs" {
   export function mkdirSync(path: string, options: { recursive?: boolean; mode?: number }): void;
   export function unlinkSync(path: string): void;
   export function chmodSync(path: string, mode: number): void;
+  export function fchmodSync(fd: number, mode: number): void;
+  export function fsyncSync(fd: number): void;
+  export function linkSync(existingPath: string, newPath: string): void;
   export function chownSync(path: string, uid: number, gid: number): void;
   /* The 2-argument form only (Node's mode flags have no lowering). The
    * destination is created or truncated carrying the SOURCE's mode. */
@@ -1064,36 +1090,61 @@ declare module "node:fs" {
     readonly R_OK: number;
     readonly W_OK: number;
     readonly X_OK: number;
+    readonly O_RDONLY: number;
+    readonly O_WRONLY: number;
+    readonly O_RDWR: number;
+    readonly O_CREAT: number;
+    readonly O_EXCL: number;
+    readonly O_NOFOLLOW: number;
+    readonly O_NONBLOCK: number;
+    readonly O_TRUNC: number;
+    readonly O_APPEND: number;
   };
   /* A stat(2) snapshot (statSync follows symlinks, lstatSync does not —
    * Node's split) — immutable; the supported surface is exactly these
-   * members. blocks is the allocated size in 512-byte units; the time
-   * fields are milliseconds with their sub-second fractions. */
+   * members. dev/ino identify the filesystem entry, blocks is the allocated
+   * size in 512-byte units, and the time fields are milliseconds with their
+   * sub-second fractions. */
   export interface Stats {
     isFile(): boolean;
     isDirectory(): boolean;
     isSymbolicLink(): boolean;
+    readonly dev: number;
+    readonly ino: number;
     readonly size: number;
     readonly blocks: number;
     readonly nlink: number;
     readonly atimeMs: number;
     readonly mtimeMs: number;
+    readonly ctimeMs: number;
   }
   export function statSync(path: string): Stats;
   export function lstatSync(path: string): Stats;
   /* The fd pair behind spawn's fd-stdio form: openSync(path, flags) →
-   * the raw fd (string flags only — "r", "w", "a" and the +/x/s
-   * variants), closeSync(fd). */
+   * the raw fd. Numeric flags use an inline OR of the O_* constants. */
   export function openSync(path: string, flags: string): number;
+  export function openSync(path: string, flags: number, mode?: number): number;
   export function closeSync(fd: number): void;
   /* Read into a caller buffer from the fd's current position when position
    * is omitted/null, or from a numeric byte position without advancing the
    * fd. Answers the byte count, 0 at EOF. */
+  export interface ReadSyncOptions {
+    offset?: number;
+    length?: number;
+    position?: number | null;
+  }
+  export function readSync(fd: number, buffer: Uint8Array, options?: ReadSyncOptions): number;
   export function readSync(fd: number, buffer: Uint8Array, offset: number, length: number, position?: number | null): number;
   /* Write a caller-buffer window, or a utf8 string, at the fd's current
    * position when position is omitted/null (advancing it), or at a numeric
    * byte position without advancing it. Answers the byte count. */
-  export function writeSync(fd: number, buffer: Uint8Array, offset: number, length: number, position?: number | null): number;
+  export interface WriteSyncOptions {
+    offset?: number;
+    length?: number;
+    position?: number | null;
+  }
+  export function writeSync(fd: number, buffer: Uint8Array, options: WriteSyncOptions): number;
+  export function writeSync(fd: number, buffer: Uint8Array, offset?: number, length?: number, position?: number | null): number;
   export function writeSync(fd: number, string: string, position?: number | null, encoding?: "utf8" | "utf-8"): number;
   /* statSync over an open fd — the same Stats snapshot. */
   export function fstatSync(fd: number): Stats;
@@ -1198,8 +1249,19 @@ declare module "fs/promises" {
   export function writeFile(path: string, data: string, encoding: "utf8" | "utf-8"): Promise<void>;
   export function mkdir(path: string, options?: { recursive?: boolean; mode?: number }): Promise<void>;
   export function readdir(path: string): Promise<string[]>;
+  export function readdir(
+    path: string,
+    options: {
+      encoding?: "utf8" | "utf-8";
+      withFileTypes: true;
+      recursive?: boolean;
+      [option: string]: unknown;
+    },
+  ): Promise<import("node:fs").Dirent[]>;
   export function rm(path: string): Promise<void>;
   export function stat(path: string): Promise<import("node:fs").Stats>;
+  export function realpath(path: string): Promise<string>;
+  export function lstat(path: string): Promise<import("node:fs").Stats>;
   export function unlink(path: string): Promise<void>;
   export function chmod(path: string, mode: number): Promise<void>;
   export function rename(oldPath: string, newPath: string): Promise<void>;
@@ -1328,7 +1390,7 @@ declare module "node:os" {
 /* The WHATWG URL class (a Node global; the es2023 lib doesn't declare it),
  * typed as exactly the supported surface: construction from ONE absolute-
  * URL string (invalid input throws a catchable TypeError, like Node), the
- * protocol/pathname/href/host/hostname/search getters, searchParams (the
+ * protocol/origin/username/pathname/href/host/hostname/port/search/hash getters, searchParams (the
  * LIVE query view — mutations through it re-serialize into the URL, so
  * href reflects immediately; every read answers the same object, Node's
  * caching), and toString() (the href serialization).
@@ -1340,16 +1402,21 @@ declare module "node:os" {
  * documented in SEMANTICS.md. */
 interface URL {
   readonly protocol: string;
+  readonly origin: string;
+  readonly username: string;
+  readonly password: string;
   readonly pathname: string;
   readonly href: string;
   readonly host: string;
   readonly hostname: string;
+  readonly port: string;
   readonly search: string;
+  readonly hash: string;
   readonly searchParams: URLSearchParams;
   toString(): string;
 }
 declare var URL: {
-  new (input: string): URL;
+  new (input: string, base?: string | URL): URL;
 };
 
 /* URLSearchParams — the WHATWG application/x-www-form-urlencoded list.
@@ -1546,16 +1613,16 @@ declare module "child_process" {
 
   /* The asynchronous slice: spawn with stdio "ignore"/"inherit"/fd/"pipe"
    * tuples (piped stdin is writable through child.stdin; piped stdout/stderr
-   * deliver through child.stdout/stderr) and
-   * the two terminal events. "exit" fires once with the exit code, or
+   * deliver through child.stdout/stderr) and the terminal events. "exit"
+   * fires once with the exit code, or
    * null when the child died to a signal; "error" fires ONLY when the
    * child could not be spawned at all (Node's split: a spawn failure
-   * emits "error" and never "exit"). Listeners take at most one
-   * parameter; Node's second "exit" parameter (the signal name) has no
-   * lowering. `on` returns void here (Node returns the child; chaining
-   * is fenced). The event loop keeps the process alive until every
-   * spawned child is reaped, like Node — reaping polls at loop
-   * quiescence (SEMANTICS.md documents the divergence). An "error"
+   * emits "error" and never "exit"). "close" fires after exit/error and
+   * every piped stdio handle reaches EOF. Exit/close listeners may take
+   * Node's code and signal parameters. `on`/`once` return void here (Node
+   * returns the child; chaining is fenced). The event loop keeps the process
+   * alive until every spawned child is reaped, like Node — reaping polls at
+   * loop quiescence (SEMANTICS.md documents the divergence). An "error"
    * event with no registered listener prints the error and exits 1,
    * exactly the unhandled-'error' EventEmitter behavior. */
   export interface ChildStdin {
@@ -1573,7 +1640,15 @@ declare module "child_process" {
     /* The exit listener may also take Node's second parameter — the
      * terminating signal's name, null for a normal exit. */
     on(event: "exit", listener: (code: number | null, signal: string | null) => void): void;
+    on(event: "close", listener: (code: number | null, signal: string | null) => void): void;
     on(event: "error", listener: (err: Error) => void): void;
+    once(event: "exit", listener: (code: number | null, signal: string | null) => void): void;
+    once(event: "close", listener: (code: number | null, signal: string | null) => void): void;
+    once(event: "error", listener: (err: Error) => void): void;
+    on(event: "message", listener: (message: any) => void): void;
+    on(event: "disconnect", listener: () => void): void;
+    once(event: "message", listener: (message: any) => void): void;
+    once(event: "disconnect", listener: () => void): void;
     /* The lifecycle members, Node's exact shapes: pid is undefined exactly
      * when the spawn failed; exitCode is null while running, the code
      * after a normal exit, null for a signal death, and -errno once a
@@ -1589,6 +1664,9 @@ declare module "child_process" {
     readonly killed: boolean;
     kill(signal?: string | number): boolean;
     unref(): void;
+    readonly connected: boolean;
+    send(message: object, callback?: (error: Error | null) => void): boolean;
+    disconnect(): void;
     [Symbol.dispose](): void;
     /* The piped streams — non-null exactly when the matching stdio slot
      * was "pipe" (Node's shape). */
@@ -1608,11 +1686,27 @@ declare module "child_process" {
       stdio: "ignore" | "inherit" | "pipe" | ("ignore" | "inherit" | "pipe" | number)[];
       /* detached gives the child its own session and process group
        * (POSIX_SPAWN_SETSID); env REPLACES the child environment; cwd
-       * sets its working directory; windowsHide is a POSIX no-op. */
+       * sets its working directory; windowsHide is a POSIX no-op; shell
+       * runs the complete command string through /bin/sh or cmd.exe. */
       detached?: boolean;
       env?: { [k: string]: string | undefined };
       cwd?: string;
       windowsHide?: boolean;
+      shell?: boolean;
+    },
+  ): ChildProcess;
+
+  export function fork(
+    modulePath: string | URL,
+    args?: string[],
+    options?: {
+      cwd?: string;
+      env?: { [k: string]: string | undefined };
+      execArgv?: string[];
+      silent?: boolean;
+      stdio?: "pipe" | "ignore" | "inherit" | ("pipe" | "ignore" | "inherit" | "ipc")[];
+      serialization?: "json" | "advanced";
+      windowsHide?: boolean;
     },
   ): ChildProcess;
 
@@ -1657,9 +1751,13 @@ declare module "child_process" {
   }
   export function execFileSync(file: string, args?: string[], options?: ExecSyncOptions): string;
   export function execSync(command: string, options?: ExecSyncOptions): string;
-  /* The callback form exists to be PROMISIFIED — `const execFileAsync =
-   * promisify(execFile)` is the one lowered use (see "util"); calling it
-   * directly with a callback has no lowering and fences per site. */
+  export type ExecFileCallback = (error: Error | null, stdout: string, stderr: string) => void;
+  /* The callback form starts an asynchronous child and captures utf8
+   * stdout/stderr. The no-callback overload remains for util.promisify's
+   * static target recognition; reached no-callback calls still fence. */
+  export function execFile(file: string, callback: ExecFileCallback): ChildProcess;
+  export function execFile(file: string, args: string[] | null, callback: ExecFileCallback): ChildProcess;
+  export function execFile(file: string, args: string[] | null, options: ExecSyncOptions, callback: ExecFileCallback): ChildProcess;
   export function execFile(
     file: string,
     args?: string[] | null,
@@ -1678,13 +1776,14 @@ declare module "node:child_process" {
   export * from "child_process";
 }
 
-/* node:util — promisify, for exactly ONE target: child_process.execFile.
- * `const execFileAsync = promisify(execFile)` binds an async exec whose
- * calls run the file (no shell, PATH-searched) and settle with
- * { stdout, stderr } — fulfilled on exit 0, rejected with Node's
- * Command-failed / spawn-ENOENT errors otherwise. Other promisify
- * targets and bare promisify values fence per site. */
+/* node:util — compile-time projections for child_process.execFile and
+ * fs.readFile. The former retains Node's custom { stdout, stderr } result;
+ * the latter resolves the callback's data argument. Other targets and bare
+ * promisify values fence per site. */
 declare module "util" {
+  export function promisify(
+    fn: typeof import("node:fs").readFile,
+  ): (path: string, encoding: "utf8" | "utf-8") => Promise<string>;
   export function promisify(
     fn: (file: string, args?: string[] | null, options?: object) => unknown,
   ): (
@@ -1781,9 +1880,10 @@ declare module "node:util/types" {
  * Object.is over scalars; deepStrictEqual compares composites
  * structurally per their static types. The messages here are plain
  * strings (Node accepts Errors — that form fences per site), and the
- * loose-equality quartet (equal/notEqual/deepEqual/notDeepEqual) is
- * declared so real code typechecks but fences at its use sites (== has
- * no lowering; assert/strict's equal IS strictEqual and lowers). */
+ * shallow legacy pair (equal/notEqual) follows Node's == coercions for
+ * primitive and primitive-union operands, including Node v24's NaN
+ * exception. deepEqual/notDeepEqual remain declared-but-fenced;
+ * assert/strict's loose names alias the strict forms and lower. */
 /* node:test — the in-process test runner (prefix-only in Node too:
  * require("test") is MODULE_NOT_FOUND). test/it register tests (sync and
  * async bodies, skip/todo/only options and method twins), describe/suite
@@ -2023,14 +2123,38 @@ declare module "node:readline" {
   export * from "readline";
 }
 
-/* node:zlib — deflateSync/inflateSync lower (Buffer in, Buffer out,
- * Node's default options; libz links only into zlib-using binaries);
- * gzip and friends typecheck and fence at their use sites. */
+/* node:zlib — the one-shot zlib/raw/gzip codecs lower for string/Buffer
+ * inputs with Node's default options; libz links only into zlib-using
+ * binaries. Callback forms use the executable worker pool. Options stay
+ * declared so reached uses receive a named SC2020 refusal; Brotli,
+ * streaming, and Zstd remain outside the lowered surface. */
 declare module "zlib" {
-  export function deflateSync(data: string | Uint8Array): Buffer;
-  export function inflateSync(data: Uint8Array): Buffer;
-  export function gzipSync(data: string | Uint8Array): Buffer;
-  export function gunzipSync(data: Uint8Array): Buffer;
+  export interface ZlibOptions { [option: string]: unknown }
+  export type ZlibCallback = (error: NodeJS.ErrnoException | null, result: Buffer) => void;
+  export function deflate(data: string | Uint8Array, callback: ZlibCallback): void;
+  export function deflate(data: string | Uint8Array, options: ZlibOptions, callback: ZlibCallback): void;
+  export function deflateSync(data: string | Uint8Array, options?: ZlibOptions): Buffer;
+  export function inflate(data: string | Uint8Array, callback: ZlibCallback): void;
+  export function inflate(data: string | Uint8Array, options: ZlibOptions, callback: ZlibCallback): void;
+  export function inflateSync(data: string | Uint8Array, options?: ZlibOptions): Buffer;
+  export function deflateRaw(data: string | Uint8Array, callback: ZlibCallback): void;
+  export function deflateRaw(data: string | Uint8Array, options: ZlibOptions, callback: ZlibCallback): void;
+  export function deflateRawSync(data: string | Uint8Array, options?: ZlibOptions): Buffer;
+  export function inflateRaw(data: string | Uint8Array, callback: ZlibCallback): void;
+  export function inflateRaw(data: string | Uint8Array, options: ZlibOptions, callback: ZlibCallback): void;
+  export function inflateRawSync(data: string | Uint8Array, options?: ZlibOptions): Buffer;
+  export function gzip(data: string | Uint8Array, callback: ZlibCallback): void;
+  export function gzip(data: string | Uint8Array, options: ZlibOptions, callback: ZlibCallback): void;
+  export function gzipSync(data: string | Uint8Array, options?: ZlibOptions): Buffer;
+  export function gunzip(data: string | Uint8Array, callback: ZlibCallback): void;
+  export function gunzip(data: string | Uint8Array, options: ZlibOptions, callback: ZlibCallback): void;
+  export function gunzipSync(data: string | Uint8Array, options?: ZlibOptions): Buffer;
+  export function unzip(data: string | Uint8Array, callback: ZlibCallback): void;
+  export function unzip(data: string | Uint8Array, options: ZlibOptions, callback: ZlibCallback): void;
+  export function unzipSync(data: string | Uint8Array, options?: ZlibOptions): Buffer;
+  export function crc32(data: string | Uint8Array, value?: number): number;
+  export function brotliCompressSync(data: string | Uint8Array): Buffer;
+  export function brotliDecompressSync(data: Uint8Array): Buffer;
 }
 declare module "node:zlib" {
   export * from "zlib";
@@ -2104,6 +2228,7 @@ declare module "net" {
     once(event: "session", listener: (session: Buffer) => void): void;
   }
   export interface Server {
+    readonly listening: boolean;
     /* Node answers the server itself (`return this` chaining). */
     listen(port: number, callback?: () => void): Server;
     /* The positional bind address (the options form's host in argument
@@ -2122,6 +2247,7 @@ declare module "net" {
     emit(event: "connection", socket: Socket): boolean;
     on(event: "connection" | "secureConnection", listener: (socket: Socket) => void): void;
     on(event: "close" | "listening", listener: () => void): void;
+    on(event: "timeout", listener: (socket: Socket) => void): void;
     on(event: "error", listener: (err: Error) => void): void;
     /* The WebSocket handover: fires INSTEAD of 'request' for
      * Connection: upgrade requests, with the raw socket + head bytes. */
@@ -2132,11 +2258,13 @@ declare module "net" {
     /* addListener IS on (Node aliases them) — the suite spells both. */
     addListener(event: "connection" | "secureConnection", listener: (socket: Socket) => void): void;
     addListener(event: "close" | "listening", listener: () => void): void;
+    addListener(event: "timeout", listener: (socket: Socket) => void): void;
     addListener(event: "error", listener: (err: Error) => void): void;
     addListener(event: "upgrade", listener: (req: import("http").IncomingMessage, socket: Socket, head: Buffer) => void): void;
     addListener(event: "request", listener: (req: import("http").IncomingMessage, res: import("http").ServerResponse) => void): void;
     once(event: "connection" | "secureConnection", listener: (socket: Socket) => void): void;
     once(event: "close" | "listening", listener: () => void): void;
+    once(event: "timeout", listener: (socket: Socket) => void): void;
     once(event: "error", listener: (err: Error) => void): void;
     once(event: "upgrade", listener: (req: import("http").IncomingMessage, socket: Socket, head: Buffer) => void): void;
     once(event: "request", listener: (req: import("http").IncomingMessage, res: import("http").ServerResponse) => void): void;
@@ -2193,8 +2321,14 @@ declare module "node:net" {
  * connection per call (no agent pooling) with Node's exact wire head. */
 declare module "http" {
   import { Server as NetServer, Socket } from "net";
+  export const METHODS: string[];
+  export const STATUS_CODES: { [status: number]: string | undefined };
+  export const maxHeaderSize: number;
   export interface Server extends NetServer {
     timeout: number;
+    setTimeout(msecs: number, callback?: (socket: Socket) => void): this;
+    closeAllConnections(): void;
+    closeIdleConnections(): void;
     keepAliveTimeout: number;
     keepAliveTimeoutBuffer: number;
     headersTimeout: number;
@@ -2232,53 +2366,82 @@ declare module "http" {
   export interface IncomingMessage {
     readonly url: string;
     readonly method: string;
+    readonly httpVersion: string;
+    readonly complete: boolean;
+    readonly aborted: boolean;
     readonly statusCode: number | undefined;
     readonly statusMessage: string | undefined;
     readonly socket: Socket;
+    readonly connection: Socket;
     readonly headers: { [name: string]: string | undefined };
+    readonly headersDistinct: { [name: string]: string[] | undefined };
     readonly rawHeaders: string[];
+    readonly trailers: { [name: string]: string | undefined };
+    readonly trailersDistinct: { [name: string]: string[] | undefined };
+    readonly rawTrailers: string[];
     resume(): void;
     destroy(): void;
+    setTimeout(msecs: number, callback?: () => void): this;
     /* setEncoding('utf8'): 'data' delivers strings (other real encodings
      * fence loudly at runtime; unknown names throw ERR_UNKNOWN_ENCODING). */
     setEncoding(encoding: string): void;
     /* The proxy legs: the body streams into a ServerResponse, a
      * ClientRequest, or a raw Socket; natural end ends the destination. */
-    pipe(destination: ServerResponse | ClientRequest | Socket): void;
+    pipe(destination: ServerResponse | import("http2").Http2ServerResponse | ClientRequest | Socket): void;
     on(event: "data", listener: (chunk: any) => void): void;
-    on(event: "end" | "close", listener: () => void): void;
+    on(event: "end" | "close" | "aborted", listener: () => void): void;
     on(event: "error", listener: (err: Error) => void): void;
     /* addListener IS on (Node aliases them) — the suite spells both. */
     addListener(event: "data", listener: (chunk: any) => void): void;
-    addListener(event: "end" | "close", listener: () => void): void;
+    addListener(event: "end" | "close" | "aborted", listener: () => void): void;
     addListener(event: "error", listener: (err: Error) => void): void;
     once(event: "data", listener: (chunk: any) => void): void;
-    once(event: "end" | "close", listener: () => void): void;
+    once(event: "end" | "close" | "aborted", listener: () => void): void;
     once(event: "error", listener: (err: Error) => void): void;
   }
   export interface ServerResponse {
     readonly headersSent: boolean;
+    readonly writableEnded: boolean;
+    readonly finished: boolean;
+    readonly writableFinished: boolean;
+    readonly writableCorked: number;
+    readonly req: IncomingMessage;
+    readonly socket: Socket | null;
+    readonly connection: Socket | null;
+    sendDate: boolean;
+    strictContentLength: boolean;
     /* Node's writable head properties: the implicit head reads them. */
     statusCode: number;
-    statusMessage: string;
+    statusMessage: string | undefined;
     setHeader(name: string, value: string | number): void;
     getHeader(name: string): string | undefined;
+    getHeaderNames(): string[];
+    getRawHeaderNames(): string[];
+    getHeaders(): OutgoingHttpHeaders;
     hasHeader(name: string): boolean;
     removeHeader(name: string): void;
     /* Both overloads answer the response (`return this` chaining); the
      * headers argument also takes Node's flat [name, value, ...] array. */
     writeHead(statusCode: number, headers?: OutgoingHttpHeaders | string[]): ServerResponse;
     writeHead(statusCode: number, statusMessage: string, headers?: OutgoingHttpHeaders | string[]): ServerResponse;
+    writeContinue(callback?: () => void): void;
+    writeProcessing(callback?: () => void): void;
+    writeEarlyHints(hints: Record<string, string | string[]>, callback?: () => void): void;
     write(data: string | Uint8Array): void;
+    flushHeaders(): void;
+    cork(): void;
+    uncork(): void;
+    addTrailers(headers: OutgoingHttpHeaders | ReadonlyArray<[string, string]>): void;
+    setTimeout(msecs: number, callback?: () => void): this;
     /* end's callback forms fire once the body went out (the 'finish'
      * emit, deferred past the handler's synchronous tail). */
     end(data?: string | Uint8Array, callback?: () => void): void;
     end(callback: () => void): void;
     destroy(): void;
-    on(event: "close", listener: () => void): void;
+    on(event: "close" | "finish", listener: () => void): void;
     /* addListener IS on (Node aliases them) — the suite spells both. */
-    addListener(event: "close", listener: () => void): void;
-    once(event: "close", listener: () => void): void;
+    addListener(event: "close" | "finish", listener: () => void): void;
+    once(event: "close" | "finish", listener: () => void): void;
   }
   /* The CLIENT slice (http.request/http.get): the options-object form
    * with hostname/host, port, path, method, timeout, and headers; the
@@ -2345,21 +2508,52 @@ declare module "http" {
   export const globalAgent: Agent;
   export interface ClientRequest {
     readonly destroyed: boolean;
+    readonly aborted: boolean;
+    readonly socket: Socket;
+    readonly connection: Socket;
+    readonly writableCorked: number;
+    readonly method: string;
+    readonly path: string;
+    readonly host: string;
+    readonly protocol: string;
+    readonly headersSent: boolean;
+    readonly writableEnded: boolean;
+    readonly writableFinished: boolean;
+    readonly finished: boolean;
+    readonly reusedSocket: boolean;
+    setHeader(name: string, value: string): void;
+    getHeader(name: string): string | undefined;
+    hasHeader(name: string): boolean;
+    removeHeader(name: string): void;
+    getHeaderNames(): string[];
+    getRawHeaderNames(): string[];
+    getHeaders(): OutgoingHttpHeaders;
+    flushHeaders(): void;
+    addTrailers(headers: OutgoingHttpHeaders | ReadonlyArray<[string, string]>): void;
+    cork(): void;
+    uncork(): void;
+    setNoDelay(noDelay?: boolean): void;
+    setSocketKeepAlive(enable?: boolean, initialDelay?: number): void;
+    setTimeout(timeout: number, callback?: () => void): this;
     write(data: string | Uint8Array): void;
     end(data?: string | Uint8Array): void;
     destroy(): void;
+    abort(): void;
     on(event: "response", listener: (res: IncomingMessage) => void): void;
+    on(event: "socket", listener: (socket: Socket) => void): void;
     on(event: "upgrade", listener: (res: IncomingMessage, socket: Socket, head: Buffer) => void): void;
-    on(event: "timeout" | "close", listener: () => void): void;
+    on(event: "timeout" | "close" | "finish" | "abort", listener: () => void): void;
     on(event: "error", listener: (err: Error) => void): void;
     /* addListener IS on (Node aliases them) — the suite spells both. */
     addListener(event: "response", listener: (res: IncomingMessage) => void): void;
+    addListener(event: "socket", listener: (socket: Socket) => void): void;
     addListener(event: "upgrade", listener: (res: IncomingMessage, socket: Socket, head: Buffer) => void): void;
-    addListener(event: "timeout" | "close", listener: () => void): void;
+    addListener(event: "timeout" | "close" | "finish" | "abort", listener: () => void): void;
     addListener(event: "error", listener: (err: Error) => void): void;
     once(event: "response", listener: (res: IncomingMessage) => void): void;
+    once(event: "socket", listener: (socket: Socket) => void): void;
     once(event: "upgrade", listener: (res: IncomingMessage, socket: Socket, head: Buffer) => void): void;
-    once(event: "timeout" | "close", listener: () => void): void;
+    once(event: "timeout" | "close" | "finish" | "abort", listener: () => void): void;
     once(event: "error", listener: (err: Error) => void): void;
   }
   export function createServer(
@@ -2390,6 +2584,8 @@ declare module "http" {
     target: RequestOptions | string | URL,
     callback?: (res: IncomingMessage) => void,
   ): ClientRequest;
+  export function validateHeaderName(name: string, label?: string): void;
+  export function validateHeaderValue(name: string, value: unknown): void;
 }
 declare module "node:http" {
   export * from "http";
@@ -2562,6 +2758,8 @@ declare module "http2" {
   }
   export interface Http2ServerResponse {
     readonly headersSent: boolean;
+    readonly writableEnded: boolean;
+    readonly writableCorked: number;
     /* The same lowered surface as http.ServerResponse — the allowHTTP1
      * lowering serves every connection as HTTP/1.1, where the compat
      * response IS this parser's response handle. */
@@ -2569,11 +2767,20 @@ declare module "http2" {
     statusMessage: string;
     setHeader(name: string, value: string | number): void;
     getHeader(name: string): string | undefined;
+    getHeaderNames(): string[];
+    getRawHeaderNames(): string[];
+    getHeaders(): import("http").OutgoingHttpHeaders;
     hasHeader(name: string): boolean;
     removeHeader(name: string): void;
     writeHead(statusCode: number, headers?: import("http").OutgoingHttpHeaders | string[]): Http2ServerResponse;
     writeHead(statusCode: number, statusMessage: string, headers?: import("http").OutgoingHttpHeaders | string[]): Http2ServerResponse;
+    writeContinue(): void;
+    writeEarlyHints(hints: Record<string, string | string[]>): void;
     write(data: string | Uint8Array): void;
+    flushHeaders(): void;
+    cork(): void;
+    uncork(): void;
+    addTrailers(headers: import("http").OutgoingHttpHeaders | ReadonlyArray<[string, string]>): void;
     end(data?: string | Uint8Array, callback?: () => void): void;
     end(callback: () => void): void;
     destroy(): void;
@@ -3162,8 +3369,14 @@ declare module "node:cluster" {
   export = cluster;
 }
 
-/* node:tty — the fd probe (the same isatty(3) behind process.*.isTTY). */
+/* node:tty — the fd probe (the same isatty(3) behind process.*.isTTY)
+ * and the supported structural view of a process output stream. */
 declare module "tty" {
+  export interface WriteStream {
+    write(data: string | Uint8Array, callback?: (error?: Error | null) => void): boolean;
+    write(data: string | Uint8Array, encoding: BufferEncoding, callback?: (error?: Error | null) => void): boolean;
+    readonly isTTY: boolean;
+  }
   export function isatty(fd: number): boolean;
 }
 declare module "node:tty" {