@types/node 16.4.14 → 16.7.0

node/fs.d.ts

@@ -5,30 +5,18 @@
  * To use the promise-based APIs:
  *
  * ```js
- * // Using ESM Module syntax:
  * import * as fs from 'fs/promises';
  * ```
  *
- * ```js
- * // Using CommonJS syntax:
- * const fs = require('fs/promises');
- * ```
- *
  * To use the callback and sync APIs:
  *
  * ```js
- * // Using ESM Module syntax:
  * import * as fs from 'fs';
  * ```
  *
- * ```js
- * // Using CommonJS syntax:
- * const fs = require('fs');
- * ```
- *
  * All file system operations have synchronous, callback, and promise-based
  * forms, and are accessible using both CommonJS syntax and ES6 Modules (ESM).
- * @see [source](https://github.com/nodejs/node/blob/v16.4.2/lib/fs.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/fs.js)
  */
 declare module 'fs' {
     import * as stream from 'node:stream';
@@ -83,7 +71,7 @@ declare module 'fs' {
     }
     export interface Stats extends StatsBase<number> {}
     /**
-     * A `<fs.Stats>` object provides information about a file.
+     * A `fs.Stats` object provides information about a file.
      *
      * Objects returned from {@link stat}, {@link lstat} and {@link fstat} and
      * their synchronous counterparts are of this type.
@@ -145,53 +133,53 @@ declare module 'fs' {
     export class Stats {}
     /**
      * A representation of a directory entry, which can be a file or a subdirectory
-     * within the directory, as returned by reading from an `<fs.Dir>`. The
+     * within the directory, as returned by reading from an `fs.Dir`. The
      * directory entry is a combination of the file name and file type pairs.
      *
      * Additionally, when {@link readdir} or {@link readdirSync} is called with
-     * the `withFileTypes` option set to `true`, the resulting array is filled with `<fs.Dirent>` objects, rather than strings or `<Buffer>` s.
+     * the `withFileTypes` option set to `true`, the resulting array is filled with `fs.Dirent` objects, rather than strings or `Buffer` s.
      * @since v10.10.0
      */
     export class Dirent {
         /**
-         * Returns `true` if the `<fs.Dirent>` object describes a regular file.
+         * Returns `true` if the `fs.Dirent` object describes a regular file.
          * @since v10.10.0
          */
         isFile(): boolean;
         /**
-         * Returns `true` if the `<fs.Dirent>` object describes a file system
+         * Returns `true` if the `fs.Dirent` object describes a file system
          * directory.
          * @since v10.10.0
          */
         isDirectory(): boolean;
         /**
-         * Returns `true` if the `<fs.Dirent>` object describes a block device.
+         * Returns `true` if the `fs.Dirent` object describes a block device.
          * @since v10.10.0
          */
         isBlockDevice(): boolean;
         /**
-         * Returns `true` if the `<fs.Dirent>` object describes a character device.
+         * Returns `true` if the `fs.Dirent` object describes a character device.
          * @since v10.10.0
          */
         isCharacterDevice(): boolean;
         /**
-         * Returns `true` if the `<fs.Dirent>` object describes a symbolic link.
+         * Returns `true` if the `fs.Dirent` object describes a symbolic link.
          * @since v10.10.0
          */
         isSymbolicLink(): boolean;
         /**
-         * Returns `true` if the `<fs.Dirent>` object describes a first-in-first-out
+         * Returns `true` if the `fs.Dirent` object describes a first-in-first-out
          * (FIFO) pipe.
          * @since v10.10.0
          */
         isFIFO(): boolean;
         /**
-         * Returns `true` if the `<fs.Dirent>` object describes a socket.
+         * Returns `true` if the `fs.Dirent` object describes a socket.
          * @since v10.10.0
          */
         isSocket(): boolean;
         /**
-         * The file name that this `<fs.Dirent>` object refers to. The type of this
+         * The file name that this `fs.Dirent` object refers to. The type of this
          * value is determined by the `options.encoding` passed to {@link readdir} or {@link readdirSync}.
          * @since v10.10.0
          */
@@ -214,7 +202,7 @@ declare module 'fs' {
      * }
      * ```
      *
-     * When using the async iterator, the `<fs.Dir>` object will be automatically
+     * When using the async iterator, the `fs.Dir` object will be automatically
      * closed after the iterator exits.
      * @since v12.12.0
      */
@@ -245,9 +233,9 @@ declare module 'fs' {
          */
         closeSync(): void;
         /**
-         * Asynchronously read the next directory entry via [`readdir(3)`](http://man7.org/linux/man-pages/man3/readdir.3.html) as an `<fs.Dirent>`.
+         * Asynchronously read the next directory entry via [`readdir(3)`](http://man7.org/linux/man-pages/man3/readdir.3.html) as an `fs.Dirent`.
          *
-         * A promise is returned that will be resolved with an `<fs.Dirent>`, or `null`if there are no more directory entries to read.
+         * A promise is returned that will be resolved with an `fs.Dirent`, or `null`if there are no more directory entries to read.
          *
          * Directory entries returned by this function are in no particular order as
          * provided by the operating system's underlying directory mechanisms.
@@ -259,7 +247,7 @@ declare module 'fs' {
         read(): Promise<Dirent | null>;
         read(cb: (err: NodeJS.ErrnoException | null, dirEnt: Dirent | null) => void): void;
         /**
-         * Synchronously read the next directory entry as an `<fs.Dirent>`. See the
+         * Synchronously read the next directory entry as an `fs.Dirent`. See the
          * POSIX [`readdir(3)`](http://man7.org/linux/man-pages/man3/readdir.3.html) documentation for more detail.
          *
          * If there are no more directory entries to read, `null` will be returned.
@@ -274,7 +262,7 @@ declare module 'fs' {
     }
     export interface FSWatcher extends EventEmitter {
         /**
-         * Stop watching for changes on the given `<fs.FSWatcher>`. Once stopped, the `<fs.FSWatcher>` object is no longer usable.
+         * Stop watching for changes on the given `fs.FSWatcher`. Once stopped, the `fs.FSWatcher` object is no longer usable.
          * @since v0.5.8
          */
         close(): void;
@@ -305,7 +293,7 @@ declare module 'fs' {
         prependOnceListener(event: 'close', listener: () => void): this;
     }
     /**
-     * Instances of `<fs.ReadStream>` are created and returned using the {@link createReadStream} function.
+     * Instances of `fs.ReadStream` are created and returned using the {@link createReadStream} function.
      * @since v0.1.93
      */
     export class ReadStream extends stream.Readable {
@@ -317,8 +305,8 @@ declare module 'fs' {
         bytesRead: number;
         /**
          * The path to the file the stream is reading from as specified in the first
-         * argument to `fs.createReadStream()`. If `path` is passed as a string, then`readStream.path` will be a string. If `path` is passed as a `<Buffer>`, then`readStream.path` will be a
-         * `<Buffer>`.
+         * argument to `fs.createReadStream()`. If `path` is passed as a string, then`readStream.path` will be a string. If `path` is passed as a `Buffer`, then`readStream.path` will be a
+         * `Buffer`.
          * @since v0.1.93
          */
         path: string | Buffer;
@@ -386,9 +374,9 @@ declare module 'fs' {
         prependOnceListener(event: string | symbol, listener: (...args: any[]) => void): this;
     }
     /**
-     * * Extends `<stream.Writable>`
+     * * Extends `stream.Writable`
      *
-     * Instances of `<fs.WriteStream>` are created and returned using the {@link createWriteStream} function.
+     * Instances of `fs.WriteStream` are created and returned using the {@link createWriteStream} function.
      * @since v0.1.93
      */
     export class WriteStream extends stream.Writable {
@@ -406,8 +394,8 @@ declare module 'fs' {
         bytesWritten: number;
         /**
          * The path to the file the stream is writing to as specified in the first
-         * argument to {@link createWriteStream}. If `path` is passed as a string, then`writeStream.path` will be a string. If `path` is passed as a `<Buffer>`, then`writeStream.path` will be a
-         * `<Buffer>`.
+         * argument to {@link createWriteStream}. If `path` is passed as a string, then`writeStream.path` will be a string. If `path` is passed as a `Buffer`, then`writeStream.path` will be a
+         * `Buffer`.
          * @since v0.1.93
          */
         path: string | Buffer;
@@ -511,6 +499,15 @@ declare module 'fs' {
      * given to the completion callback. A file descriptor can also be passed as the
      * first argument. In this case, `fs.ftruncate()` is called.
      *
+     * ```js
+     * import { truncate } from 'fs';
+     * // Assuming that 'path/file.txt' is a regular file.
+     * truncate('path/file.txt', (err) => {
+     *   if (err) throw err;
+     *   console.log('path/file.txt was truncated');
+     * });
+     * ```
+     *
      * Passing a file descriptor is deprecated and may result in an error being thrown
      * in the future.
      *
@@ -789,7 +786,7 @@ declare module 'fs' {
      */
     export function lchmodSync(path: PathLike, mode: Mode): void;
     /**
-     * Asynchronous [`stat(2)`](http://man7.org/linux/man-pages/man2/stat.2.html). The callback gets two arguments `(err, stats)` where`stats` is an `<fs.Stats>` object.
+     * Asynchronous [`stat(2)`](http://man7.org/linux/man-pages/man2/stat.2.html). The callback gets two arguments `(err, stats)` where`stats` is an `fs.Stats` object.
      *
      * In case of an error, the `err.code` will be one of `Common System Errors`.
      *
@@ -950,7 +947,7 @@ declare module 'fs' {
      */
     export const statSync: StatSyncFn;
     /**
-     * Invokes the callback with the `<fs.Stats>` for the file descriptor.
+     * Invokes the callback with the `fs.Stats` for the file descriptor.
      *
      * See the POSIX [`fstat(2)`](http://man7.org/linux/man-pages/man2/fstat.2.html) documentation for more detail.
      * @since v0.1.95
@@ -998,8 +995,8 @@ declare module 'fs' {
      */
     export const fstatSync: StatSyncFn<number>;
     /**
-     * Retrieves the `<fs.Stats>` for the symbolic link referred to by the path.
-     * The callback gets two arguments `(err, stats)` where `stats` is a `<fs.Stats>` object. `lstat()` is identical to `stat()`, except that if `path` is a symbolic
+     * Retrieves the `fs.Stats` for the symbolic link referred to by the path.
+     * The callback gets two arguments `(err, stats)` where `stats` is a `fs.Stats` object. `lstat()` is identical to `stat()`, except that if `path` is a symbolic
      * link, then the link itself is stat-ed, not the file that it refers to.
      *
      * See the POSIX [`lstat(2)`](http://man7.org/linux/man-pages/man2/lstat.2.html) documentation for more details.
@@ -1133,7 +1130,7 @@ declare module 'fs' {
      * The optional `options` argument can be a string specifying an encoding, or an
      * object with an `encoding` property specifying the character encoding to use for
      * the link path passed to the callback. If the `encoding` is set to `'buffer'`,
-     * the link path returned will be passed as a `<Buffer>` object.
+     * the link path returned will be passed as a `Buffer` object.
      * @since v0.1.31
      */
     export function readlink(path: PathLike, options: EncodingOption, callback: (err: NodeJS.ErrnoException | null, linkString: string) => void): void;
@@ -1182,7 +1179,7 @@ declare module 'fs' {
      * The optional `options` argument can be a string specifying an encoding, or an
      * object with an `encoding` property specifying the character encoding to use for
      * the link path returned. If the `encoding` is set to `'buffer'`,
-     * the link path returned will be passed as a `<Buffer>` object.
+     * the link path returned will be passed as a `Buffer` object.
      * @since v0.1.31
      */
     export function readlinkSync(path: PathLike, options?: EncodingOption): string;
@@ -1218,7 +1215,7 @@ declare module 'fs' {
      * The optional `options` argument can be a string specifying an encoding, or an
      * object with an `encoding` property specifying the character encoding to use for
      * the path passed to the callback. If the `encoding` is set to `'buffer'`,
-     * the path returned will be passed as a `<Buffer>` object.
+     * the path returned will be passed as a `Buffer` object.
      *
      * If `path` resolves to a socket or a pipe, the function will return a system
      * dependent name for that object.
@@ -1271,7 +1268,7 @@ declare module 'fs' {
          * The optional `options` argument can be a string specifying an encoding, or an
          * object with an `encoding` property specifying the character encoding to use for
          * the path passed to the callback. If the `encoding` is set to `'buffer'`,
-         * the path returned will be passed as a `<Buffer>` object.
+         * the path returned will be passed as a `Buffer` object.
          *
          * On Linux, when Node.js is linked against musl libc, the procfs file system must
          * be mounted on `/proc` in order for this function to work. Glibc does not have
@@ -1731,9 +1728,9 @@ declare module 'fs' {
      * The optional `options` argument can be a string specifying an encoding, or an
      * object with an `encoding` property specifying the character encoding to use for
      * the filenames passed to the callback. If the `encoding` is set to `'buffer'`,
-     * the filenames returned will be passed as `<Buffer>` objects.
+     * the filenames returned will be passed as `Buffer` objects.
      *
-     * If `options.withFileTypes` is set to `true`, the `files` array will contain `<fs.Dirent>` objects.
+     * If `options.withFileTypes` is set to `true`, the `files` array will contain `fs.Dirent` objects.
      * @since v0.1.8
      */
     export function readdir(
@@ -1860,9 +1857,9 @@ declare module 'fs' {
      * The optional `options` argument can be a string specifying an encoding, or an
      * object with an `encoding` property specifying the character encoding to use for
      * the filenames returned. If the `encoding` is set to `'buffer'`,
-     * the filenames returned will be passed as `<Buffer>` objects.
+     * the filenames returned will be passed as `Buffer` objects.
      *
-     * If `options.withFileTypes` is set to `true`, the result will contain `<fs.Dirent>` objects.
+     * If `options.withFileTypes` is set to `true`, the result will contain `fs.Dirent` objects.
      * @since v0.1.21
      */
     export function readdirSync(
@@ -2177,6 +2174,8 @@ declare module 'fs' {
         }>;
     }
     /**
+     * If `buffer` is a plain object, it must have an own (not inherited) `toString`function property.
+     *
      * For detailed information, see the documentation of the asynchronous version of
      * this API: {@link write}.
      * @since v0.1.21
@@ -2510,10 +2509,12 @@ declare module 'fs' {
      * a file descriptor.
      *
      * The `encoding` option is ignored if `data` is a buffer.
-     * If `data` is a normal object, it must have an own `toString` function property.
+     *
+     * If `data` is a plain object, it must have an own (not inherited) `toString`function property.
      *
      * ```js
      * import { writeFile } from 'fs';
+     * import { Buffer } from 'buffer';
      *
      * const data = new Uint8Array(Buffer.from('Hello Node.js'));
      * writeFile('message.txt', data, (err) => {
@@ -2538,12 +2539,13 @@ declare module 'fs' {
      * performs multiple `write` calls internally to write the buffer passed to it.
      * For performance sensitive code consider using {@link createWriteStream}.
      *
-     * It is possible to use an `<AbortSignal>` to cancel an `fs.writeFile()`.
+     * It is possible to use an `AbortSignal` to cancel an `fs.writeFile()`.
      * Cancelation is "best effort", and some amount of data is likely still
      * to be written.
      *
      * ```js
      * import { writeFile } from 'fs';
+     * import { Buffer } from 'buffer';
      *
      * const controller = new AbortController();
      * const { signal } = controller;
@@ -2586,6 +2588,8 @@ declare module 'fs' {
     /**
      * Returns `undefined`.
      *
+     * If `data` is a plain object, it must have an own (not inherited) `toString`function property.
+     *
      * For detailed information, see the documentation of the asynchronous version of
      * this API: {@link writeFile}.
      * @since v0.1.29
@@ -2594,7 +2598,7 @@ declare module 'fs' {
     export function writeFileSync(file: PathOrFileDescriptor, data: string | NodeJS.ArrayBufferView, options?: WriteFileOptions): void;
     /**
      * Asynchronously append data to a file, creating the file if it does not yet
-     * exist. `data` can be a string or a `<Buffer>`.
+     * exist. `data` can be a string or a `Buffer`.
      *
      * ```js
      * import { appendFile } from 'fs';
@@ -2668,7 +2672,7 @@ declare module 'fs' {
     }
     /**
      * Synchronously append data to a file, creating the file if it does not yet
-     * exist. `data` can be a string or a `<Buffer>`.
+     * exist. `data` can be a string or a `Buffer`.
      *
      * ```js
      * import { appendFileSync } from 'fs';
@@ -2806,10 +2810,10 @@ declare module 'fs' {
      * On most platforms, `'rename'` is emitted whenever a filename appears or
      * disappears in the directory.
      *
-     * The listener callback is attached to the `'change'` event fired by `<fs.FSWatcher>`, but it is not the same thing as the `'change'` value of`eventType`.
+     * The listener callback is attached to the `'change'` event fired by `fs.FSWatcher`, but it is not the same thing as the `'change'` value of`eventType`.
      *
      * If a `signal` is passed, aborting the corresponding AbortController will close
-     * the returned `<fs.FSWatcher>`.
+     * the returned `fs.FSWatcher`.
      * @since v0.5.10
      * @param listener
      */
@@ -3146,7 +3150,7 @@ declare module 'fs' {
      * });
      *
      * // Check if the file exists in the current directory, and if it is writable.
-     * access(file, constants.F_OK | fs.constants.W_OK, (err) => {
+     * access(file, constants.F_OK | constants.W_OK, (err) => {
      *   if (err) {
      *     console.error(
      *       `${file} ${err.code === 'ENOENT' ? 'does not exist' : 'is read-only'}`);
@@ -3343,11 +3347,11 @@ declare module 'fs' {
      * start counting at 0, allowed values are in the
      * \[0, [`Number.MAX_SAFE_INTEGER`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER)\] range. If `fd` is specified and `start` is
      * omitted or `undefined`, `fs.createReadStream()` reads sequentially from the
-     * current file position. The `encoding` can be any one of those accepted by `<Buffer>`.
+     * current file position. The `encoding` can be any one of those accepted by `Buffer`.
      *
      * If `fd` is specified, `ReadStream` will ignore the `path` argument and will use
      * the specified file descriptor. This means that no `'open'` event will be
-     * emitted. `fd` should be blocking; non-blocking `fd`s should be passed to `<net.Socket>`.
+     * emitted. `fd` should be blocking; non-blocking `fd`s should be passed to `net.Socket`.
      *
      * If `fd` points to a character device that only supports blocking reads
      * (such as keyboard or sound card), read operations do not finish until data is
@@ -3404,7 +3408,7 @@ declare module 'fs' {
      * position past the beginning of the file, allowed values are in the
      * \[0, [`Number.MAX_SAFE_INTEGER`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER)\] range. Modifying a file rather than replacing
      * it may require the `flags` option to be set to `r+` rather than the default `w`.
-     * The `encoding` can be any one of those accepted by `<Buffer>`.
+     * The `encoding` can be any one of those accepted by `Buffer`.
      *
      * If `autoClose` is set to true (default behavior) on `'error'` or `'finish'`the file descriptor will be closed automatically. If `autoClose` is false,
      * then the file descriptor won't be closed, even if there's an error.
@@ -3418,9 +3422,9 @@ declare module 'fs' {
      * performance as some optimizations (`_writev()`)
      * will be disabled. When providing the `fs` option,  overrides for `open`,`close`, and at least one of `write` and `writev` are required.
      *
-     * Like `<fs.ReadStream>`, if `fd` is specified, `<fs.WriteStream>` will ignore the`path` argument and will use the specified file descriptor. This means that no`'open'` event will be
+     * Like `fs.ReadStream`, if `fd` is specified, `fs.WriteStream` will ignore the`path` argument and will use the specified file descriptor. This means that no`'open'` event will be
      * emitted. `fd` should be blocking; non-blocking `fd`s
-     * should be passed to `<net.Socket>`.
+     * should be passed to `net.Socket`.
      *
      * If `options` is a string, then it specifies the encoding.
      * @since v0.1.31
@@ -3615,7 +3619,7 @@ declare module 'fs' {
     /**
      * Synchronously open a directory. See [`opendir(3)`](http://man7.org/linux/man-pages/man3/opendir.3.html).
      *
-     * Creates an `<fs.Dir>`, which contains all further functions for reading from
+     * Creates an `fs.Dir`, which contains all further functions for reading from
      * and cleaning up the directory.
      *
      * The `encoding` option sets the encoding for the `path` while opening the
@@ -3627,7 +3631,7 @@ declare module 'fs' {
      * Asynchronously open a directory. See the POSIX [`opendir(3)`](http://man7.org/linux/man-pages/man3/opendir.3.html) documentation for
      * more details.
      *
-     * Creates an `<fs.Dir>`, which contains all further functions for reading from
+     * Creates an `fs.Dir`, which contains all further functions for reading from
      * and cleaning up the directory.
      *
      * The `encoding` option sets the encoding for the `path` while opening the
@@ -3652,6 +3656,67 @@ declare module 'fs' {
         bigint?: boolean | undefined;
         throwIfNoEntry?: boolean | undefined;
     }
+    export interface CopyOptions {
+        /**
+         * Dereference symlinks
+         * @default false
+         */
+        dereference?: boolean;
+        /**
+         * When `force` is `false`, and the destination
+         * exists, throw an error.
+         * @default false
+         */
+        errorOnExist?: boolean;
+        /**
+         * Function to filter copied files/directories. Return
+         * `true` to copy the item, `false` to ignore it.
+         */
+        filter?(source: string, destination: string): boolean;
+        /**
+         * Overwrite existing file or directory. _The copy
+         * operation will ignore errors if you set this to false and the destination
+         * exists. Use the `errorOnExist` option to change this behavior.
+         * @default true
+         */
+        force?: boolean;
+        /**
+         * When `true` timestamps from `src` will
+         * be preserved.
+         * @default false
+         */
+        preserveTimestamps?: boolean;
+        /**
+         * Copy directories recursively.
+         * @default false
+         */
+        recursive?: boolean;
+    }
+    /**
+     * Asynchronously copies the entire directory structure from `src` to `dest`,
+     * including subdirectories and files.
+     *
+     * When copying a directory to another directory, globs are not supported and
+     * behavior is similar to `cp dir1/ dir2/`.
+     * @since v16.7.0
+     * @experimental
+     * @param src source path to copy.
+     * @param dest destination path to copy to.
+     */
+    export function cp(source: string, destination: string, callback: (err: NodeJS.ErrnoException | null) => void): void;
+    export function cp(source: string, destination: string, opts: CopyOptions, callback: (err: NodeJS.ErrnoException | null) => void): void;
+    /**
+     * Synchronously copies the entire directory structure from `src` to `dest`,
+     * including subdirectories and files.
+     *
+     * When copying a directory to another directory, globs are not supported and
+     * behavior is similar to `cp dir1/ dir2/`.
+     * @since v16.7.0
+     * @experimental
+     * @param src source path to copy.
+     * @param dest destination path to copy to.
+     */
+    export function cpSync(source: string, destination: string, opts?: CopyOptions): void;
 }
 declare module 'node:fs' {
     export * from 'fs';

node/globals.d.ts

@@ -13,19 +13,6 @@ interface ErrorConstructor {
     stackTraceLimit: number;
 }
 
-// Node.js ESNEXT support
-interface String {
-    /** Removes whitespace from the left end of a string. */
-    trimLeft(): string;
-    /** Removes whitespace from the right end of a string. */
-    trimRight(): string;
-
-    /** Returns a copy with leading whitespace removed. */
-    trimStart(): string;
-    /** Returns a copy with trailing whitespace removed. */
-    trimEnd(): string;
-}
-
 /*-----------------------------------------------*
  *                                               *
  *                   GLOBAL                      *
@@ -89,6 +76,30 @@ declare var AbortSignal: {
 };
 //#endregion borrowed
 
+//#region ArrayLike.at()
+interface RelativeIndexable<T> {
+    /**
+     * Takes an integer value and returns the item at that index,
+     * allowing for positive and negative integers.
+     * Negative integers count back from the last item in the array.
+     */
+    at(index: number): T | undefined;
+}
+interface String extends RelativeIndexable<string> {}
+interface Array<T> extends RelativeIndexable<T> {}
+interface Int8Array extends RelativeIndexable<number> {}
+interface Uint8Array extends RelativeIndexable<number> {}
+interface Uint8ClampedArray extends RelativeIndexable<number> {}
+interface Int16Array extends RelativeIndexable<number> {}
+interface Uint16Array extends RelativeIndexable<number> {}
+interface Int32Array extends RelativeIndexable<number> {}
+interface Uint32Array extends RelativeIndexable<number> {}
+interface Float32Array extends RelativeIndexable<number> {}
+interface Float64Array extends RelativeIndexable<number> {}
+interface BigInt64Array extends RelativeIndexable<bigint> {}
+interface BigUint64Array extends RelativeIndexable<bigint> {}
+//#endregion ArrayLike.at() end
+
 /*----------------------------------------------*
 *                                               *
 *               GLOBAL INTERFACES               *

node/http.d.ts

@@ -37,7 +37,7 @@
  *   'Host', 'mysite.com',
  *   'accepT', '*' ]
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.4.2/lib/http.js)
+ * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/http.js)
  */
 declare module 'http' {
     import * as stream from 'node:stream';
@@ -162,26 +162,80 @@ declare module 'http' {
     class Server extends NetServer {
         constructor(requestListener?: RequestListener);
         constructor(options: ServerOptions, requestListener?: RequestListener);
+        /**
+         * Sets the timeout value for sockets, and emits a `'timeout'` event on
+         * the Server object, passing the socket as an argument, if a timeout
+         * occurs.
+         *
+         * If there is a `'timeout'` event listener on the Server object, then it
+         * will be called with the timed-out socket as an argument.
+         *
+         * By default, the Server does not timeout sockets. However, if a callback
+         * is assigned to the Server's `'timeout'` event, timeouts must be handled
+         * explicitly.
+         * @since v0.9.12
+         * @param [msecs=0 (no timeout)]
+         */
         setTimeout(msecs?: number, callback?: () => void): this;
         setTimeout(callback: () => void): this;
         /**
          * Limits maximum incoming headers count. If set to 0, no limit will be applied.
-         * @default 2000
-         * {@link https://nodejs.org/api/http.html#http_server_maxheaderscount}
+         * @since v0.7.0
          */
         maxHeadersCount: number | null;
+        /**
+         * The number of milliseconds of inactivity before a socket is presumed
+         * to have timed out.
+         *
+         * A value of `0` will disable the timeout behavior on incoming connections.
+         *
+         * The socket timeout logic is set up on connection, so changing this
+         * value only affects new connections to the server, not any existing connections.
+         * @since v0.9.12
+         */
         timeout: number;
         /**
-         * Limit the amount of time the parser will wait to receive the complete HTTP headers.
-         * @default 60000
-         * {@link https://nodejs.org/api/http.html#http_server_headerstimeout}
+         * Limit the amount of time the parser will wait to receive the complete HTTP
+         * headers.
+         *
+         * In case of inactivity, the rules defined in `server.timeout` apply. However,
+         * that inactivity based timeout would still allow the connection to be kept open
+         * if the headers are being sent very slowly (by default, up to a byte per 2
+         * minutes). In order to prevent this, whenever header data arrives an additional
+         * check is made that more than `server.headersTimeout` milliseconds has not
+         * passed since the connection was established. If the check fails, a `'timeout'`event is emitted on the server object, and (by default) the socket is destroyed.
+         * See `server.timeout` for more information on how timeout behavior can be
+         * customized.
+         * @since v11.3.0, v10.14.0
          */
         headersTimeout: number;
+        /**
+         * The number of milliseconds of inactivity a server needs to wait for additional
+         * incoming data, after it has finished writing the last response, before a socket
+         * will be destroyed. If the server receives new data before the keep-alive
+         * timeout has fired, it will reset the regular inactivity timeout, i.e.,`server.timeout`.
+         *
+         * A value of `0` will disable the keep-alive timeout behavior on incoming
+         * connections.
+         * A value of `0` makes the http server behave similarly to Node.js versions prior
+         * to 8.0.0, which did not have a keep-alive timeout.
+         *
+         * The socket timeout logic is set up on connection, so changing this value only
+         * affects new connections to the server, not any existing connections.
+         * @since v8.0.0
+         */
         keepAliveTimeout: number;
         /**
-         * Sets the timeout value in milliseconds for receiving the entire request from the client.
-         * @default 0
-         * {@link https://nodejs.org/api/http.html#http_server_requesttimeout}
+         * Sets the timeout value in milliseconds for receiving the entire request from
+         * the client.
+         *
+         * If the timeout expires, the server responds with status 408 without
+         * forwarding the request to the request listener and then closes the connection.
+         *
+         * It must be set to a non-zero value (e.g. 120 seconds) to protect against
+         * potential Denial-of-Service attacks in case the server is deployed without a
+         * reverse proxy in front.
+         * @since v14.11.0
          */
         requestTimeout: number;
         addListener(event: string, listener: (...args: any[]) => void): this;
@@ -686,7 +740,7 @@ declare module 'http' {
      * access response
      * status, headers and data.
      *
-     * Different from its `socket` value which is a subclass of `<stream.Duplex>`, the`IncomingMessage` itself extends `<stream.Readable>` and is created separately to
+     * Different from its `socket` value which is a subclass of `stream.Duplex`, the`IncomingMessage` itself extends `stream.Readable` and is created separately to
      * parse and emit the incoming HTTP headers and payload, as the underlying socket
      * may be reused multiple times in case of keep-alive.
      * @since v0.1.17
@@ -746,9 +800,9 @@ declare module 'http' {
          * With HTTPS support, use `request.socket.getPeerCertificate()` to obtain the
          * client's authentication details.
          *
-         * This property is guaranteed to be an instance of the `<net.Socket>` class,
-         * a subclass of `<stream.Duplex>`, unless the user specified a socket
-         * type other than `<net.Socket>`.
+         * This property is guaranteed to be an instance of the `net.Socket` class,
+         * a subclass of `stream.Duplex`, unless the user specified a socket
+         * type other than `net.Socket`.
          * @since v0.3.0
          */
         socket: Socket;