@sorrell/utilities 1.2.5 → 1.2.6

package/Distribution/Types/FileSystem/FileSystem.Types.d.cts

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

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "FileSystem.Types.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/FileSystem/FileSystem.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG,IAAK,MAAO,EAAE,CAAC"
+}

package/Distribution/Types/FileSystem/FileSystem.Types.d.mts

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

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "FileSystem.Types.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/FileSystem/FileSystem.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG,IAAK,MAAO,EAAE,CAAC"
+}

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

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

package/Distribution/Types/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,MAAM,MAAM,cAAc,GAAG,IAAK,MAAO,EAAE,CAAC"}

package/Distribution/Types/FileSystem/FileSystem.d.cts

@@ -0,0 +1,55 @@
+/**
+ * @file      FileSystem.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import { type FFileExtension } from "./FileSystem.Types.cjs";
+/**
+ * @param Extension - The file extension that you wish to test.
+ * @returns Whether the file extension is valid on the current platform.
+ */
+export declare function IsSupportedFileExtension(Extension: FFileExtension): boolean;
+/**
+ * Given a path at which we wish to create a new file, check if a file at that
+ * path already exists, and if so, then append `(${ number })` before the file
+ * extension, consistent with the Windows Explorer handles conflicting file
+ * names when pasting files.
+ */
+export declare function GetSafeNewPath(InPath: string): Promise<string>;
+/**
+ * @param DirectoryPath - The path to the directory in which you wish to check.
+ * @param FileName - The desired file name.
+ * @param PersistNewFile - *(Optional)* Whether to keep the otherwise-temporary
+ *                         file created at the desired path.
+ * @param Extension - *(Optional)* If provided, the function will only return `true`
+ *                    if `FileName.endsWith(Extension)` *and* the `Extension` is a valid
+ *                    file extension.
+ * @returns Whether a file of the given `FileName` can be created in `DirectoryPath`.
+ *
+ * @remarks This *does* attempt to create a file at the desired path.  The file is
+ *       temporary iff `!PersistNewFile`, and is never created when this function
+ *       returns `false`.
+ */
+export declare function IsValidFileName(DirectoryPath: string, FileName: string, PersistNewFile?: boolean, Extension?: FFileExtension | undefined): Promise<boolean>;
+/**
+ * Write a text file to a given {@link Path} having contents {@link Contents}.
+ *
+ * @param Path - The path of the file that will be written.
+ * @param Contents - The text contents of the file to write.
+ *
+ * @returns {Promise<void>} A {@link Promise} that resolves when the call to {@link Fs.writeFile} resolves.
+ *
+ * @example
+ * ```typescript
+ * import { WriteTextFile } from "@sorrell/utilities/fs";
+ * import { resolve } from "path";
+ *
+ * const MyReadMe: string = "# ReadMe\n\nThis package accomplishes...\n";
+ * const MyReadMePath: string = resolve(".");
+ *
+ * await WriteTextFile(MyReadMePath, MyReadMe);
+ * ```
+ */
+export declare function WriteTextFile(Path: string, Contents: string): Promise<void>;
+//# sourceMappingURL=FileSystem.d.cts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "FileSystem.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/FileSystem/FileSystem.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAmB5D;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAuC3E;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBpE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACjC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,OAAe,EAC/B,SAAS,GAAE,cAAc,GAAG,SAAqB,GAClD,OAAO,CAAC,OAAO,CAAC,CAmClB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjF"
+}

package/Distribution/Types/FileSystem/FileSystem.d.mts

@@ -0,0 +1,55 @@
+/**
+ * @file      FileSystem.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import { type FFileExtension } from "./FileSystem.Types.mjs";
+/**
+ * @param Extension - The file extension that you wish to test.
+ * @returns Whether the file extension is valid on the current platform.
+ */
+export declare function IsSupportedFileExtension(Extension: FFileExtension): boolean;
+/**
+ * Given a path at which we wish to create a new file, check if a file at that
+ * path already exists, and if so, then append `(${ number })` before the file
+ * extension, consistent with the Windows Explorer handles conflicting file
+ * names when pasting files.
+ */
+export declare function GetSafeNewPath(InPath: string): Promise<string>;
+/**
+ * @param DirectoryPath - The path to the directory in which you wish to check.
+ * @param FileName - The desired file name.
+ * @param PersistNewFile - *(Optional)* Whether to keep the otherwise-temporary
+ *                         file created at the desired path.
+ * @param Extension - *(Optional)* If provided, the function will only return `true`
+ *                    if `FileName.endsWith(Extension)` *and* the `Extension` is a valid
+ *                    file extension.
+ * @returns Whether a file of the given `FileName` can be created in `DirectoryPath`.
+ *
+ * @remarks This *does* attempt to create a file at the desired path.  The file is
+ *       temporary iff `!PersistNewFile`, and is never created when this function
+ *       returns `false`.
+ */
+export declare function IsValidFileName(DirectoryPath: string, FileName: string, PersistNewFile?: boolean, Extension?: FFileExtension | undefined): Promise<boolean>;
+/**
+ * Write a text file to a given {@link Path} having contents {@link Contents}.
+ *
+ * @param Path - The path of the file that will be written.
+ * @param Contents - The text contents of the file to write.
+ *
+ * @returns {Promise<void>} A {@link Promise} that resolves when the call to {@link Fs.writeFile} resolves.
+ *
+ * @example
+ * ```typescript
+ * import { WriteTextFile } from "@sorrell/utilities/fs";
+ * import { resolve } from "path";
+ *
+ * const MyReadMe: string = "# ReadMe\n\nThis package accomplishes...\n";
+ * const MyReadMePath: string = resolve(".");
+ *
+ * await WriteTextFile(MyReadMePath, MyReadMe);
+ * ```
+ */
+export declare function WriteTextFile(Path: string, Contents: string): Promise<void>;
+//# sourceMappingURL=FileSystem.d.mts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "FileSystem.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/FileSystem/FileSystem.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAmB5D;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAuC3E;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBpE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACjC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,OAAe,EAC/B,SAAS,GAAE,cAAc,GAAG,SAAqB,GAClD,OAAO,CAAC,OAAO,CAAC,CAmClB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjF"
+}

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

@@ -0,0 +1,55 @@
+/**
+ * @file      FileSystem.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import { type FFileExtension } from "./FileSystem.Types.ts";
+/**
+ * @param Extension - The file extension that you wish to test.
+ * @returns Whether the file extension is valid on the current platform.
+ */
+export declare function IsSupportedFileExtension(Extension: FFileExtension): boolean;
+/**
+ * Given a path at which we wish to create a new file, check if a file at that
+ * path already exists, and if so, then append `(${ number })` before the file
+ * extension, consistent with the Windows Explorer handles conflicting file
+ * names when pasting files.
+ */
+export declare function GetSafeNewPath(InPath: string): Promise<string>;
+/**
+ * @param DirectoryPath - The path to the directory in which you wish to check.
+ * @param FileName - The desired file name.
+ * @param PersistNewFile - *(Optional)* Whether to keep the otherwise-temporary
+ *                         file created at the desired path.
+ * @param Extension - *(Optional)* If provided, the function will only return `true`
+ *                    if `FileName.endsWith(Extension)` *and* the `Extension` is a valid
+ *                    file extension.
+ * @returns Whether a file of the given `FileName` can be created in `DirectoryPath`.
+ *
+ * @remarks This *does* attempt to create a file at the desired path.  The file is
+ *       temporary iff `!PersistNewFile`, and is never created when this function
+ *       returns `false`.
+ */
+export declare function IsValidFileName(DirectoryPath: string, FileName: string, PersistNewFile?: boolean, Extension?: FFileExtension | undefined): Promise<boolean>;
+/**
+ * Write a text file to a given {@link Path} having contents {@link Contents}.
+ *
+ * @param Path - The path of the file that will be written.
+ * @param Contents - The text contents of the file to write.
+ *
+ * @returns {Promise<void>} A {@link Promise} that resolves when the call to {@link Fs.writeFile} resolves.
+ *
+ * @example
+ * ```typescript
+ * import { WriteTextFile } from "@sorrell/utilities/fs";
+ * import { resolve } from "path";
+ *
+ * const MyReadMe: string = "# ReadMe\n\nThis package accomplishes...\n";
+ * const MyReadMePath: string = resolve(".");
+ *
+ * await WriteTextFile(MyReadMePath, MyReadMe);
+ * ```
+ */
+export declare function WriteTextFile(Path: string, Contents: string): Promise<void>;
+//# sourceMappingURL=FileSystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["../../../Source/FileSystem/FileSystem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAmB5D;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAuC3E;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBpE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACjC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,OAAe,EAC/B,SAAS,GAAE,cAAc,GAAG,SAAqB,GAClD,OAAO,CAAC,OAAO,CAAC,CAmClB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjF"}

package/Distribution/Types/FileSystem/index.d.cts

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

package/Distribution/Types/FileSystem/index.d.cts.map

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

package/Distribution/Types/FileSystem/index.d.mts

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

package/Distribution/Types/FileSystem/index.d.mts.map

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

package/Distribution/Types/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.ts";
+export * from "./FileSystem.Types.ts";
+//# sourceMappingURL=index.d.ts.map

package/Distribution/Types/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/Types/Functional/Functional.Internal.Types.d.cts

@@ -0,0 +1,9 @@
+/**
+ * @file      Functional.Internal.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { CurriedArgument } from "./Functional.Internal";
+export type FCurriedArgument = typeof CurriedArgument;
+//# sourceMappingURL=Functional.Internal.Types.d.cts.map

package/Distribution/Types/Functional/Functional.Internal.Types.d.cts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Functional.Internal.Types.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Functional/Functional.Internal.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,gBAAgB,GAAG,OAAO,eAAe,CAAC"
+}

package/Distribution/Types/Functional/Functional.Internal.Types.d.mts

@@ -0,0 +1,9 @@
+/**
+ * @file      Functional.Internal.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { CurriedArgument } from "./Functional.Internal";
+export type FCurriedArgument = typeof CurriedArgument;
+//# sourceMappingURL=Functional.Internal.Types.d.mts.map

package/Distribution/Types/Functional/Functional.Internal.Types.d.mts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Functional.Internal.Types.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Functional/Functional.Internal.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,gBAAgB,GAAG,OAAO,eAAe,CAAC"
+}

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

@@ -0,0 +1,9 @@
+/**
+ * @file      Functional.Internal.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { CurriedArgument } from "./Functional.Internal";
+export type FCurriedArgument = typeof CurriedArgument;
+//# sourceMappingURL=Functional.Internal.Types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Functional.Internal.Types.d.ts","sourceRoot":"","sources":["../../../Source/Functional/Functional.Internal.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,gBAAgB,GAAG,OAAO,eAAe,CAAC"}

package/Distribution/Types/Functional/Functional.Internal.d.cts

@@ -0,0 +1,8 @@
+/**
+ * @file      Functional.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export declare const CurriedArgument: unique symbol;
+//# sourceMappingURL=Functional.Internal.d.cts.map

package/Distribution/Types/Functional/Functional.Internal.d.cts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Functional.Internal.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Functional/Functional.Internal.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,eAAO,MAAM,eAAe,EAAE,OAAO,MAAsC,CAAC"
+}

package/Distribution/Types/Functional/Functional.Internal.d.mts

@@ -0,0 +1,8 @@
+/**
+ * @file      Functional.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export declare const CurriedArgument: unique symbol;
+//# sourceMappingURL=Functional.Internal.d.mts.map

package/Distribution/Types/Functional/Functional.Internal.d.mts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Functional.Internal.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Functional/Functional.Internal.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,eAAO,MAAM,eAAe,EAAE,OAAO,MAAsC,CAAC"
+}

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

@@ -0,0 +1,8 @@
+/**
+ * @file      Functional.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export declare const CurriedArgument: unique symbol;
+//# sourceMappingURL=Functional.Internal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Functional.Internal.d.ts","sourceRoot":"","sources":["../../../Source/Functional/Functional.Internal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,eAAe,EAAE,OAAO,MAAsC,CAAC"}

package/Distribution/Types/Functional/Functional.Types.d.cts

@@ -0,0 +1,28 @@
+/**
+ * @file      Functional.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { TMaybeAsync } from "../Async/Async.Types.cjs";
+export type TExtractFunction<Type> = Type extends {
+    (...ArgumentVector: infer ArgumentVectorType): infer ReturnType;
+} ? (...ArgumentVector: ArgumentVectorType) => ReturnType : never;
+/**
+ * A function type with defaults that make defining callback types convenient.
+ *
+ * @template ArgumentType - The type of the argument or argument vector.
+ * If `ArgumentType extends Array<unknown>`, then this will be taken to
+ * be the argument vector.  To set the argument vector to be a single,
+ * `Array` argument, say `MyArrayType`, set `ArgumentType` to `[ MyArrayType ]`.
+ * @template ReturnType - The type returned by this.
+ */
+export type TFunction<ArgumentType = never, ReturnType = void> = [
+    ArgumentType
+] extends [never] ? {
+    (): ReturnType;
+} : ArgumentType extends Array<unknown> ? (...ArgumentVector: ArgumentType) => ReturnType : (Argument: ArgumentType) => ReturnType;
+export declare namespace TFunction {
+    type MaybeAsync<ArgumentVectorType extends Array<unknown> = [], ReturnType = void> = TMaybeAsync<TFunction<ArgumentVectorType, ReturnType>>;
+}
+//# sourceMappingURL=Functional.Types.d.cts.map

package/Distribution/Types/Functional/Functional.Types.d.cts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Functional.Types.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Functional/Functional.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,MAAM,gBAAgB,CAAC,IAAI,IAC7B,IAAI,SAAS;IAAE,CAAC,GAAG,cAAc,EAAE,MAAM,kBAAkB,GAAG,MAAM,UAAU,CAAA;CAAE,GAC1E,CAAC,GAAG,cAAc,EAAE,kBAAkB,KAAK,UAAU,GACrD,KAAK,CAAC;AAEhB;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,CAAC,YAAY,GAAG,KAAK,EAAE,UAAU,GAAG,IAAI,IACzD;IAAE,YAAY;CAAE,SAAS,CAAE,KAAK,CAAE,GAC5B;IACE,IAAI,UAAU,CAAC;CAClB,GACC,YAAY,SAAS,KAAK,CAAC,OAAO,CAAC,GAC/B,CAAC,GAAG,cAAc,EAAE,YAAY,KAAK,UAAU,GAC/C,CAAC,QAAQ,EAAE,YAAY,KAAK,UAAU,CAAC;AAErD,yBAAiB,SAAS,CAC1B;IACI,KAAY,UAAU,CAClB,kBAAkB,SAAS,KAAK,CAAC,OAAO,CAAC,GAAG,EAAG,EAC/C,UAAU,GAAG,IAAI,IAEjB,WAAW,CAAC,SAAS,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC,CAAC;CAC9D"
+}

package/Distribution/Types/Functional/Functional.Types.d.mts

@@ -0,0 +1,28 @@
+/**
+ * @file      Functional.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { TMaybeAsync } from "../Async/Async.Types.mjs";
+export type TExtractFunction<Type> = Type extends {
+    (...ArgumentVector: infer ArgumentVectorType): infer ReturnType;
+} ? (...ArgumentVector: ArgumentVectorType) => ReturnType : never;
+/**
+ * A function type with defaults that make defining callback types convenient.
+ *
+ * @template ArgumentType - The type of the argument or argument vector.
+ * If `ArgumentType extends Array<unknown>`, then this will be taken to
+ * be the argument vector.  To set the argument vector to be a single,
+ * `Array` argument, say `MyArrayType`, set `ArgumentType` to `[ MyArrayType ]`.
+ * @template ReturnType - The type returned by this.
+ */
+export type TFunction<ArgumentType = never, ReturnType = void> = [
+    ArgumentType
+] extends [never] ? {
+    (): ReturnType;
+} : ArgumentType extends Array<unknown> ? (...ArgumentVector: ArgumentType) => ReturnType : (Argument: ArgumentType) => ReturnType;
+export declare namespace TFunction {
+    type MaybeAsync<ArgumentVectorType extends Array<unknown> = [], ReturnType = void> = TMaybeAsync<TFunction<ArgumentVectorType, ReturnType>>;
+}
+//# sourceMappingURL=Functional.Types.d.mts.map

package/Distribution/Types/Functional/Functional.Types.d.mts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Functional.Types.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Functional/Functional.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,MAAM,gBAAgB,CAAC,IAAI,IAC7B,IAAI,SAAS;IAAE,CAAC,GAAG,cAAc,EAAE,MAAM,kBAAkB,GAAG,MAAM,UAAU,CAAA;CAAE,GAC1E,CAAC,GAAG,cAAc,EAAE,kBAAkB,KAAK,UAAU,GACrD,KAAK,CAAC;AAEhB;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,CAAC,YAAY,GAAG,KAAK,EAAE,UAAU,GAAG,IAAI,IACzD;IAAE,YAAY;CAAE,SAAS,CAAE,KAAK,CAAE,GAC5B;IACE,IAAI,UAAU,CAAC;CAClB,GACC,YAAY,SAAS,KAAK,CAAC,OAAO,CAAC,GAC/B,CAAC,GAAG,cAAc,EAAE,YAAY,KAAK,UAAU,GAC/C,CAAC,QAAQ,EAAE,YAAY,KAAK,UAAU,CAAC;AAErD,yBAAiB,SAAS,CAC1B;IACI,KAAY,UAAU,CAClB,kBAAkB,SAAS,KAAK,CAAC,OAAO,CAAC,GAAG,EAAG,EAC/C,UAAU,GAAG,IAAI,IAEjB,WAAW,CAAC,SAAS,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC,CAAC;CAC9D"
+}

package/Distribution/Types/Functional/Functional.Types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @file      Functional.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { TMaybeAsync } from "../Async/Async.Types.ts";
+export type TExtractFunction<Type> = Type extends {
+    (...ArgumentVector: infer ArgumentVectorType): infer ReturnType;
+} ? (...ArgumentVector: ArgumentVectorType) => ReturnType : never;
+/**
+ * A function type with defaults that make defining callback types convenient.
+ *
+ * @template ArgumentType - The type of the argument or argument vector.
+ * If `ArgumentType extends Array<unknown>`, then this will be taken to
+ * be the argument vector.  To set the argument vector to be a single,
+ * `Array` argument, say `MyArrayType`, set `ArgumentType` to `[ MyArrayType ]`.
+ * @template ReturnType - The type returned by this.
+ */
+export type TFunction<ArgumentType = never, ReturnType = void> = [
+    ArgumentType
+] extends [never] ? {
+    (): ReturnType;
+} : ArgumentType extends Array<unknown> ? (...ArgumentVector: ArgumentType) => ReturnType : (Argument: ArgumentType) => ReturnType;
+export declare namespace TFunction {
+    type MaybeAsync<ArgumentVectorType extends Array<unknown> = [], ReturnType = void> = TMaybeAsync<TFunction<ArgumentVectorType, ReturnType>>;
+}
+//# sourceMappingURL=Functional.Types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Functional.Types.d.ts","sourceRoot":"","sources":["../../../Source/Functional/Functional.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,MAAM,gBAAgB,CAAC,IAAI,IAC7B,IAAI,SAAS;IAAE,CAAC,GAAG,cAAc,EAAE,MAAM,kBAAkB,GAAG,MAAM,UAAU,CAAA;CAAE,GAC1E,CAAC,GAAG,cAAc,EAAE,kBAAkB,KAAK,UAAU,GACrD,KAAK,CAAC;AAEhB;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,CAAC,YAAY,GAAG,KAAK,EAAE,UAAU,GAAG,IAAI,IACzD;IAAE,YAAY;CAAE,SAAS,CAAE,KAAK,CAAE,GAC5B;IACE,IAAI,UAAU,CAAC;CAClB,GACC,YAAY,SAAS,KAAK,CAAC,OAAO,CAAC,GAC/B,CAAC,GAAG,cAAc,EAAE,YAAY,KAAK,UAAU,GAC/C,CAAC,QAAQ,EAAE,YAAY,KAAK,UAAU,CAAC;AAErD,yBAAiB,SAAS,CAC1B;IACI,KAAY,UAAU,CAClB,kBAAkB,SAAS,KAAK,CAAC,OAAO,CAAC,GAAG,EAAG,EAC/C,UAAU,GAAG,IAAI,IAEjB,WAAW,CAAC,SAAS,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC,CAAC;CAC9D"}

package/Distribution/Types/Functional/Functional.d.cts

@@ -0,0 +1,8 @@
+/**
+ * @file      Functional.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export declare function Identity<Type>(...Arguments: Array<Type>): Type[];
+//# sourceMappingURL=Functional.d.cts.map

package/Distribution/Types/Functional/Functional.d.cts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Functional.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Functional/Functional.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAMH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,GAAG,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,UAGvD"
+}

package/Distribution/Types/Functional/Functional.d.mts

@@ -0,0 +1,8 @@
+/**
+ * @file      Functional.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export declare function Identity<Type>(...Arguments: Array<Type>): Type[];
+//# sourceMappingURL=Functional.d.mts.map

package/Distribution/Types/Functional/Functional.d.mts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Functional.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Functional/Functional.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAMH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,GAAG,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,UAGvD"
+}

package/Distribution/Types/Functional/Functional.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file      Functional.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export declare function Identity<Type>(...Arguments: Array<Type>): Type[];
+//# sourceMappingURL=Functional.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Functional.d.ts","sourceRoot":"","sources":["../../../Source/Functional/Functional.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,GAAG,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,UAGvD"}

package/Distribution/Types/Functional/index.d.cts

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

package/Distribution/Types/Functional/index.d.cts.map

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

package/Distribution/Types/Functional/index.d.mts

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