@types/node 16.0.0 → 16.3.0

node/util.d.ts

@@ -10,24 +10,24 @@ declare module 'util' {
          * the getter function.
          * @default `false`
          */
-        getters?: 'get' | 'set' | boolean;
-        showHidden?: boolean;
+        getters?: 'get' | 'set' | boolean | undefined;
+        showHidden?: boolean | undefined;
         /**
          * @default 2
          */
-        depth?: number | null;
-        colors?: boolean;
-        customInspect?: boolean;
-        showProxy?: boolean;
-        maxArrayLength?: number | null;
+        depth?: number | null | undefined;
+        colors?: boolean | undefined;
+        customInspect?: boolean | undefined;
+        showProxy?: boolean | undefined;
+        maxArrayLength?: number | null | undefined;
         /**
          * Specifies the maximum number of characters to
          * include when formatting. Set to `null` or `Infinity` to show all elements.
          * Set to `0` or negative to show no characters.
          * @default 10000
          */
-        maxStringLength?: number | null;
-        breakLength?: number;
+        maxStringLength?: number | null | undefined;
+        breakLength?: number | undefined;
         /**
          * Setting this to `false` causes each object key
          * to be displayed on a new line. It will also add new lines to text that is
@@ -38,8 +38,8 @@ declare module 'util' {
          * For more information, see the example below.
          * @default `true`
          */
-        compact?: boolean | number;
-        sorted?: boolean | ((a: string, b: string) => number);
+        compact?: boolean | number | undefined;
+        sorted?: boolean | ((a: string, b: string) => number) | undefined;
     }
 
     export type Style = 'special' | 'number' | 'bigint' | 'boolean' | 'undefined' | 'null' | 'string' | 'symbol' | 'date' | 'regexp' | 'module';
@@ -168,11 +168,11 @@ declare module 'util' {
         readonly ignoreBOM: boolean;
         constructor(
           encoding?: string,
-          options?: { fatal?: boolean; ignoreBOM?: boolean }
+          options?: { fatal?: boolean | undefined; ignoreBOM?: boolean | undefined }
         );
         decode(
           input?: NodeJS.ArrayBufferView | ArrayBuffer | null,
-          options?: { stream?: boolean }
+          options?: { stream?: boolean | undefined }
         ): string;
     }
 
@@ -200,3 +200,65 @@ declare module 'util' {
 declare module 'node:util' {
     export * from 'util';
 }
+
+declare module 'util/types' {
+    import { KeyObject, webcrypto } from 'crypto';
+
+    function isAnyArrayBuffer(object: unknown): object is ArrayBufferLike;
+    function isArgumentsObject(object: unknown): object is IArguments;
+    function isArrayBuffer(object: unknown): object is ArrayBuffer;
+    function isArrayBufferView(object: unknown): object is NodeJS.ArrayBufferView;
+    function isAsyncFunction(object: unknown): boolean;
+    function isBigInt64Array(value: unknown): value is BigInt64Array;
+    function isBigUint64Array(value: unknown): value is BigUint64Array;
+    function isBooleanObject(object: unknown): object is Boolean;
+    function isBoxedPrimitive(object: unknown): object is String | Number | BigInt | Boolean | Symbol;
+    function isDataView(object: unknown): object is DataView;
+    function isDate(object: unknown): object is Date;
+    function isExternal(object: unknown): boolean;
+    function isFloat32Array(object: unknown): object is Float32Array;
+    function isFloat64Array(object: unknown): object is Float64Array;
+    function isGeneratorFunction(object: unknown): object is GeneratorFunction;
+    function isGeneratorObject(object: unknown): object is Generator;
+    function isInt8Array(object: unknown): object is Int8Array;
+    function isInt16Array(object: unknown): object is Int16Array;
+    function isInt32Array(object: unknown): object is Int32Array;
+    function isMap<T>(
+        object: T | {},
+    ): object is T extends ReadonlyMap<any, any>
+        ? unknown extends T
+            ? never
+            : ReadonlyMap<any, any>
+        : Map<unknown, unknown>;
+    function isMapIterator(object: unknown): boolean;
+    function isModuleNamespaceObject(value: unknown): boolean;
+    function isNativeError(object: unknown): object is Error;
+    function isNumberObject(object: unknown): object is Number;
+    function isPromise(object: unknown): object is Promise<unknown>;
+    function isProxy(object: unknown): boolean;
+    function isRegExp(object: unknown): object is RegExp;
+    function isSet<T>(
+        object: T | {},
+    ): object is T extends ReadonlySet<any>
+        ? unknown extends T
+            ? never
+            : ReadonlySet<any>
+        : Set<unknown>;
+    function isSetIterator(object: unknown): boolean;
+    function isSharedArrayBuffer(object: unknown): object is SharedArrayBuffer;
+    function isStringObject(object: unknown): object is String;
+    function isSymbolObject(object: unknown): object is Symbol;
+    function isTypedArray(object: unknown): object is NodeJS.TypedArray;
+    function isUint8Array(object: unknown): object is Uint8Array;
+    function isUint8ClampedArray(object: unknown): object is Uint8ClampedArray;
+    function isUint16Array(object: unknown): object is Uint16Array;
+    function isUint32Array(object: unknown): object is Uint32Array;
+    function isWeakMap(object: unknown): object is WeakMap<object, unknown>;
+    function isWeakSet(object: unknown): object is WeakSet<object>;
+    function isKeyObject(object: unknown): object is KeyObject;
+    function isCryptoKey(object: unknown): object is webcrypto.CryptoKey;
+}
+
+declare module 'node:util/types' {
+    export * from 'util/types';
+}

node/vm.d.ts

@@ -5,67 +5,67 @@ declare module 'vm' {
          * Specifies the filename used in stack traces produced by this script.
          * Default: `''`.
          */
-        filename?: string;
+        filename?: string | undefined;
         /**
          * Specifies the line number offset that is displayed in stack traces produced by this script.
          * Default: `0`.
          */
-        lineOffset?: number;
+        lineOffset?: number | undefined;
         /**
          * Specifies the column number offset that is displayed in stack traces produced by this script.
          * @default 0
          */
-        columnOffset?: number;
+        columnOffset?: number | undefined;
     }
     interface ScriptOptions extends BaseOptions {
-        displayErrors?: boolean;
-        timeout?: number;
-        cachedData?: Buffer;
+        displayErrors?: boolean | undefined;
+        timeout?: number | undefined;
+        cachedData?: Buffer | undefined;
         /** @deprecated in favor of `script.createCachedData()` */
-        produceCachedData?: boolean;
+        produceCachedData?: boolean | undefined;
     }
     interface RunningScriptOptions extends BaseOptions {
         /**
          * When `true`, if an `Error` occurs while compiling the `code`, the line of code causing the error is attached to the stack trace.
          * Default: `true`.
          */
-        displayErrors?: boolean;
+        displayErrors?: boolean | undefined;
         /**
          * Specifies the number of milliseconds to execute code before terminating execution.
          * If execution is terminated, an `Error` will be thrown. This value must be a strictly positive integer.
          */
-        timeout?: number;
+        timeout?: number | undefined;
         /**
          * If `true`, the execution will be terminated when `SIGINT` (Ctrl+C) is received.
          * Existing handlers for the event that have been attached via `process.on('SIGINT')` will be disabled during script execution, but will continue to work after that.
          * If execution is terminated, an `Error` will be thrown.
          * Default: `false`.
          */
-        breakOnSigint?: boolean;
+        breakOnSigint?: boolean | undefined;
         /**
          * If set to `afterEvaluate`, microtasks will be run immediately after the script has run.
          */
-        microtaskMode?: 'afterEvaluate';
+        microtaskMode?: 'afterEvaluate' | undefined;
     }
     interface CompileFunctionOptions extends BaseOptions {
         /**
          * Provides an optional data with V8's code cache data for the supplied source.
          */
-        cachedData?: Buffer;
+        cachedData?: Buffer | undefined;
         /**
          * Specifies whether to produce new cache data.
          * Default: `false`,
          */
-        produceCachedData?: boolean;
+        produceCachedData?: boolean | undefined;
         /**
          * The sandbox/context in which the said function should be compiled in.
          */
-        parsingContext?: Context;
+        parsingContext?: Context | undefined;
 
         /**
          * An array containing a collection of context extensions (objects wrapping the current scope) to be applied while compiling
          */
-        contextExtensions?: Object[];
+        contextExtensions?: Object[] | undefined;
     }
 
     interface CreateContextOptions {
@@ -73,7 +73,7 @@ declare module 'vm' {
          * Human-readable name of the newly created context.
          * @default 'VM Context i' Where i is an ascending numerical index of the created context.
          */
-        name?: string;
+        name?: string | undefined;
         /**
          * Corresponds to the newly created context for display purposes.
          * The origin should be formatted like a `URL`, but with only the scheme, host, and port (if necessary),
@@ -81,24 +81,24 @@ declare module 'vm' {
          * Most notably, this string should omit the trailing slash, as that denotes a path.
          * @default ''
          */
-        origin?: string;
+        origin?: string | undefined;
         codeGeneration?: {
             /**
              * If set to false any calls to eval or function constructors (Function, GeneratorFunction, etc)
              * will throw an EvalError.
              * @default true
              */
-            strings?: boolean;
+            strings?: boolean | undefined;
             /**
              * If set to false any attempt to compile a WebAssembly module will throw a WebAssembly.CompileError.
              * @default true
              */
-            wasm?: boolean;
-        };
+            wasm?: boolean | undefined;
+        } | undefined;
         /**
          * If set to `afterEvaluate`, microtasks will be run immediately after the script has run.
          */
-        microtaskMode?: 'afterEvaluate';
+        microtaskMode?: 'afterEvaluate' | undefined;
     }
 
     type MeasureMemoryMode = 'summary' | 'detailed';
@@ -107,8 +107,8 @@ declare module 'vm' {
         /**
          * @default 'summary'
          */
-        mode?: MeasureMemoryMode;
-        context?: Context;
+        mode?: MeasureMemoryMode | undefined;
+        context?: Context | undefined;
     }
 
     interface MemoryMeasurement {
@@ -124,7 +124,7 @@ declare module 'vm' {
         runInNewContext(sandbox?: Context, options?: RunningScriptOptions): any;
         runInThisContext(options?: RunningScriptOptions): any;
         createCachedData(): Buffer;
-        cachedDataRejected?: boolean;
+        cachedDataRejected?: boolean | undefined;
     }
     function createContext(sandbox?: Context, options?: CreateContextOptions): Context;
     function isContext(sandbox: Context): boolean;

node/wasi.d.ts

@@ -5,13 +5,13 @@ declare module 'wasi' {
          * see as command line arguments. The first argument is the virtual path to the
          * WASI command itself.
          */
-        args?: string[];
+        args?: string[] | undefined;
 
         /**
          * An object similar to `process.env` that the WebAssembly
          * application will see as its environment.
          */
-        env?: object;
+        env?: object | undefined;
 
         /**
          * This object represents the WebAssembly application's
@@ -19,7 +19,7 @@ declare module 'wasi' {
          * directories within the sandbox. The corresponding values in `preopens` are
          * the real paths to those directories on the host machine.
          */
-        preopens?: NodeJS.Dict<string>;
+        preopens?: NodeJS.Dict<string> | undefined;
 
         /**
          * By default, WASI applications terminate the Node.js
@@ -28,25 +28,25 @@ declare module 'wasi' {
          * process.
          * @default false
          */
-        returnOnExit?: boolean;
+        returnOnExit?: boolean | undefined;
 
         /**
          * The file descriptor used as standard input in the WebAssembly application.
          * @default 0
          */
-        stdin?: number;
+        stdin?: number | undefined;
 
         /**
          * The file descriptor used as standard output in the WebAssembly application.
          * @default 1
          */
-        stdout?: number;
+        stdout?: number | undefined;
 
         /**
          * The file descriptor used as standard error in the WebAssembly application.
          * @default 2
          */
-        stderr?: number;
+        stderr?: number | undefined;
     }
 
     class WASI {

node/worker_threads.d.ts

@@ -81,43 +81,43 @@ declare module 'worker_threads' {
          * but the values will be available on the global `process.argv` as if they
          * were passed as CLI options to the script.
          */
-        argv?: any[];
-        env?: NodeJS.Dict<string> | typeof SHARE_ENV;
-        eval?: boolean;
+        argv?: any[] | undefined;
+        env?: NodeJS.Dict<string> | typeof SHARE_ENV | undefined;
+        eval?: boolean | undefined;
         workerData?: any;
-        stdin?: boolean;
-        stdout?: boolean;
-        stderr?: boolean;
-        execArgv?: string[];
-        resourceLimits?: ResourceLimits;
+        stdin?: boolean | undefined;
+        stdout?: boolean | undefined;
+        stderr?: boolean | undefined;
+        execArgv?: string[] | undefined;
+        resourceLimits?: ResourceLimits | undefined;
         /**
          * Additional data to send in the first worker message.
          */
-        transferList?: TransferListItem[];
+        transferList?: TransferListItem[] | undefined;
         /**
          * @default true
          */
-        trackUnmanagedFds?: boolean;
+        trackUnmanagedFds?: boolean | undefined;
     }
 
     interface ResourceLimits {
         /**
          * The maximum size of a heap space for recently created objects.
          */
-        maxYoungGenerationSizeMb?: number;
+        maxYoungGenerationSizeMb?: number | undefined;
         /**
          * The maximum size of the main heap in MB.
          */
-        maxOldGenerationSizeMb?: number;
+        maxOldGenerationSizeMb?: number | undefined;
         /**
          * The size of a pre-allocated memory range used for generated code.
          */
-        codeRangeSizeMb?: number;
+        codeRangeSizeMb?: number | undefined;
         /**
          * The default maximum stack size for the thread. Small values may lead to unusable Worker instances.
          * @default 4
          */
-        stackSizeMb?: number;
+        stackSizeMb?: number | undefined;
     }
 
     class Worker extends EventEmitter {
@@ -125,7 +125,7 @@ declare module 'worker_threads' {
         readonly stdout: Readable;
         readonly stderr: Readable;
         readonly threadId: number;
-        readonly resourceLimits?: ResourceLimits;
+        readonly resourceLimits?: ResourceLimits | undefined;
         readonly performance: WorkerPerformance;
 
         /**

node/zlib.d.ts

@@ -5,51 +5,51 @@ declare module 'zlib' {
         /**
          * @default constants.Z_NO_FLUSH
          */
-        flush?: number;
+        flush?: number | undefined;
         /**
          * @default constants.Z_FINISH
          */
-        finishFlush?: number;
+        finishFlush?: number | undefined;
         /**
          * @default 16*1024
          */
-        chunkSize?: number;
-        windowBits?: number;
-        level?: number; // compression only
-        memLevel?: number; // compression only
-        strategy?: number; // compression only
-        dictionary?: NodeJS.ArrayBufferView | ArrayBuffer; // deflate/inflate only, empty dictionary by default
-        info?: boolean;
-        maxOutputLength?: number;
+        chunkSize?: number | undefined;
+        windowBits?: number | undefined;
+        level?: number | undefined; // compression only
+        memLevel?: number | undefined; // compression only
+        strategy?: number | undefined; // compression only
+        dictionary?: NodeJS.ArrayBufferView | ArrayBuffer | undefined; // deflate/inflate only, empty dictionary by default
+        info?: boolean | undefined;
+        maxOutputLength?: number | undefined;
     }
 
     interface BrotliOptions {
         /**
          * @default constants.BROTLI_OPERATION_PROCESS
          */
-        flush?: number;
+        flush?: number | undefined;
         /**
          * @default constants.BROTLI_OPERATION_FINISH
          */
-        finishFlush?: number;
+        finishFlush?: number | undefined;
         /**
          * @default 16*1024
          */
-        chunkSize?: number;
+        chunkSize?: number | undefined;
         params?: {
             /**
              * Each key is a `constants.BROTLI_*` constant.
              */
             [key: number]: boolean | number;
-        };
-        maxOutputLength?: number;
+        } | undefined;
+        maxOutputLength?: number | undefined;
     }
 
     interface Zlib {
         /** @deprecated Use bytesWritten instead. */
         readonly bytesRead: number;
         readonly bytesWritten: number;
-        shell?: boolean | string;
+        shell?: boolean | string | undefined;
         close(callback?: () => void): void;
         flush(kind?: number, callback?: () => void): void;
         flush(callback?: () => void): void;

node/util/types.d.ts

@@ -1,57 +0,0 @@
-declare module 'util/types' {
-    function isAnyArrayBuffer(object: unknown): object is ArrayBufferLike;
-    function isArgumentsObject(object: unknown): object is IArguments;
-    function isArrayBuffer(object: unknown): object is ArrayBuffer;
-    function isArrayBufferView(object: unknown): object is NodeJS.ArrayBufferView;
-    function isAsyncFunction(object: unknown): boolean;
-    function isBigInt64Array(value: unknown): value is BigInt64Array;
-    function isBigUint64Array(value: unknown): value is BigUint64Array;
-    function isBooleanObject(object: unknown): object is Boolean;
-    function isBoxedPrimitive(object: unknown): object is String | Number | BigInt | Boolean | Symbol;
-    function isDataView(object: unknown): object is DataView;
-    function isDate(object: unknown): object is Date;
-    function isExternal(object: unknown): boolean;
-    function isFloat32Array(object: unknown): object is Float32Array;
-    function isFloat64Array(object: unknown): object is Float64Array;
-    function isGeneratorFunction(object: unknown): object is GeneratorFunction;
-    function isGeneratorObject(object: unknown): object is Generator;
-    function isInt8Array(object: unknown): object is Int8Array;
-    function isInt16Array(object: unknown): object is Int16Array;
-    function isInt32Array(object: unknown): object is Int32Array;
-    function isMap<T>(
-        object: T | {},
-    ): object is T extends ReadonlyMap<any, any>
-        ? unknown extends T
-            ? never
-            : ReadonlyMap<any, any>
-        : Map<unknown, unknown>;
-    function isMapIterator(object: unknown): boolean;
-    function isModuleNamespaceObject(value: unknown): boolean;
-    function isNativeError(object: unknown): object is Error;
-    function isNumberObject(object: unknown): object is Number;
-    function isPromise(object: unknown): object is Promise<unknown>;
-    function isProxy(object: unknown): boolean;
-    function isRegExp(object: unknown): object is RegExp;
-    function isSet<T>(
-        object: T | {},
-    ): object is T extends ReadonlySet<any>
-        ? unknown extends T
-            ? never
-            : ReadonlySet<any>
-        : Set<unknown>;
-    function isSetIterator(object: unknown): boolean;
-    function isSharedArrayBuffer(object: unknown): object is SharedArrayBuffer;
-    function isStringObject(object: unknown): object is String;
-    function isSymbolObject(object: unknown): object is Symbol;
-    function isTypedArray(object: unknown): object is NodeJS.TypedArray;
-    function isUint8Array(object: unknown): object is Uint8Array;
-    function isUint8ClampedArray(object: unknown): object is Uint8ClampedArray;
-    function isUint16Array(object: unknown): object is Uint16Array;
-    function isUint32Array(object: unknown): object is Uint32Array;
-    function isWeakMap(object: unknown): object is WeakMap<object, unknown>;
-    function isWeakSet(object: unknown): object is WeakSet<object>;
-}
-
-declare module 'node:util/types' {
-    export * from 'util/types';
-}