@sorrell/cli-utilities 1.0.43 → 1.0.47

package/Distribution/FileSystem/FileSystem.Internal.Types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @file      FileSystem.Types.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export type FDeletePhase = "Scanning" | "Deleting" | "Done";
+export type FDeleteEntryKind = "File" | "Directory" | "Other";
+export type FDeleteEntry = {
+    EntryPath: string;
+    Kind: FDeleteEntryKind;
+    Size: number;
+};
+export type FDeleteProgress = {
+    Phase: FDeletePhase;
+    CurrentPath: string | null;
+    DiscoveredEntries: number;
+    TotalEntries: number;
+    DeletedEntries: number;
+    TotalBytes: number;
+    DeletedBytes: number;
+};
+export type FTerminalDeleteProgressRenderer = {
+    Update: (Progress: FDeleteProgress) => void;
+    Error: (ErrorValue: unknown) => void;
+};
+//# sourceMappingURL=FileSystem.Internal.Types.d.ts.map

package/Distribution/FileSystem/FileSystem.Internal.Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystem.Internal.Types.d.ts","sourceRoot":"","sources":["../../Source/FileSystem/FileSystem.Internal.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAClB,UAAU,GACV,UAAU,GACV,MAAM,CAAC;AAEb,MAAM,MAAM,gBAAgB,GACtB,MAAM,GACN,WAAW,GACX,OAAO,CAAC;AAEd,MAAM,MAAM,YAAY,GACpB;IACI,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,MAAM,MAAM,eAAe,GACvB;IACI,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACxB,CAAC;AAEN,MAAM,MAAM,+BAA+B,GACvC;IACI,MAAM,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5C,KAAK,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC,CAAC"}

package/Distribution/FileSystem/FileSystem.Internal.Types.js

@@ -0,0 +1,8 @@
+/**
+ * @file      FileSystem.Types.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export {};
+//# sourceMappingURL=FileSystem.Internal.Types.js.map

package/Distribution/FileSystem/FileSystem.Internal.Types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystem.Internal.Types.js","sourceRoot":"","sources":["../../Source/FileSystem/FileSystem.Internal.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/Distribution/FileSystem/FileSystem.Internal.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @file      FileSystem.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { FDeleteEntry, FDeleteProgress, FTerminalDeleteProgressRenderer } from "./FileSystem.Internal.Types.js";
+import type { FDeleteWithProgressOptions } from "./FileSystem.Types.js";
+/**
+ * Determines whether a given {@link ErrorValue} represents a missing file error.
+ *
+ * @param ErrorValue - The value to test.
+ *
+ * @returns {boolean} Whether the given {@link ErrorValue} is an object representing
+ * a missing file error.
+ */
+export declare function IsMissingFileError(ErrorValue: unknown): boolean;
+/**
+ * Build a plan of files to delete, so that the deletion progress
+ * can be displayed to the user.
+ *
+ * @param RootPath - The root path of the files to delete.
+ * @param Progress - The {@link FDeleteProgress} object tracking the deletion.
+ * @param Options - The options for this deletion.
+ *
+ * @returns {Promise<Array<FDeleteEntry>>} The entries to delete.
+ */
+export declare function BuildDeletionPlan(RootPath: string, Progress: FDeleteProgress, Options: FDeleteWithProgressOptions): Promise<Array<FDeleteEntry>>;
+export declare function CreateScanningMessage(Progress: FDeleteProgress): string;
+export declare function CreateDeletingMessage(Progress: FDeleteProgress): string;
+export declare function CreateDoneMessage(Progress: FDeleteProgress): string;
+export declare function CreateErrorMessage(ErrorValue: unknown): string;
+export declare function FormatBytes(Bytes: number): string;
+export declare function CreateTerminalDeleteProgressRenderer(Options: FDeleteWithProgressOptions): FTerminalDeleteProgressRenderer;
+//# sourceMappingURL=FileSystem.Internal.d.ts.map

package/Distribution/FileSystem/FileSystem.Internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystem.Internal.d.ts","sourceRoot":"","sources":["../../Source/FileSystem/FileSystem.Internal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACR,YAAY,EACZ,eAAe,EACf,+BAA+B,EAClC,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAQ/D;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,0BAA0B,GACpC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAmE9B;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAGvE;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAWvE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAGnE;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAQ9D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAajD;AAED,wBAAgB,oCAAoC,CAChD,OAAO,EAAE,0BAA0B,GACpC,+BAA+B,CAuGjC"}

package/Distribution/FileSystem/FileSystem.Internal.js

@@ -0,0 +1,178 @@
+/**
+ * @file      FileSystem.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import * as Path from "path";
+import { progress as CreateProgress, spinner as CreateSpinner } from "@clack/prompts";
+import { promises as Fs } from "fs";
+/**
+ * Determines whether a given {@link ErrorValue} represents a missing file error.
+ *
+ * @param ErrorValue - The value to test.
+ *
+ * @returns {boolean} Whether the given {@link ErrorValue} is an object representing
+ * a missing file error.
+ */
+export function IsMissingFileError(ErrorValue) {
+    return (typeof ErrorValue === "object" &&
+        ErrorValue !== null &&
+        "code" in ErrorValue &&
+        ErrorValue.code === "ENOENT");
+}
+/**
+ * Build a plan of files to delete, so that the deletion progress
+ * can be displayed to the user.
+ *
+ * @param RootPath - The root path of the files to delete.
+ * @param Progress - The {@link FDeleteProgress} object tracking the deletion.
+ * @param Options - The options for this deletion.
+ *
+ * @returns {Promise<Array<FDeleteEntry>>} The entries to delete.
+ */
+export async function BuildDeletionPlan(RootPath, Progress, Options) {
+    const Entries = [];
+    /* eslint-disable-next-line jsdoc/require-jsdoc */
+    async function Visit(CurrentPath) {
+        Options.Signal?.throwIfAborted();
+        Progress.Phase = "Scanning";
+        Progress.CurrentPath = CurrentPath;
+        Options.OnProgress?.({ ...Progress });
+        let Stats;
+        try {
+            Stats = await Fs.lstat(CurrentPath);
+        }
+        catch (ErrorValue) {
+            if (IsMissingFileError(ErrorValue)) {
+                return;
+            }
+            throw ErrorValue;
+        }
+        if (Stats.isDirectory()) {
+            const Children = await Fs.readdir(CurrentPath, { withFileTypes: true });
+            for (const Child of Children) {
+                await Visit(Path.join(CurrentPath, Child.name));
+            }
+            Entries.push({
+                EntryPath: CurrentPath,
+                Kind: "Directory",
+                Size: 0
+            });
+        }
+        else {
+            const Size = Stats.isFile() ? Stats.size : 0;
+            Entries.push({
+                EntryPath: CurrentPath,
+                Kind: Stats.isFile() ? "File" : "Other",
+                Size
+            });
+            Progress.TotalBytes += Size;
+        }
+        Progress.DiscoveredEntries = Entries.length;
+        Options.OnProgress?.({ ...Progress });
+    }
+    await Visit(RootPath);
+    return Entries;
+}
+export function CreateScanningMessage(Progress) {
+    return `Scanning... ${Progress.DiscoveredEntries} entries, ${FormatBytes(Progress.TotalBytes)} found`;
+}
+export function CreateDeletingMessage(Progress) {
+    const Percent = Progress.TotalEntries === 0
+        ? 100
+        : (Progress.DeletedEntries / Progress.TotalEntries) * 100;
+    return (`Deleting... ${Progress.DeletedEntries}/${Progress.TotalEntries} entries ` +
+        `(${Percent.toFixed(1)}%), ` +
+        `${FormatBytes(Progress.DeletedBytes)} / ${FormatBytes(Progress.TotalBytes)}`);
+}
+export function CreateDoneMessage(Progress) {
+    return `Deleted ${Progress.DeletedEntries} entries, ${FormatBytes(Progress.DeletedBytes)}.`;
+}
+export function CreateErrorMessage(ErrorValue) {
+    if (ErrorValue instanceof Error) {
+        return `Delete failed: ${ErrorValue.message}`;
+    }
+    return "Delete failed.";
+}
+export function FormatBytes(Bytes) {
+    const Units = ["B", "KB", "MB", "GB", "TB"];
+    let Value = Bytes;
+    let UnitIndex = 0;
+    while (Value >= 1024 && UnitIndex < Units.length - 1) {
+        Value /= 1024;
+        UnitIndex += 1;
+    }
+    return `${Value.toFixed(UnitIndex === 0 ? 0 : 1)} ${Units[UnitIndex]}`;
+}
+export function CreateTerminalDeleteProgressRenderer(Options) {
+    if (Options.ShouldRenderTerminalProgress === false) {
+        return {
+            Error() {
+                return;
+            },
+            Update() {
+                return;
+            }
+        };
+    }
+    const ScanningSpinner = CreateSpinner({ indicator: "timer" });
+    let HasStartedScanningSpinner = false;
+    let HasStoppedScanningSpinner = false;
+    let DeletionProgress = null;
+    let LastRenderedDeletedEntries = 0;
+    return {
+        Error(ErrorValue) {
+            const Message = CreateErrorMessage(ErrorValue);
+            if (DeletionProgress !== null) {
+                DeletionProgress.error(Message);
+                return;
+            }
+            if (HasStartedScanningSpinner && !HasStoppedScanningSpinner) {
+                ScanningSpinner.stop(Message);
+            }
+        },
+        Update(Progress) {
+            if (Progress.Phase === "Scanning") {
+                const Message = CreateScanningMessage(Progress);
+                if (!HasStartedScanningSpinner) {
+                    ScanningSpinner.start(Message);
+                    HasStartedScanningSpinner = true;
+                }
+                else {
+                    ScanningSpinner.message(Message);
+                }
+                return;
+            }
+            if (!HasStoppedScanningSpinner) {
+                if (HasStartedScanningSpinner) {
+                    ScanningSpinner.stop(`Scanned ${Progress.DiscoveredEntries} entries ` +
+                        `(${FormatBytes(Progress.TotalBytes)}).`);
+                }
+                HasStoppedScanningSpinner = true;
+            }
+            if (Progress.Phase === "Deleting") {
+                if (DeletionProgress === null) {
+                    DeletionProgress = CreateProgress({
+                        max: Math.max(Progress.TotalEntries, 1),
+                        style: "block"
+                    });
+                    DeletionProgress.start(CreateDeletingMessage(Progress));
+                }
+                const DeletedEntryDelta = Progress.DeletedEntries - LastRenderedDeletedEntries;
+                if (DeletedEntryDelta > 0) {
+                    DeletionProgress.advance(DeletedEntryDelta, CreateDeletingMessage(Progress));
+                    LastRenderedDeletedEntries = Progress.DeletedEntries;
+                }
+                else {
+                    DeletionProgress.message(CreateDeletingMessage(Progress));
+                }
+                return;
+            }
+            if (DeletionProgress !== null) {
+                DeletionProgress.stop(CreateDoneMessage(Progress));
+            }
+        }
+    };
+}
+//# sourceMappingURL=FileSystem.Internal.js.map

package/Distribution/FileSystem/FileSystem.Internal.js.map

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

package/Distribution/FileSystem/FileSystem.Types.Internal.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @file      FileSystem.Types.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export type FDeletePhase = "Scanning" | "Deleting" | "Done";
+export type FDeleteEntryKind = "File" | "Directory" | "Other";
+export type FDeleteEntry = {
+    EntryPath: string;
+    Kind: FDeleteEntryKind;
+    Size: number;
+};
+export type FDeleteProgress = {
+    Phase: FDeletePhase;
+    CurrentPath: string | null;
+    DiscoveredEntries: number;
+    TotalEntries: number;
+    DeletedEntries: number;
+    TotalBytes: number;
+    DeletedBytes: number;
+};
+//# sourceMappingURL=FileSystem.Types.Internal.d.ts.map

package/Distribution/FileSystem/FileSystem.Types.Internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystem.Types.Internal.d.ts","sourceRoot":"","sources":["../../Source/FileSystem/FileSystem.Types.Internal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAClB,UAAU,GACV,UAAU,GACV,MAAM,CAAC;AAEb,MAAM,MAAM,gBAAgB,GACtB,MAAM,GACN,WAAW,GACX,OAAO,CAAC;AAEd,MAAM,MAAM,YAAY,GACpB;IACI,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,MAAM,MAAM,eAAe,GACvB;IACI,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACxB,CAAC"}

package/Distribution/FileSystem/FileSystem.Types.Internal.js

@@ -0,0 +1,8 @@
+/**
+ * @file      FileSystem.Types.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export {};
+//# sourceMappingURL=FileSystem.Types.Internal.js.map

package/Distribution/FileSystem/FileSystem.Types.Internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystem.Types.Internal.js","sourceRoot":"","sources":["../../Source/FileSystem/FileSystem.Types.Internal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/Distribution/FileSystem/FileSystem.Types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @file      FileSystem.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { FDeleteProgress } from "./FileSystem.Internal.Types.js";
+import type { TFunction } from "@sorrell/utilities/functional";
+/**
+ * @property {TFunction<FDeleteProgress>} OnProgress - The callback that is called
+ * upon deleting files.
+ * @property {boolean} ShouldRenderTerminalProgress - Should the progress be rendered
+ * in the terminal (default is `true`).
+ * @property {AbortSignal} Signal - A signal to abort the deletion.
+ */
+export type FDeleteWithProgressOptions = {
+    OnProgress?: TFunction<FDeleteProgress>;
+    ShouldRenderTerminalProgress?: boolean;
+    Signal?: AbortSignal;
+};
+//# sourceMappingURL=FileSystem.Types.d.ts.map

package/Distribution/FileSystem/FileSystem.Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystem.Types.d.ts","sourceRoot":"","sources":["../../Source/FileSystem/FileSystem.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,GAClC;IACI,UAAU,CAAC,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;IACxC,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB,CAAC"}

package/Distribution/FileSystem/FileSystem.Types.js

@@ -0,0 +1,8 @@
+/**
+ * @file      FileSystem.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export {};
+//# sourceMappingURL=FileSystem.Types.js.map

package/Distribution/FileSystem/FileSystem.Types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystem.Types.js","sourceRoot":"","sources":["../../Source/FileSystem/FileSystem.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/Distribution/FileSystem/FileSystem.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @file      FileSystem.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { FDeleteWithProgressOptions } from "./FileSystem.Types.js";
+/**
+ * Recursively delete a given {@link RootPath}, and display the progress in
+ * the terminal.
+ *
+ * @param RootPath - The path to recursively delete.
+ * @param Options - The {@link FDeleteWithProgressOptions} object specifying
+ * options for this deletion.
+ *
+ * @returns {Promise<void>} The {@link Promise} that is fulfilled upon the deletion
+ * of the given {@link RootPath}.
+ */
+export declare function DeleteWithProgress(RootPath: string, Options?: FDeleteWithProgressOptions): Promise<void>;
+//# sourceMappingURL=FileSystem.d.ts.map

package/Distribution/FileSystem/FileSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["../../Source/FileSystem/FileSystem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAKxE;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,0BAAgC,GAC1C,OAAO,CAAC,IAAI,CAAC,CA4Ef"}

package/Distribution/FileSystem/FileSystem.js

@@ -0,0 +1,76 @@
+/**
+ * @file      FileSystem.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import { BuildDeletionPlan, CreateTerminalDeleteProgressRenderer, IsMissingFileError } from "./FileSystem.Internal.js";
+import { promises as Fs } from "fs";
+/* eslint-disable jsdoc/require-example */
+/**
+ * Recursively delete a given {@link RootPath}, and display the progress in
+ * the terminal.
+ *
+ * @param RootPath - The path to recursively delete.
+ * @param Options - The {@link FDeleteWithProgressOptions} object specifying
+ * options for this deletion.
+ *
+ * @returns {Promise<void>} The {@link Promise} that is fulfilled upon the deletion
+ * of the given {@link RootPath}.
+ */
+export async function DeleteWithProgress(RootPath, Options = {}) {
+    const TerminalProgressRenderer = CreateTerminalDeleteProgressRenderer(Options);
+    const ProgressOptions = {
+        ...Options,
+        OnProgress(Progress) {
+            TerminalProgressRenderer.Update(Progress);
+            Options.OnProgress?.({ ...Progress });
+        }
+    };
+    const Progress = {
+        CurrentPath: null,
+        DeletedBytes: 0,
+        DeletedEntries: 0,
+        DiscoveredEntries: 0,
+        Phase: "Scanning",
+        TotalBytes: 0,
+        TotalEntries: 0
+    };
+    try {
+        const Entries = await BuildDeletionPlan(RootPath, Progress, ProgressOptions);
+        Progress.Phase = "Deleting";
+        Progress.TotalEntries = Entries.length;
+        Progress.CurrentPath = null;
+        ProgressOptions.OnProgress?.({ ...Progress });
+        for (const Entry of Entries) {
+            ProgressOptions.Signal?.throwIfAborted();
+            Progress.CurrentPath = Entry.EntryPath;
+            ProgressOptions.OnProgress?.({ ...Progress });
+            try {
+                if (Entry.Kind === "Directory") {
+                    await Fs.rmdir(Entry.EntryPath);
+                }
+                else {
+                    await Fs.unlink(Entry.EntryPath);
+                }
+            }
+            catch (ErrorValue) {
+                if (!IsMissingFileError(ErrorValue)) {
+                    throw ErrorValue;
+                }
+            }
+            Progress.DeletedEntries += 1;
+            Progress.DeletedBytes += Entry.Size;
+            ProgressOptions.OnProgress?.({ ...Progress });
+        }
+        Progress.Phase = "Done";
+        Progress.CurrentPath = null;
+        ProgressOptions.OnProgress?.({ ...Progress });
+    }
+    catch (ErrorValue) {
+        TerminalProgressRenderer.Error(ErrorValue);
+        throw ErrorValue;
+    }
+}
+/* eslint-enable jsdoc/require-example */
+//# sourceMappingURL=FileSystem.js.map

package/Distribution/FileSystem/FileSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystem.js","sourceRoot":"","sources":["../../Source/FileSystem/FileSystem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACH,iBAAiB,EACjB,oCAAoC,EACpC,kBAAkB,EACrB,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AAEpC,0CAA0C;AAE1C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACpC,QAAgB,EAChB,UAAsC,EAAG;IAGzC,MAAM,wBAAwB,GAC1B,oCAAoC,CAAC,OAAO,CAAC,CAAC;IAElD,MAAM,eAAe,GACjB;QACI,GAAG,OAAO;QACV,UAAU,CAAC,QAAyB;YAEhC,wBAAwB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC1C,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;QAC1C,CAAC;KACJ,CAAC;IAEN,MAAM,QAAQ,GACV;QACI,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE,CAAC;QACf,cAAc,EAAE,CAAC;QACjB,iBAAiB,EAAE,CAAC;QACpB,KAAK,EAAE,UAAU;QACjB,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,CAAC;KAClB,CAAC;IAEN,IACA,CAAC;QACG,MAAM,OAAO,GAAwB,MAAM,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;QAElG,QAAQ,CAAC,KAAK,GAAG,UAAU,CAAC;QAC5B,QAAQ,CAAC,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;QACvC,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC;QAC5B,eAAe,CAAC,UAAU,EAAE,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;QAE9C,KAAK,MAAM,KAAK,IAAI,OAAO,EAC3B,CAAC;YACG,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YAEzC,QAAQ,CAAC,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC;YACvC,eAAe,CAAC,UAAU,EAAE,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;YAE9C,IACA,CAAC;gBACG,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAC9B,CAAC;oBACG,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBACpC,CAAC;qBAED,CAAC;oBACG,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBACrC,CAAC;YACL,CAAC;YACD,OAAO,UAAU,EACjB,CAAC;gBACG,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,EACnC,CAAC;oBACG,MAAM,UAAU,CAAC;gBACrB,CAAC;YACL,CAAC;YAED,QAAQ,CAAC,cAAc,IAAI,CAAC,CAAC;YAC7B,QAAQ,CAAC,YAAY,IAAI,KAAK,CAAC,IAAI,CAAC;YAEpC,eAAe,CAAC,UAAU,EAAE,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;QAClD,CAAC;QAED,QAAQ,CAAC,KAAK,GAAG,MAAM,CAAC;QACxB,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC;QAC5B,eAAe,CAAC,UAAU,EAAE,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,UAAU,EACjB,CAAC;QACG,wBAAwB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,UAAU,CAAC;IACrB,CAAC;AACL,CAAC;AAED,yCAAyC"}

package/Distribution/FileSystem/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @file      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export * from "./FileSystem.js";
+export * from "./FileSystem.Types.js";
+//# sourceMappingURL=index.d.ts.map

package/Distribution/FileSystem/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../Source/FileSystem/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}

package/Distribution/FileSystem/index.js

@@ -0,0 +1,9 @@
+/**
+ * @file      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export * from "./FileSystem.js";
+export * from "./FileSystem.Types.js";
+//# sourceMappingURL=index.js.map

package/Distribution/FileSystem/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../Source/FileSystem/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}

package/Distribution/Git/Git.Internal.Types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @file      Git.Internal.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/** The data used in {@link RepoNotCleanError}. */
+export type FRepoNotCleanErrorData = Readonly<{
+    RepositoryPath: string;
+    StatusOutput: string;
+}>;
+//# sourceMappingURL=Git.Internal.Types.d.ts.map

package/Distribution/Git/Git.Internal.Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Git.Internal.Types.d.ts","sourceRoot":"","sources":["../../Source/Git/Git.Internal.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,kDAAkD;AAClD,MAAM,MAAM,sBAAsB,GAC9B,QAAQ,CAAC;IACL,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACxB,CAAC,CAAC"}

package/Distribution/Git/Git.Internal.Types.js

@@ -0,0 +1,8 @@
+/**
+ * @file      Git.Internal.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export {};
+//# sourceMappingURL=Git.Internal.Types.js.map

package/Distribution/Git/Git.Internal.Types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Git.Internal.Types.js","sourceRoot":"","sources":["../../Source/Git/Git.Internal.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/Distribution/Git/Git.Types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @file      Git.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { CommandExecutor, Error } from "@effect/platform";
+import type { RepoNotCleanError } from "./Git.js";
+import type { Effect } from "effect";
+/** The {@link Effect.Effect | effect} returned by {@link RequireCleanGitRepository}. */
+export type ERequireCleanRepo = Effect.Effect<void, RepoNotCleanError | Error.PlatformError, CommandExecutor.CommandExecutor>;
+//# sourceMappingURL=Git.Types.d.ts.map

package/Distribution/Git/Git.Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Git.Types.d.ts","sourceRoot":"","sources":["../../Source/Git/Git.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,KAAK,EAAE,iBAAiB,EAA6B,MAAM,UAAU,CAAC;AAC7E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,wFAAwF;AACxF,MAAM,MAAM,iBAAiB,GACzB,MAAM,CAAC,MAAM,CACT,IAAI,EACJ,iBAAiB,GAAG,KAAK,CAAC,aAAa,EACvC,eAAe,CAAC,eAAe,CAClC,CAAC"}

package/Distribution/Git/Git.Types.js

@@ -0,0 +1,8 @@
+/**
+ * @file      Git.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export {};
+//# sourceMappingURL=Git.Types.js.map

package/Distribution/Git/Git.Types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Git.Types.js","sourceRoot":"","sources":["../../Source/Git/Git.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/Distribution/Git/Git.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @file      Git.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { ERequireCleanRepo } from "./Git.Types.js";
+import type { FRepoNotCleanErrorData } from "./Git.Internal.Types.js";
+declare const RepoNotCleanError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "RepoNotCleanError";
+} & Readonly<A>;
+/** The error that is thrown when the current `git` repo must be clean, but is not. */
+export declare class RepoNotCleanError extends RepoNotCleanError_base<FRepoNotCleanErrorData> {
+}
+/**
+ * Get an {@link Effect.Effect | effect} that causes the program to fail if a given `git`
+ * repo is not clean.
+ *
+ * @param RepositoryPath - The *optional* path to a directory in the repository.  If no path is specified,
+ * then the current working directory is used.
+ *
+ * @returns {ERequireCleanRepo} An {@link Effect.Effect | effect} that causes the program to fail
+ * if the `git` repo at the given {@link RepositoryPath} (or CWD if no {@link RepositoryPath} is specified)
+ * is not clean.
+ */
+export declare function RequireCleanGitRepository(RepositoryPath?: string): ERequireCleanRepo;
+export {};
+//# sourceMappingURL=Git.d.ts.map

package/Distribution/Git/Git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Git.d.ts","sourceRoot":"","sources":["../../Source/Git/Git.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;;;;AAEtE,sFAAsF;AACtF,qBAAa,iBAAkB,SAAQ,uBAAsC,sBAAsB,CAAC;CAAI;AAIxG;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,iBAAiB,CA0BpF"}

package/Distribution/Git/Git.js

@@ -0,0 +1,43 @@
+/**
+ * @file      Git.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import { Data, Effect } from "effect";
+import { Command } from "@effect/platform";
+/** The error that is thrown when the current `git` repo must be clean, but is not. */
+export class RepoNotCleanError extends Data.TaggedError("RepoNotCleanError") {
+}
+;
+/* eslint-disable jsdoc/require-example */
+/**
+ * Get an {@link Effect.Effect | effect} that causes the program to fail if a given `git`
+ * repo is not clean.
+ *
+ * @param RepositoryPath - The *optional* path to a directory in the repository.  If no path is specified,
+ * then the current working directory is used.
+ *
+ * @returns {ERequireCleanRepo} An {@link Effect.Effect | effect} that causes the program to fail
+ * if the `git` repo at the given {@link RepositoryPath} (or CWD if no {@link RepositoryPath} is specified)
+ * is not clean.
+ */
+export function RequireCleanGitRepository(RepositoryPath) {
+    return Effect.gen(function* () {
+        if (RepositoryPath === undefined) {
+            RepositoryPath = process.cwd();
+        }
+        const StatusCommand = Command
+            .make("git", "status", "--porcelain=v1")
+            .pipe(Command.workingDirectory(RepositoryPath));
+        const StatusOutput = yield* Command.string(StatusCommand);
+        if (StatusOutput.trim().length > 0) {
+            return yield* Effect.fail(new RepoNotCleanError({
+                RepositoryPath,
+                StatusOutput
+            }));
+        }
+    });
+}
+/* eslint-enable jsdoc/require-example */
+//# sourceMappingURL=Git.js.map

package/Distribution/Git/Git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Git.js","sourceRoot":"","sources":["../../Source/Git/Git.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAI3C,sFAAsF;AACtF,MAAM,OAAO,iBAAkB,SAAQ,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAyB;CAAI;AAAA,CAAC;AAEzG,0CAA0C;AAE1C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CAAC,cAAuB;IAE7D,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAEvB,IAAI,cAAc,KAAK,SAAS,EAChC,CAAC;YACG,cAAc,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QACnC,CAAC;QAED,MAAM,aAAa,GACf,OAAO;aACF,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,CAAC;aACvC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAC;QAExD,MAAM,YAAY,GAAW,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAElE,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAClC,CAAC;YACG,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACrB,IAAI,iBAAiB,CAAC;gBAClB,cAAc;gBACd,YAAY;aACf,CAAC,CACL,CAAC;QACN,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC;AAED,yCAAyC"}

package/Distribution/Git/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @file      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export * from "./Git.js";
+export * from "./Git.Types.js";
+//# sourceMappingURL=index.d.ts.map

package/Distribution/Git/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../Source/Git/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"}

package/Distribution/Git/index.js

@@ -0,0 +1,9 @@
+/**
+ * @file      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export * from "./Git.js";
+export * from "./Git.Types.js";
+//# sourceMappingURL=index.js.map

package/Distribution/Git/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../Source/Git/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"}

package/Distribution/PackageConfig/PackageConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PackageConfig.d.ts","sourceRoot":"","sources":["../../Source/PackageConfig/PackageConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAmC,cAAc,IAAI,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AACjG,OAAO,KAAK,EAAyB,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGhG;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAC1B,YAAY,SAAS,eAAe,EACpC,WAAW,EAEX,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,KAAK,CAAC,EAC/D,eAAe,CAAC,EAAE,GAAI,MAAO,OAAO,GACrC,oBAAoB,CAAC,cAAc,CA+CrC"}
+{"version":3,"file":"PackageConfig.d.ts","sourceRoot":"","sources":["../../Source/PackageConfig/PackageConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAmC,cAAc,IAAI,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AACjG,OAAO,KAAK,EAAyB,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGhG;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAC1B,YAAY,SAAS,eAAe,EACpC,WAAW,EAEX,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,KAAK,CAAC,EAC/D,eAAe,CAAC,EAAE,GAAI,MAAO,OAAO,GACrC,oBAAoB,CAAC,cAAc,CAgDrC"}

package/Distribution/PackageConfig/PackageConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"PackageConfig.js","sourceRoot":"","sources":["../../Source/PackageConfig/PackageConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAEjG,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,cAAc,CAI1B,WAAmB,EACnB,cAA+D,EAC/D,eAAoC;IAGpC,MAAM,oBAAoB,GAA0B,2BAA2B,CAC3E,WAAW,EACX,cAAc,EACd,eAAe,CAClB,CAAC;IAEF,OAAO,oBAAoB,CAAC,IAAI,CAC5B;QACI,IAAI,EAAE,CAAQ,aAAmC,EAAE,EAAE;YAEjD,OAAO,oBAAoB,CAAC,IAAI,CAC5B,MAAM,CAAC,OAAO,CAAC,CAAC,QAA6C,EAAE,EAAE,CAC7D,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CACpC,CAAC;QACN,CAAC;QAED,SAAS,EAAE,oBAAoB,CAAC,QAAQ,CACpC;YACI,KAAK,EAAE,uBAAuB,CAAC,KAAK;YAEpC,IAAI,EAAE,CACF,YAAmC,EACnC,aAA6C,EAC7C,KAAc,EAChB,EAAE;gBAEA,OAAO,oBAAoB,CAAC,IAAI,CAC5B,MAAM,CAAC,OAAO,CAAC,CAAC,QAA6C,EAAE,EAAE,CAC7D,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,EAAE,KAAK,CAAC,CAC9D,CACJ,CAAC;YACN,CAAC;YAED,iBAAiB,EAAE,CAAC,YAAmC,EAAE,EAAE;gBAEvD,OAAO,oBAAoB,CAAC,IAAI,CAC5B,MAAM,CAAC,OAAO,CAAC,CAAC,QAA6C,EAAE,EAAE,CAC7D,QAAQ,CAAC,SAAS,CAAC,iBAAiB,CAAC,YAAY,CAAC,CACrD,CACJ,CAAC;YACN,CAAC;SACJ,CACJ;KACJ,CACJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"PackageConfig.js","sourceRoot":"","sources":["../../Source/PackageConfig/PackageConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAEjG,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,cAAc,CAI1B,WAAmB,EACnB,cAA+D,EAC/D,eAAoC;IAGpC,MAAM,oBAAoB,GACtB,2BAA2B,CACvB,WAAW,EACX,cAAc,EACd,eAAe,CAClB,CAAC;IAEN,OAAO,oBAAoB,CAAC,IAAI,CAC5B;QACI,IAAI,EAAE,CAAQ,aAAmC,EAAE,EAAE;YAEjD,OAAO,oBAAoB,CAAC,IAAI,CAC5B,MAAM,CAAC,OAAO,CAAC,CAAC,QAA6C,EAAE,EAAE,CAC7D,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CACpC,CAAC;QACN,CAAC;QAED,SAAS,EAAE,oBAAoB,CAAC,QAAQ,CACpC;YACI,KAAK,EAAE,uBAAuB,CAAC,KAAK;YAEpC,IAAI,EAAE,CACF,YAAmC,EACnC,aAA6C,EAC7C,KAAc,EAChB,EAAE;gBAEA,OAAO,oBAAoB,CAAC,IAAI,CAC5B,MAAM,CAAC,OAAO,CAAC,CAAC,QAA6C,EAAE,EAAE,CAC7D,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,EAAE,KAAK,CAAC,CAC9D,CACJ,CAAC;YACN,CAAC;YAED,iBAAiB,EAAE,CAAC,YAAmC,EAAE,EAAE;gBAEvD,OAAO,oBAAoB,CAAC,IAAI,CAC5B,MAAM,CAAC,OAAO,CAAC,CAAC,QAA6C,EAAE,EAAE,CAC7D,QAAQ,CAAC,SAAS,CAAC,iBAAiB,CAAC,YAAY,CAAC,CACrD,CACJ,CAAC;YACN,CAAC;SACJ,CACJ;KACJ,CACJ,CAAC;AACN,CAAC"}

package/Distribution/index.d.ts

@@ -4,10 +4,12 @@
  * @copyright (c) 2026 Gage Sorrell
  * @license   MIT
  */
-export * from "./Inquirer/Confirm.js";
 export * as Command from "./Command/index.js";
+export * as English from "./English/index.js";
+export * as PackageConfig from "./PackageConfig/index.js";
 export * as Listr from "./Listr/index.js";
-export * as Inquirer from "./Inquirer/index.js";
+export * as Fs from "./FileSystem/index.js";
+export * as Git from "./Git/index.js";
 export * as PseudoTerminal from "./PseudoTerminal/index.js";
 export * as Format from "./Format/index.js";
 export * as Ora from "./Ora/index.js";

package/Distribution/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../Source/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,uBAAuB,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../Source/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/Distribution/index.js

@@ -4,10 +4,12 @@
  * @copyright (c) 2026 Gage Sorrell
  * @license   MIT
  */
-export * from "./Inquirer/Confirm.js";
 export * as Command from "./Command/index.js";
+export * as English from "./English/index.js";
+export * as PackageConfig from "./PackageConfig/index.js";
 export * as Listr from "./Listr/index.js";
-export * as Inquirer from "./Inquirer/index.js";
+export * as Fs from "./FileSystem/index.js";
+export * as Git from "./Git/index.js";
 export * as PseudoTerminal from "./PseudoTerminal/index.js";
 export * as Format from "./Format/index.js";
 export * as Ora from "./Ora/index.js";

package/Distribution/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../Source/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,uBAAuB,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../Source/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/ReadMe.md

@@ -0,0 +1,17 @@
+*Copyright © 2026 Gage Sorrell.  Released under the [MIT license](./License.md).*
+
+# `@sorrell/cli-utilities`
+
+**Purpose.** General-purpose utilities for CLI applications, written in TypeScript.
+
+## Installation
+
+In your NodeJS project,
+
+```bash
+npm install @sorrell/cli-utilities
+```
+
+## Documentation
+
+`@TODO` [Documentation is available here.](https://link.sorrell.sh/cli-utils)

package/package.json

@@ -1,16 +1,19 @@
 {
   "name": "@sorrell/cli-utilities",
-  "version": "1.0.43",
-  "description": "Utilities for CLI tools.",
+  "version": "1.0.47",
+  "description": "Utilities developing CLI tools with TypeScript.",
   "keywords": [
     "cli",
     "utility",
     "utilities",
     "typescript",
     "ts",
+    "sorrell",
     "inquirer",
     "ora",
-    "commander"
+    "commander",
+    "clack",
+    "prompts"
   ],
   "homepage": "https://github.com/GageSorrell/SorrellWm/tree/Master/Package/CliUtilities",
   "bugs": {
@@ -40,6 +43,18 @@
       "require": "./Distribution/Format/index.js",
       "types": "./Distribution/Format/index.d.ts"
     },
+    "./fs": {
+      "default": "./Distribution/FileSystem/index.js",
+      "import": "./Distribution/FileSystem/index.js",
+      "require": "./Distribution/FileSystem/index.js",
+      "types": "./Distribution/FileSystem/index.d.ts"
+    },
+    "./git": {
+      "default": "./Distribution/Git/index.js",
+      "import": "./Distribution/Git/index.js",
+      "require": "./Distribution/Git/index.js",
+      "types": "./Distribution/Git/index.d.ts"
+    },
     "./inquirer": {
       "default": "./Distribution/Inquirer/index.js",
       "import": "./Distribution/Inquirer/index.js",
@@ -65,24 +80,18 @@
       "types": "./Distribution/PseudoTerminal/index.d.ts"
     }
   },
-  "main": "./Distribution/index.js",
-  "types": "./Distribution/index.d.ts",
   "scripts": {
     "build": "tsc -p tsconfig.json"
   },
   "devDependencies": {
-    "@types/node": "^25.5.0",
-    "@typescript/native-preview": "^7.0.0-dev.20260326.1",
+    "@types/node": "^24.12.2",
     "package-json-type": "^1.1.2"
   },
   "dependencies": {
+    "@clack/prompts": "^1.4.0",
     "@effect/platform": "^0.96.0",
-    "@inquirer/core": "^11.1.7",
-    "@inquirer/prompts": "^8.3.2",
-    "@inquirer/type": "^4.0.4",
     "@listr2/prompt-adapter-enquirer": "^4.2.1",
-    "@sorrell/inquirer-file-selector": "^1.0.4",
-    "@sorrell/utilities": "^1.1.60",
+    "@sorrell/utilities": "^1.2.4",
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
     "clipboardy": "^5.3.1",