@sorrell/utilities 1.1.60 → 1.2.0

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Async.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Async/Async.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC5F,OAAO,KAAK,EACR,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAqB/F;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,GAAG,CAAC,mBAAmB,EAAE,iBAAiB,EAC5D,QAAQ,EAAE,KAAK,CAAC,mBAAmB,CAAC,EACpC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC,GACvE,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAUnC;AAED;;;GAGG;AACH,8BAAsB,YAAY,CAAC,WAAW,CAAE,YAAW,WAAW,CAAC,WAAW,CAAC;IAExE,IAAI,CAAC,UAAU,GAAG,WAAW,EAAE,UAAU,GAAG,KAAK,EACpD,YAAY,CAAC,EAAE,YAAY,CAAC,WAAW,EAAE,UAAU,CAAC,EACpD,WAAW,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,GACtC,YAAY,CAAC,UAAU,GAAG,UAAU,CAAC;CAI3C;AAED;;;;;;;;;GASG;AACH,qBAAa,0BAA2B,SAAQ,SAAS;;CAMxD;AAED;;;;GAIG;AACH,qBAAa,QAAQ,CAAC,WAAW,CAAE,SAAQ,YAAY,CAAC,WAAW,CAAE,YAAW,WAAW,CAAC,WAAW,CAAC;gBAEjF,QAAQ,EAAE,oBAAoB,CAAC,WAAW,CAAC;IAsB9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACI,IAAI,CAAC,UAAU,GAAG,WAAW,EAAE,UAAU,GAAG,KAAK,EACpD,WAAW,EAAE,YAAY,CAAC,WAAW,EAAE,UAAU,CAAC,EAClD,UAAU,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,GACrC,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;IAKpB,IAAI,CAAC,UAAU,GAAG,WAAW,EAAE,UAAU,GAAG,KAAK,EAC7D,WAAW,CAAC,EAAE,YAAY,CAAC,WAAW,EAAE,UAAU,CAAC,EACnD,UAAU,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,GACrC,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;IAK7B,KAAK,CAAC,UAAU,GAAG,KAAK,EAC3B,UAAU,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,GACjD,YAAY,CAAC,WAAW,GAAG,UAAU,CAAC;IAOlC,OAAO,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC;WAKzD,OAAO,CAAC,WAAW,EAC7B,KAAK,EAAE,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC,GAC9C,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;WAKnB,MAAM,CAAC,WAAW,GAAG,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC;IAK7E,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;CAIrC"
+}

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

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

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

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

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

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

package/Distribution/Types/Effect/Effect.Types.d.cts

@@ -0,0 +1,16 @@
+/**
+ * @file      Effect.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { Effect } from "effect";
+export type Any = Effect.Effect<any, any, any>;
+export type Factory<ArgumentVectorType, EffectType extends Any> = [
+    ArgumentVectorType
+] extends [never] ? {
+    (): EffectType;
+} : {
+    (): EffectType;
+};
+//# sourceMappingURL=Effect.Types.d.cts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Effect.Types.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Effect/Effect.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAE/C,MAAM,MAAM,OAAO,CAAC,kBAAkB,EAAE,UAAU,SAAS,GAAG,IAC1D;IAAE,kBAAkB;CAAE,SAAS,CAAE,KAAK,CAAE,GAClC;IACE,IAAI,UAAU,CAAC;CAClB,GACC;IACE,IAAI,UAAU,CAAC;CAClB,CAAC"
+}

package/Distribution/Types/Effect/Effect.Types.d.mts

@@ -0,0 +1,16 @@
+/**
+ * @file      Effect.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { Effect } from "effect";
+export type Any = Effect.Effect<any, any, any>;
+export type Factory<ArgumentVectorType, EffectType extends Any> = [
+    ArgumentVectorType
+] extends [never] ? {
+    (): EffectType;
+} : {
+    (): EffectType;
+};
+//# sourceMappingURL=Effect.Types.d.mts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Effect.Types.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Effect/Effect.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAE/C,MAAM,MAAM,OAAO,CAAC,kBAAkB,EAAE,UAAU,SAAS,GAAG,IAC1D;IAAE,kBAAkB;CAAE,SAAS,CAAE,KAAK,CAAE,GAClC;IACE,IAAI,UAAU,CAAC;CAClB,GACC;IACE,IAAI,UAAU,CAAC;CAClB,CAAC"
+}

package/Distribution/Types/Effect/Effect.d.cts

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

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

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

package/Distribution/Types/Effect/Effect.d.mts

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

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

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

package/Distribution/Types/Effect/Index.Effect.d.cts

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

package/Distribution/Types/Effect/Index.Effect.d.cts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Index.Effect.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Effect/Index.Effect.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC"
+}

package/Distribution/Types/Effect/Index.Effect.d.mts

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

package/Distribution/Types/Effect/Index.Effect.d.mts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Index.Effect.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Effect/Index.Effect.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC"
+}

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

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

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "index.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Effect/index.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC"
+}

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

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

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "index.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Effect/index.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC"
+}

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.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

@@ -32,4 +32,24 @@ export declare function GetSafeNewPath(InPath: string): Promise<string>;
  *       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

@@ -1 +1 @@
-{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["../../../Source/FileSystem/FileSystem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAiB5D;;;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"}
+{"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/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"}