@ac-kit/node 0.1.0

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2024-2026 Anthony Champagne and contributors
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,39 @@
+# @ac-kit/node
+
+The `node:*` built-ins, wrapped so they behave like the rest of your code:
+promises instead of callbacks, `AbortSignal` instead of bespoke cancellation,
+and typed errors instead of a string `code` on a bare `Error`.
+
+Zero runtime dependencies — every wrapper is over something Node already ships.
+
+```ts
+import { existsAsync, walkPaths, writeFileAtomic } from "@ac-kit/node";
+
+for await (const entry of walkPaths({
+  include: "**/*.ts",
+  exclude: "**/node_modules",
+})) {
+  console.log(entry.path);
+}
+
+// Writes to a temporary file and renames, so a reader never sees a partial file.
+await writeFileAtomic("config.json", JSON.stringify(config));
+```
+
+## What it covers
+
+- **Sockets** — promise-based TCP, TLS, IPC and UDP classes.
+- **Filesystem** — `walkPaths`, `writeFileAtomic`, `existsAsync`,
+  `isDirectoryAsync`, `fileContentEqual`, `compressFile`, `createTempDir`,
+  `escapePath`.
+- **Processes** — `execAsync`, forking, and typed `NodeError` /
+  `NodeSystemError` / `NodeExecError` / `ProcessExitError`.
+- **Modules** — `importModule`, `optionalImport`, `resolveModule`.
+- **Streams** — including `nonClosingWritableStream`, for wrapping a stream
+  whose lifecycle you do not own.
+
+Host-bound by definition. The portable counterpart is `@ac-kit/core`.
+
+See the
+[generated API docs](https://anthochamp.github.io/node-essentials/api/node/)
+for the full reference.

package/dist/child-process/exec-async.d.ts

@@ -0,0 +1,24 @@
+import { type ExecFileOptions, type ExecFileOptionsWithBufferEncoding, type ExecFileOptionsWithStringEncoding, type ExecOptions, type ExecOptionsWithBufferEncoding, type ExecOptionsWithStringEncoding, execFile as execFileSync, exec as execSync } from "node:child_process";
+export declare const exec: typeof execSync.__promisify__;
+export declare const execFile: typeof execFileSync.__promisify__;
+export declare function execAsync<O extends ExecOptions | ExecOptionsWithBufferEncoding | ExecOptionsWithStringEncoding, R = O extends ExecOptionsWithStringEncoding ? {
+    stdout: string;
+    stderr: string;
+} : O extends ExecOptionsWithBufferEncoding ? {
+    stdout: Buffer;
+    stderr: Buffer;
+} : {
+    stdout: string | Buffer;
+    stderr: string | Buffer;
+}>(command: string, options?: O): Promise<R>;
+export declare function execFileAsync<O extends ExecFileOptions | ExecFileOptionsWithBufferEncoding | ExecFileOptionsWithStringEncoding, R = O extends ExecFileOptionsWithStringEncoding ? {
+    stdout: string;
+    stderr: string;
+} : O extends ExecFileOptionsWithBufferEncoding ? {
+    stdout: Buffer;
+    stderr: Buffer;
+} : {
+    stdout: string | Buffer;
+    stderr: string | Buffer;
+}>(file: string, args?: ReadonlyArray<string>, options?: O): Promise<R>;
+//# sourceMappingURL=exec-async.d.ts.map

package/dist/child-process/exec-async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-async.d.ts","sourceRoot":"","sources":["../../src/child-process/exec-async.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,eAAe,EACpB,KAAK,iCAAiC,EACtC,KAAK,iCAAiC,EACtC,KAAK,WAAW,EAChB,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EAClC,QAAQ,IAAI,YAAY,EACxB,IAAI,IAAI,QAAQ,EAChB,MAAM,oBAAoB,CAAC;AAM5B,eAAO,MAAM,IAAI,EAAE,OAAO,QAAQ,CAAC,aAAmC,CAAC;AACvE,eAAO,MAAM,QAAQ,EAAE,OAAO,YAAY,CAAC,aACnB,CAAC;AAEzB,wBAAsB,SAAS,CAC9B,CAAC,SACE,WAAW,GACX,6BAA6B,GAC7B,6BAA6B,EAChC,CAAC,GAAG,CAAC,SAAS,6BAA6B,GACxC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC,CAAC,SAAS,6BAA6B,GACtC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EACvD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAc1C;AAED,wBAAsB,aAAa,CAClC,CAAC,SACE,eAAe,GACf,iCAAiC,GACjC,iCAAiC,EACpC,CAAC,GAAG,CAAC,SAAS,iCAAiC,GAC5C;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC,CAAC,SAAS,iCAAiC,GAC1C;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EACvD,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAcrE"}

package/dist/child-process/exec-async.js

@@ -0,0 +1,33 @@
+import { execFile as execFileSync, exec as execSync, } from "node:child_process";
+import { promisify } from "node:util";
+import { isNodeExecErrorLike } from "../error/node-exec-error.js";
+import { ProcessExitWithOutputError } from "../error/process-exit-error.js";
+export const exec = promisify(execSync);
+export const execFile = promisify(execFileSync);
+export async function execAsync(command, options) {
+    let result;
+    try {
+        result = (await exec(command, options));
+    }
+    catch (error) {
+        if (isNodeExecErrorLike(error)) {
+            throw ProcessExitWithOutputError.fromNodeExecError(error);
+        }
+        throw error;
+    }
+    return result;
+}
+export async function execFileAsync(file, args, options) {
+    let result;
+    try {
+        result = (await execFile(file, args, options));
+    }
+    catch (error) {
+        if (isNodeExecErrorLike(error)) {
+            throw ProcessExitWithOutputError.fromNodeExecError(error);
+        }
+        throw error;
+    }
+    return result;
+}
+//# sourceMappingURL=exec-async.js.map

package/dist/child-process/exec-async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-async.js","sourceRoot":"","sources":["../../src/child-process/exec-async.ts"],"names":[],"mappings":"AAAA,OAAO,EAON,QAAQ,IAAI,YAAY,EACxB,IAAI,IAAI,QAAQ,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAE5E,MAAM,CAAC,MAAM,IAAI,GAAkC,SAAS,CAAC,QAAQ,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,QAAQ,GACpB,SAAS,CAAC,YAAY,CAAC,CAAC;AAEzB,MAAM,CAAC,KAAK,UAAU,SAAS,CAU7B,OAAe,EAAE,OAAW;IAC7B,IAAI,MAAS,CAAC;IAEd,IAAI,CAAC;QACJ,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAM,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,0BAA0B,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,KAAK,CAAC;IACb,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAUjC,IAAY,EAAE,IAA4B,EAAE,OAAW;IACxD,IAAI,MAAS,CAAC;IAEd,IAAI,CAAC;QACJ,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAM,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,0BAA0B,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,KAAK,CAAC;IACb,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/error/node-aggregate-error.d.ts

@@ -0,0 +1,18 @@
+import { type IAggregateError } from "@ac-kit/core";
+import { type INodeError } from "./node-error.js";
+/**
+ * Node AggregateError interface (AggregateError with a code property)
+ *
+ * @see https://github.com/nodejs/node/blob/main/lib/internal/errors.js
+ */
+export interface INodeAggregateError extends IAggregateError, INodeError {
+}
+/**
+ * Test if value is Node AggregateError-like (has name, message, code and errors
+ * properties)
+ *
+ * @param value The value to test
+ * @returns True if the value is Node AggregateError-like
+ */
+export declare function isNodeAggregateErrorLike(value: unknown): value is INodeAggregateError;
+//# sourceMappingURL=node-aggregate-error.d.ts.map

package/dist/error/node-aggregate-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-aggregate-error.d.ts","sourceRoot":"","sources":["../../src/error/node-aggregate-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAE1E,OAAO,EAAE,KAAK,UAAU,EAAmB,MAAM,iBAAiB,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,eAAe,EAAE,UAAU;CAAG;AAE3E;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,mBAAmB,CAE9B"}

package/dist/error/node-aggregate-error.js

@@ -0,0 +1,13 @@
+import { isAggregateErrorLike } from "@ac-kit/core";
+import { isNodeErrorLike } from "./node-error.js";
+/**
+ * Test if value is Node AggregateError-like (has name, message, code and errors
+ * properties)
+ *
+ * @param value The value to test
+ * @returns True if the value is Node AggregateError-like
+ */
+export function isNodeAggregateErrorLike(value) {
+    return isAggregateErrorLike(value) && isNodeErrorLike(value);
+}
+//# sourceMappingURL=node-aggregate-error.js.map

package/dist/error/node-aggregate-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-aggregate-error.js","sourceRoot":"","sources":["../../src/error/node-aggregate-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAwB,MAAM,cAAc,CAAC;AAE1E,OAAO,EAAmB,eAAe,EAAE,MAAM,iBAAiB,CAAC;AASnE;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACvC,KAAc;IAEd,OAAO,oBAAoB,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC"}

package/dist/error/node-error.d.ts

@@ -0,0 +1,26 @@
+import { type IError } from "@ac-kit/core";
+/** Node Error interface (error with a code property) */
+export interface INodeError extends IError {
+    /**
+     * The error code
+     *
+     * @see https://nodejs.org/api/errors.html#nodejs-error-codes
+     */
+    code: string;
+}
+/**
+ * Test if value is Node Error-like (has name, message and code properties)
+ *
+ * @param value The value to test
+ * @returns True if the value is Node Error-like
+ */
+export declare function isNodeErrorLike(value: unknown): value is INodeError;
+/**
+ * Test if value is Node Error-like and has the specified code
+ *
+ * @param value The value to test
+ * @param code The error code to match
+ * @returns True if the value is Node Error-like and has the specified code
+ */
+export declare function isNodeErrorWithCode(value: unknown, code: string): boolean;
+//# sourceMappingURL=node-error.d.ts.map

package/dist/error/node-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-error.d.ts","sourceRoot":"","sources":["../../src/error/node-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAExD,wDAAwD;AACxD,MAAM,WAAW,UAAW,SAAQ,MAAM;IACzC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzE"}

package/dist/error/node-error.js

@@ -0,0 +1,21 @@
+import { isErrorLike } from "@ac-kit/core";
+/**
+ * Test if value is Node Error-like (has name, message and code properties)
+ *
+ * @param value The value to test
+ * @returns True if the value is Node Error-like
+ */
+export function isNodeErrorLike(value) {
+    return isErrorLike(value) && "code" in value;
+}
+/**
+ * Test if value is Node Error-like and has the specified code
+ *
+ * @param value The value to test
+ * @param code The error code to match
+ * @returns True if the value is Node Error-like and has the specified code
+ */
+export function isNodeErrorWithCode(value, code) {
+    return isNodeErrorLike(value) && value.code === code;
+}
+//# sourceMappingURL=node-error.js.map

package/dist/error/node-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-error.js","sourceRoot":"","sources":["../../src/error/node-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAe,MAAM,cAAc,CAAC;AAYxD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC7C,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,MAAM,IAAI,KAAK,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc,EAAE,IAAY;IAC/D,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AACtD,CAAC"}

package/dist/error/node-exec-error.d.ts

@@ -0,0 +1,21 @@
+import { type IError } from "@ac-kit/core";
+/**
+ * Error object representing a failed execution of a child process using
+ * `child_process.exec` or `child_process.execFile`.
+ */
+export interface INodeExecError extends IError {
+    code: string | number;
+    killed: boolean;
+    signal: NodeJS.Signals | null;
+    cmd: string;
+    stdout: string | Buffer;
+    stderr: string | Buffer;
+}
+/**
+ * Check if a value is a INodeExecError-like object.
+ *
+ * @param value The value to test
+ * @returns True if the value is a INodeExecError-like object
+ */
+export declare function isNodeExecErrorLike(value: unknown): value is INodeExecError;
+//# sourceMappingURL=node-exec-error.d.ts.map

package/dist/error/node-exec-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-exec-error.d.ts","sourceRoot":"","sources":["../../src/error/node-exec-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,MAAM;IAC7C,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAU3E"}

package/dist/error/node-exec-error.js

@@ -0,0 +1,17 @@
+import { isErrorLike } from "@ac-kit/core";
+/**
+ * Check if a value is a INodeExecError-like object.
+ *
+ * @param value The value to test
+ * @returns True if the value is a INodeExecError-like object
+ */
+export function isNodeExecErrorLike(value) {
+    return (isErrorLike(value) &&
+        "code" in value &&
+        "killed" in value &&
+        "signal" in value &&
+        "cmd" in value &&
+        "stdout" in value &&
+        "stderr" in value);
+}
+//# sourceMappingURL=node-exec-error.js.map

package/dist/error/node-exec-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-exec-error.js","sourceRoot":"","sources":["../../src/error/node-exec-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAe,MAAM,cAAc,CAAC;AAexD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IACjD,OAAO,CACN,WAAW,CAAC,KAAK,CAAC;QAClB,MAAM,IAAI,KAAK;QACf,QAAQ,IAAI,KAAK;QACjB,QAAQ,IAAI,KAAK;QACjB,KAAK,IAAI,KAAK;QACd,QAAQ,IAAI,KAAK;QACjB,QAAQ,IAAI,KAAK,CACjB,CAAC;AACH,CAAC"}

package/dist/error/node-system-error.d.ts

@@ -0,0 +1,46 @@
+import type { INodeError } from "./node-error.js";
+export type NodeSystemErrorInfo = {
+    errno: number;
+    syscall: string;
+    path?: string;
+    dest?: string;
+    [key: string]: unknown;
+};
+/**
+ * Node System Error interface (Error with code, errno, syscall and optional
+ * path and dest properties)
+ *
+ * @see https://github.com/nodejs/node/blob/main/lib/internal/errors.js
+ */
+export interface INodeSystemError extends INodeError {
+    /** The uv error context */
+    info: NodeSystemErrorInfo;
+    errno: number;
+    syscall: string;
+    path?: string;
+    dest?: string;
+}
+/**
+ * Test if value is Node System Error-like (has name, message, code, info, errno
+ * and syscall properties)
+ *
+ * @param value The value to test
+ * @returns True if the value is Node System Error-like
+ */
+export declare function isNodeSystemErrorLike(value: unknown): value is INodeSystemError;
+/**
+ * Get the system error name (eg. ENOENT) for a Node System Error
+ *
+ * @param error The Node System Error
+ * @returns The system error name, or undefined if not found
+ */
+export declare function getNodeSystemErrorName(error: Pick<INodeSystemError, "errno">): string | undefined;
+/**
+ * Get the system error message (eg. no such file or directory) for a Node
+ * System Error
+ *
+ * @param error The Node System Error
+ * @returns The system error message, or undefined if not found
+ */
+export declare function getNodeSystemErrorMessage(error: Pick<INodeSystemError, "errno">): string | undefined;
+//# sourceMappingURL=node-system-error.d.ts.map

package/dist/error/node-system-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-system-error.d.ts","sourceRoot":"","sources":["../../src/error/node-system-error.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IACnD,2BAA2B;IAC3B,IAAI,EAAE,mBAAmB,CAAC;IAE1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,gBAAgB,CAO3B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,GACpC,MAAM,GAAG,SAAS,CAEpB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,GACpC,MAAM,GAAG,SAAS,CAEpB"}

package/dist/error/node-system-error.js

@@ -0,0 +1,35 @@
+import { getSystemErrorMessage, getSystemErrorName } from "node:util";
+import { isErrorLike } from "@ac-kit/core";
+/**
+ * Test if value is Node System Error-like (has name, message, code, info, errno
+ * and syscall properties)
+ *
+ * @param value The value to test
+ * @returns True if the value is Node System Error-like
+ */
+export function isNodeSystemErrorLike(value) {
+    return (isErrorLike(value) &&
+        "info" in value &&
+        "errno" in value &&
+        "syscall" in value);
+}
+/**
+ * Get the system error name (eg. ENOENT) for a Node System Error
+ *
+ * @param error The Node System Error
+ * @returns The system error name, or undefined if not found
+ */
+export function getNodeSystemErrorName(error) {
+    return getSystemErrorName(error.errno);
+}
+/**
+ * Get the system error message (eg. no such file or directory) for a Node
+ * System Error
+ *
+ * @param error The Node System Error
+ * @returns The system error message, or undefined if not found
+ */
+export function getNodeSystemErrorMessage(error) {
+    return getSystemErrorMessage(error.errno);
+}
+//# sourceMappingURL=node-system-error.js.map

package/dist/error/node-system-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-system-error.js","sourceRoot":"","sources":["../../src/error/node-system-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEtE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA6B3C;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACpC,KAAc;IAEd,OAAO,CACN,WAAW,CAAC,KAAK,CAAC;QAClB,MAAM,IAAI,KAAK;QACf,OAAO,IAAI,KAAK;QAChB,SAAS,IAAI,KAAK,CAClB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACrC,KAAsC;IAEtC,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACxC,KAAsC;IAEtC,OAAO,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC"}

package/dist/error/process-exit-error.d.ts

@@ -0,0 +1,22 @@
+import { INodeExecError } from "./node-exec-error.js";
+/**
+ * Error thrown when a shell command exits with a non-zero code or is terminated
+ * by a signal.
+ */
+export declare class ProcessExitError extends Error {
+    readonly code: string | number | null;
+    readonly signal: NodeJS.Signals | null;
+    readonly killed: boolean;
+    constructor(code: string | number | null, signal: NodeJS.Signals | null, killed: boolean, options?: ErrorOptions);
+}
+/**
+ * Error thrown when a shell command exits with a non-zero code or is terminated
+ * by a signal, including its stdout and stderr output.
+ */
+export declare class ProcessExitWithOutputError extends ProcessExitError {
+    readonly stdout: string | Buffer;
+    readonly stderr: string | Buffer;
+    static fromNodeExecError(error: INodeExecError): ProcessExitWithOutputError;
+    constructor(code: string | number | null, signal: NodeJS.Signals | null, killed: boolean, stdout: string | Buffer, stderr: string | Buffer, options?: ErrorOptions);
+}
+//# sourceMappingURL=process-exit-error.d.ts.map

package/dist/error/process-exit-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-exit-error.d.ts","sourceRoot":"","sources":["../../src/error/process-exit-error.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAEzC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI;IACtC,QAAQ,CAAC,MAAM,EAAE,OAAO;IAHzB,YACU,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC5B,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,EAC7B,MAAM,EAAE,OAAO,EACxB,OAAO,CAAC,EAAE,YAAY,EAgBtB;CACD;AAED;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB;IA0B9D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IA1BjC,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,0BAA0B,CAmB1E;IAED,YACC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC5B,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,EAC7B,MAAM,EAAE,OAAO,EACN,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,MAAM,EAAE,MAAM,GAAG,MAAM,EAChC,OAAO,CAAC,EAAE,YAAY,EAKtB;CACD"}

package/dist/error/process-exit-error.js

@@ -0,0 +1,46 @@
+import { joinNonEmpty } from "@ac-kit/core";
+/**
+ * Error thrown when a shell command exits with a non-zero code or is terminated
+ * by a signal.
+ */
+export class ProcessExitError extends Error {
+    code;
+    signal;
+    killed;
+    constructor(code, signal, killed, options) {
+        super(joinNonEmpty([
+            code !== null || signal !== null || killed ? "Process exited" : null,
+            code !== null ? `with code ${code}` : null,
+            signal !== null ? `with signal ${signal}` : null,
+            killed ? "(killed)" : null,
+        ], " "), options);
+        this.code = code;
+        this.signal = signal;
+        this.killed = killed;
+        this.name = "ProcessExitError";
+    }
+}
+/**
+ * Error thrown when a shell command exits with a non-zero code or is terminated
+ * by a signal, including its stdout and stderr output.
+ */
+export class ProcessExitWithOutputError extends ProcessExitError {
+    stdout;
+    stderr;
+    static fromNodeExecError(error) {
+        const result = new ProcessExitWithOutputError(error.code, error.signal, error.killed, error.stdout, error.stderr, error.cause
+            ? {
+                cause: error.cause,
+            }
+            : undefined);
+        Error.captureStackTrace(result, ProcessExitWithOutputError.fromNodeExecError);
+        return result;
+    }
+    constructor(code, signal, killed, stdout, stderr, options) {
+        super(code, signal, killed, options);
+        this.stdout = stdout;
+        this.stderr = stderr;
+        this.name = "ProcessExitWithOutputError";
+    }
+}
+//# sourceMappingURL=process-exit-error.js.map

package/dist/error/process-exit-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-exit-error.js","sourceRoot":"","sources":["../../src/error/process-exit-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAEhC,IAAI;IACJ,MAAM;IACN,MAAM;IAHhB,YACU,IAA4B,EAC5B,MAA6B,EAC7B,MAAe,EACxB,OAAsB;QAEtB,KAAK,CACJ,YAAY,CACX;YACC,IAAI,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI;YACpE,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;YAC1C,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,eAAe,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI;YAChD,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;SAC1B,EACD,GAAG,CACH,EACD,OAAO,CACP,CAAC;oBAhBO,IAAI;sBACJ,MAAM;sBACN,MAAM;QAgBf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IAChC,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,OAAO,0BAA2B,SAAQ,gBAAgB;IA0BrD,MAAM;IACN,MAAM;IA1BhB,MAAM,CAAC,iBAAiB,CAAC,KAAqB;QAC7C,MAAM,MAAM,GAAG,IAAI,0BAA0B,CAC5C,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,KAAK;YACV,CAAC,CAAC;gBACA,KAAK,EAAE,KAAK,CAAC,KAAK;aAClB;YACF,CAAC,CAAC,SAAS,CACZ,CAAC;QAEF,KAAK,CAAC,iBAAiB,CACtB,MAAM,EACN,0BAA0B,CAAC,iBAAiB,CAC5C,CAAC;QACF,OAAO,MAAM,CAAC;IACf,CAAC;IAED,YACC,IAA4B,EAC5B,MAA6B,EAC7B,MAAe,EACN,MAAuB,EACvB,MAAuB,EAChC,OAAsB;QAEtB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;sBAJ5B,MAAM;sBACN,MAAM;QAKf,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC1C,CAAC;CACD"}

package/dist/fs/compress-file.d.ts

@@ -0,0 +1,42 @@
+import { type PathLike } from "node:fs";
+export declare enum CompressFileExtension {
+    BROTLI = ".br",
+    GZIP = ".gz",
+    ZSTD = ".zst"
+}
+export type CompressFileOptions = {
+    /**
+     * The compression algorithm to use.
+     *
+     * Default is `CompressFileExtension.GZIP`.
+     */
+    fileType?: CompressFileExtension;
+    /**
+     * Whether to keep the source file after compression.
+     *
+     * Default is `false`.
+     */
+    keepSource?: boolean;
+    /** An `AbortSignal` to cancel the operation. */
+    signal?: AbortSignal | null;
+};
+/**
+ * Compress a file using the specified compression algorithm.
+ *
+ * The destination file path can be omitted, in which case it will be generated
+ * by appending the appropriate file extension to the source file path.
+ *
+ * By default, the source file will be deleted after compression. This can be
+ * changed by setting the `keepSource` option to `true`.
+ *
+ * Supported compression algorithms are Brotli, Gzip, and Zstd.
+ *
+ * @param src The path to the source file.
+ * @param dest The path to the destination file. If omitted, it will be
+ *   generated by appending the appropriate file extension to the source file
+ *   path.
+ * @param options Compression options.
+ * @returns The path to the compressed file.
+ */
+export declare function compressFile(src: PathLike, dest?: PathLike | null, options?: CompressFileOptions): Promise<PathLike>;
+//# sourceMappingURL=compress-file.d.ts.map

package/dist/fs/compress-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress-file.d.ts","sourceRoot":"","sources":["../../src/fs/compress-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAW7E,oBAAY,qBAAqB;IAChC,MAAM,QAAQ;IACd,IAAI,QAAQ;IACZ,IAAI,SAAS;CACb;AAED,MAAM,MAAM,mBAAmB,GAAG;IACjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAEjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,gDAAgD;IAChD,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAC5B,CAAC;AAQF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CACjC,GAAG,EAAE,QAAQ,EACb,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,EACtB,OAAO,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CA2CnB"}

package/dist/fs/compress-file.js

@@ -0,0 +1,72 @@
+import { createReadStream, createWriteStream } from "node:fs";
+import { unlink } from "node:fs/promises";
+import { createBrotliCompress, createGzip, createZstdCompress, } from "node:zlib";
+import { defaults } from "@ac-kit/core";
+export var CompressFileExtension;
+(function (CompressFileExtension) {
+    CompressFileExtension["BROTLI"] = ".br";
+    CompressFileExtension["GZIP"] = ".gz";
+    CompressFileExtension["ZSTD"] = ".zst";
+})(CompressFileExtension || (CompressFileExtension = {}));
+const COMPRESS_FILE_DEFAULT_OPTIONS = {
+    fileType: CompressFileExtension.GZIP,
+    keepSource: false,
+    signal: null,
+};
+/**
+ * Compress a file using the specified compression algorithm.
+ *
+ * The destination file path can be omitted, in which case it will be generated
+ * by appending the appropriate file extension to the source file path.
+ *
+ * By default, the source file will be deleted after compression. This can be
+ * changed by setting the `keepSource` option to `true`.
+ *
+ * Supported compression algorithms are Brotli, Gzip, and Zstd.
+ *
+ * @param src The path to the source file.
+ * @param dest The path to the destination file. If omitted, it will be
+ *   generated by appending the appropriate file extension to the source file
+ *   path.
+ * @param options Compression options.
+ * @returns The path to the compressed file.
+ */
+export async function compressFile(src, dest, options) {
+    const effectiveOptions = defaults(options, COMPRESS_FILE_DEFAULT_OPTIONS);
+    if (!dest) {
+        if (src instanceof URL) {
+            dest = new URL(src);
+            dest.pathname += effectiveOptions.fileType;
+        }
+        else if (Buffer.isBuffer(src)) {
+            dest = Buffer.concat([src, Buffer.from(effectiveOptions.fileType)]);
+        }
+        else {
+            dest = `${src}${effectiveOptions.fileType}`;
+        }
+    }
+    let compressionStream;
+    switch (effectiveOptions.fileType) {
+        case CompressFileExtension.BROTLI:
+            compressionStream = createBrotliCompress();
+            break;
+        case CompressFileExtension.GZIP:
+            compressionStream = createGzip();
+            break;
+        case CompressFileExtension.ZSTD:
+            compressionStream = createZstdCompress();
+            break;
+    }
+    await new Promise((resolve, reject) => {
+        createReadStream(src, { signal: effectiveOptions.signal ?? undefined })
+            .pipe(compressionStream)
+            .pipe(createWriteStream(dest))
+            .once("error", reject)
+            .once("finish", resolve);
+    });
+    if (!options?.keepSource) {
+        await unlink(src);
+    }
+    return dest;
+}
+//# sourceMappingURL=compress-file.js.map

package/dist/fs/compress-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress-file.js","sourceRoot":"","sources":["../../src/fs/compress-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAiB,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EACN,oBAAoB,EACpB,UAAU,EACV,kBAAkB,GAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,CAAN,IAAY,qBAIX;AAJD,WAAY,qBAAqB;IAChC,uCAAc,CAAA;IACd,qCAAY,CAAA;IACZ,sCAAa,CAAA;AACd,CAAC,EAJW,qBAAqB,KAArB,qBAAqB,QAIhC;AAqBD,MAAM,6BAA6B,GAAkC;IACpE,QAAQ,EAAE,qBAAqB,CAAC,IAAI;IACpC,UAAU,EAAE,KAAK;IACjB,MAAM,EAAE,IAAI;CACZ,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,GAAa,EACb,IAAsB,EACtB,OAA6B;IAE7B,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,EAAE,6BAA6B,CAAC,CAAC;IAE1E,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,IAAI,GAAG,YAAY,GAAG,EAAE,CAAC;YACxB,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YACpB,IAAI,CAAC,QAAQ,IAAI,gBAAgB,CAAC,QAAQ,CAAC;QAC5C,CAAC;aAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACP,IAAI,GAAG,GAAG,GAAG,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAC;QAC7C,CAAC;IACF,CAAC;IAED,IAAI,iBAA4B,CAAC;IAEjC,QAAQ,gBAAgB,CAAC,QAAQ,EAAE,CAAC;QACnC,KAAK,qBAAqB,CAAC,MAAM;YAChC,iBAAiB,GAAG,oBAAoB,EAAE,CAAC;YAC3C,MAAM;QAEP,KAAK,qBAAqB,CAAC,IAAI;YAC9B,iBAAiB,GAAG,UAAU,EAAE,CAAC;YACjC,MAAM;QAEP,KAAK,qBAAqB,CAAC,IAAI;YAC9B,iBAAiB,GAAG,kBAAkB,EAAE,CAAC;YACzC,MAAM;IACR,CAAC;IAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,gBAAgB,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,gBAAgB,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;aACrE,IAAI,CAAC,iBAAiB,CAAC;aACvB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;aAC7B,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;aACrB,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;QAC1B,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/fs/create-temp-dir.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Creates a fresh temporary directory named `<prefix>-XXXXXX`.
+ *
+ * @param prefix The prefix for the temporary directory name.
+ * @param parentDirectory Directory to create it under. Defaults to the OS
+ *   temporary directory. Pass the eventual destination's own filesystem when
+ *   the directory is staging for a `rename`, which is only atomic within one
+ *   filesystem.
+ * @returns A promise that resolves to the path of the newly created temporary
+ *   directory.
+ */
+export declare function createTempDir(prefix: string, parentDirectory?: string): Promise<string>;
+//# sourceMappingURL=create-temp-dir.d.ts.map

package/dist/fs/create-temp-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-temp-dir.d.ts","sourceRoot":"","sources":["../../src/fs/create-temp-dir.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CAEjB"}

package/dist/fs/create-temp-dir.js

@@ -0,0 +1,18 @@
+import { mkdtemp } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+/**
+ * Creates a fresh temporary directory named `<prefix>-XXXXXX`.
+ *
+ * @param prefix The prefix for the temporary directory name.
+ * @param parentDirectory Directory to create it under. Defaults to the OS
+ *   temporary directory. Pass the eventual destination's own filesystem when
+ *   the directory is staging for a `rename`, which is only atomic within one
+ *   filesystem.
+ * @returns A promise that resolves to the path of the newly created temporary
+ *   directory.
+ */
+export function createTempDir(prefix, parentDirectory) {
+    return mkdtemp(join(parentDirectory ?? tmpdir(), `${prefix}-`));
+}
+//# sourceMappingURL=create-temp-dir.js.map

package/dist/fs/create-temp-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-temp-dir.js","sourceRoot":"","sources":["../../src/fs/create-temp-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC5B,MAAc,EACd,eAAwB;IAExB,OAAO,OAAO,CAAC,IAAI,CAAC,eAAe,IAAI,MAAM,EAAE,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC;AACjE,CAAC"}

package/dist/fs/escape-path.d.ts

@@ -0,0 +1,19 @@
+export type EscapePathFn = (str: string, replacement?: string) => string;
+/**
+ * Escapes a string to be used as a safe file or directory name.
+ *
+ * It replaces any characters that are not allowed in file or directory names
+ * with an underscore (_). It also ensures that the name does not exceed the
+ * maximum length allowed by the operating system (255 characters).
+ *
+ * On POSIX systems, it replaces / and null characters. On Windows systems, it
+ * replaces < > : " / \ | ? * and control characters (0-31). It also avoids
+ * reserved names like CON, PRN, AUX, NUL, COM1, LPT1, etc.
+ *
+ * @param str The string to escape
+ * @returns The escaped string
+ * @see https://stackoverflow.com/questions/1976007/what-characters-are-forbidden-in-windows-and-linux-directory-names
+ * @see https://en.wikipedia.org/wiki/Comparison_of_file_systems#Limits
+ */
+export declare const escapePath: EscapePathFn;
+//# sourceMappingURL=escape-path.d.ts.map