webpack 5.97.1 → 5.104.1

package/lib/util/fs.js

@@ -45,64 +45,67 @@ const path = require("path");
  */
 
 /**
- * @typedef {IStatsBase<bigint> & { atimeNs: bigint, mtimeNs: bigint, ctimeNs: bigint, birthtimeNs: bigint  }} IBigIntStats
+ * @typedef {IStatsBase<bigint> & { atimeNs: bigint, mtimeNs: bigint, ctimeNs: bigint, birthtimeNs: bigint }} IBigIntStats
  */
 
 /**
+ * @template {string | Buffer} [T=string]
  * @typedef {object} Dirent
- * @property {() => boolean} isFile
- * @property {() => boolean} isDirectory
- * @property {() => boolean} isBlockDevice
- * @property {() => boolean} isCharacterDevice
- * @property {() => boolean} isSymbolicLink
- * @property {() => boolean} isFIFO
- * @property {() => boolean} isSocket
- * @property {string} name
- * @property {string} path
+ * @property {() => boolean} isFile true when is file, otherwise false
+ * @property {() => boolean} isDirectory true when is directory, otherwise false
+ * @property {() => boolean} isBlockDevice true when is block device, otherwise false
+ * @property {() => boolean} isCharacterDevice true when is character device, otherwise false
+ * @property {() => boolean} isSymbolicLink true when is symbolic link, otherwise false
+ * @property {() => boolean} isFIFO true when is FIFO, otherwise false
+ * @property {() => boolean} isSocket true when is socket, otherwise false
+ * @property {T} name name
+ * @property {string} parentPath path
+ * @property {string=} path path
  */
 
 /** @typedef {string | number | boolean | null} JsonPrimitive */
 /** @typedef {JsonValue[]} JsonArray */
+/** @typedef {{ [Key in string]?: JsonValue }} JsonObject */
 /** @typedef {JsonPrimitive | JsonObject | JsonArray} JsonValue */
-/** @typedef {{[Key in string]: JsonValue} & {[Key in string]?: JsonValue | undefined}} JsonObject */
-
-/** @typedef {function(NodeJS.ErrnoException | null): void} NoParamCallback */
-/** @typedef {function(NodeJS.ErrnoException | null, string=): void} StringCallback */
-/** @typedef {function(NodeJS.ErrnoException | null, Buffer=): void} BufferCallback */
-/** @typedef {function(NodeJS.ErrnoException | null, (string | Buffer)=): void} StringOrBufferCallback */
-/** @typedef {function(NodeJS.ErrnoException | null, (string[])=): void} ReaddirStringCallback */
-/** @typedef {function(NodeJS.ErrnoException | null, (Buffer[])=): void} ReaddirBufferCallback */
-/** @typedef {function(NodeJS.ErrnoException | null, (string[] | Buffer[])=): void} ReaddirStringOrBufferCallback */
-/** @typedef {function(NodeJS.ErrnoException | null, (Dirent[])=): void} ReaddirDirentCallback */
-/** @typedef {function(NodeJS.ErrnoException | null, IStats=): void} StatsCallback */
-/** @typedef {function(NodeJS.ErrnoException | null, IBigIntStats=): void} BigIntStatsCallback */
-/** @typedef {function(NodeJS.ErrnoException | null, (IStats | IBigIntStats)=): void} StatsOrBigIntStatsCallback */
-/** @typedef {function(NodeJS.ErrnoException | null, number=): void} NumberCallback */
-/** @typedef {function(NodeJS.ErrnoException | Error | null, JsonObject=): void} ReadJsonCallback */
+
+/** @typedef {(err: NodeJS.ErrnoException | null) => void} NoParamCallback */
+/** @typedef {(err: NodeJS.ErrnoException | null, result?: string) => void} StringCallback */
+/** @typedef {(err: NodeJS.ErrnoException | null, result?: Buffer) => void} BufferCallback */
+/** @typedef {(err: NodeJS.ErrnoException | null, result?: string | Buffer) => void} StringOrBufferCallback */
+/** @typedef {(err: NodeJS.ErrnoException | null, result?: string[]) => void} ReaddirStringCallback */
+/** @typedef {(err: NodeJS.ErrnoException | null, result?: Buffer[]) => void} ReaddirBufferCallback */
+/** @typedef {(err: NodeJS.ErrnoException | null, result?: string[] | Buffer[]) => void} ReaddirStringOrBufferCallback */
+/** @typedef {(err: NodeJS.ErrnoException | null, result?: Dirent[]) => void} ReaddirDirentCallback */
+/** @typedef {(err: NodeJS.ErrnoException | null, result?: Dirent<Buffer>[]) => void} ReaddirDirentBufferCallback */
+/** @typedef {(err: NodeJS.ErrnoException | null, result?: IStats) => void} StatsCallback */
+/** @typedef {(err: NodeJS.ErrnoException | null, result?: IBigIntStats) => void} BigIntStatsCallback */
+/** @typedef {(err: NodeJS.ErrnoException | null, result?: IStats | IBigIntStats) => void} StatsOrBigIntStatsCallback */
+/** @typedef {(err: NodeJS.ErrnoException | null, result?: number) => void} NumberCallback */
+/** @typedef {(err: NodeJS.ErrnoException | Error | null, result?: JsonObject) => void} ReadJsonCallback */
 
 /** @typedef {Map<string, FileSystemInfoEntry | "ignore">} TimeInfoEntries */
 
+/** @typedef {Set<string>} Changes */
+/** @typedef {Set<string>} Removals */
+
 /**
  * @typedef {object} WatcherInfo
- * @property {Set<string> | null} changes get current aggregated changes that have not yet send to callback
- * @property {Set<string> | null} removals get current aggregated removals that have not yet send to callback
+ * @property {Changes | null} changes get current aggregated changes that have not yet send to callback
+ * @property {Removals | null} removals get current aggregated removals that have not yet send to callback
  * @property {TimeInfoEntries} fileTimeInfoEntries get info about files
  * @property {TimeInfoEntries} contextTimeInfoEntries get info about directories
  */
 
-/** @typedef {Set<string>} Changes */
-/** @typedef {Set<string>} Removals */
-
 // TODO webpack 6 deprecate missing getInfo
 /**
  * @typedef {object} Watcher
- * @property {function(): void} close closes the watcher and all underlying file watchers
- * @property {function(): void} pause closes the watcher, but keeps underlying file watchers alive until the next watch call
- * @property {(function(): Changes | null)=} getAggregatedChanges get current aggregated changes that have not yet send to callback
- * @property {(function(): Removals | null)=} getAggregatedRemovals get current aggregated removals that have not yet send to callback
- * @property {function(): TimeInfoEntries} getFileTimeInfoEntries get info about files
- * @property {function(): TimeInfoEntries} getContextTimeInfoEntries get info about directories
- * @property {function(): WatcherInfo=} getInfo get info about timestamps and changes
+ * @property {() => void} close closes the watcher and all underlying file watchers
+ * @property {() => void} pause closes the watcher, but keeps underlying file watchers alive until the next watch call
+ * @property {(() => Changes | null)=} getAggregatedChanges get current aggregated changes that have not yet send to callback
+ * @property {(() => Removals | null)=} getAggregatedRemovals get current aggregated removals that have not yet send to callback
+ * @property {() => TimeInfoEntries} getFileTimeInfoEntries get info about files
+ * @property {() => TimeInfoEntries} getContextTimeInfoEntries get info about directories
+ * @property {() => WatcherInfo=} getInfo get info about timestamps and changes
  */
 
 /**
@@ -112,8 +115,8 @@ const path = require("path");
  * @param {Iterable<string>} missing watched existence entries
  * @param {number} startTime timestamp of start time
  * @param {WatchOptions} options options object
- * @param {function(Error | null, TimeInfoEntries=, TimeInfoEntries=, Changes=, Removals=): void} callback aggregated callback
- * @param {function(string, number): void} callbackUndelayed callback when the first change was detected
+ * @param {(err: Error | null, timeInfoEntries1?: TimeInfoEntries, timeInfoEntries2?: TimeInfoEntries, changes?: Changes, removals?: Removals) => void} callback aggregated callback
+ * @param {(value: string, num: number) => void} callbackUndelayed callback when the first change was detected
  * @returns {Watcher} a watcher
  */
 
@@ -129,23 +132,23 @@ const path = require("path");
 
 /**
  * @typedef {object} ObjectEncodingOptions
- * @property {BufferEncoding | null | undefined} [encoding]
+ * @property {BufferEncoding | null | undefined=} encoding
  */
 
 /**
  * @typedef {{
- * (path: PathOrFileDescriptor, options: ({ encoding?: null | undefined, flag?: string | undefined } & import("events").Abortable) | undefined | null, callback: BufferCallback): void;
- * (path: PathOrFileDescriptor, options: ({ encoding: BufferEncoding, flag?: string | undefined } & import("events").Abortable) | BufferEncoding, callback: StringCallback): void;
- * (path: PathOrFileDescriptor, options: (ObjectEncodingOptions & { flag?: string | undefined } & import("events").Abortable) | BufferEncoding | undefined | null, callback: StringOrBufferCallback): void;
- * (path: PathOrFileDescriptor, callback: BufferCallback): void;
+ * (path: PathOrFileDescriptor, options: ({ encoding?: null | undefined, flag?: string | undefined } & import("events").Abortable) | undefined | null, callback: BufferCallback): void,
+ * (path: PathOrFileDescriptor, options: ({ encoding: BufferEncoding, flag?: string | undefined } & import("events").Abortable) | BufferEncoding, callback: StringCallback): void,
+ * (path: PathOrFileDescriptor, options: (ObjectEncodingOptions & { flag?: string | undefined } & import("events").Abortable) | BufferEncoding | undefined | null, callback: StringOrBufferCallback): void,
+ * (path: PathOrFileDescriptor, callback: BufferCallback): void,
  * }} ReadFile
  */
 
 /**
  * @typedef {{
- * (path: PathOrFileDescriptor, options?: { encoding?: null | undefined, flag?: string | undefined } | null): Buffer;
- * (path: PathOrFileDescriptor, options: { encoding: BufferEncoding, flag?: string | undefined } | BufferEncoding): string;
- * (path: PathOrFileDescriptor, options?: (ObjectEncodingOptions & { flag?: string | undefined }) | BufferEncoding | null): string | Buffer;
+ * (path: PathOrFileDescriptor, options?: { encoding?: null | undefined, flag?: string | undefined } | null): Buffer,
+ * (path: PathOrFileDescriptor, options: { encoding: BufferEncoding, flag?: string | undefined } | BufferEncoding): string,
+ * (path: PathOrFileDescriptor, options?: (ObjectEncodingOptions & { flag?: string | undefined }) | BufferEncoding | null): string | Buffer,
  * }} ReadFileSync
  */
 
@@ -154,7 +157,7 @@ const path = require("path");
  */
 
 /**
- * @typedef {'buffer'| { encoding: 'buffer' }} BufferEncodingOption
+ * @typedef {"buffer" | { encoding: "buffer" }} BufferEncodingOption
  */
 
 /**
@@ -170,109 +173,111 @@ const path = require("path");
 
 /**
  * @typedef {{
- * (path: PathLike, options: EncodingOption, callback: StringCallback): void;
- * (path: PathLike, options: BufferEncodingOption, callback: BufferCallback): void;
- * (path: PathLike, options: EncodingOption, callback: StringOrBufferCallback): void;
- * (path: PathLike, callback: StringCallback): void;
+ * (path: PathLike, options: EncodingOption, callback: StringCallback): void,
+ * (path: PathLike, options: BufferEncodingOption, callback: BufferCallback): void,
+ * (path: PathLike, options: EncodingOption, callback: StringOrBufferCallback): void,
+ * (path: PathLike, callback: StringCallback): void,
  * }} Readlink
  */
 
 /**
  * @typedef {{
- * (path: PathLike, options?: EncodingOption): string;
- * (path: PathLike, options: BufferEncodingOption): Buffer;
- * (path: PathLike, options?: EncodingOption): string | Buffer;
+ * (path: PathLike, options?: EncodingOption): string,
+ * (path: PathLike, options: BufferEncodingOption): Buffer,
+ * (path: PathLike, options?: EncodingOption): string | Buffer,
  * }} ReadlinkSync
  */
 
 /**
  * @typedef {{
- * (path: PathLike, options: { encoding: BufferEncoding | null, withFileTypes?: false | undefined, recursive?: boolean | undefined } | BufferEncoding | undefined | null, callback: ReaddirStringCallback): void;
- * (path: PathLike, options: { encoding: 'buffer', withFileTypes?: false | undefined, recursive?: boolean | undefined } | 'buffer', callback: ReaddirBufferCallback): void;
- * (path: PathLike, callback: ReaddirStringCallback): void;
- * (path: PathLike, options: (ObjectEncodingOptions & { withFileTypes?: false | undefined, recursive?: boolean | undefined }) | BufferEncoding | undefined | null, callback: ReaddirStringOrBufferCallback): void;
- * (path: PathLike, options: ObjectEncodingOptions & { withFileTypes: true, recursive?: boolean | undefined }, callback: ReaddirDirentCallback): void;
+ * (path: PathLike, options: { encoding: BufferEncoding | null, withFileTypes?: false | undefined, recursive?: boolean | undefined } | BufferEncoding | undefined | null, callback: (err: NodeJS.ErrnoException | null, files?: string[]) => void): void,
+ * (path: PathLike, options: { encoding: "buffer", withFileTypes?: false | undefined, recursive?: boolean | undefined } | "buffer", callback: (err: NodeJS.ErrnoException | null, files?: Buffer[]) => void): void,
+ * (path: PathLike, options: (ObjectEncodingOptions & { withFileTypes?: false | undefined, recursive?: boolean | undefined }) | BufferEncoding | undefined | null, callback: (err: NodeJS.ErrnoException | null, files?: string[] | Buffer[]) => void): void,
+ * (path: PathLike, callback: (err: NodeJS.ErrnoException | null, files?: string[]) => void): void,
+ * (path: PathLike, options: ObjectEncodingOptions & { withFileTypes: true, recursive?: boolean | undefined }, callback: (err: NodeJS.ErrnoException | null, files?: Dirent<string>[]) => void): void,
+ * (path: PathLike, options: { encoding: "buffer", withFileTypes: true, recursive?: boolean | undefined }, callback: (err: NodeJS.ErrnoException | null, files: Dirent<Buffer>[]) => void): void,
  * }} Readdir
  */
 
 /**
  * @typedef {{
- * (path: PathLike, options?: { encoding: BufferEncoding | null, withFileTypes?: false | undefined, recursive?: boolean | undefined } | BufferEncoding | null): string[];
- * (path: PathLike, options: { encoding: 'buffer', withFileTypes?: false | undefined, recursive?: boolean | undefined } | 'buffer'): Buffer[];
- * (path: PathLike, options?: (ObjectEncodingOptions & { withFileTypes?: false | undefined, recursive?: boolean | undefined }) | BufferEncoding | null): string[] | Buffer[];
- * (path: PathLike, options: ObjectEncodingOptions & { withFileTypes: true, recursive?: boolean | undefined }): Dirent[];
+ * (path: PathLike, options?: { encoding: BufferEncoding | null, withFileTypes?: false | undefined, recursive?: boolean | undefined; } | BufferEncoding | null): string[],
+ * (path: PathLike, options: { encoding: "buffer", withFileTypes?: false | undefined, recursive?: boolean | undefined } | "buffer"): Buffer[],
+ * (path: PathLike, options?: (ObjectEncodingOptions & { withFileTypes?: false | undefined, recursive?: boolean | undefined }) | BufferEncoding | null): string[] | Buffer[],
+ * (path: PathLike, options: ObjectEncodingOptions & { withFileTypes: true, recursive?: boolean | undefined }): Dirent[],
+ * (path: PathLike, options: { encoding: "buffer", withFileTypes: true, recursive?: boolean | undefined }): Dirent<Buffer>[],
  * }} ReaddirSync
  */
 
 /**
  * @typedef {{
- * (path: PathLike, callback: StatsCallback): void;
- * (path: PathLike, options: (StatOptions & { bigint?: false | undefined }) | undefined, callback: StatsCallback): void;
- * (path: PathLike, options: StatOptions & { bigint: true }, callback: BigIntStatsCallback): void;
- * (path: PathLike, options: StatOptions | undefined, callback: StatsOrBigIntStatsCallback): void;
+ * (path: PathLike, callback: StatsCallback): void,
+ * (path: PathLike, options: (StatOptions & { bigint?: false | undefined }) | undefined, callback: StatsCallback): void,
+ * (path: PathLike, options: StatOptions & { bigint: true }, callback: BigIntStatsCallback): void,
+ * (path: PathLike, options: StatOptions | undefined, callback: StatsOrBigIntStatsCallback): void,
  * }} Stat
  */
 
 /**
  * @typedef {{
- * (path: PathLike, options?: undefined): IStats;
- * (path: PathLike, options?: StatSyncOptions & { bigint?: false | undefined, throwIfNoEntry: false }): IStats | undefined;
- * (path: PathLike, options: StatSyncOptions & { bigint: true, throwIfNoEntry: false }): IBigIntStats | undefined;
- * (path: PathLike, options?: StatSyncOptions & { bigint?: false | undefined }): IStats;
- * (path: PathLike, options: StatSyncOptions & { bigint: true }): IBigIntStats;
- * (path: PathLike,  options: StatSyncOptions & { bigint: boolean, throwIfNoEntry?: false | undefined }): IStats | IBigIntStats;
- * (path: PathLike,  options?: StatSyncOptions): IStats | IBigIntStats | undefined;
+ * (path: PathLike, options?: undefined): IStats,
+ * (path: PathLike, options?: StatSyncOptions & { bigint?: false | undefined, throwIfNoEntry: false }): IStats | undefined,
+ * (path: PathLike, options: StatSyncOptions & { bigint: true, throwIfNoEntry: false }): IBigIntStats | undefined,
+ * (path: PathLike, options?: StatSyncOptions & { bigint?: false | undefined }): IStats,
+ * (path: PathLike, options: StatSyncOptions & { bigint: true }): IBigIntStats,
+ * (path: PathLike,  options: StatSyncOptions & { bigint: boolean, throwIfNoEntry?: false | undefined }): IStats | IBigIntStats,
+ * (path: PathLike,  options?: StatSyncOptions): IStats | IBigIntStats | undefined,
  * }} StatSync
  */
 
 /**
  * @typedef {{
- * (path: PathLike, callback: StatsCallback): void;
- * (path: PathLike, options: (StatOptions & { bigint?: false | undefined }) | undefined, callback: StatsCallback): void;
- * (path: PathLike, options: StatOptions & { bigint: true }, callback: BigIntStatsCallback): void;
- * (path: PathLike, options: StatOptions | undefined, callback: StatsOrBigIntStatsCallback): void;
+ * (path: PathLike, callback: StatsCallback): void,
+ * (path: PathLike, options: (StatOptions & { bigint?: false | undefined }) | undefined, callback: StatsCallback): void,
+ * (path: PathLike, options: StatOptions & { bigint: true }, callback: BigIntStatsCallback): void,
+ * (path: PathLike, options: StatOptions | undefined, callback: StatsOrBigIntStatsCallback): void,
  * }} LStat
  */
 
 /**
  * @typedef {{
- * (path: PathLike, options?: undefined): IStats;
- * (path: PathLike, options?: StatSyncOptions & { bigint?: false | undefined, throwIfNoEntry: false }): IStats | undefined;
- * (path: PathLike, options: StatSyncOptions & { bigint: true, throwIfNoEntry: false }): IBigIntStats | undefined;
- * (path: PathLike, options?: StatSyncOptions & { bigint?: false | undefined }): IStats;
- * (path: PathLike, options: StatSyncOptions & { bigint: true }): IBigIntStats;
- * (path: PathLike,  options: StatSyncOptions & { bigint: boolean, throwIfNoEntry?: false | undefined }): IStats | IBigIntStats;
- * (path: PathLike,  options?: StatSyncOptions): IStats | IBigIntStats | undefined;
+ * (path: PathLike, options?: undefined): IStats,
+ * (path: PathLike, options?: StatSyncOptions & { bigint?: false | undefined, throwIfNoEntry: false }): IStats | undefined,
+ * (path: PathLike, options: StatSyncOptions & { bigint: true, throwIfNoEntry: false }): IBigIntStats | undefined,
+ * (path: PathLike, options?: StatSyncOptions & { bigint?: false | undefined }): IStats,
+ * (path: PathLike, options: StatSyncOptions & { bigint: true }): IBigIntStats,
+ * (path: PathLike,  options: StatSyncOptions & { bigint: boolean, throwIfNoEntry?: false | undefined }): IStats | IBigIntStats,
+ * (path: PathLike,  options?: StatSyncOptions): IStats | IBigIntStats | undefined,
  * }} LStatSync
  */
 
 /**
  * @typedef {{
- * (path: PathLike, options: EncodingOption, callback: StringCallback): void;
- * (path: PathLike, options: BufferEncodingOption, callback: BufferCallback): void;
- * (path: PathLike, options: EncodingOption, callback: StringOrBufferCallback): void;
+ * (path: PathLike, options: EncodingOption, callback: StringCallback): void,
+ * (path: PathLike, options: BufferEncodingOption, callback: BufferCallback): void,
+ * (path: PathLike, options: EncodingOption, callback: StringOrBufferCallback): void,
  * (path: PathLike, callback: StringCallback): void;
  * }} RealPath
  */
 
 /**
  * @typedef {{
- * (path: PathLike, options?: EncodingOption): string;
- * (path: PathLike, options: BufferEncodingOption): Buffer;
- * (path: PathLike, options?: EncodingOption): string | Buffer;
+ * (path: PathLike, options?: EncodingOption): string,
+ * (path: PathLike, options: BufferEncodingOption): Buffer,
+ * (path: PathLike, options?: EncodingOption): string | Buffer,
  * }} RealPathSync
  */
 
 /**
- * @typedef {function(PathOrFileDescriptor, ReadJsonCallback): void} ReadJson
+ * @typedef {(pathOrFileDescriptor: PathOrFileDescriptor, callback: ReadJsonCallback) => void} ReadJson
  */
 
 /**
- * @typedef {function(PathOrFileDescriptor): JsonObject} ReadJsonSync
+ * @typedef {(pathOrFileDescriptor: PathOrFileDescriptor) => JsonObject} ReadJsonSync
  */
 
 /**
- * @typedef {function((string | string[] | Set<string>)=): void} Purge
+ * @typedef {(value?: string | string[] | Set<string>) => void} Purge
  */
 
 /**
@@ -292,9 +297,9 @@ const path = require("path");
  * @property {ReadJson=} readJson
  * @property {ReadJsonSync=} readJsonSync
  * @property {Purge=} purge
- * @property {(function(string, string): string)=} join
- * @property {(function(string, string): string)=} relative
- * @property {(function(string): string)=} dirname
+ * @property {((path1: string, path2: string) => string)=} join
+ * @property {((from: string, to: string) => string)=} relative
+ * @property {((dirname: string) => string)=} dirname
  */
 
 /**
@@ -307,8 +312,8 @@ const path = require("path");
 
 /**
  * @typedef {{
- * (file: PathOrFileDescriptor, data: string | NodeJS.ArrayBufferView, options: WriteFileOptions, callback: NoParamCallback): void;
- * (file: PathOrFileDescriptor, data: string | NodeJS.ArrayBufferView, callback: NoParamCallback): void;
+ * (file: PathOrFileDescriptor, data: string | NodeJS.ArrayBufferView, options: WriteFileOptions, callback: NoParamCallback): void,
+ * (file: PathOrFileDescriptor, data: string | NodeJS.ArrayBufferView, callback: NoParamCallback): void,
  * }} WriteFile
  */
 
@@ -318,10 +323,10 @@ const path = require("path");
 
 /**
  * @typedef {{
- * (file: PathLike, options: MakeDirectoryOptions & { recursive: true }, callback: StringCallback): void;
- * (file: PathLike, options: Mode | (MakeDirectoryOptions & { recursive?: false | undefined; }) | null | undefined, callback: NoParamCallback): void;
- * (file: PathLike, options: Mode | MakeDirectoryOptions | null | undefined, callback: StringCallback): void;
- * (file: PathLike, callback: NoParamCallback): void;
+ * (file: PathLike, options: MakeDirectoryOptions & { recursive: true }, callback: StringCallback): void,
+ * (file: PathLike, options: Mode | (MakeDirectoryOptions & { recursive?: false | undefined; }) | null | undefined, callback: NoParamCallback): void,
+ * (file: PathLike, options: Mode | MakeDirectoryOptions | null | undefined, callback: StringCallback): void,
+ * (file: PathLike, callback: NoParamCallback): void,
  * }} Mkdir
  */
 
@@ -331,28 +336,41 @@ const path = require("path");
 
 /**
  * @typedef {{
- * (file: PathLike, callback: NoParamCallback): void;
- * (file: PathLike, options: RmDirOptions, callback: NoParamCallback): void;
+ * (file: PathLike, callback: NoParamCallback): void,
+ * (file: PathLike, options: RmDirOptions, callback: NoParamCallback): void,
  * }} Rmdir
  */
 
 /**
- * @typedef {function(PathLike, NoParamCallback): void} Unlink
+ * @typedef {(pathLike: PathLike, callback: NoParamCallback) => void} Unlink
+ */
+
+/**
+ * @typedef {FSImplementation & { read: (...args: EXPECTED_ANY[]) => EXPECTED_ANY }} CreateReadStreamFSImplementation
+ */
+
+/**
+ * @typedef {StreamOptions & { fs?: CreateReadStreamFSImplementation | null | undefined, end?: number | undefined }} ReadStreamOptions
+ */
+
+/**
+ * @typedef {(path: PathLike, options?: BufferEncoding | ReadStreamOptions) => NodeJS.ReadableStream} CreateReadStream
  */
 
 /**
  * @typedef {object} OutputFileSystem
- * @property {WriteFile} writeFile
  * @property {Mkdir} mkdir
  * @property {Readdir=} readdir
  * @property {Rmdir=} rmdir
+ * @property {WriteFile} writeFile
  * @property {Unlink=} unlink
  * @property {Stat} stat
  * @property {LStat=} lstat
  * @property {ReadFile} readFile
- * @property {(function(string, string): string)=} join
- * @property {(function(string, string): string)=} relative
- * @property {(function(string): string)=} dirname
+ * @property {CreateReadStream=} createReadStream
+ * @property {((path1: string, path2: string) => string)=} join
+ * @property {((from: string, to: string) => string)=} relative
+ * @property {((dirname: string) => string)=} dirname
  */
 
 /**
@@ -362,9 +380,9 @@ const path = require("path");
 
 /**
  * @typedef {{
- * (path: PathLike, options: MakeDirectoryOptions & { recursive: true }): string | undefined;
- * (path: PathLike, options?: Mode | (MakeDirectoryOptions & { recursive?: false | undefined }) | null): void;
- * (path: PathLike, options?: Mode | MakeDirectoryOptions | null): string | undefined;
+ * (path: PathLike, options: MakeDirectoryOptions & { recursive: true }): string | undefined,
+ * (path: PathLike, options?: Mode | (MakeDirectoryOptions & { recursive?: false | undefined }) | null): void,
+ * (path: PathLike, options?: Mode | MakeDirectoryOptions | null): string | undefined,
  * }} MkdirSync
  */
 
@@ -391,11 +409,11 @@ const path = require("path");
  */
 
 /**
- * @typedef {StreamOptions & { fs?: CreateWriteStreamFSImplementation | null | undefined }} WriteStreamOptions
+ * @typedef {StreamOptions & { fs?: CreateWriteStreamFSImplementation | null | undefined, flush?: boolean | undefined }} WriteStreamOptions
  */
 
 /**
- * @typedef {function(PathLike, (BufferEncoding | WriteStreamOptions)=): NodeJS.WritableStream} CreateWriteStream
+ * @typedef {(pathLike: PathLike, result?: BufferEncoding | WriteStreamOptions) => NodeJS.WritableStream} CreateWriteStream
  */
 
 /**
@@ -404,9 +422,9 @@ const path = require("path");
 
 /**
  * @typedef {{
- * (file: PathLike, flags: OpenMode | undefined,  mode: Mode | undefined | null, callback: NumberCallback): void;
- * (file: PathLike, flags: OpenMode | undefined, callback: NumberCallback): void;
- * (file: PathLike, callback: NumberCallback): void;
+ * (file: PathLike, flags: OpenMode | undefined,  mode: Mode | undefined | null, callback: NumberCallback): void,
+ * (file: PathLike, flags: OpenMode | undefined, callback: NumberCallback): void,
+ * (file: PathLike, callback: NumberCallback): void,
  * }} Open
  */
 
@@ -431,17 +449,17 @@ const path = require("path");
  */
 
 /**
- * @template {NodeJS.ArrayBufferView} [TBuffer=Buffer]
+ * @template {NodeJS.ArrayBufferView} [TBuffer=NodeJS.ArrayBufferView]
  * @typedef {{
- * (fd: number, buffer: TBuffer, offset: number, length: number, position: ReadPosition | null, callback: (err: NodeJS.ErrnoException | null, bytesRead: number, buffer: TBuffer) => void): void;
- * (fd: number, options: ReadAsyncOptions<TBuffer>, callback: (err: NodeJS.ErrnoException | null, bytesRead: number, buffer: TBuffer) => void): void;
- * (fd: number, callback: (err: NodeJS.ErrnoException | null, bytesRead: number, buffer: NodeJS.ArrayBufferView) => void): void;
+ * (fd: number, buffer: TBuffer, offset: number, length: number, position: ReadPosition | null, callback: (err: NodeJS.ErrnoException | null, bytesRead: number, buffer: TBuffer) => void): void,
+ * (fd: number, options: ReadAsyncOptions<TBuffer>, callback: (err: NodeJS.ErrnoException | null, bytesRead: number, buffer: TBuffer) => void): void,
+ * (fd: number, callback: (err: NodeJS.ErrnoException | null, bytesRead: number, buffer: NodeJS.ArrayBufferView) => void): void,
  * }} Read
  */
 
-/** @typedef {function(number, NoParamCallback): void} Close */
+/** @typedef {(df: number, callback: NoParamCallback) => void} Close */
 
-/** @typedef {function(PathLike, PathLike, NoParamCallback): void} Rename */
+/** @typedef {(a: PathLike, b: PathLike, callback: NoParamCallback) => void} Rename */
 
 /**
  * @typedef {object} IntermediateFileSystemExtras
@@ -456,7 +474,7 @@ const path = require("path");
 /** @typedef {InputFileSystem & OutputFileSystem & IntermediateFileSystemExtras} IntermediateFileSystem */
 
 /**
- * @param {InputFileSystem|OutputFileSystem|undefined} fs a file system
+ * @param {InputFileSystem | OutputFileSystem | undefined} fs a file system
  * @param {string} rootPath the root path
  * @param {string} targetPath the target path
  * @returns {string} location of targetPath relative to rootPath
@@ -473,10 +491,9 @@ const relative = (fs, rootPath, targetPath) => {
 		`${rootPath} is neither a posix nor a windows path, and there is no 'relative' method defined in the file system`
 	);
 };
-module.exports.relative = relative;
 
 /**
- * @param {InputFileSystem|OutputFileSystem|undefined} fs a file system
+ * @param {InputFileSystem | OutputFileSystem | undefined} fs a file system
  * @param {string} rootPath a path
  * @param {string} filename a filename
  * @returns {string} the joined path
@@ -493,10 +510,9 @@ const join = (fs, rootPath, filename) => {
 		`${rootPath} is neither a posix nor a windows path, and there is no 'join' method defined in the file system`
 	);
 };
-module.exports.join = join;
 
 /**
- * @param {InputFileSystem|OutputFileSystem|undefined} fs a file system
+ * @param {InputFileSystem | OutputFileSystem | undefined} fs a file system
  * @param {string} absPath an absolute path
  * @returns {string} the parent directory of the absolute path
  */
@@ -512,16 +528,15 @@ const dirname = (fs, absPath) => {
 		`${absPath} is neither a posix nor a windows path, and there is no 'dirname' method defined in the file system`
 	);
 };
-module.exports.dirname = dirname;
 
 /**
  * @param {OutputFileSystem} fs a file system
  * @param {string} p an absolute path
- * @param {function(Error=): void} callback callback function for the error
+ * @param {(err?: Error) => void} callback callback function for the error
  * @returns {void}
  */
 const mkdirp = (fs, p, callback) => {
-	fs.mkdir(p, err => {
+	fs.mkdir(p, (err) => {
 		if (err) {
 			if (err.code === "ENOENT") {
 				const dir = dirname(fs, p);
@@ -529,12 +544,12 @@ const mkdirp = (fs, p, callback) => {
 					callback(err);
 					return;
 				}
-				mkdirp(fs, dir, err => {
+				mkdirp(fs, dir, (err) => {
 					if (err) {
 						callback(err);
 						return;
 					}
-					fs.mkdir(p, err => {
+					fs.mkdir(p, (err) => {
 						if (err) {
 							if (err.code === "EEXIST") {
 								callback();
@@ -557,7 +572,6 @@ const mkdirp = (fs, p, callback) => {
 		callback();
 	});
 };
-module.exports.mkdirp = mkdirp;
 
 /**
  * @param {IntermediateFileSystem} fs a file system
@@ -584,7 +598,6 @@ const mkdirpSync = (fs, p) => {
 		}
 	}
 };
-module.exports.mkdirpSync = mkdirpSync;
 
 /**
  * @param {InputFileSystem} fs a file system
@@ -593,27 +606,27 @@ module.exports.mkdirpSync = mkdirpSync;
  * @returns {void}
  */
 const readJson = (fs, p, callback) => {
-	if ("readJson" in fs)
+	if ("readJson" in fs) {
 		return /** @type {NonNullable<InputFileSystem["readJson"]>} */ (
 			fs.readJson
 		)(p, callback);
+	}
 	fs.readFile(p, (err, buf) => {
 		if (err) return callback(err);
 		let data;
 		try {
-			data = JSON.parse(/** @type {Buffer} */ (buf).toString("utf-8"));
+			data = JSON.parse(/** @type {Buffer} */ (buf).toString("utf8"));
 		} catch (err1) {
 			return callback(/** @type {Error} */ (err1));
 		}
 		return callback(null, data);
 	});
 };
-module.exports.readJson = readJson;
 
 /**
  * @param {InputFileSystem} fs a file system
  * @param {string} p an absolute path
- * @param {function(NodeJS.ErrnoException | Error | null, (IStats | string)=): void} callback callback
+ * @param {(err: NodeJS.ErrnoException | Error | null, stats?: IStats | string) => void} callback callback
  * @returns {void}
  */
 const lstatReadlinkAbsolute = (fs, p, callback) => {
@@ -648,4 +661,19 @@ const lstatReadlinkAbsolute = (fs, p, callback) => {
 	if ("lstat" in fs) return doStat();
 	doReadLink();
 };
+
+/**
+ * @param {string} pathname a path
+ * @returns {boolean} is absolute
+ */
+const isAbsolute = (pathname) =>
+	path.posix.isAbsolute(pathname) || path.win32.isAbsolute(pathname);
+
+module.exports.dirname = dirname;
+module.exports.isAbsolute = isAbsolute;
+module.exports.join = join;
 module.exports.lstatReadlinkAbsolute = lstatReadlinkAbsolute;
+module.exports.mkdirp = mkdirp;
+module.exports.mkdirpSync = mkdirpSync;
+module.exports.readJson = readJson;
+module.exports.relative = relative;