@zenfs/core 1.0.9 → 1.0.11

package/dist/emulation/async.d.ts

@@ -1,8 +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"/>
 import { Buffer } from 'buffer';
 import type * as fs from 'node:fs';
 import type { FileContents } from '../filesystem.js';
@@ -14,26 +9,15 @@ import * as promises from './promises.js';
 import { ReadStream, WriteStream } from './streams.js';
 import { FSWatcher } from './watchers.js';
 /**
- * Asynchronous rename. No arguments other than a possible exception are given
- * to the completion callback.
- * @param oldPath
- * @param newPath
- * @param callback
+ * Asynchronous rename. No arguments other than a possible exception are given to the completion callback.
  */
 export declare function rename(oldPath: fs.PathLike, newPath: fs.PathLike, cb?: Callback): void;
 /**
- * Test whether or not the given path exists by checking with the file system.
+ * Test whether or not `path` exists by checking with the file system.
  * Then call the callback argument with either true or false.
- * @param path
- * @param callback
  * @deprecated Use {@link stat} or {@link access} instead.
  */
 export declare function exists(path: fs.PathLike, cb?: (exists: boolean) => unknown): void;
-/**
- * Asynchronous `stat`.
- * @param path
- * @param callback
- */
 export declare function stat(path: fs.PathLike, callback: Callback<[Stats]>): void;
 export declare function stat(path: fs.PathLike, options: {
     bigint?: false;
@@ -46,8 +30,6 @@ export declare function stat(path: fs.PathLike, options: fs.StatOptions, callbac
  * Asynchronous `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
- * @param callback
  */
 export declare function lstat(path: fs.PathLike, callback: Callback<[Stats]>): void;
 export declare function lstat(path: fs.PathLike, options: fs.StatOptions & {
@@ -57,23 +39,13 @@ export declare function lstat(path: fs.PathLike, options: fs.StatOptions & {
     bigint: true;
 }, callback: Callback<[BigIntStats]>): void;
 export declare function lstat(path: fs.PathLike, options: fs.StatOptions, callback: Callback<[Stats | BigIntStats]>): void;
-/**
- * Asynchronous `truncate`.
- * @param path
- * @param len
- * @param callback
- */
 export declare function truncate(path: fs.PathLike, cb?: Callback): void;
 export declare function truncate(path: fs.PathLike, len: number, cb?: Callback): void;
-/**
- * Asynchronous `unlink`.
- * @param path
- * @param callback
- */
 export declare function unlink(path: fs.PathLike, cb?: Callback): void;
 /**
  * Asynchronous file open.
  * Exclusive mode ensures that path is newly created.
+ * Mode defaults to `0644`
  *
  * `flags` can be:
  *
@@ -91,20 +63,14 @@ export declare function unlink(path: fs.PathLike, cb?: Callback): void;
  * * `'ax+'` - Like 'a+' but opens the file in exclusive mode.
  *
  * @see http://www.manpagez.com/man/2/open/
- * @param path
- * @param flags
- * @param mode defaults to `0644`
- * @param callback
  */
 export declare function open(path: fs.PathLike, flag: string, cb?: Callback<[number]>): void;
 export declare function open(path: fs.PathLike, flag: string, mode: number | string, cb?: Callback<[number]>): void;
 /**
  * Asynchronously reads the entire contents of a file.
- * @param filename
- * @param options
- * @option options encoding The string encoding for the file contents. Defaults to `null`.
- * @option options flag Defaults to `'r'`.
- * @param callback If no encoding is specified, then the raw buffer is returned.
+ * @option encoding The string encoding for the file contents. Defaults to `null`.
+ * @option flag Defaults to `'r'`.
+ * @param cb If no encoding is specified, then the raw buffer is returned.
  */
 export declare function readFile(filename: fs.PathLike, cb: Callback<[Uint8Array]>): void;
 export declare function readFile(filename: fs.PathLike, options: {
@@ -120,13 +86,9 @@ export declare function readFile(filename: fs.PathLike, options: {
  *
  * The encoding option is ignored if data is a buffer.
  *
- * @param filename
- * @param data
- * @param options
  * @option encoding Defaults to `'utf8'`.
  * @option mode Defaults to `0644`.
  * @option flag Defaults to `'w'`.
- * @param callback
  */
 export declare function writeFile(filename: fs.PathLike, data: FileContents, cb?: Callback): void;
 export declare function writeFile(filename: fs.PathLike, data: FileContents, encoding?: BufferEncoding, cb?: Callback): void;
@@ -135,13 +97,9 @@ export declare function writeFile(filename: fs.PathLike, data: FileContents, opt
  * Asynchronously append data to a file, creating the file if it not yet
  * exists.
  *
- * @param filename
- * @param data
- * @param options
  * @option encoding Defaults to `'utf8'`.
  * @option mode Defaults to `0644`.
  * @option flag Defaults to `'a'`.
- * @param callback
  */
 export declare function appendFile(filename: fs.PathLike, data: FileContents, cb?: Callback): void;
 export declare function appendFile(filename: fs.PathLike, data: FileContents, options?: fs.EncodingOption & {
@@ -151,10 +109,7 @@ export declare function appendFile(filename: fs.PathLike, data: FileContents, op
 export declare function appendFile(filename: fs.PathLike, data: FileContents, encoding?: BufferEncoding, cb?: Callback): void;
 /**
  * Asynchronous `fstat`.
- * `fstat()` is identical to `stat()`, except that the file to be stat-ed is
- * specified by the file descriptor `fd`.
- * @param fd
- * @param callback
+ * `fstat()` is identical to `stat()`, except that the file to be stat-ed is specified by the file descriptor `fd`.
  */
 export declare function fstat(fd: number, cb: Callback<[Stats]>): void;
 export declare function fstat(fd: number, options: fs.StatOptions & {
@@ -163,45 +118,20 @@ export declare function fstat(fd: number, options: fs.StatOptions & {
 export declare function fstat(fd: number, options: fs.StatOptions & {
     bigint: true;
 }, cb: Callback<[BigIntStats]>): void;
-/**
- * Asynchronous close.
- * @param fd
- * @param callback
- */
 export declare function close(fd: number, cb?: Callback): void;
-/**
- * Asynchronous ftruncate.
- * @param fd
- * @param len
- * @param callback
- */
 export declare function ftruncate(fd: number, cb?: Callback): void;
 export declare function ftruncate(fd: number, len?: number, cb?: Callback): void;
-/**
- * Asynchronous fsync.
- * @param fd
- * @param callback
- */
 export declare function fsync(fd: number, cb?: Callback): void;
-/**
- * Asynchronous fdatasync.
- * @param fd
- * @param callback
- */
 export declare function fdatasync(fd: number, cb?: Callback): void;
 /**
  * Write buffer to the file specified by `fd`.
- * Note that it is unsafe to use fs.write multiple times on the same file
- * without waiting for the callback.
- * @param fd
- * @param buffer Uint8Array containing the data to write to
- *   the file.
+ * Note that it is unsafe to use fs.write multiple times on the same file without waiting for the callback.
+ * @param buffer Uint8Array containing the data to write to the file.
  * @param offset Offset in the buffer to start reading data from.
  * @param length The amount of bytes to write to the file.
- * @param position Offset from the beginning of the file where this
- *   data should be written. If position is null, the data will be written at
- *   the current position.
- * @param callback The number specifies the number of bytes written into the file.
+ * @param position Offset from the beginning of the file where this data should be written.
+ * If position is null, the data will be written at the current position.
+ * @param cb The number specifies the number of bytes written into the file.
  */
 export declare function write(fd: number, buffer: Uint8Array, offset: number, length: number, cb?: Callback<[number, Uint8Array]>): void;
 export declare function write(fd: number, buffer: Uint8Array, offset: number, length: number, position?: number, cb?: Callback<[number, Uint8Array]>): void;
@@ -210,60 +140,30 @@ export declare function write(fd: number, data: FileContents, position?: number,
 export declare function write(fd: number, data: FileContents, position: number | null, encoding: BufferEncoding, cb?: Callback<[number, string]>): void;
 /**
  * Read data from the file specified by `fd`.
- * @param buffer The buffer that the data will be
- *   written to.
- * @param offset The offset within the buffer where writing will
- *   start.
+ * @param buffer The buffer that the data will be written to.
+ * @param offset The offset within the buffer where writing will start.
  * @param length An integer specifying the number of bytes to read.
- * @param position An integer specifying where to begin reading from
- *   in the file. If position is null, data will be read from the current file
- *   position.
- * @param callback The number is the number of bytes read
+ * @param position An integer specifying where to begin reading from in the file.
+ * If position is null, data will be read from the current file position.
+ * @param cb The number is the number of bytes read
  */
 export declare function read(fd: number, buffer: Uint8Array, offset: number, length: number, position?: number, cb?: Callback<[number, Uint8Array]>): void;
-/**
- * Asynchronous `fchown`.
- * @param fd
- * @param uid
- * @param gid
- * @param callback
- */
 export declare function fchown(fd: number, uid: number, gid: number, cb?: Callback): void;
-/**
- * Asynchronous `fchmod`.
- * @param fd
- * @param mode
- * @param callback
- */
 export declare function fchmod(fd: number, mode: string | number, cb: Callback): void;
 /**
- * Change the file timestamps of a file referenced by the supplied file
- * descriptor.
- * @param fd
- * @param atime
- * @param mtime
- * @param callback
+ * Change the file timestamps of a file referenced by the supplied file descriptor.
  */
 export declare function futimes(fd: number, atime: number | Date, mtime: number | Date, cb?: Callback): void;
-/**
- * Asynchronous `rmdir`.
- * @param path
- * @param callback
- */
 export declare function rmdir(path: fs.PathLike, cb?: Callback): void;
 /**
  * Asynchronous `mkdir`.
- * @param path
  * @param mode defaults to `0777`
- * @param callback
  */
 export declare function mkdir(path: fs.PathLike, mode?: fs.Mode, cb?: Callback): void;
 /**
  * Asynchronous `readdir`. Reads the contents of a directory.
  * The callback gets two arguments `(err, files)` where `files` is an array of
  * the names of the files in the directory excluding `'.'` and `'..'`.
- * @param path
- * @param callback
  */
 export declare function readdir(path: fs.PathLike, cb: Callback<[string[]]>): void;
 export declare function readdir(path: fs.PathLike, options: {
@@ -272,92 +172,37 @@ export declare function readdir(path: fs.PathLike, options: {
 export declare function readdir(path: fs.PathLike, options: {
     withFileTypes: true;
 }, cb: Callback<[Dirent[]]>): void;
-/**
- * Asynchronous `link`.
- * @param existing
- * @param newpath
- * @param callback
- */
 export declare function link(existing: fs.PathLike, newpath: fs.PathLike, cb?: Callback): void;
 /**
  * Asynchronous `symlink`.
  * @param target target path
  * @param path link path
- * @param type can be either `'dir'` or `'file'` (default is `'file'`)
- * @param callback
+ * Type defaults to file
  */
 export declare function symlink(target: fs.PathLike, path: fs.PathLike, cb?: Callback): void;
 export declare function symlink(target: fs.PathLike, path: fs.PathLike, type?: fs.symlink.Type, cb?: Callback): void;
-/**
- * Asynchronous readlink.
- * @param path
- * @param callback
- */
 export declare function readlink(path: fs.PathLike, callback: Callback<[string]> & any): void;
 export declare function readlink(path: fs.PathLike, options: fs.BufferEncodingOption, callback: Callback<[Uint8Array]>): void;
 export declare function readlink(path: fs.PathLike, options: fs.EncodingOption, callback: Callback<[string | Uint8Array]>): void;
 export declare function readlink(path: fs.PathLike, options: fs.EncodingOption, callback: Callback<[string]>): void;
-/**
- * Asynchronous `chown`.
- * @param path
- * @param uid
- * @param gid
- * @param callback
- */
 export declare function chown(path: fs.PathLike, uid: number, gid: number, cb?: Callback): void;
-/**
- * Asynchronous `lchown`.
- * @param path
- * @param uid
- * @param gid
- * @param callback
- */
 export declare function lchown(path: fs.PathLike, uid: number, gid: number, cb?: Callback): void;
-/**
- * Asynchronous `chmod`.
- * @param path
- * @param mode
- * @param callback
- */
 export declare function chmod(path: fs.PathLike, mode: number | string, cb?: Callback): void;
-/**
- * Asynchronous `lchmod`.
- * @param path
- * @param mode
- * @param callback
- */
 export declare function lchmod(path: fs.PathLike, mode: number | string, cb?: Callback): void;
 /**
  * Change file timestamps of the file referenced by the supplied path.
- * @param path
- * @param atime
- * @param mtime
- * @param callback
  */
 export declare function utimes(path: fs.PathLike, atime: number | Date, mtime: number | Date, cb?: Callback): void;
 /**
  * Change file timestamps of the file referenced by the supplied path.
- * @param path
- * @param atime
- * @param mtime
- * @param callback
  */
 export declare function lutimes(path: fs.PathLike, atime: number | Date, mtime: number | Date, cb?: Callback): void;
 /**
  * Asynchronous `realpath`. The callback gets two arguments
  * `(err, resolvedPath)`. May use `process.cwd` to resolve relative paths.
- *
- * @param path
- * @param callback
  */
 export declare function realpath(path: fs.PathLike, cb?: Callback<[string]>): void;
 export declare function realpath(path: fs.PathLike, options: fs.EncodingOption, cb: Callback<[string]>): void;
-/**
- * Asynchronous `access`.
- * @param path
- * @param mode
- * @param callback
- */
 export declare function access(path: fs.PathLike, cb: Callback): void;
 export declare function access(path: fs.PathLike, mode: number, cb: Callback): void;
 /**
@@ -425,7 +270,7 @@ interface WriteStreamOptions extends StreamOptions {
  * @param options Options for the ReadStream and file opening (e.g., `encoding`, `highWaterMark`, `mode`).
  * @returns A ReadStream object for interacting with the file's contents.
  */
-export declare function createReadStream(path: fs.PathLike, _options?: BufferEncoding | ReadStreamOptions): ReadStream;
+export declare function createReadStream(path: fs.PathLike, options?: BufferEncoding | ReadStreamOptions): ReadStream;
 /**
  * Opens a file in write mode and creates a Node.js-like WriteStream.
  *
@@ -433,7 +278,7 @@ export declare function createReadStream(path: fs.PathLike, _options?: BufferEnc
  * @param options Options for the WriteStream and file opening (e.g., `encoding`, `highWaterMark`, `mode`).
  * @returns A WriteStream object for writing to the file.
  */
-export declare function createWriteStream(path: fs.PathLike, _options?: BufferEncoding | WriteStreamOptions): WriteStream;
+export declare function createWriteStream(path: fs.PathLike, options?: BufferEncoding | WriteStreamOptions): WriteStream;
 export declare function rm(path: fs.PathLike, callback: Callback): void;
 export declare function rm(path: fs.PathLike, options: fs.RmOptions, callback: Callback): void;
 /**

package/dist/emulation/async.js

@@ -9,11 +9,7 @@ import { ReadStream, WriteStream } from './streams.js';
 import { FSWatcher, StatWatcher } from './watchers.js';
 const nop = () => { };
 /**
- * Asynchronous rename. No arguments other than a possible exception are given
- * to the completion callback.
- * @param oldPath
- * @param newPath
- * @param callback
+ * Asynchronous rename. No arguments other than a possible exception are given to the completion callback.
  */
 export function rename(oldPath, newPath, cb = nop) {
     promises
@@ -23,10 +19,8 @@ export function rename(oldPath, newPath, cb = nop) {
 }
 rename;
 /**
- * Test whether or not the given path exists by checking with the file system.
+ * Test whether or not `path` exists by checking with the file system.
  * Then call the callback argument with either true or false.
- * @param path
- * @param callback
  * @deprecated Use {@link stat} or {@link access} instead.
  */
 export function exists(path, cb = nop) {
@@ -61,11 +55,6 @@ export function truncate(path, cbLen = 0, cb = nop) {
         .catch(cb);
 }
 truncate;
-/**
- * Asynchronous `unlink`.
- * @param path
- * @param callback
- */
 export function unlink(path, cb = nop) {
     promises
         .unlink(path)
@@ -115,11 +104,6 @@ export function fstat(fd, options, cb = nop) {
         .catch(cb);
 }
 fstat;
-/**
- * Asynchronous close.
- * @param fd
- * @param callback
- */
 export function close(fd, cb = nop) {
     new promises.FileHandle(fd)
         .close()
@@ -139,11 +123,6 @@ export function ftruncate(fd, lenOrCB, cb = nop) {
         .catch(cb);
 }
 ftruncate;
-/**
- * Asynchronous fsync.
- * @param fd
- * @param callback
- */
 export function fsync(fd, cb = nop) {
     fd2file(fd)
         .sync()
@@ -151,11 +130,6 @@ export function fsync(fd, cb = nop) {
         .catch(cb);
 }
 fsync;
-/**
- * Asynchronous fdatasync.
- * @param fd
- * @param callback
- */
 export function fdatasync(fd, cb = nop) {
     fd2file(fd)
         .datasync()
@@ -211,15 +185,12 @@ export function write(fd, data, cbPosOff, cbLenEnc, cbPosEnc, cb = nop) {
 write;
 /**
  * Read data from the file specified by `fd`.
- * @param buffer The buffer that the data will be
- *   written to.
- * @param offset The offset within the buffer where writing will
- *   start.
+ * @param buffer The buffer that the data will be written to.
+ * @param offset The offset within the buffer where writing will start.
  * @param length An integer specifying the number of bytes to read.
- * @param position An integer specifying where to begin reading from
- *   in the file. If position is null, data will be read from the current file
- *   position.
- * @param callback The number is the number of bytes read
+ * @param position An integer specifying where to begin reading from in the file.
+ * If position is null, data will be read from the current file position.
+ * @param cb The number is the number of bytes read
  */
 export function read(fd, buffer, offset, length, position, cb = nop) {
     new promises.FileHandle(fd)
@@ -228,13 +199,6 @@ export function read(fd, buffer, offset, length, position, cb = nop) {
         .catch(cb);
 }
 read;
-/**
- * Asynchronous `fchown`.
- * @param fd
- * @param uid
- * @param gid
- * @param callback
- */
 export function fchown(fd, uid, gid, cb = nop) {
     new promises.FileHandle(fd)
         .chown(uid, gid)
@@ -242,12 +206,6 @@ export function fchown(fd, uid, gid, cb = nop) {
         .catch(cb);
 }
 fchown;
-/**
- * Asynchronous `fchmod`.
- * @param fd
- * @param mode
- * @param callback
- */
 export function fchmod(fd, mode, cb) {
     new promises.FileHandle(fd)
         .chmod(mode)
@@ -256,12 +214,7 @@ export function fchmod(fd, mode, cb) {
 }
 fchmod;
 /**
- * Change the file timestamps of a file referenced by the supplied file
- * descriptor.
- * @param fd
- * @param atime
- * @param mtime
- * @param callback
+ * Change the file timestamps of a file referenced by the supplied file descriptor.
  */
 export function futimes(fd, atime, mtime, cb = nop) {
     new promises.FileHandle(fd)
@@ -270,11 +223,6 @@ export function futimes(fd, atime, mtime, cb = nop) {
         .catch(cb);
 }
 futimes;
-/**
- * Asynchronous `rmdir`.
- * @param path
- * @param callback
- */
 export function rmdir(path, cb = nop) {
     promises
         .rmdir(path)
@@ -284,9 +232,7 @@ export function rmdir(path, cb = nop) {
 rmdir;
 /**
  * Asynchronous `mkdir`.
- * @param path
  * @param mode defaults to `0777`
- * @param callback
  */
 export function mkdir(path, mode, cb = nop) {
     promises
@@ -304,12 +250,6 @@ export function readdir(path, _options, cb = nop) {
         .catch(cb);
 }
 readdir;
-/**
- * Asynchronous `link`.
- * @param existing
- * @param newpath
- * @param callback
- */
 export function link(existing, newpath, cb = nop) {
     promises
         .link(existing, newpath)
@@ -334,13 +274,6 @@ export function readlink(path, options, callback = nop) {
         .catch(callback);
 }
 readlink;
-/**
- * Asynchronous `chown`.
- * @param path
- * @param uid
- * @param gid
- * @param callback
- */
 export function chown(path, uid, gid, cb = nop) {
     promises
         .chown(path, uid, gid)
@@ -348,13 +281,6 @@ export function chown(path, uid, gid, cb = nop) {
         .catch(cb);
 }
 chown;
-/**
- * Asynchronous `lchown`.
- * @param path
- * @param uid
- * @param gid
- * @param callback
- */
 export function lchown(path, uid, gid, cb = nop) {
     promises
         .lchown(path, uid, gid)
@@ -362,12 +288,6 @@ export function lchown(path, uid, gid, cb = nop) {
         .catch(cb);
 }
 lchown;
-/**
- * Asynchronous `chmod`.
- * @param path
- * @param mode
- * @param callback
- */
 export function chmod(path, mode, cb = nop) {
     promises
         .chmod(path, mode)
@@ -375,12 +295,6 @@ export function chmod(path, mode, cb = nop) {
         .catch(cb);
 }
 chmod;
-/**
- * Asynchronous `lchmod`.
- * @param path
- * @param mode
- * @param callback
- */
 export function lchmod(path, mode, cb = nop) {
     promises
         .lchmod(path, mode)
@@ -390,10 +304,6 @@ export function lchmod(path, mode, cb = nop) {
 lchmod;
 /**
  * Change file timestamps of the file referenced by the supplied path.
- * @param path
- * @param atime
- * @param mtime
- * @param callback
  */
 export function utimes(path, atime, mtime, cb = nop) {
     promises
@@ -404,10 +314,6 @@ export function utimes(path, atime, mtime, cb = nop) {
 utimes;
 /**
  * Change file timestamps of the file referenced by the supplied path.
- * @param path
- * @param atime
- * @param mtime
- * @param callback
  */
 export function lutimes(path, atime, mtime, cb = nop) {
     promises
@@ -434,11 +340,11 @@ export function access(path, cbMode, cb = nop) {
 }
 access;
 const statWatchers = new Map();
-export function watchFile(path, optsListener, listener) {
+export function watchFile(path, options, listener) {
     const normalizedPath = normalizePath(path.toString());
-    const options = typeof optsListener != 'function' ? optsListener : {};
-    if (typeof optsListener === 'function') {
-        listener = optsListener;
+    const opts = typeof options != 'function' ? options : {};
+    if (typeof options == 'function') {
+        listener = options;
     }
     if (!listener) {
         throw new ErrnoError(Errno.EINVAL, 'No listener specified', path.toString(), 'watchFile');
@@ -450,7 +356,7 @@ export function watchFile(path, optsListener, listener) {
         }
         return;
     }
-    const watcher = new StatWatcher(normalizedPath, options);
+    const watcher = new StatWatcher(normalizedPath, opts);
     watcher.on('change', (curr, prev) => {
         const entry = statWatchers.get(normalizedPath);
         if (!entry) {
@@ -505,8 +411,8 @@ watch;
  * @param options Options for the ReadStream and file opening (e.g., `encoding`, `highWaterMark`, `mode`).
  * @returns A ReadStream object for interacting with the file's contents.
  */
-export function createReadStream(path, _options) {
-    const options = typeof _options == 'object' ? _options : { encoding: _options };
+export function createReadStream(path, options) {
+    options = typeof options == 'object' ? options : { encoding: options };
     let handle;
     const stream = new ReadStream({
         highWaterMark: options.highWaterMark || 64 * 1024,
@@ -544,8 +450,8 @@ createReadStream;
  * @param options Options for the WriteStream and file opening (e.g., `encoding`, `highWaterMark`, `mode`).
  * @returns A WriteStream object for writing to the file.
  */
-export function createWriteStream(path, _options) {
-    const options = typeof _options == 'object' ? _options : { encoding: _options };
+export function createWriteStream(path, options) {
+    options = typeof options == 'object' ? options : { encoding: options };
     let handle;
     const stream = new WriteStream({
         highWaterMark: options?.highWaterMark,

package/dist/emulation/dir.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" resolution-mode="require"/>
 import type { Dir as _Dir, Dirent as _Dirent } from 'fs';
 import type { Stats } from '../stats.js';
 import type { Callback } from '../utils.js';

package/dist/emulation/path.d.ts

@@ -1,8 +1,4 @@
-/// <reference types="node" resolution-mode="require"/>
 import type { ParsedPath } from 'node:path';
-/**
- * An absolute path
- */
 export type AbsolutePath = `/${string}`;
 export declare let cwd: string;
 export declare function cd(path: string): void;