@zenfs/core 1.0.9 → 1.0.11

package/dist/emulation/path.js

@@ -265,14 +265,12 @@ export function basename(path, suffix) {
                     // Try to match the explicit extension
                     if (path[i] === suffix[extIdx]) {
                         if (--extIdx === -1) {
-                            // We matched the extension, so mark this as the end of our path
-                            // component
+                            // We matched the extension, so mark this as the end of our path component
                             end = i;
                         }
                     }
                     else {
-                        // Extension does not match, so our result is the entire path
-                        // component
+                        // Extension does not match, so our result is the entire path component
                         extIdx = -1;
                         end = firstNonSlashEnd;
                     }
@@ -287,16 +285,14 @@ export function basename(path, suffix) {
     }
     for (let i = path.length - 1; i >= 0; --i) {
         if (path[i] === '/') {
-            // If we reached a path separator that was not part of a set of path
-            // separators at the end of the string, stop now
+            // If we reached a path separator that was not part of a set of path separators at the end of the string, stop now
             if (!matchedSlash) {
                 start = i + 1;
                 break;
             }
         }
         else if (end === -1) {
-            // We saw the first non-path separator, mark this as the end of our
-            // path component
+            // We saw the first non-path separator, mark this as the end of our path component
             matchedSlash = false;
             end = i + 1;
         }

package/dist/emulation/promises.d.ts

@@ -1,11 +1,3 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
 import { Buffer } from 'buffer';
 import type * as fs from 'node:fs';
 import type * as promises from 'node:fs/promises';
@@ -50,9 +42,9 @@ export declare class FileHandle implements promises.FileHandle {
     sync(): Promise<void>;
     /**
      * Asynchronous ftruncate(2) - Truncate a file to a specified length.
-     * @param len If not specified, defaults to `0`.
+     * @param length If not specified, defaults to `0`.
      */
-    truncate(len?: number | null): Promise<void>;
+    truncate(length?: number | null): Promise<void>;
     /**
      * Asynchronously change file timestamps of the file.
      * @param atime The last access time. If a string is provided, it will be coerced to number.
@@ -64,10 +56,9 @@ export declare class FileHandle implements promises.FileHandle {
      * The `FileHandle` must have been opened for appending.
      * @param data The data to write. If something other than a `Buffer` or `Uint8Array` is provided, the value is coerced to a string.
      * @param _options Either the encoding for the file, or an object optionally specifying the encoding, file mode, and flag.
-     * If `encoding` is not supplied, the default of `'utf8'` is used.
-     * If `mode` is not supplied, the default of `0o666` is used.
-     * If `mode` is a string, it is parsed as an octal integer.
-     * If `flag` is not supplied, the default of `'a'` is used.
+     * - `encoding` defaults to `'utf8'`.
+     * - `mode` defaults to `0o666`.
+     * - `flag` defaults to `'a'`.
      */
     appendFile(data: string | Uint8Array, _options?: (fs.ObjectEncodingOptions & FlagAndOpenMode) | BufferEncoding): Promise<void>;
     /**
@@ -92,10 +83,11 @@ export declare class FileHandle implements promises.FileHandle {
     /**
      * Returns a `ReadableStream` that may be used to read the files data.
      *
-     * An error will be thrown if this method is called more than once or is called after the `FileHandle` is closed
-     * or closing.
+     * An error will be thrown if this method is called more than once or is called after the `FileHandle` is closed or closing.
      *
-     * While the `ReadableStream` will read the file to completion, it will not close the `FileHandle` automatically. User code must still call the `fileHandle.close()` method.
+     * While the `ReadableStream` will read the file to completion,
+     * it will not close the `FileHandle` automatically.
+     * User code must still call the `fileHandle.close()` method.
      *
      * @since v17.0.0
      * @experimental
@@ -134,10 +126,9 @@ export declare class FileHandle implements promises.FileHandle {
      * It is unsafe to call `writeFile()` multiple times on the same file without waiting for the `Promise` to be resolved (or rejected).
      * @param data The data to write. If something other than a `Buffer` or `Uint8Array` is provided, the value is coerced to a string.
      * @param _options Either the encoding for the file, or an object optionally specifying the encoding, file mode, and flag.
-     * If `encoding` is not supplied, the default of `'utf8'` is used.
-     * If `mode` is not supplied, the default of `0o666` is used.
-     * If `mode` is a string, it is parsed as an octal integer.
-     * If `flag` is not supplied, the default of `'w'` is used.
+     * - `encoding` defaults to `'utf8'`.
+     * - `mode` defaults to `0o666`.
+     * - `flag` defaults to `'w'`.
      */
     writeFile(data: string | Uint8Array, _options?: fs.WriteFileOptions): Promise<void>;
     /**
@@ -159,36 +150,21 @@ export declare class FileHandle implements promises.FileHandle {
      */
     readv(buffers: NodeJS.ArrayBufferView[], position?: number): Promise<fs.ReadVResult>;
     /**
-     * Creates a `ReadStream` for reading from the file.
-     *
+     * Creates a stream for reading from the file.
      * @param options Options for the readable stream
-     * @returns A `ReadStream` object.
      */
     createReadStream(options?: CreateReadStreamOptions): ReadStream;
     /**
-     * Creates a `WriteStream` for writing to the file.
-     *
+     * Creates a stream for writing to the file.
      * @param options Options for the writeable stream.
-     * @returns A `WriteStream` object
      */
     createWriteStream(options?: CreateWriteStreamOptions): WriteStream;
 }
-/**
- * Renames a file
- * @param oldPath
- * @param newPath
- */
 export declare function rename(oldPath: fs.PathLike, newPath: fs.PathLike): Promise<void>;
 /**
- * Test whether or not the given path exists by checking with the file system.
- * @param path
+ * Test whether or not `path` exists by checking with the file system.
  */
 export declare function exists(path: fs.PathLike): Promise<boolean>;
-/**
- * `stat`.
- * @param path
- * @returns Stats
- */
 export declare function stat(path: fs.PathLike, options: fs.BigIntOptions): Promise<BigIntStats>;
 export declare function stat(path: fs.PathLike, options?: {
     bigint?: false;
@@ -198,8 +174,6 @@ export declare function stat(path: fs.PathLike, options?: fs.StatOptions): Promi
  * `lstat`.
  * `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.
- * @param path
- * @return
  */
 export declare function lstat(path: fs.PathLike, options?: {
     bigint?: boolean;
@@ -207,31 +181,20 @@ export declare function lstat(path: fs.PathLike, options?: {
 export declare function lstat(path: fs.PathLike, options: {
     bigint: true;
 }): Promise<BigIntStats>;
-/**
- * `truncate`.
- * @param path
- * @param len
- */
 export declare function truncate(path: fs.PathLike, len?: number): Promise<void>;
-/**
- * `unlink`.
- * @param path
- */
 export declare function unlink(path: fs.PathLike): Promise<void>;
 /**
  * Asynchronous file open.
  * @see http://www.manpagez.com/man/2/open/
- * @param flags Handles the complexity of the various file modes. See its API for more details.
+ * @param flag Handles the complexity of the various file modes. See its API for more details.
  * @param mode Mode to use to open the file. Can be ignored if the filesystem doesn't support permissions.
  */
 export declare function open(path: fs.PathLike, flag?: fs.OpenMode, mode?: fs.Mode): Promise<FileHandle>;
 /**
  * Asynchronously reads the entire contents of a file.
- * @param filename
- * @param options
- * options.encoding The string encoding for the file contents. Defaults to `null`.
- * options.flag Defaults to `'r'`.
- * @returns file data
+ * @option encoding The string encoding for the file contents. Defaults to `null`.
+ * @option flag Defaults to `'r'`.
+ * @returns the file data
  */
 export declare function readFile(path: fs.PathLike | promises.FileHandle, options?: {
     encoding?: null;
@@ -248,12 +211,9 @@ export declare function readFile(path: fs.PathLike | promises.FileHandle, option
  * Asynchronously writes data to a file, replacing the file if it already exists.
  *
  * The encoding option is ignored if data is a buffer.
- * @param path
- * @param data Note:
- * @param _options
- * @option options encoding Defaults to `'utf8'`.
- * @option options mode Defaults to `0644`.
- * @option options flag Defaults to `'w'`.
+ * @option encoding Defaults to `'utf8'`.
+ * @option mode Defaults to `0644`.
+ * @option flag Defaults to `'w'`.
  */
 export declare function writeFile(path: fs.PathLike | promises.FileHandle, data: FileContents | Stream | Iterable<string | ArrayBufferView> | AsyncIterable<string | ArrayBufferView>, _options?: (fs.ObjectEncodingOptions & {
     mode?: fs.Mode;
@@ -261,23 +221,15 @@ export declare function writeFile(path: fs.PathLike | promises.FileHandle, data:
     flush?: boolean;
 }) | BufferEncoding | null): Promise<void>;
 /**
- * Asynchronously append data to a file, creating the file if it not yet
- * exists.
- * @param path
- * @param data
- * @param options
- * @option options encoding Defaults to `'utf8'`.
- * @option options mode Defaults to `0644`.
- * @option options flag Defaults to `'a'`.
+ * Asynchronously append data to a file, creating the file if it not yet exists.
+ * @option encoding Defaults to `'utf8'`.
+ * @option mode Defaults to `0644`.
+ * @option flag Defaults to `'a'`.
  */
 export declare function appendFile(path: fs.PathLike | promises.FileHandle, data: FileContents, _options?: BufferEncoding | (fs.EncodingOption & {
     mode?: fs.Mode;
     flag?: fs.OpenMode;
 }) | null): Promise<void>;
-/**
- * `rmdir`.
- * @param path
- */
 export declare function rmdir(path: fs.PathLike): Promise<void>;
 /**
  * Asynchronous mkdir(2) - create a directory.
@@ -295,7 +247,7 @@ export declare function mkdir(path: fs.PathLike, options?: fs.Mode | fs.MakeDire
 /**
  * Asynchronous readdir(3) - read a directory.
  * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
- * @param options The encoding (or an object specifying the encoding), used as the encoding of the result. If not provided, `'utf8'` is used.
+ * @param options The encoding (or an object specifying the encoding), used as the encoding of the result. If not provided, `'utf8'`.
  */
 export declare function readdir(path: fs.PathLike, options?: (fs.ObjectEncodingOptions & {
     withFileTypes?: false;
@@ -313,11 +265,6 @@ export declare function readdir(path: fs.PathLike, options: fs.ObjectEncodingOpt
     withFileTypes: true;
     recursive?: boolean;
 }): Promise<Dirent[]>;
-/**
- * `link`.
- * @param targetPath
- * @param linkPath
- */
 export declare function link(targetPath: fs.PathLike, linkPath: fs.PathLike): Promise<void>;
 /**
  * `symlink`.
@@ -326,68 +273,31 @@ export declare function link(targetPath: fs.PathLike, linkPath: fs.PathLike): Pr
  * @param type can be either `'dir'` or `'file'` (default is `'file'`)
  */
 export declare function symlink(target: fs.PathLike, path: fs.PathLike, type?: fs.symlink.Type | string | null): Promise<void>;
-/**
- * readlink.
- * @param path
- */
 export declare function readlink(path: fs.PathLike, options: fs.BufferEncodingOption): Promise<Buffer>;
 export declare function readlink(path: fs.PathLike, options?: fs.EncodingOption | null): Promise<string>;
 export declare function readlink(path: fs.PathLike, options?: fs.BufferEncodingOption | fs.EncodingOption | string | null): Promise<string | Buffer>;
-/**
- * `chown`.
- * @param path
- * @param uid
- * @param gid
- */
 export declare function chown(path: fs.PathLike, uid: number, gid: number): Promise<void>;
-/**
- * `lchown`.
- * @param path
- * @param uid
- * @param gid
- */
 export declare function lchown(path: fs.PathLike, uid: number, gid: number): Promise<void>;
-/**
- * `chmod`.
- * @param path
- * @param mode
- */
 export declare function chmod(path: fs.PathLike, mode: fs.Mode): Promise<void>;
-/**
- * `lchmod`.
- * @param path
- * @param mode
- */
 export declare function lchmod(path: fs.PathLike, mode: fs.Mode): Promise<void>;
 /**
  * Change file timestamps of the file referenced by the supplied path.
- * @param path
- * @param atime
- * @param mtime
  */
 export declare function utimes(path: fs.PathLike, atime: string | number | Date, mtime: string | number | Date): Promise<void>;
 /**
  * Change file timestamps of the file referenced by the supplied path.
- * @param path
- * @param atime
- * @param mtime
  */
 export declare function lutimes(path: fs.PathLike, atime: fs.TimeLike, mtime: fs.TimeLike): Promise<void>;
 /**
  * Asynchronous realpath(3) - return the canonicalized absolute pathname.
  * @param path A path to a file. If a URL is provided, it must use the `file:` protocol.
- * @param options The encoding (or an object specifying the encoding), used as the encoding of the result. If not provided, `'utf8'` is used.
+ * @param options The encoding (or an object specifying the encoding), used as the encoding of the result. Defaults to `'utf8'`.
  */
 export declare function realpath(path: fs.PathLike, options: fs.BufferEncodingOption): Promise<Buffer>;
 export declare function realpath(path: fs.PathLike, options?: fs.EncodingOption | BufferEncoding): Promise<string>;
 export declare function watch(filename: fs.PathLike, options?: fs.WatchOptions | BufferEncoding): AsyncIterable<FileChangeInfo<string>>;
 export declare function watch(filename: fs.PathLike, options: fs.WatchOptions | fs.BufferEncodingOption): AsyncIterable<FileChangeInfo<Buffer>>;
 export declare function watch(filename: fs.PathLike, options?: fs.WatchOptions | string): AsyncIterable<FileChangeInfo<string>> | AsyncIterable<FileChangeInfo<Buffer>>;
-/**
- * `access`.
- * @param path
- * @param mode
- */
 export declare function access(path: fs.PathLike, mode?: number): Promise<void>;
 /**
  * Asynchronous `rm`. Removes files or directories (recursively).
@@ -425,15 +335,15 @@ export declare function opendir(path: fs.PathLike, options?: fs.OpenDirOptions):
  * @param opts Options for the copy operation. Currently supports these options from Node.js 'fs.await cp':
  *   * `dereference`: Dereference symbolic links.
  *   * `errorOnExist`: Throw an error if the destination file or directory already exists.
- *   * `filter`: A function that takes a source and destination path and returns a boolean, indicating whether to copy the given source element.
+ *   * `filter`: A function that takes a source and destination path and returns a boolean, indicating whether to copy `source` element.
  *   * `force`: Overwrite the destination if it exists, and overwrite existing readonly destination files.
  *   * `preserveTimestamps`: Preserve file timestamps.
  *   * `recursive`: If `true`, copies directories recursively.
  */
 export declare function cp(source: fs.PathLike, destination: fs.PathLike, opts?: fs.CopyOptions): Promise<void>;
 /**
- * @since v18.15.0
- * @return Fulfills with an {fs.StatFs} for the file system.
+ * @since Node v18.15.0
+ * @returns Fulfills with an {fs.StatFs} for the file system.
  */
 export declare function statfs(path: fs.PathLike, opts?: fs.StatFsOptions & {
     bigint?: false;

package/dist/emulation/promises.js

@@ -1,7 +1,7 @@
 var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
     if (value !== null && value !== void 0) {
         if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
-        var dispose;
+        var dispose, inner;
         if (async) {
             if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
             dispose = value[Symbol.asyncDispose];
@@ -9,8 +9,10 @@ var __addDisposableResource = (this && this.__addDisposableResource) || function
         if (dispose === void 0) {
             if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
             dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
         }
         if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
         env.stack.push({ value: value, dispose: dispose, async: async });
     }
     else if (async) {
@@ -96,14 +98,14 @@ export class FileHandle {
     }
     /**
      * Asynchronous ftruncate(2) - Truncate a file to a specified length.
-     * @param len If not specified, defaults to `0`.
+     * @param length If not specified, defaults to `0`.
      */
-    async truncate(len) {
-        len || (len = 0);
-        if (len < 0) {
+    async truncate(length) {
+        length || (length = 0);
+        if (length < 0) {
             throw new ErrnoError(Errno.EINVAL);
         }
-        await this.file.truncate(len);
+        await this.file.truncate(length);
         emitChange('change', this.file.path);
     }
     /**
@@ -120,10 +122,9 @@ export class FileHandle {
      * The `FileHandle` must have been opened for appending.
      * @param data The data to write. If something other than a `Buffer` or `Uint8Array` is provided, the value is coerced to a string.
      * @param _options Either the encoding for the file, or an object optionally specifying the encoding, file mode, and flag.
-     * If `encoding` is not supplied, the default of `'utf8'` is used.
-     * If `mode` is not supplied, the default of `0o666` is used.
-     * If `mode` is a string, it is parsed as an octal integer.
-     * If `flag` is not supplied, the default of `'a'` is used.
+     * - `encoding` defaults to `'utf8'`.
+     * - `mode` defaults to `0o666`.
+     * - `flag` defaults to `'a'`.
      */
     async appendFile(data, _options = {}) {
         const options = normalizeOptions(_options, 'utf8', 'a', 0o644);
@@ -166,10 +167,11 @@ export class FileHandle {
     /**
      * Returns a `ReadableStream` that may be used to read the files data.
      *
-     * An error will be thrown if this method is called more than once or is called after the `FileHandle` is closed
-     * or closing.
+     * An error will be thrown if this method is called more than once or is called after the `FileHandle` is closed or closing.
      *
-     * While the `ReadableStream` will read the file to completion, it will not close the `FileHandle` automatically. User code must still call the `fileHandle.close()` method.
+     * While the `ReadableStream` will read the file to completion,
+     * it will not close the `FileHandle` automatically.
+     * User code must still call the `fileHandle.close()` method.
      *
      * @since v17.0.0
      * @experimental
@@ -245,10 +247,9 @@ export class FileHandle {
      * It is unsafe to call `writeFile()` multiple times on the same file without waiting for the `Promise` to be resolved (or rejected).
      * @param data The data to write. If something other than a `Buffer` or `Uint8Array` is provided, the value is coerced to a string.
      * @param _options Either the encoding for the file, or an object optionally specifying the encoding, file mode, and flag.
-     * If `encoding` is not supplied, the default of `'utf8'` is used.
-     * If `mode` is not supplied, the default of `0o666` is used.
-     * If `mode` is a string, it is parsed as an octal integer.
-     * If `flag` is not supplied, the default of `'w'` is used.
+     * - `encoding` defaults to `'utf8'`.
+     * - `mode` defaults to `0o666`.
+     * - `flag` defaults to `'w'`.
      */
     async writeFile(data, _options = {}) {
         const options = normalizeOptions(_options, 'utf8', 'w', 0o644);
@@ -297,10 +298,8 @@ export class FileHandle {
         return { bytesRead, buffers };
     }
     /**
-     * Creates a `ReadStream` for reading from the file.
-     *
+     * Creates a stream for reading from the file.
      * @param options Options for the readable stream
-     * @returns A `ReadStream` object.
      */
     createReadStream(options) {
         const stream = new ReadStream({
@@ -322,10 +321,8 @@ export class FileHandle {
         return stream;
     }
     /**
-     * Creates a `WriteStream` for writing to the file.
-     *
+     * Creates a stream for writing to the file.
      * @param options Options for the writeable stream.
-     * @returns A `WriteStream` object
      */
     createWriteStream(options) {
         const streamOptions = {
@@ -346,11 +343,6 @@ export class FileHandle {
         return stream;
     }
 }
-/**
- * Renames a file
- * @param oldPath
- * @param newPath
- */
 export async function rename(oldPath, newPath) {
     oldPath = normalizePath(oldPath);
     newPath = normalizePath(newPath);
@@ -375,8 +367,7 @@ export async function rename(oldPath, newPath) {
 }
 rename;
 /**
- * Test whether or not the given path exists by checking with the file system.
- * @param path
+ * Test whether or not `path` exists by checking with the file system.
  */
 export async function exists(path) {
     try {
@@ -418,11 +409,6 @@ export async function lstat(path, options) {
 }
 lstat;
 // FILE-ONLY METHODS
-/**
- * `truncate`.
- * @param path
- * @param len
- */
 export async function truncate(path, len = 0) {
     const env_1 = { stack: [], error: void 0, hasError: false };
     try {
@@ -440,10 +426,6 @@ export async function truncate(path, len = 0) {
     }
 }
 truncate;
-/**
- * `unlink`.
- * @param path
- */
 export async function unlink(path) {
     path = normalizePath(path);
     const { fs, path: resolved } = resolveMount(path);
@@ -505,7 +487,7 @@ async function _open(path, _flag, _mode = 0o644, resolveSymlinks) {
 /**
  * Asynchronous file open.
  * @see http://www.manpagez.com/man/2/open/
- * @param flags Handles the complexity of the various file modes. See its API for more details.
+ * @param flag Handles the complexity of the various file modes. See its API for more details.
  * @param mode Mode to use to open the file. Can be ignored if the filesystem doesn't support permissions.
  */
 export async function open(path, flag = 'r', mode = 0o644) {
@@ -534,12 +516,9 @@ readFile;
  * Asynchronously writes data to a file, replacing the file if it already exists.
  *
  * The encoding option is ignored if data is a buffer.
- * @param path
- * @param data Note:
- * @param _options
- * @option options encoding Defaults to `'utf8'`.
- * @option options mode Defaults to `0644`.
- * @option options flag Defaults to `'w'`.
+ * @option encoding Defaults to `'utf8'`.
+ * @option mode Defaults to `0644`.
+ * @option flag Defaults to `'w'`.
  */
 export async function writeFile(path, data, _options) {
     const env_3 = { stack: [], error: void 0, hasError: false };
@@ -564,14 +543,10 @@ export async function writeFile(path, data, _options) {
 }
 writeFile;
 /**
- * Asynchronously append data to a file, creating the file if it not yet
- * exists.
- * @param path
- * @param data
- * @param options
- * @option options encoding Defaults to `'utf8'`.
- * @option options mode Defaults to `0644`.
- * @option options flag Defaults to `'a'`.
+ * Asynchronously append data to a file, creating the file if it not yet exists.
+ * @option encoding Defaults to `'utf8'`.
+ * @option mode Defaults to `0644`.
+ * @option flag Defaults to `'a'`.
  */
 export async function appendFile(path, data, _options) {
     const env_4 = { stack: [], error: void 0, hasError: false };
@@ -600,10 +575,6 @@ export async function appendFile(path, data, _options) {
 }
 appendFile;
 // DIRECTORY-ONLY METHODS
-/**
- * `rmdir`.
- * @param path
- */
 export async function rmdir(path) {
     path = normalizePath(path);
     path = (await exists(path)) ? await realpath(path) : path;
@@ -687,11 +658,6 @@ export async function readdir(path, options) {
 }
 readdir;
 // SYMLINK METHODS
-/**
- * `link`.
- * @param targetPath
- * @param linkPath
- */
 export async function link(targetPath, linkPath) {
     targetPath = normalizePath(targetPath);
     if (!(await stat(dirname(targetPath))).hasAccess(constants.R_OK)) {
@@ -755,12 +721,6 @@ export async function readlink(path, options) {
 }
 readlink;
 // PROPERTY OPERATIONS
-/**
- * `chown`.
- * @param path
- * @param uid
- * @param gid
- */
 export async function chown(path, uid, gid) {
     const env_6 = { stack: [], error: void 0, hasError: false };
     try {
@@ -778,12 +738,6 @@ export async function chown(path, uid, gid) {
     }
 }
 chown;
-/**
- * `lchown`.
- * @param path
- * @param uid
- * @param gid
- */
 export async function lchown(path, uid, gid) {
     const env_7 = { stack: [], error: void 0, hasError: false };
     try {
@@ -801,11 +755,6 @@ export async function lchown(path, uid, gid) {
     }
 }
 lchown;
-/**
- * `chmod`.
- * @param path
- * @param mode
- */
 export async function chmod(path, mode) {
     const env_8 = { stack: [], error: void 0, hasError: false };
     try {
@@ -823,11 +772,6 @@ export async function chmod(path, mode) {
     }
 }
 chmod;
-/**
- * `lchmod`.
- * @param path
- * @param mode
- */
 export async function lchmod(path, mode) {
     const env_9 = { stack: [], error: void 0, hasError: false };
     try {
@@ -847,9 +791,6 @@ export async function lchmod(path, mode) {
 lchmod;
 /**
  * Change file timestamps of the file referenced by the supplied path.
- * @param path
- * @param atime
- * @param mtime
  */
 export async function utimes(path, atime, mtime) {
     const env_10 = { stack: [], error: void 0, hasError: false };
@@ -870,9 +811,6 @@ export async function utimes(path, atime, mtime) {
 utimes;
 /**
  * Change file timestamps of the file referenced by the supplied path.
- * @param path
- * @param atime
- * @param mtime
  */
 export async function lutimes(path, atime, mtime) {
     const env_11 = { stack: [], error: void 0, hasError: false };
@@ -930,11 +868,6 @@ export function watch(filename, options = {}) {
     };
 }
 watch;
-/**
- * `access`.
- * @param path
- * @param mode
- */
 export async function access(path, mode = constants.F_OK) {
     const stats = await stat(path);
     if (!stats.hasAccess(mode)) {
@@ -1015,7 +948,7 @@ opendir;
  * @param opts Options for the copy operation. Currently supports these options from Node.js 'fs.await cp':
  *   * `dereference`: Dereference symbolic links.
  *   * `errorOnExist`: Throw an error if the destination file or directory already exists.
- *   * `filter`: A function that takes a source and destination path and returns a boolean, indicating whether to copy the given source element.
+ *   * `filter`: A function that takes a source and destination path and returns a boolean, indicating whether to copy `source` element.
  *   * `force`: Overwrite the destination if it exists, and overwrite existing readonly destination files.
  *   * `preserveTimestamps`: Preserve file timestamps.
  *   * `recursive`: If `true`, copies directories recursively.

package/dist/emulation/shared.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" resolution-mode="require"/>
 import type { BigIntStatsFs, StatsFs } from 'node:fs';
 import type { File } from '../file.js';
 import type { FileSystem } from '../filesystem.js';
@@ -13,11 +12,11 @@ export type MountObject = Record<AbsolutePath, FileSystem>;
  */
 export declare const mounts: Map<string, FileSystem>;
 /**
- * Mounts the file system at the given mount point.
+ * Mounts the file system at `mountPoint`.
  */
 export declare function mount(mountPoint: string, fs: FileSystem): void;
 /**
- * Unmounts the file system at the given mount point.
+ * Unmounts the file system at `mountPoint`.
  */
 export declare function umount(mountPoint: string): void;
 /**
@@ -30,8 +29,13 @@ export declare function resolveMount(path: string): {
 };
 /**
  * Reverse maps the paths in text from the mounted FileSystem to the global path
+ * @hidden
  */
 export declare function fixPaths(text: string, paths: Record<string, string>): string;
+/**
+ * Fix paths in error stacks
+ * @hidden
+ */
 export declare function fixError<E extends Error>(e: E, paths: Record<string, string>): E;
 export declare function mountObject(mounts: MountObject): void;
 /**