@sorrell/cli-utilities 1.0.29 → 1.0.30

package/Distribution/English/English.Types.d.ts

@@ -0,0 +1,18 @@
+import type { Inflectors } from "en-inflectors";
+import type { TValues } from "@sorrell/utilities/misc";
+type InflectorFunctions = {
+    [Key in keyof Inflectors as Inflectors[Key] extends Function ? Key : never]: Key;
+};
+type InflectorFunctionsWithArgument = {
+    [Key in keyof Inflectors as Inflectors[Key] extends (Argument: string) => string ? Key : never]: Key;
+};
+type InflectorFunctionsNoArgument = {
+    [Key in keyof Inflectors as Inflectors[Key] extends () => string ? Key : never]: Key;
+};
+export type InflectorFunction = TValues<InflectorFunctions>;
+export declare namespace InflectorFunction {
+    type WithArgument = TValues<InflectorFunctionsWithArgument>;
+    type NoArgument = TValues<InflectorFunctionsNoArgument>;
+}
+export {};
+//# sourceMappingURL=English.Types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"English.Types.d.ts","sourceRoot":"","sources":["../../Source/English/English.Types.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,KAAK,kBAAkB,GACnB;KACM,GAAG,IAAI,MAAM,UAAU,IAAI,UAAU,CAAC,GAAG,CAAC,SAAS,QAAQ,GAAG,GAAG,GAAG,KAAK,GAC3E,GAAG;CACN,CAAC;AAEN,KAAK,8BAA8B,GAC/B;KACM,GAAG,IAAI,MAAM,UAAU,IAAI,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,GAAG,GAAG,KAAK,GAC/F,GAAG;CACN,CAAC;AAEN,KAAK,4BAA4B,GAC7B;KACM,GAAG,IAAI,MAAM,UAAU,IAAI,UAAU,CAAC,GAAG,CAAC,SAAS,MAAM,MAAM,GAAG,GAAG,GAAG,KAAK,GAC/E,GAAG;CACN,CAAC;AAEN,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAE5D,yBAAiB,iBAAiB,CAClC;IACI,KAAY,YAAY,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACnE,KAAY,UAAU,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;CAClE"}

package/Distribution/English/English.Types.js

@@ -0,0 +1,7 @@
+/* File:      English.Types.ts
+ * Author:    Gage Sorrell <gage@sorrell.sh>
+ * Copyright: (c) 2026 Gage Sorrell
+ * License:   MIT
+ */
+export {};
+//# sourceMappingURL=English.Types.js.map

package/Distribution/English/English.Types.js.map

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

package/Distribution/English/English.d.ts

@@ -0,0 +1,2 @@
+export declare const DummyEnglesh: "Foo";
+//# sourceMappingURL=English.d.ts.map

package/Distribution/English/English.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"English.d.ts","sourceRoot":"","sources":["../../Source/English/English.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,YAAY,EAAE,KAAsB,CAAC"}

package/Distribution/English/English.js

@@ -0,0 +1,7 @@
+/* File:      English.ts
+ * Author:    Gage Sorrell <gage@sorrell.sh>
+ * Copyright: (c) 2026 Gage Sorrell
+ * License:   MIT
+ */
+export const DummyEnglesh = "Foo";
+//# sourceMappingURL=English.js.map

package/Distribution/English/English.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"English.js","sourceRoot":"","sources":["../../Source/English/English.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAU,KAAc,CAAC"}

package/Distribution/English/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./English.js";
+export * from "./English.Types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../Source/English/index.ts"],"names":[],"mappings":"AAMA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/Distribution/English/index.js

@@ -0,0 +1,8 @@
+/* File:      index.ts
+ * Author:    Gage Sorrell <gage@sorrell.sh>
+ * Copyright: (c) 2026 Gage Sorrell
+ * License:   MIT
+ */
+export * from "./English.js";
+export * from "./English.Types.js";
+//# sourceMappingURL=index.js.map

package/Distribution/English/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../Source/English/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/Distribution/English.Types.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=English.Types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"English.Types.d.ts","sourceRoot":"","sources":["../Source/English.Types.ts"],"names":[],"mappings":""}

package/Distribution/English.Types.js

@@ -0,0 +1,8 @@
+/* File:      English.Types.ts
+ * Author:    Gage Sorrell <gage@sorrell.sh>
+ * Copyright: (c) 2026 Gage Sorrell
+ * License:   MIT
+ */
+export {};
+// export type InflectorFunction =
+//# sourceMappingURL=English.Types.js.map

package/Distribution/English.Types.js.map

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

package/Distribution/English.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=English.d.ts.map

package/Distribution/English.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"English.d.ts","sourceRoot":"","sources":["../Source/English.ts"],"names":[],"mappings":""}

package/Distribution/English.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=English.js.map

package/Distribution/English.js.map

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

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

@@ -0,0 +1,4 @@
+import type { Formatter } from "./Format.Types.js";
+/** The result of parsing a {@link FormatRules} object. */
+export type FormatRulesParsed = Map<string | RegExp, Formatter>;
+//# sourceMappingURL=Format.Internal.Types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Format.Internal.Types.d.ts","sourceRoot":"","sources":["../../Source/Format/Format.Internal.Types.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,0DAA0D;AAC1D,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,SAAS,CAAC,CAAC"}

package/Distribution/Format/Format.Internal.Types.js

@@ -0,0 +1,7 @@
+/* File:      Format.Internal.Types.ts
+ * Author:    Gage Sorrell <gage@sorrell.sh>
+ * Copyright: (c) 2026 Gage Sorrell
+ * License:   MIT
+ */
+export {};
+//# sourceMappingURL=Format.Internal.Types.js.map

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

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

package/Distribution/Format/Format.Internal.d.ts

@@ -0,0 +1,14 @@
+import type { FormatRules } from "./Format.Types.js";
+import type { FormatRulesParsed } from "./Format.Internal.Types.js";
+/**
+ * Parse a given {@link FormatRules} object into a `Map`, such that
+ * the keys of the given {@link Rules} that describe regular expressions
+ * are replaced by the `RegExp` objects that they describe.  Keys that
+ * correspond to substrings are left as-is.
+ *
+ * @param Rules - The given {@link FormatRules} to parse.
+ *
+ * @returns The parsed {@link FormatRules}, as a {@link FormatRulesParsed} `Map`.
+ */
+export declare function ParseFormatRules(Rules: FormatRules): FormatRulesParsed;
+//# sourceMappingURL=Format.Internal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Format.Internal.d.ts","sourceRoot":"","sources":["../../Source/Format/Format.Internal.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAkFpE;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAatE"}

package/Distribution/Format/Format.Internal.js

@@ -0,0 +1,78 @@
+/* File:      Format.Internal.ts
+ * Author:    Gage Sorrell <gage@sorrell.sh>
+ * Copyright: (c) 2026 Gage Sorrell
+ * License:   MIT
+ */
+/**
+ * @param Value - The given string to parse.
+ * @returns The parsed string or regular expression.
+ */
+function ParseStringOrRegularExpression(Value) {
+    if (Value.length < 2) {
+        return Value;
+    }
+    if (Value[0] !== "/") {
+        return Value;
+    }
+    const ClosingSlashIndex = GetClosingSlashIndex(Value);
+    if (ClosingSlashIndex <= 0) {
+        return Value;
+    }
+    const Pattern = Value.slice(1, ClosingSlashIndex);
+    const Flags = Value.slice(ClosingSlashIndex + 1);
+    try {
+        return new RegExp(Pattern, Flags);
+    }
+    catch {
+        return Value;
+    }
+}
+/**
+ * @param Value - The given `string` whose index of a closing slash is returned.
+ * @returns The index of the closing slash in the given `string`, or `-1` if there is no closing slash.
+ */
+function GetClosingSlashIndex(Value) {
+    for (let Index = Value.length - 1; Index >= 1; Index--) {
+        if (Value[Index] !== "/") {
+            continue;
+        }
+        if (!IsCharacterEscaped(Value, Index)) {
+            return Index;
+        }
+    }
+    return -1;
+}
+/**
+ * @param Value - The given `string` in which to check whether the character at the given `index` is escaped.
+ * @param Index - The index of the character to check.
+ * @returns Whether the given {@link Value} is escaped at the given {@link Index}.
+ */
+function IsCharacterEscaped(Value, Index) {
+    let BackslashCount = 0;
+    for (let CurrentIndex = Index - 1; CurrentIndex >= 0; CurrentIndex--) {
+        if (Value[CurrentIndex] !== "\\") {
+            break;
+        }
+        BackslashCount++;
+    }
+    return (BackslashCount % 2) === 1;
+}
+/**
+ * Parse a given {@link FormatRules} object into a `Map`, such that
+ * the keys of the given {@link Rules} that describe regular expressions
+ * are replaced by the `RegExp` objects that they describe.  Keys that
+ * correspond to substrings are left as-is.
+ *
+ * @param Rules - The given {@link FormatRules} to parse.
+ *
+ * @returns The parsed {@link FormatRules}, as a {@link FormatRulesParsed} `Map`.
+ */
+export function ParseFormatRules(Rules) {
+    const Out = new Map();
+    Object.entries(Rules).forEach(([Key, Formatter]) => {
+        const ParsedKey = ParseStringOrRegularExpression(Key);
+        Out.set(ParsedKey, Formatter);
+    });
+    return Out;
+}
+//# sourceMappingURL=Format.Internal.js.map

package/Distribution/Format/Format.Internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Format.Internal.js","sourceRoot":"","sources":["../../Source/Format/Format.Internal.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;GAGG;AACH,SAAS,8BAA8B,CAAC,KAAa;IAEjD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EACpB,CAAC;QACG,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,EACpB,CAAC;QACG,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,iBAAiB,GAAW,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAE9D,IAAI,iBAAiB,IAAI,CAAC,EAC1B,CAAC;QACG,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,GAAW,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAW,KAAK,CAAC,KAAK,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC;IAEzD,IACA,CAAC;QACG,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IACD,MACA,CAAC;QACG,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,KAAa;IAEvC,KAAK,IAAI,KAAK,GAAW,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAC9D,CAAC;QACG,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,EACxB,CAAC;YACG,SAAS;QACb,CAAC;QAED,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,EACrC,CAAC;YACG,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,OAAO,CAAC,CAAC,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,KAAa,EAAE,KAAa;IAEpD,IAAI,cAAc,GAAW,CAAC,CAAC;IAE/B,KAAK,IAAI,YAAY,GAAW,KAAK,GAAG,CAAC,EAAE,YAAY,IAAI,CAAC,EAAE,YAAY,EAAE,EAC5E,CAAC;QACG,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,IAAI,EAChC,CAAC;YACG,MAAM;QACV,CAAC;QAED,cAAc,EAAE,CAAC;IACrB,CAAC;IAED,OAAO,CAAC,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAkB;IAE/C,MAAM,GAAG,GAAoC,IAAI,GAAG,EAA8B,CAAC;IAInF,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,GAAG,EAAE,SAAS,CAAS,EAAQ,EAAE;QAE9D,MAAM,SAAS,GAAoB,8BAA8B,CAAC,GAAG,CAAC,CAAC;QACvE,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACf,CAAC"}

package/Distribution/Format/Format.Types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * A function that formats a given {@link Message | Message string}.
+ *
+ * @param Message - The given message to format.
+ *
+ * @returns The formatted message.
+ */
+export type Formatter = {
+    (Message: string): string;
+};
+/** A mapping of substrings or regular expressions to {@link Formatter | Formatters}. */
+export type FormatRules = Record<string, Formatter>;
+//# sourceMappingURL=Format.Types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Format.Types.d.ts","sourceRoot":"","sources":["../../Source/Format/Format.Types.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GACjB;IACI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B,CAAC;AAEN,wFAAwF;AACxF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC"}

package/Distribution/Format/Format.Types.js

@@ -0,0 +1,7 @@
+/* File:      Format.Types.ts
+ * Author:    Gage Sorrell <gage@sorrell.sh>
+ * Copyright: (c) 2026 Gage Sorrell
+ * License:   MIT
+ */
+export {};
+//# sourceMappingURL=Format.Types.js.map

package/Distribution/Format/Format.Types.js.map

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

package/Distribution/Format/Format.d.ts

@@ -0,0 +1,42 @@
+import type { FormatRules, Formatter } from "./Format.Types.js";
+/**
+ * Formats a given {@link Message} as code.
+ *
+ * @param Message - The given message to format.
+ *
+ * @returns The given {@link Message}, formatted to convey that it is code.
+ */
+export declare function Code(Message: string): string;
+/**
+ * Formats a given {@link Path} as a path.
+ *
+ * @note Currently, this is just an alias for {@link Code}.
+ *
+ * @param Path - The path to format.
+ *
+ * @returns The given {@link Path}, formatted to convey that it is a path.
+ */
+export declare function Path(Path: string): string;
+/**
+ * Format a given {@link Message} according to the given {@link Rules}.
+ *
+ * @param Message - The message to format.
+ * @param Rules - The {@link FormatRules} describing the transformations that should be made.
+ *
+ * @returns The formatted {@link Message}, such that every matched substring in {@link Rules}
+ * is formatted by the corresponding {@link Formatter}.
+ */
+export declare function Format(Message: string, Rules: FormatRules): string;
+/**
+ * Creates a function that formats a given `string` with the given {@link Rules}.
+ *
+ * @param Rules - The {@link FormatRules} used to format messages passed to the
+ * returned function.  If multiple are given, then the keys will be pooled.  If
+ * multiple {@link Rules} share a given key, then the respective formatter functions
+ * will be composed in the order of the given {@link Rules} objects.
+ *
+ * @returns A function that will format the `Message` passed to it according to the
+ * {@link Rules} passed to this function.
+ */
+export declare function MakeFormatter(...Rules: [FormatRules] | Array<FormatRules>): Formatter;
+//# sourceMappingURL=Format.d.ts.map

package/Distribution/Format/Format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Format.d.ts","sourceRoot":"","sources":["../../Source/Format/Format.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAiBhE;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,WAAW,GACnB,MAAM,CAYR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,GAAG,KAAK,EAAE,CAAE,WAAW,CAAE,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,SAAS,CAsCvF"}

package/Distribution/Format/Format.js

@@ -0,0 +1,95 @@
+/* File:      Format.ts
+ * Author:    Gage Sorrell <gage@sorrell.sh>
+ * Copyright: (c) 2026 Gage Sorrell
+ * License:   MIT
+ * Comment:   This module contains functions to output messages
+ *            to the user with consistent and aesthetic formatting.
+ */
+import Chalk from "chalk";
+import { ParseFormatRules } from "./Format.Internal.js";
+/**
+ * The base function for all functions exported by this module.
+ *
+ * @param Message - The input of the function in which this is called.
+ *
+ * @returns The given {@link Message} with base formatting applied.
+ */
+function FormatBase(Message) {
+    return Chalk.reset(Message);
+}
+/**
+ * Formats a given {@link Message} as code.
+ *
+ * @param Message - The given message to format.
+ *
+ * @returns The given {@link Message}, formatted to convey that it is code.
+ */
+export function Code(Message) {
+    return FormatBase(Chalk.red(Message));
+}
+/**
+ * Formats a given {@link Path} as a path.
+ *
+ * @note Currently, this is just an alias for {@link Code}.
+ *
+ * @param Path - The path to format.
+ *
+ * @returns The given {@link Path}, formatted to convey that it is a path.
+ */
+export function Path(Path) {
+    return Code(Chalk.red(Path));
+}
+/**
+ * Format a given {@link Message} according to the given {@link Rules}.
+ *
+ * @param Message - The message to format.
+ * @param Rules - The {@link FormatRules} describing the transformations that should be made.
+ *
+ * @returns The formatted {@link Message}, such that every matched substring in {@link Rules}
+ * is formatted by the corresponding {@link Formatter}.
+ */
+export function Format(Message, Rules) {
+    Message = FormatBase(Message);
+    const RulesParsed = ParseFormatRules(Rules);
+    for (const [Match, Formatter] of RulesParsed) {
+        Message = Message.replaceAll(Match, Formatter);
+    }
+    return Message;
+}
+/**
+ * Creates a function that formats a given `string` with the given {@link Rules}.
+ *
+ * @param Rules - The {@link FormatRules} used to format messages passed to the
+ * returned function.  If multiple are given, then the keys will be pooled.  If
+ * multiple {@link Rules} share a given key, then the respective formatter functions
+ * will be composed in the order of the given {@link Rules} objects.
+ *
+ * @returns A function that will format the `Message` passed to it according to the
+ * {@link Rules} passed to this function.
+ */
+export function MakeFormatter(...Rules) {
+    /* eslint-disable-next-line jsdoc/require-jsdoc */
+    function ComposeRules() {
+        if (Rules.length === 1) {
+            return Rules[0];
+        }
+        return Rules.reduce((PreviousValue, CurrentValue) => {
+            const NewValue = { ...PreviousValue };
+            Object.keys(CurrentValue).forEach((Key) => {
+                if (Key in NewValue && PreviousValue[Key] !== undefined && CurrentValue[Key] !== undefined) {
+                    const OriginalFunction = PreviousValue[Key];
+                    const CurrentFunction = CurrentValue[Key];
+                    NewValue[Key] = function (Message) {
+                        return CurrentFunction(OriginalFunction(Message));
+                    };
+                }
+            });
+            return NewValue;
+        }, {});
+    }
+    const OutRules = ComposeRules();
+    return function (Message) {
+        return Format(Message, OutRules);
+    };
+}
+//# sourceMappingURL=Format.js.map

package/Distribution/Format/Format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Format.js","sourceRoot":"","sources":["../../Source/Format/Format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;;GAMG;AACH,SAAS,UAAU,CAAC,OAAe;IAE/B,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,IAAI,CAAC,OAAe;IAEhC,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,IAAI,CAAC,IAAY;IAE7B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAClB,OAAe,EACf,KAAkB;IAGlB,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAE9B,MAAM,WAAW,GAAsB,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAE/D,KAAK,MAAM,CAAE,KAAK,EAAE,SAAS,CAAE,IAAI,WAAW,EAC9C,CAAC;QACG,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,GAAG,KAA2C;IAExE,kDAAkD;IAClD,SAAS,YAAY;QAEjB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EACtB,CAAC;YACG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QAED,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,aAA0B,EAAE,YAAyB,EAAe,EAAE;YAEvF,MAAM,QAAQ,GAAgB,EAAE,GAAG,aAAa,EAAE,CAAC;YAEnD,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,GAAW,EAAQ,EAAE;gBAEpD,IAAI,GAAG,IAAI,QAAQ,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,SAAS,EAC1F,CAAC;oBACG,MAAM,gBAAgB,GAAc,aAAa,CAAC,GAAG,CAAC,CAAC;oBACvD,MAAM,eAAe,GAAc,YAAY,CAAC,GAAG,CAAC,CAAC;oBAErD,QAAQ,CAAC,GAAG,CAAC,GAAG,UAAS,OAAe;wBAEpC,OAAO,eAAe,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;oBACtD,CAAC,CAAC;gBACN,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC;QACpB,CAAC,EAAE,EAAG,CAAC,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAgB,YAAY,EAAE,CAAC;IAE7C,OAAO,UAAS,OAAe;QAE3B,OAAO,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC,CAAC;AACN,CAAC"}

package/Distribution/Format/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./Format.js";
+export * from "./Format.Types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../Source/Format/index.ts"],"names":[],"mappings":"AAMA,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC"}

package/Distribution/Format/index.js

@@ -0,0 +1,8 @@
+/* File:      index.ts
+ * Author:    Gage Sorrell <gage@sorrell.sh>
+ * Copyright: (c) 2026 Gage Sorrell
+ * License:   MIT
+ */
+export * from "./Format.js";
+export * from "./Format.Types.js";
+//# sourceMappingURL=index.js.map

package/Distribution/Format/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../Source/Format/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC"}

package/Distribution/Inquirer/Confirm.Types.d.ts

@@ -0,0 +1,9 @@
+import type { PartialDeep } from "@inquirer/type";
+import type { Theme } from "@inquirer/core";
+/** The configuration object for {@link Confirm}. */
+export type FConfirmConfig = {
+    message: string;
+    default?: boolean;
+    theme?: PartialDeep<Theme>;
+};
+//# sourceMappingURL=Confirm.Types.d.ts.map

package/Distribution/Inquirer/Confirm.Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Confirm.Types.d.ts","sourceRoot":"","sources":["../../Source/Inquirer/Confirm.Types.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,oDAAoD;AACpD,MAAM,MAAM,cAAc,GACtB;IACI,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;CAC9B,CAAC"}

package/Distribution/Inquirer/Confirm.Types.js

@@ -0,0 +1,7 @@
+/* File:      Confirm.Types.ts
+ * Author:    Gage Sorrell <gage@sorrell.sh>
+ * Copyright: (c) 2026 Gage Sorrell
+ * License:   MIT
+ */
+export {};
+//# sourceMappingURL=Confirm.Types.js.map

package/Distribution/Inquirer/Confirm.Types.js.map

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

package/Distribution/Inquirer/Confirm.d.ts

@@ -0,0 +1,11 @@
+import type { FConfirmConfig } from "./Confirm.Types.js";
+import type { Prompt } from "@inquirer/type";
+/**
+ * An `inquirer` prompt identical to `confirm`, but with more natural handling of keypresses.
+ *
+ * @param config - The configuration for this prompt.
+ *
+ * @returns The `boolean` corresponding to the user's choice.
+ */
+export declare const Confirm: Prompt<boolean, FConfirmConfig>;
+//# sourceMappingURL=Confirm.d.ts.map

package/Distribution/Inquirer/Confirm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Confirm.d.ts","sourceRoot":"","sources":["../../Source/Inquirer/Confirm.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAa7C;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,cAAc,CAwDnD,CAAC"}

package/Distribution/Inquirer/Confirm.js

@@ -0,0 +1,64 @@
+/* File:      Confirm.ts
+ * Author:    Gage Sorrell <gage@sorrell.sh>
+ * Copyright: (c) 2026 Gage Sorrell
+ * License:   MIT
+ */
+import { createPrompt, isEnterKey, makeTheme, useKeypress, usePrefix, useState } from "@inquirer/core";
+/**
+ * @param Value - The answer.
+ * @returns The string to display for the given answer.
+ */
+function GetAnswerString(Value) {
+    return Value ? "Yes" : "No";
+}
+/* eslint-disable jsdoc/require-jsdoc */
+/**
+ * An `inquirer` prompt identical to `confirm`, but with more natural handling of keypresses.
+ *
+ * @param config - The configuration for this prompt.
+ *
+ * @returns The `boolean` corresponding to the user's choice.
+ */
+export const Confirm = createPrompt((Configuration, Done) => {
+    const [status, SetStatus] = useState("idle");
+    const [DisplayValue, SetDisplayValue] = useState("");
+    const theme = makeTheme(Configuration.theme);
+    const Prefix = usePrefix({ status, theme });
+    useKeypress((Key) => {
+        if (status !== "idle") {
+            return;
+        }
+        const KeyName = Key.name?.toLowerCase();
+        if (KeyName === "y") {
+            SetDisplayValue(theme.style.answer("Yes"));
+            SetStatus("done");
+            Done(true);
+            return;
+        }
+        if (KeyName === "n") {
+            SetDisplayValue(theme.style.answer("No"));
+            SetStatus("done");
+            Done(false);
+            return;
+        }
+        if (isEnterKey(Key)) {
+            const Answer = Configuration.default ?? true;
+            SetDisplayValue(theme.style.answer(GetAnswerString(Answer)));
+            SetStatus("done");
+            Done(Answer);
+        }
+    });
+    const DefaultHint = status === "idle"
+        ? ` ${theme.style.defaultAnswer(Configuration.default === false ? "y/N" : "Y/n")}`
+        : "";
+    return [
+        Prefix,
+        " ",
+        theme.style.message(Configuration.message, status),
+        DefaultHint,
+        " ",
+        DisplayValue
+    ].join("");
+});
+/* eslint-enable jsdoc/require-jsdoc */
+//# sourceMappingURL=Confirm.js.map

package/Distribution/Inquirer/Confirm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Confirm.js","sourceRoot":"","sources":["../../Source/Inquirer/Confirm.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAIH,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAIrC;;;GAGG;AACH,SAAS,eAAe,CAAC,KAAc;IAEnC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAChC,CAAC;AAED,wCAAwC;AAExC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAAoC,YAAY,CAChE,CAAC,aAA6B,EAAE,IAAgC,EAAE,EAAE;IAEhE,MAAM,CAAE,MAAM,EAAE,SAAS,CAAE,GAAG,QAAQ,CAAS,MAAM,CAAC,CAAC;IACvD,MAAM,CAAE,YAAY,EAAE,eAAe,CAAE,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvD,MAAM,KAAK,GAAU,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,MAAM,GAAW,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAEpD,WAAW,CAAC,CAAC,GAAkB,EAAE,EAAE;QAE/B,IAAI,MAAM,KAAK,MAAM,EACrB,CAAC;YACG,OAAO;QACX,CAAC;QAED,MAAM,OAAO,GAAW,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;QAEhD,IAAI,OAAO,KAAK,GAAG,EACnB,CAAC;YACG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3C,SAAS,CAAC,MAAM,CAAC,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,CAAC;YACX,OAAO;QACX,CAAC;QAED,IAAI,OAAO,KAAK,GAAG,EACnB,CAAC;YACG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1C,SAAS,CAAC,MAAM,CAAC,CAAC;YAClB,IAAI,CAAC,KAAK,CAAC,CAAC;YACZ,OAAO;QACX,CAAC;QAED,IAAI,UAAU,CAAC,GAAG,CAAC,EACnB,CAAC;YACG,MAAM,MAAM,GAAY,aAAa,CAAC,OAAO,IAAI,IAAI,CAAC;YACtD,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC7D,SAAS,CAAC,MAAM,CAAC,CAAC;YAClB,IAAI,CAAC,MAAM,CAAC,CAAC;QACjB,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GACb,MAAM,KAAK,MAAM;QACb,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE;QAClF,CAAC,CAAC,EAAE,CAAC;IAEb,OAAO;QACH,MAAM;QACN,GAAG;QACH,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC;QAClD,WAAW;QACX,GAAG;QACH,YAAY;KACf,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACf,CAAC,CACJ,CAAC;AAEF,uCAAuC"}

package/Distribution/Inquirer/FileSelector.Types.d.ts

@@ -0,0 +1,9 @@
+import type { PromptConfig } from "@sorrell/inquirer-file-selector";
+export type { Item } from "@sorrell/inquirer-file-selector";
+export type FFileSelectorConfigFull = PromptConfig & {
+    allowCancel?: false;
+    multiple?: false;
+};
+export type FFileSelectorConfigBase = Omit<FFileSelectorConfigFull, "message" | "allowCancel">;
+export type FFileSelectorConfig = Pick<FFileSelectorConfigFull, "filter" | "message" | "type" | "theme"> & Partial<Pick<FFileSelectorConfigFull, "allowCancel" | "basePath">>;
+//# sourceMappingURL=FileSelector.Types.d.ts.map

package/Distribution/Inquirer/FileSelector.Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSelector.Types.d.ts","sourceRoot":"","sources":["../../Source/Inquirer/FileSelector.Types.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,YAAY,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AAE5D,MAAM,MAAM,uBAAuB,GAC/B,YAAY,GACZ;IACI,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,QAAQ,CAAC,EAAE,KAAK,CAAC;CACpB,CAAC;AAEN,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,uBAAuB,EAAG,SAAS,GAAG,aAAa,CAAC,CAAC;AAEhG,MAAM,MAAM,mBAAmB,GAC3B,IAAI,CAAC,uBAAuB,EACtB,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,CACZ,GACD,OAAO,CAAC,IAAI,CACR,uBAAuB,EACrB,aAAa,GACb,UAAU,CACf,CAAC,CAAC"}

package/Distribution/Inquirer/FileSelector.Types.js

@@ -0,0 +1,7 @@
+/* File:      FileSelector.Types.ts
+ * Author:    Gage Sorrell <gage@sorrell.sh>
+ * Copyright: (c) 2026 Gage Sorrell
+ * License:   MIT
+ */
+export {};
+//# sourceMappingURL=FileSelector.Types.js.map

package/Distribution/Inquirer/FileSelector.Types.js.map

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

package/Distribution/Inquirer/FileSelector.d.ts

@@ -0,0 +1,15 @@
+import type { FFileSelectorConfig } from "./FileSelector.Types.js";
+import { type Item } from "@sorrell/inquirer-file-selector";
+/**
+ * Create an {@link https://www.npmjs.com/package/@inquirer/prompts | Inquirer} prompt for
+ * browsing and selecting a file or directory.
+ *
+ * This wraps {@link https://www.npmjs.com/package/inquirer-file-selector | inquirer-file-selector}.
+ *
+ * @deprecated An enquirer-based alternative needs to be found or built.
+ *
+ * @param Config - The options for the prompt.
+ * @returns The `Item` selected by the user via the prompt.
+ */
+export declare function FileSelector(Config: FFileSelectorConfig): Promise<Item>;
+//# sourceMappingURL=FileSelector.d.ts.map

package/Distribution/Inquirer/FileSelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSelector.d.ts","sourceRoot":"","sources":["../../Source/Inquirer/FileSelector.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACR,mBAAmB,EAEM,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,KAAK,IAAI,EAAkC,MAAM,iCAAiC,CAAC;AAI5F;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsD7E"}