cdk-ecr-deployment 2.0.2 → 2.0.6

package/node_modules/@types/cacheable-request/node_modules/@types/node/v8.d.ts

@@ -4,7 +4,7 @@
  * ```js
  * const v8 = require('v8');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/v8.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/v8.js)
  */
 declare module 'v8' {
     import { Readable } from 'node:stream';
@@ -362,14 +362,14 @@ declare module 'v8' {
      *
      * When the process is about to exit, one last coverage will still be written to
      * disk unless {@link stopCoverage} is invoked before the process exits.
-     * @since v15.1.0, v12.22.0
+     * @since v15.1.0, v14.18.0, v12.22.0
      */
     function takeCoverage(): void;
     /**
      * The `v8.stopCoverage()` method allows the user to stop the coverage collection
      * started by `NODE_V8_COVERAGE`, so that V8 can release the execution count
      * records and optimize code. This can be used in conjunction with {@link takeCoverage} if the user wants to collect the coverage on demand.
-     * @since v15.1.0, v12.22.0
+     * @since v15.1.0, v14.18.0, v12.22.0
      */
     function stopCoverage(): void;
 }

package/node_modules/@types/cacheable-request/node_modules/@types/node/vm.d.ts

@@ -32,7 +32,7 @@
  *
  * console.log(x); // 1; y is not defined.
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/vm.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/vm.js)
  */
 declare module 'vm' {
     interface Context extends NodeJS.Dict<any> {}

package/node_modules/@types/cacheable-request/node_modules/@types/node/wasi.d.ts

@@ -68,7 +68,7 @@
  * The `--experimental-wasi-unstable-preview1` CLI argument is needed for this
  * example to run.
  * @experimental
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/wasi.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/wasi.js)
  */
 declare module 'wasi' {
     interface WASIOptions {

package/node_modules/@types/cacheable-request/node_modules/@types/node/worker_threads.d.ts

@@ -49,7 +49,7 @@
  *
  * Worker threads inherit non-process-specific options by default. Refer to `Worker constructor options` to know how to customize worker thread options,
  * specifically `argv` and `execArgv` options.
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/worker_threads.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/worker_threads.js)
  */
 declare module 'worker_threads' {
     import { Blob } from 'node:buffer';
@@ -384,7 +384,7 @@ declare module 'worker_threads' {
         /**
          * An object that can be used to query performance information from a worker
          * instance. Similar to `perf_hooks.performance`.
-         * @since v15.1.0, v12.22.0
+         * @since v15.1.0, v14.17.0, v12.22.0
          */
         readonly performance: WorkerPerformance;
         /**
@@ -629,14 +629,14 @@ declare module 'worker_threads' {
      *   console.log(getEnvironmentData('Hello'));  // Prints 'World!'.
      * }
      * ```
-     * @since v15.12.0
+     * @since v15.12.0, v14.18.0
      * @experimental
      * @param key Any arbitrary, cloneable JavaScript value that can be used as a {Map} key.
      */
     function getEnvironmentData(key: Serializable): Serializable;
     /**
      * The `worker.setEnvironmentData()` API sets the content of`worker.getEnvironmentData()` in the current thread and all new `Worker`instances spawned from the current context.
-     * @since v15.12.0
+     * @since v15.12.0, v14.18.0
      * @experimental
      * @param key Any arbitrary, cloneable JavaScript value that can be used as a {Map} key.
      * @param value Any arbitrary, cloneable JavaScript value that will be cloned and passed automatically to all new `Worker` instances. If `value` is passed as `undefined`, any previously set value

package/node_modules/@types/cacheable-request/node_modules/@types/node/zlib.d.ts

@@ -88,7 +88,7 @@
  *   });
  * ```
  * @since v0.5.8
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/zlib.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/zlib.js)
  */
 declare module 'zlib' {
     import * as stream from 'node:stream';

package/node_modules/@types/keyv/node_modules/@types/node/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for Node.js (https://nodejs.org/).
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node.
 
 ### Additional Details
- * Last updated: Tue, 07 Dec 2021 06:31:07 GMT
+ * Last updated: Mon, 20 Dec 2021 23:01:20 GMT
  * Dependencies: none
  * Global values: `AbortController`, `AbortSignal`, `__dirname`, `__filename`, `console`, `exports`, `gc`, `global`, `module`, `process`, `require`
 

package/node_modules/@types/keyv/node_modules/@types/node/assert.d.ts

@@ -1,7 +1,7 @@
 /**
  * The `assert` module provides a set of assertion functions for verifying
  * invariants.
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/assert.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/assert.js)
  */
 declare module 'assert' {
     /**

package/node_modules/@types/keyv/node_modules/@types/node/async_hooks.d.ts

@@ -6,7 +6,7 @@
  * import async_hooks from 'async_hooks';
  * ```
  * @experimental
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/async_hooks.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/async_hooks.js)
  */
 declare module 'async_hooks' {
     /**
@@ -395,8 +395,9 @@ declare module 'async_hooks' {
         getStore(): T | undefined;
         /**
          * Runs a function synchronously within a context and returns its
-         * return value. The store is not accessible outside of the callback function or
-         * the asynchronous operations created within the callback.
+         * return value. The store is not accessible outside of the callback function.
+         * The store is accessible to any asynchronous operations created within the
+         * callback.
          *
          * The optional `args` are passed to the callback function.
          *
@@ -410,6 +411,9 @@ declare module 'async_hooks' {
          * try {
          *   asyncLocalStorage.run(store, () => {
          *     asyncLocalStorage.getStore(); // Returns the store object
+         *     setTimeout(() => {
+         *       asyncLocalStorage.getStore(); // Returns the store object
+         *     }, 200);
          *     throw new Error();
          *   });
          * } catch (e) {

package/node_modules/@types/keyv/node_modules/@types/node/buffer.d.ts

@@ -41,7 +41,7 @@
  * // Creates a Buffer containing the Latin-1 bytes [0x74, 0xe9, 0x73, 0x74].
  * const buf7 = Buffer.from('tést', 'latin1');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/buffer.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/buffer.js)
  */
 declare module 'buffer' {
     import { BinaryLike } from 'node:crypto';
@@ -113,18 +113,18 @@ declare module 'buffer' {
     /**
      * A [`Blob`](https://developer.mozilla.org/en-US/docs/Web/API/Blob) encapsulates immutable, raw data that can be safely shared across
      * multiple worker threads.
-     * @since v15.7.0
+     * @since v15.7.0, v14.18.0
      * @experimental
      */
     export class Blob {
         /**
          * The total size of the `Blob` in bytes.
-         * @since v15.7.0
+         * @since v15.7.0, v14.18.0
          */
         readonly size: number;
         /**
          * The content-type of the `Blob`.
-         * @since v15.7.0
+         * @since v15.7.0, v14.18.0
          */
         readonly type: string;
         /**
@@ -139,13 +139,13 @@ declare module 'buffer' {
         /**
          * Returns a promise that fulfills with an [ArrayBuffer](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer) containing a copy of
          * the `Blob` data.
-         * @since v15.7.0
+         * @since v15.7.0, v14.18.0
          */
         arrayBuffer(): Promise<ArrayBuffer>;
         /**
          * Creates and returns a new `Blob` containing a subset of this `Blob` objects
          * data. The original `Blob` is not altered.
-         * @since v15.7.0
+         * @since v15.7.0, v14.18.0
          * @param start The starting index.
          * @param end The ending index.
          * @param type The content-type for the new `Blob`
@@ -154,7 +154,7 @@ declare module 'buffer' {
         /**
          * Returns a promise that fulfills with the contents of the `Blob` decoded as a
          * UTF-8 string.
-         * @since v15.7.0
+         * @since v15.7.0, v14.18.0
          */
         text(): Promise<string>;
         /**
@@ -2114,7 +2114,7 @@ declare module 'buffer' {
          * **binary data and predate the introduction of typed arrays in JavaScript.**
          * **For code running using Node.js APIs, converting between base64-encoded strings**
          * **and binary data should be performed using `Buffer.from(str, 'base64')` and`buf.toString('base64')`.**
-         * @since v15.13.0
+         * @since v15.13.0, v14.17.0
          * @deprecated Use `Buffer.from(data, 'base64')` instead.
          * @param data The Base64-encoded input string.
          */
@@ -2130,7 +2130,7 @@ declare module 'buffer' {
          * **binary data and predate the introduction of typed arrays in JavaScript.**
          * **For code running using Node.js APIs, converting between base64-encoded strings**
          * **and binary data should be performed using `Buffer.from(str, 'base64')` and`buf.toString('base64')`.**
-         * @since v15.13.0
+         * @since v15.13.0, v14.17.0
          * @deprecated Use `buf.toString('base64')` instead.
          * @param data An ASCII (Latin1) string.
          */

package/node_modules/@types/keyv/node_modules/@types/node/child_process.d.ts

@@ -60,7 +60,7 @@
  * For certain use cases, such as automating shell scripts, the `synchronous counterparts` may be more convenient. In many cases, however,
  * the synchronous methods can have significant impact on performance due to
  * stalling the event loop while spawned processes complete.
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/child_process.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/child_process.js)
  */
 declare module 'child_process' {
     import { ObjectEncodingOptions } from 'node:fs';

package/node_modules/@types/keyv/node_modules/@types/node/cluster.d.ts

@@ -49,7 +49,7 @@
  * ```
  *
  * On Windows, it is not yet possible to set up a named pipe server in a worker.
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/cluster.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/cluster.js)
  */
 declare module 'cluster' {
     import * as child from 'node:child_process';

package/node_modules/@types/keyv/node_modules/@types/node/console.d.ts

@@ -53,7 +53,7 @@
  * myConsole.warn(`Danger ${name}! Danger!`);
  * // Prints: Danger Will Robinson! Danger!, to err
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/console.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/console.js)
  */
 declare module 'console' {
     import console = require('node:console');

package/node_modules/@types/keyv/node_modules/@types/node/crypto.d.ts

@@ -13,7 +13,7 @@
  * // Prints:
  * //   c0fa1bc00531bd78ef38c628449c5102aeabd49b5dc3a2a516ea6ea959d6658e
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/crypto.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/crypto.js)
  */
 declare module 'crypto' {
     import * as stream from 'node:stream';
@@ -3030,7 +3030,7 @@ declare module 'crypto' {
     /**
      * Generates a random [RFC 4122](https://www.rfc-editor.org/rfc/rfc4122.txt) version 4 UUID. The UUID is generated using a
      * cryptographic pseudorandom number generator.
-     * @since v15.6.0
+     * @since v15.6.0, v14.17.0
      */
     function randomUUID(options?: RandomUUIDOptions): string;
     interface X509CheckOptions {

package/node_modules/@types/keyv/node_modules/@types/node/dgram.d.ts

@@ -23,7 +23,7 @@
  * server.bind(41234);
  * // Prints: server listening 0.0.0.0:41234
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/dgram.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/dgram.js)
  */
 declare module 'dgram' {
     import { AddressInfo } from 'node:net';
@@ -260,7 +260,7 @@ declare module 'dgram' {
          *
          * The `address` argument is a string. If the value of `address` is a host name,
          * DNS will be used to resolve the address of the host. If `address` is not
-         * provided or otherwise falsy, `'127.0.0.1'` (for `udp4` sockets) or `'::1'`(for `udp6` sockets) will be used by default.
+         * provided or otherwise nullish, `'127.0.0.1'` (for `udp4` sockets) or `'::1'`(for `udp6` sockets) will be used by default.
          *
          * If the socket has not been previously bound with a call to `bind`, the socket
          * is assigned a random port number and is bound to the "all interfaces" address

package/node_modules/@types/keyv/node_modules/@types/node/diagnostics_channel.d.ts

@@ -20,7 +20,7 @@
  * should generally include the module name to avoid collisions with data from
  * other modules.
  * @experimental
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/diagnostics_channel.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/diagnostics_channel.js)
  */
 declare module 'diagnostics_channel' {
     /**

package/node_modules/@types/keyv/node_modules/@types/node/dns/promises.d.ts

@@ -119,7 +119,7 @@ declare module 'dns/promises' {
      *
      * <omitted>
      *
-     * On error, the `Promise` is rejected with an `Error` object, where `err.code`is one of the `DNS error codes`.
+     * On error, the `Promise` is rejected with an `Error` object, where `err.code`is one of the DNS error codes.
      * @since v10.6.0
      * @param hostname Host name to resolve.
      * @param [rrtype='A'] Resource record type.
@@ -189,7 +189,7 @@ declare module 'dns/promises' {
      * Uses the DNS protocol to resolve `CAA` records for the `hostname`. On success,
      * the `Promise` is resolved with an array of objects containing available
      * certification authority authorization records available for the `hostname`(e.g. `[{critical: 0, iodef: 'mailto:pki@example.com'},{critical: 128, issue: 'pki.example.com'}]`).
-     * @since v15.0.0
+     * @since v15.0.0, v14.17.0
      */
     function resolveCaa(hostname: string): Promise<CaaRecord[]>;
     /**
@@ -300,7 +300,7 @@ declare module 'dns/promises' {
      * Performs a reverse DNS query that resolves an IPv4 or IPv6 address to an
      * array of host names.
      *
-     * On error, the `Promise` is rejected with an `Error` object, where `err.code`is one of the `DNS error codes`.
+     * On error, the `Promise` is rejected with an `Error` object, where `err.code`is one of the DNS error codes.
      * @since v10.6.0
      */
     function reverse(ip: string): Promise<string[]>;
@@ -332,14 +332,16 @@ declare module 'dns/promises' {
      */
     function setServers(servers: ReadonlyArray<string>): void;
     /**
-     * Set the default value of `verbatim` in {@link lookup}. The value could be:
-     * - `ipv4first`: sets default `verbatim` `false`.
-     * - `verbatim`: sets default `verbatim` `true`.
+     * Set the default value of `verbatim` in `dns.lookup()` and `dnsPromises.lookup()`. The value could be:
      *
-     * The default is `ipv4first` and {@link setDefaultResultOrder} have higher priority than `--dns-result-order`.
-     * When using worker threads, {@link setDefaultResultOrder} from the main thread won't affect the default dns orders in workers.
-     * @since v14.18.0
-     * @param order must be 'ipv4first' or 'verbatim'.
+     * * `ipv4first`: sets default `verbatim` `false`.
+     * * `verbatim`: sets default `verbatim` `true`.
+     *
+     * The default is `ipv4first` and `dnsPromises.setDefaultResultOrder()` have
+     * higher priority than `--dns-result-order`. When using `worker threads`,`dnsPromises.setDefaultResultOrder()` from the main thread won't affect the
+     * default dns orders in workers.
+     * @since v16.4.0, v14.18.0
+     * @param order must be `'ipv4first'` or `'verbatim'`.
      */
     function setDefaultResultOrder(order: 'ipv4first' | 'verbatim'): void;
     class Resolver {

package/node_modules/@types/keyv/node_modules/@types/node/dns.d.ts

@@ -42,7 +42,7 @@
  * ```
  *
  * See the `Implementation considerations section` for more information.
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/dns.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/dns.js)
  */
 declare module 'dns' {
     import * as dnsPromises from 'node:dns/promises';
@@ -58,6 +58,9 @@ declare module 'dns' {
         family?: number | undefined;
         hints?: number | undefined;
         all?: boolean | undefined;
+        /**
+         * @default true
+         */
         verbatim?: boolean | undefined;
     }
     export interface LookupOneOptions extends LookupOptions {
@@ -241,7 +244,7 @@ declare module 'dns' {
      *
      * <omitted>
      *
-     * On error, `err` is an `Error` object, where `err.code` is one of the `DNS error codes`.
+     * On error, `err` is an `Error` object, where `err.code` is one of theDNS error codes.
      * @since v0.1.27
      * @param hostname Host name to resolve.
      * @param [rrtype='A'] Resource record type.
@@ -314,7 +317,7 @@ declare module 'dns' {
      * Uses the DNS protocol to resolve `CAA` records for the `hostname`. The`addresses` argument passed to the `callback` function
      * will contain an array of certification authority authorization records
      * available for the `hostname` (e.g. `[{critical: 0, iodef: 'mailto:pki@example.com'}, {critical: 128, issue: 'pki.example.com'}]`).
-     * @since v15.0.0
+     * @since v15.0.0, v14.17.0
      */
     export function resolveCaa(hostname: string, callback: (err: NodeJS.ErrnoException | null, records: CaaRecord[]) => void): void;
     export namespace resolveCaa {
@@ -527,14 +530,16 @@ declare module 'dns' {
      */
     export function getServers(): string[];
     /**
-     * Set the default value of `verbatim` in {@link lookup}. The value could be:
-     * - `ipv4first`: sets default `verbatim` `false`.
-     * - `verbatim`: sets default `verbatim` `true`.
-     *
-     * The default is `ipv4first` and {@link setDefaultResultOrder} have higher priority than `--dns-result-order`.
-     * When using worker threads, {@link setDefaultResultOrder} from the main thread won't affect the default dns orders in workers.
-     * @since v14.18.0
-     * @param order must be 'ipv4first' or 'verbatim'.
+     * Set the default value of `verbatim` in {@link lookup} and `dnsPromises.lookup()`. The value could be:
+     *
+     * * `ipv4first`: sets default `verbatim` `false`.
+     * * `verbatim`: sets default `verbatim` `true`.
+     *
+     * The default is `ipv4first` and {@link setDefaultResultOrder} have higher
+     * priority than `--dns-result-order`. When using `worker threads`,{@link setDefaultResultOrder} from the main thread won't affect the default
+     * dns orders in workers.
+     * @since v16.4.0, v14.18.0
+     * @param order must be `'ipv4first'` or `'verbatim'`.
      */
     export function setDefaultResultOrder(order: 'ipv4first' | 'verbatim'): void;
     // Error codes
@@ -640,7 +645,7 @@ declare module 'dns' {
          * The resolver will use the v4 local address when making requests to IPv4 DNS
          * servers, and the v6 local address when making requests to IPv6 DNS servers.
          * The `rrtype` of resolution requests has no impact on the local address used.
-         * @since v15.1.0
+         * @since v15.1.0, v14.17.0
          * @param [ipv4='0.0.0.0'] A string representation of an IPv4 address.
          * @param [ipv6='::0'] A string representation of an IPv6 address.
          */

package/node_modules/@types/keyv/node_modules/@types/node/domain.d.ts

@@ -11,7 +11,7 @@
  * will be notified, rather than losing the context of the error in the`process.on('uncaughtException')` handler, or causing the program to
  * exit immediately with an error code.
  * @deprecated Since v1.4.2 - Deprecated
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/domain.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/domain.js)
  */
 declare module 'domain' {
     import EventEmitter = require('node:events');

package/node_modules/@types/keyv/node_modules/@types/node/events.d.ts

@@ -32,7 +32,7 @@
  * });
  * myEmitter.emit('event');
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/events.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/events.js)
  */
 declare module 'events' {
     interface EventEmitterOptions {
@@ -257,7 +257,7 @@ declare module 'events' {
          *   getEventListeners(et, 'foo'); // [listener]
          * }
          * ```
-         * @since v15.2.0
+         * @since v15.2.0, v14.17.0
          */
         static getEventListeners(emitter: DOMEventTarget | NodeJS.EventEmitter, name: string | symbol): Function[];
         /**

package/node_modules/@types/keyv/node_modules/@types/node/fs/promises.d.ts

@@ -42,11 +42,11 @@ declare module 'fs/promises' {
         mode?: Mode | undefined;
         flag?: OpenMode | undefined;
     }
-    interface FileReadResult<T extends ArrayBufferView> {
+    interface FileReadResult<T extends NodeJS.ArrayBufferView> {
         bytesRead: number;
         buffer: T;
     }
-    interface FileReadOptions<T extends ArrayBufferView = Buffer> {
+    interface FileReadOptions<T extends NodeJS.ArrayBufferView = Buffer> {
         /**
          * @default `Buffer.alloc(0xffff)`
          */
@@ -207,8 +207,8 @@ declare module 'fs/promises' {
          * integer, the current file position will remain unchanged.
          * @return Fulfills upon success with an object with two properties:
          */
-        read<T extends ArrayBufferView>(buffer: T, offset?: number | null, length?: number | null, position?: number | null): Promise<FileReadResult<T>>;
-        read<T extends ArrayBufferView = Buffer>(options?: FileReadOptions<T>): Promise<FileReadResult<T>>;
+        read<T extends NodeJS.ArrayBufferView>(buffer: T, offset?: number | null, length?: number | null, position?: number | null): Promise<FileReadResult<T>>;
+        read<T extends NodeJS.ArrayBufferView = Buffer>(options?: FileReadOptions<T>): Promise<FileReadResult<T>>;
         /**
          * Asynchronously reads the entire contents of a file.
          *
@@ -1043,7 +1043,7 @@ declare module 'fs/promises' {
      * disappears in the directory.
      *
      * All the `caveats` for `fs.watch()` also apply to `fsPromises.watch()`.
-     * @since v15.9.0
+     * @since v15.9.0, v14.18.0
      * @return of objects with the properties:
      */
     function watch(

package/node_modules/@types/keyv/node_modules/@types/node/fs.d.ts

@@ -16,7 +16,7 @@
  *
  * 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.9.0/lib/fs.js)
+ * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/fs.js)
  */
 declare module 'fs' {
     import * as stream from 'node:stream';
@@ -268,18 +268,22 @@ declare module 'fs' {
      */
     export interface StatWatcher extends EventEmitter {
         /**
+         * When called, requests that the Node.js event loop _not_ exit so long as the `fs.StatWatcher` is active. Calling `watcher.ref()` multiple times will have
+         * no effect.
+         *
+         * By default, all `fs.StatWatcher` objects are "ref'ed", making it normally
+         * unnecessary to call `watcher.ref()` unless `watcher.unref()` had been
+         * called previously.
          * @since v14.3.0, v12.20.0
-         * When called, requests that the Node.js event loop not exit so long as the `fs.StatWatcher` is active.
-         * Calling `watcher.ref()` multiple times will have no effect.
-         * By default, all `fs.StatWatcher`` objects are "ref'ed", making it normally unnecessary to call `watcher.ref()`
-         * unless `watcher.unref()` had been called previously.
          */
         ref(): this;
         /**
+         * When called, the active `fs.StatWatcher` object will not require the Node.js
+         * event loop to remain active. If there is no other activity keeping the
+         * event loop running, the process may exit before the `fs.StatWatcher` object's
+         * callback is invoked. Calling `watcher.unref()` multiple times will have
+         * no effect.
          * @since v14.3.0, v12.20.0
-         * When called, the active `fs.StatWatcher`` object will not require the Node.js event loop to remain active.
-         * If there is no other activity keeping the event loop running, the process may exit before the `fs.StatWatcher`` object's callback is invoked.
-         * `Calling watcher.unref()` multiple times will have no effect.
          */
         unref(): this;
     }
@@ -1014,8 +1018,10 @@ declare module 'fs' {
         function __promisify__(fd: number, options?: StatOptions): Promise<Stats | BigIntStats>;
     }
     /**
-     * Synchronous fstat(2) - Get file status.
-     * @param fd A file descriptor.
+     * Retrieves 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
      */
     export function fstatSync(
         fd: number,
@@ -1030,7 +1036,6 @@ declare module 'fs' {
         }
     ): BigIntStats;
     export function fstatSync(fd: number, options?: StatOptions): Stats | BigIntStats;
-
     /**
      * 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
@@ -2812,6 +2817,52 @@ declare module 'fs' {
         persistent?: boolean | undefined;
         interval?: number | undefined;
     }
+    /**
+     * Watch for changes on `filename`. The callback `listener` will be called each
+     * time the file is accessed.
+     *
+     * The `options` argument may be omitted. If provided, it should be an object. The`options` object may contain a boolean named `persistent` that indicates
+     * whether the process should continue to run as long as files are being watched.
+     * The `options` object may specify an `interval` property indicating how often the
+     * target should be polled in milliseconds.
+     *
+     * The `listener` gets two arguments the current stat object and the previous
+     * stat object:
+     *
+     * ```js
+     * import { watchFile } from 'fs';
+     *
+     * watchFile('message.text', (curr, prev) => {
+     *   console.log(`the current mtime is: ${curr.mtime}`);
+     *   console.log(`the previous mtime was: ${prev.mtime}`);
+     * });
+     * ```
+     *
+     * These stat objects are instances of `fs.Stat`. If the `bigint` option is `true`,
+     * the numeric values in these objects are specified as `BigInt`s.
+     *
+     * To be notified when the file was modified, not just accessed, it is necessary
+     * to compare `curr.mtimeMs` and `prev.mtimeMs`.
+     *
+     * When an `fs.watchFile` operation results in an `ENOENT` error, it
+     * will invoke the listener once, with all the fields zeroed (or, for dates, the
+     * Unix Epoch). If the file is created later on, the listener will be called
+     * again, with the latest stat objects. This is a change in functionality since
+     * v0.10.
+     *
+     * Using {@link watch} is more efficient than `fs.watchFile` and`fs.unwatchFile`. `fs.watch` should be used instead of `fs.watchFile` and`fs.unwatchFile` when possible.
+     *
+     * When a file being watched by `fs.watchFile()` disappears and reappears,
+     * then the contents of `previous` in the second callback event (the file's
+     * reappearance) will be the same as the contents of `previous` in the first
+     * callback event (its disappearance).
+     *
+     * This happens when:
+     *
+     * * the file is deleted, followed by a restore
+     * * the file is renamed and then renamed a second time back to its original name
+     * @since v0.1.31
+     */
     export function watchFile(
         filename: PathLike,
         options: