@ac-kit/core 0.1.0

package/dist/pattern/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pattern/types.ts"],"names":[],"mappings":""}

package/dist/polyfill/math-sum-precise.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Exactly-rounded sum of `values` — the result is the binary64 nearest to the
+ * true mathematical sum, as if every addition were performed at infinite
+ * precision and rounded once at the end.
+ *
+ * A polyfill of the `Math.sumPrecise` proposal, using Shewchuk's
+ * partial-expansion algorithm (the one behind Python's `math.fsum`): each term
+ * is folded into a list of non-overlapping partial sums that together represent
+ * the running total exactly. See {@link PreciseSum} for the same algorithm as
+ * an accumulator, for loops that feed several totals at once.
+ *
+ * **When to reach for it, and when to let the caller decide.** A naive `+=`
+ * loop loses accuracy through cancellation, not through length: summing a
+ * million same-signed values of similar magnitude is nearly exact, while
+ * summing three values that nearly cancel can lose every significant bit.
+ *
+ * - Use it **unconditionally** where terms differ in sign or in magnitude —
+ *   squared deviations from a mean, reciprocals, logarithms, inverse-variance
+ *   weights. There the naive answer can be arbitrarily wrong, so speed is not a
+ *   trade worth offering.
+ * - Offer the caller a **choice** only where the summation is a documented hot
+ *   path _and_ the terms are known to share a sign and a magnitude, which is
+ *   the case where naive summation is already close to exact.
+ * - Never offer the choice merely because the input may be large. Length alone
+ *   does not motivate it, and an option that nobody can answer correctly is
+ *   worse than no option.
+ *
+ * O(n·k) additions, where k is the number of live partials — 1 or 2 for
+ * well-conditioned input, and bounded by the exponent range at worst.
+ *
+ * Intermediate overflow is compensated: a running partial that leaves the
+ * finite range is counted rather than lost, so `[MAX_VALUE, MAX_VALUE,
+ * -MAX_VALUE, -MAX_VALUE]` answers `0` where a naive sum answers `NaN` and
+ * Python's `math.fsum` refuses the case outright.
+ *
+ * Exact summation only removes the error of the **additions**. When the terms
+ * are themselves products, round each one first with `@ac-kit/math-scalar`'s
+ * `diffOfProducts` or `sumOfProducts`; a term that arrives already wrong cannot
+ * be recovered here.
+ *
+ * @param values The terms to add.
+ * @returns The exactly-rounded sum. `-0` for an empty input, matching the
+ *   proposal; `NaN` if any term is `NaN` or if both infinities are present.
+ */
+export declare function sumPrecise(values: Iterable<number>): number;
+//# sourceMappingURL=math-sum-precise.d.ts.map

package/dist/polyfill/math-sum-precise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math-sum-precise.d.ts","sourceRoot":"","sources":["../../src/polyfill/math-sum-precise.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAQ3D"}

package/dist/polyfill/math-sum-precise.js

@@ -0,0 +1,53 @@
+import { PreciseSum } from "../number/precise-sum.js";
+/**
+ * Exactly-rounded sum of `values` — the result is the binary64 nearest to the
+ * true mathematical sum, as if every addition were performed at infinite
+ * precision and rounded once at the end.
+ *
+ * A polyfill of the `Math.sumPrecise` proposal, using Shewchuk's
+ * partial-expansion algorithm (the one behind Python's `math.fsum`): each term
+ * is folded into a list of non-overlapping partial sums that together represent
+ * the running total exactly. See {@link PreciseSum} for the same algorithm as
+ * an accumulator, for loops that feed several totals at once.
+ *
+ * **When to reach for it, and when to let the caller decide.** A naive `+=`
+ * loop loses accuracy through cancellation, not through length: summing a
+ * million same-signed values of similar magnitude is nearly exact, while
+ * summing three values that nearly cancel can lose every significant bit.
+ *
+ * - Use it **unconditionally** where terms differ in sign or in magnitude —
+ *   squared deviations from a mean, reciprocals, logarithms, inverse-variance
+ *   weights. There the naive answer can be arbitrarily wrong, so speed is not a
+ *   trade worth offering.
+ * - Offer the caller a **choice** only where the summation is a documented hot
+ *   path _and_ the terms are known to share a sign and a magnitude, which is
+ *   the case where naive summation is already close to exact.
+ * - Never offer the choice merely because the input may be large. Length alone
+ *   does not motivate it, and an option that nobody can answer correctly is
+ *   worse than no option.
+ *
+ * O(n·k) additions, where k is the number of live partials — 1 or 2 for
+ * well-conditioned input, and bounded by the exponent range at worst.
+ *
+ * Intermediate overflow is compensated: a running partial that leaves the
+ * finite range is counted rather than lost, so `[MAX_VALUE, MAX_VALUE,
+ * -MAX_VALUE, -MAX_VALUE]` answers `0` where a naive sum answers `NaN` and
+ * Python's `math.fsum` refuses the case outright.
+ *
+ * Exact summation only removes the error of the **additions**. When the terms
+ * are themselves products, round each one first with `@ac-kit/math-scalar`'s
+ * `diffOfProducts` or `sumOfProducts`; a term that arrives already wrong cannot
+ * be recovered here.
+ *
+ * @param values The terms to add.
+ * @returns The exactly-rounded sum. `-0` for an empty input, matching the
+ *   proposal; `NaN` if any term is `NaN` or if both infinities are present.
+ */
+export function sumPrecise(values) {
+    const total = new PreciseSum();
+    for (const value of values) {
+        total.add(value);
+    }
+    return total.value;
+}
+//# sourceMappingURL=math-sum-precise.js.map

package/dist/polyfill/math-sum-precise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math-sum-precise.js","sourceRoot":"","sources":["../../src/polyfill/math-sum-precise.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,UAAU,UAAU,CAAC,MAAwB;IAClD,MAAM,KAAK,GAAG,IAAI,UAAU,EAAE,CAAC;IAE/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC;AACpB,CAAC"}

package/dist/promise/promise-to-async-iterable-iterator.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Converts a promise to an async iterable iterator that yields the resolved
+ * value once.
+ *
+ * @param promise The promise to convert.
+ * @returns An async iterable iterator that yields the resolved value of the
+ *   promise once.
+ */
+export declare function promiseValueToAsyncIterableIterator<T>(promise: PromiseLike<T>): AsyncIterableIterator<T>;
+//# sourceMappingURL=promise-to-async-iterable-iterator.d.ts.map

package/dist/promise/promise-to-async-iterable-iterator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise-to-async-iterable-iterator.d.ts","sourceRoot":"","sources":["../../src/promise/promise-to-async-iterable-iterator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CAAC,CAAC,EACpD,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GACrB,qBAAqB,CAAC,CAAC,CAAC,CAe1B"}

package/dist/promise/promise-to-async-iterable-iterator.js

@@ -0,0 +1,24 @@
+/**
+ * Converts a promise to an async iterable iterator that yields the resolved
+ * value once.
+ *
+ * @param promise The promise to convert.
+ * @returns An async iterable iterator that yields the resolved value of the
+ *   promise once.
+ */
+export function promiseValueToAsyncIterableIterator(promise) {
+    let done = false;
+    return {
+        async next() {
+            if (done) {
+                return { value: undefined, done: true };
+            }
+            done = true;
+            return { value: await promise, done: false };
+        },
+        [Symbol.asyncIterator]() {
+            return this;
+        },
+    };
+}
+//# sourceMappingURL=promise-to-async-iterable-iterator.js.map

package/dist/promise/promise-to-async-iterable-iterator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise-to-async-iterable-iterator.js","sourceRoot":"","sources":["../../src/promise/promise-to-async-iterable-iterator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,mCAAmC,CAClD,OAAuB;IAEvB,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,OAAO;QACN,KAAK,CAAC,IAAI;YACT,IAAI,IAAI,EAAE,CAAC;gBACV,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACzC,CAAC;YAED,IAAI,GAAG,IAAI,CAAC;YACZ,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QAC9C,CAAC;QACD,CAAC,MAAM,CAAC,aAAa,CAAC;YACrB,OAAO,IAAI,CAAC;QACb,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/promise/waiter-queue.d.ts

@@ -0,0 +1,40 @@
+/**
+ * A FIFO queue of pending promise resolvers, with abort-signal cancellation
+ * built in once.
+ *
+ * @template T The value a released waiter's promise resolves with.
+ * @template E Per-waiter metadata a release policy can inspect via `peek` or
+ *   `releaseMatching` — e.g. how many permits a `Semaphore` acquisition needs,
+ *   or the target value a `Counter` wait is for. Defaults to `void` for
+ *   policies with nothing to inspect (a plain FIFO release, as `Mutex` and
+ *   `Condition` use).
+ */
+export declare class WaiterQueue<T = void, E = void> {
+    private readonly entries;
+    /** Number of waiters currently queued. */
+    get size(): number;
+    /** The metadata of the longest-waiting entry, or `undefined` if empty. */
+    peek(): E | undefined;
+    /**
+     * Registers a new waiter and returns a promise that resolves with the value
+     * passed to whichever release call resolves it, or rejects if `signal` aborts
+     * first.
+     *
+     * @param extra Per-waiter metadata, inspected later via `peek` or
+     *   `releaseMatching`.
+     * @param signal Optional abort signal to cancel the wait.
+     */
+    enqueue(extra: E, signal?: AbortSignal | null): Promise<T>;
+    /** Removes and resolves the longest-waiting entry, if any. */
+    releaseNext(value: T): boolean;
+    /** Removes and resolves every currently queued entry, in queue order. */
+    releaseAll(value: T): number;
+    /**
+     * Removes and resolves every entry whose metadata matches `predicate`, in
+     * queue order — for release policies that aren't a FIFO prefix (e.g.
+     * `Counter`, which releases whichever waiters target the new value,
+     * regardless of queue position).
+     */
+    releaseMatching(predicate: (extra: E) => boolean, value: T): number;
+}
+//# sourceMappingURL=waiter-queue.d.ts.map

package/dist/promise/waiter-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiter-queue.d.ts","sourceRoot":"","sources":["../../src/promise/waiter-queue.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAE9C,0CAA0C;IAC1C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,0EAA0E;IAC1E,IAAI,IAAI,CAAC,GAAG,SAAS,CAEpB;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CA0BzD;IAED,8DAA8D;IAC9D,WAAW,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAI7B;IAED,yEAAyE;IACzE,UAAU,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,CAM3B;IAED;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAelE;CACD"}

package/dist/promise/waiter-queue.js

@@ -0,0 +1,90 @@
+/**
+ * A FIFO queue of pending promise resolvers, with abort-signal cancellation
+ * built in once.
+ *
+ * @template T The value a released waiter's promise resolves with.
+ * @template E Per-waiter metadata a release policy can inspect via `peek` or
+ *   `releaseMatching` — e.g. how many permits a `Semaphore` acquisition needs,
+ *   or the target value a `Counter` wait is for. Defaults to `void` for
+ *   policies with nothing to inspect (a plain FIFO release, as `Mutex` and
+ *   `Condition` use).
+ */
+export class WaiterQueue {
+    entries = [];
+    /** Number of waiters currently queued. */
+    get size() {
+        return this.entries.length;
+    }
+    /** The metadata of the longest-waiting entry, or `undefined` if empty. */
+    peek() {
+        return this.entries[0]?.extra;
+    }
+    /**
+     * Registers a new waiter and returns a promise that resolves with the value
+     * passed to whichever release call resolves it, or rejects if `signal` aborts
+     * first.
+     *
+     * @param extra Per-waiter metadata, inspected later via `peek` or
+     *   `releaseMatching`.
+     * @param signal Optional abort signal to cancel the wait.
+     */
+    enqueue(extra, signal) {
+        if (signal?.aborted) {
+            return Promise.reject(signal.reason);
+        }
+        return new Promise((resolve, reject) => {
+            const entry = { resolve, extra };
+            this.entries.push(entry);
+            if (signal) {
+                const handleAbort = () => {
+                    const index = this.entries.indexOf(entry);
+                    if (index !== -1) {
+                        this.entries.splice(index, 1);
+                    }
+                    reject(signal.reason);
+                };
+                signal.addEventListener("abort", handleAbort, { once: true });
+                // Removing the listener here — not a flag — is what keeps a settled
+                // waiter from being rejected again by a later abort.
+                entry.resolve = (value) => {
+                    signal.removeEventListener("abort", handleAbort);
+                    resolve(value);
+                };
+            }
+        });
+    }
+    /** Removes and resolves the longest-waiting entry, if any. */
+    releaseNext(value) {
+        const entry = this.entries.shift();
+        entry?.resolve(value);
+        return entry !== undefined;
+    }
+    /** Removes and resolves every currently queued entry, in queue order. */
+    releaseAll(value) {
+        const released = this.entries.splice(0, this.entries.length);
+        for (const entry of released) {
+            entry.resolve(value);
+        }
+        return released.length;
+    }
+    /**
+     * Removes and resolves every entry whose metadata matches `predicate`, in
+     * queue order — for release policies that aren't a FIFO prefix (e.g.
+     * `Counter`, which releases whichever waiters target the new value,
+     * regardless of queue position).
+     */
+    releaseMatching(predicate, value) {
+        const released = [];
+        for (let i = this.entries.length - 1; i >= 0; i--) {
+            if (predicate(this.entries[i].extra)) {
+                released.push(this.entries[i]);
+                this.entries.splice(i, 1);
+            }
+        }
+        for (let i = released.length - 1; i >= 0; i--) {
+            released[i].resolve(value);
+        }
+        return released.length;
+    }
+}
+//# sourceMappingURL=waiter-queue.js.map

package/dist/promise/waiter-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiter-queue.js","sourceRoot":"","sources":["../../src/promise/waiter-queue.ts"],"names":[],"mappings":"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"}

package/dist/set/fast-set.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A {@link Set}-like container that routes {@link PropertyKey} elements (string,
+ * number, symbol) to a null-prototype plain object and all other elements to a
+ * native {@link Set}.
+ *
+ * V8 stores integer-keyed properties on a null-prototype object as a packed C++
+ * elements array, making membership checks significantly faster than a
+ * hash-table-backed {@link Set} for bounded numeric ranges.
+ */
+export declare class FastSet<T> {
+    private hash;
+    private set;
+    constructor(iterable?: Iterable<T>);
+    has(value: T): boolean;
+    add(value: T): FastSet<T>;
+}
+//# sourceMappingURL=fast-set.d.ts.map

package/dist/set/fast-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fast-set.d.ts","sourceRoot":"","sources":["../../src/set/fast-set.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,qBAAa,OAAO,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAwC;IACpD,OAAO,CAAC,GAAG,CAAqB;IAEhC,YAAY,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAMjC;IAED,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAMrB;IAED,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CASxB;CACD"}

package/dist/set/fast-set.js

@@ -0,0 +1,38 @@
+import { isPropertyKey } from "../guards/is-property-key.js";
+/**
+ * A {@link Set}-like container that routes {@link PropertyKey} elements (string,
+ * number, symbol) to a null-prototype plain object and all other elements to a
+ * native {@link Set}.
+ *
+ * V8 stores integer-keyed properties on a null-prototype object as a packed C++
+ * elements array, making membership checks significantly faster than a
+ * hash-table-backed {@link Set} for bounded numeric ranges.
+ */
+export class FastSet {
+    hash;
+    set;
+    constructor(iterable) {
+        if (iterable !== undefined) {
+            for (const value of iterable) {
+                this.add(value);
+            }
+        }
+    }
+    has(value) {
+        if (isPropertyKey(value)) {
+            return this.hash?.[value] !== undefined;
+        }
+        return this.set?.has(value) ?? false;
+    }
+    add(value) {
+        if (isPropertyKey(value)) {
+            (this.hash ??= Object.create(null))[value] =
+                true;
+        }
+        else {
+            (this.set ??= new Set()).add(value);
+        }
+        return this;
+    }
+}
+//# sourceMappingURL=fast-set.js.map

package/dist/set/fast-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fast-set.js","sourceRoot":"","sources":["../../src/set/fast-set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,OAAO,OAAO;IACX,IAAI,CAAwC;IAC5C,GAAG,CAAqB;IAEhC,YAAY,QAAsB;QACjC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC5B,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;gBAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;QACF,CAAC;IACF,CAAC;IAED,GAAG,CAAC,KAAQ;QACX,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC;QACzC,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;IACtC,CAAC;IAED,GAAG,CAAC,KAAQ;QACX,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAA8B,CAAC,CAAC,KAAK,CAAC;gBACtE,IAAI,CAAC;QACP,CAAC;aAAM,CAAC;YACP,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,GAAG,EAAK,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

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

@@ -0,0 +1,9 @@
+/**
+ * Escapes any characters in a path segment that are not allowed in file or
+ * directory names on POSIX-compliant systems.
+ *
+ * @param str The path segment to escape
+ * @returns The escaped path segment
+ */
+export declare function escapePosixPath(str: string, replacement?: string): string;
+//# sourceMappingURL=escape-posix-path.d.ts.map

package/dist/shell/fs/escape-posix-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-posix-path.d.ts","sourceRoot":"","sources":["../../../src/shell/fs/escape-posix-path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,SAAM,GAAG,MAAM,CAOtE"}

package/dist/shell/fs/escape-posix-path.js

@@ -0,0 +1,15 @@
+/**
+ * Escapes any characters in a path segment that are not allowed in file or
+ * directory names on POSIX-compliant systems.
+ *
+ * @param str The path segment to escape
+ * @returns The escaped path segment
+ */
+export function escapePosixPath(str, replacement = "_") {
+    if (str === "." || str === "..") {
+        str = `_${str}`;
+    }
+    // eslint-disable-next-line no-control-regex
+    return str.replace(/[/\x00]/g, replacement).substring(0, 255);
+}
+//# sourceMappingURL=escape-posix-path.js.map

package/dist/shell/fs/escape-posix-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-posix-path.js","sourceRoot":"","sources":["../../../src/shell/fs/escape-posix-path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,WAAW,GAAG,GAAG;IAC7D,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IACjB,CAAC;IAED,4CAA4C;IAC5C,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC/D,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Escapes any characters in a path segment that are not allowed in file or
+ * directory names on Windows.
+ *
+ * @param str The path segment to escape
+ * @returns The escaped path segment
+ */
+export declare function escapeWin32Path(str: string, replacement?: string): string;
+//# sourceMappingURL=escape-win32-path.d.ts.map

package/dist/shell/fs/escape-win32-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-win32-path.d.ts","sourceRoot":"","sources":["../../../src/shell/fs/escape-win32-path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,SAAM,GAAG,MAAM,CAYtE"}

package/dist/shell/fs/escape-win32-path.js

@@ -0,0 +1,18 @@
+/**
+ * Escapes any characters in a path segment that are not allowed in file or
+ * directory names on Windows.
+ *
+ * @param str The path segment to escape
+ * @returns The escaped path segment
+ */
+export function escapeWin32Path(str, replacement = "_") {
+    if (/^(con|prn|aux|nul|com[1-9]|lpt[1-9])(\..*)?$/i.test(str)) {
+        str = `${replacement}${str}`;
+    }
+    return (str
+        // eslint-disable-next-line no-control-regex
+        .replace(/[<>:"/\\|?*\x00-\x1F]/g, replacement)
+        .replace(/[ .]+$/, replacement)
+        .substring(0, 255));
+}
+//# sourceMappingURL=escape-win32-path.js.map

package/dist/shell/fs/escape-win32-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-win32-path.js","sourceRoot":"","sources":["../../../src/shell/fs/escape-win32-path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,WAAW,GAAG,GAAG;IAC7D,IAAI,+CAA+C,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/D,GAAG,GAAG,GAAG,WAAW,GAAG,GAAG,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO,CACN,GAAG;QACF,4CAA4C;SAC3C,OAAO,CAAC,wBAAwB,EAAE,WAAW,CAAC;SAC9C,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC;SAC9B,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CACnB,CAAC;AACH,CAAC"}

package/dist/shell/process/parse-env-variable.d.ts

@@ -0,0 +1,43 @@
+import type { EnvVariable, EnvVariableValue } from "./types.js";
+/**
+ * Parse a string as an environment variable definition.
+ *
+ * If the string does not contain an equal sign, the variable value will be
+ * null.
+ *
+ * @param value The environment variable string to parse.
+ * @returns The parsed environment variable.
+ */
+export declare function parseEnvVariable(value: string): EnvVariable;
+/**
+ * Parse a string value as an environment variable value.
+ *
+ * @param value The string value to parse.
+ * @returns The parsed string, number, bigint, boolean value, or null if the
+ *   input is null or empty.
+ */
+export declare function parseEnvVariableValue(value: string | undefined | null): EnvVariableValue;
+/**
+ * Parse a string value as a string environment variable value.
+ *
+ * @param value The string value to parse.
+ * @returns The parsed string value, or null if the value is null or empty.
+ */
+export declare function parseEnvVariableValueAsString(value: string | undefined | null): string | null;
+/**
+ * Parse a string value as a number or bigint environment variable value.
+ *
+ * @param value The string value to parse.
+ * @returns The parsed number or bigint value, or null if the value is not a
+ *   valid number or bigint representation.
+ */
+export declare function parseEnvVariableValueAsNumber(value: string | undefined | null): number | bigint | null;
+/**
+ * Parse a string value as a boolean environment variable value.
+ *
+ * @param value The string value to parse.
+ * @returns The parsed boolean value, or null if the value is not a valid
+ *   boolean representation.
+ */
+export declare function parseEnvVariableValueAsBool(value: string | undefined | null): boolean | null;
+//# sourceMappingURL=parse-env-variable.d.ts.map

package/dist/shell/process/parse-env-variable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-env-variable.d.ts","sourceRoot":"","sources":["../../../src/shell/process/parse-env-variable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAS3D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAC9B,gBAAgB,CAgBlB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC5C,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAC9B,MAAM,GAAG,IAAI,CAUf;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC5C,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAC9B,MAAM,GAAG,MAAM,GAAG,IAAI,CAuBxB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAC9B,OAAO,GAAG,IAAI,CAuBhB"}

package/dist/shell/process/parse-env-variable.js

@@ -0,0 +1,109 @@
+/**
+ * Parse a string as an environment variable definition.
+ *
+ * If the string does not contain an equal sign, the variable value will be
+ * null.
+ *
+ * @param value The environment variable string to parse.
+ * @returns The parsed environment variable.
+ */
+export function parseEnvVariable(value) {
+    const eqIndex = value.indexOf("=");
+    if (eqIndex === -1) {
+        return { name: value, value: null };
+    }
+    const name = value.substring(0, eqIndex);
+    const rawValue = value.substring(eqIndex + 1);
+    return { name, value: parseEnvVariableValue(rawValue) };
+}
+/**
+ * Parse a string value as an environment variable value.
+ *
+ * @param value The string value to parse.
+ * @returns The parsed string, number, bigint, boolean value, or null if the
+ *   input is null or empty.
+ */
+export function parseEnvVariableValue(value) {
+    if (!value) {
+        return null;
+    }
+    const num = parseEnvVariableValueAsNumber(value);
+    if (num !== null) {
+        return num;
+    }
+    const bool = parseEnvVariableValueAsBool(value);
+    if (bool !== null) {
+        return bool;
+    }
+    return parseEnvVariableValueAsString(value);
+}
+/**
+ * Parse a string value as a string environment variable value.
+ *
+ * @param value The string value to parse.
+ * @returns The parsed string value, or null if the value is null or empty.
+ */
+export function parseEnvVariableValueAsString(value) {
+    if (!value || value.length === 0) {
+        return null;
+    }
+    if (value.startsWith('"') && value.endsWith('"')) {
+        return JSON.parse(value);
+    }
+    return value;
+}
+/**
+ * Parse a string value as a number or bigint environment variable value.
+ *
+ * @param value The string value to parse.
+ * @returns The parsed number or bigint value, or null if the value is not a
+ *   valid number or bigint representation.
+ */
+export function parseEnvVariableValueAsNumber(value) {
+    if (!value) {
+        return null;
+    }
+    try {
+        const bn = BigInt(value);
+        if (bn >= BigInt(Number.MIN_SAFE_INTEGER) &&
+            bn <= BigInt(Number.MAX_SAFE_INTEGER)) {
+            return Number(bn);
+        }
+        return bn;
+    }
+    catch {
+        const num = Number(value);
+        if (!Number.isNaN(num)) {
+            return num;
+        }
+    }
+    return null;
+}
+/**
+ * Parse a string value as a boolean environment variable value.
+ *
+ * @param value The string value to parse.
+ * @returns The parsed boolean value, or null if the value is not a valid
+ *   boolean representation.
+ */
+export function parseEnvVariableValueAsBool(value) {
+    if (!value) {
+        return null;
+    }
+    switch (value.toLowerCase()) {
+        case "1":
+        case "true":
+        case "yes":
+        case "on":
+            return true;
+        case "0":
+        case "false":
+        case "no":
+        case "off":
+            return false;
+        default:
+            break;
+    }
+    return null;
+}
+//# sourceMappingURL=parse-env-variable.js.map

package/dist/shell/process/parse-env-variable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-env-variable.js","sourceRoot":"","sources":["../../../src/shell/process/parse-env-variable.ts"],"names":[],"mappings":"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"}

package/dist/shell/process/stringify-env-variable.d.ts

@@ -0,0 +1,50 @@
+import type { EnvVariableValue } from "./types.js";
+/**
+ * Stringify a string environment variable value.
+ *
+ * If the string contains spaces, quotes, or equal signs, it will be quoted.
+ *
+ * @param value The string value to stringify.
+ * @returns The stringified string value.
+ */
+export declare function stringifyEnvVariableStringValue(value: string): string;
+/**
+ * Stringify a number or bigint environment variable value.
+ *
+ * @param value The number or bigint value to stringify.
+ * @returns The stringified number or bigint value.
+ */
+export declare function stringifyEnvVariableNumberValue(value: number | bigint): string;
+export type EnvVariableBoolValueFlavor = "1/0" | "true/false" | "yes/no" | "on/off";
+/**
+ * Stringify a boolean environment variable value according to the specified
+ * flavor.
+ *
+ * @param value The boolean value to stringify.
+ * @param flavor The flavor to use for stringifying the boolean value.
+ * @returns The stringified boolean value.
+ */
+export declare function stringifyEnvVariableBoolValue(value: boolean, flavor: EnvVariableBoolValueFlavor): string;
+export type StringifyEnvVariableValueOptions = {
+    /** The flavor to use when stringifying boolean values. Defaults to "1/0". */
+    boolFlavor?: EnvVariableBoolValueFlavor;
+};
+/**
+ * Stringify an environment variable value.
+ *
+ * @param value The environment variable value.
+ * @param options Options for stringifying the value.
+ * @returns The stringified environment variable value.
+ */
+export declare function stringifyEnvVariableValue(value: EnvVariableValue, options?: StringifyEnvVariableValueOptions): string;
+export type StringifyEnvVariableOptions = StringifyEnvVariableValueOptions;
+/**
+ * Stringify an environment variable assignment (e.g., `KEY=value`)
+ *
+ * @param name The environment variable name.
+ * @param value The environment variable value.
+ * @param options Options for stringifying the value.
+ * @returns The stringified environment variable assignment.
+ */
+export declare function stringifyEnvVariable(name: string, value: EnvVariableValue, options?: StringifyEnvVariableOptions): string;
+//# sourceMappingURL=stringify-env-variable.d.ts.map