@sorrell/utilities 1.2.5 → 1.2.6

package/Distribution/Types/Record/Record.d.cts

@@ -0,0 +1,63 @@
+/**
+ * @file      Record.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { TFlatMapRecordTransformer, TFromPath, TMapRecordTransformer, TPath, TRef } from "./Record.Types.cjs";
+/**
+ * Set a value within a given {@link InRecord | Record} at a given {@link Path} to be a given
+ * {@link Value}.
+ *
+ * @param InRecord - The {@link Record} that holds the value with path {@link Path} to be retrieved
+ * by this function.
+ * @param Path - The {@link PathType} that describes the property to be retrieved by this.
+ * @param Value - The value to be set at the given {@link Path} of the given {@link InRecord | Record}.
+ *
+ * @throws {Error} An {@link Error} iff the given {@link Path} is an {@link Array}, rather than a
+ * `.`-delimited `string`.
+ */
+export declare function SetPropertyFromPath<RecordType extends Record<string | number, unknown>, PathType extends TPath<RecordType>>(InRecord: RecordType, Path: PathType, Value: TFromPath<RecordType, PathType>): void;
+/**
+ * Get a value within a given {@link InRecord | Record} at a given {@link Path}.
+ *
+ * @param InRecord - The {@link Record} that holds the value with path {@link Path} to be retrieved
+ * by this function.
+ * @param Path - The {@link PathType} that describes the property to be retrieved by this.
+ *
+ * @throws {Error} An {@link Error} iff the given {@link Path} is an {@link Array}, rather than a
+ * `.`-delimited `string`.
+ *
+ * @returns {TFromPath<RecordType, PathType>} The value in the {@link InRecord} at the given {@link Path}.
+ */
+export declare function GetPropertyFromPath<RecordType extends Record<string, unknown>, PathType extends TPath<RecordType>>(InRecord: RecordType, Path: PathType): TFromPath<RecordType, PathType>;
+/**
+ * Creates a {@link TRef} of a given {@link Type}.  Useful for passing
+ * primitives to functions by-reference.
+ *
+ * @template Type - The type of the value wrapped by the returned {@link TRef}.
+ *
+ * @returns {TRef<Type>} A {@link TRef} of the given {@link Type}.
+ */
+export declare function MakeRef<Type>(): TRef<Type>;
+/**
+ * Maps a {@link Record} to an {@link Array}.
+ *
+ * @param InRecord - The {@link Record} over which this function maps.
+ * @param InFunction - The {@link TFlatMapRecordTransformer | transformer} that maps
+ * the record to an {@link Array}.
+ *
+ * @returns {Array<ElementType>} An {@link Array} of elements, mapped from the given {@link InRecord}.
+ */
+export declare function MapRecord<KeyType extends PropertyKey, PropertyType, ElementType>(InRecord: Record<KeyType, PropertyType>, InFunction: TMapRecordTransformer<KeyType, PropertyType, ElementType>): Array<ElementType>;
+/**
+ * Maps a {@link Record} to an {@link Array}.
+ *
+ * @param InRecord - The {@link Record} over which this function maps.
+ * @param InFunction - The {@link TFlatMapRecordTransformer | transformer} that maps
+ * the record to an {@link Array}.
+ *
+ * @returns {Array<ElementType>} An {@link Array} of elements, mapped from the given {@link InRecord}.
+ */
+export declare function FlatMapRecord<KeyType extends PropertyKey, PropertyType, ElementType>(InRecord: Record<KeyType, PropertyType>, InFunction: TFlatMapRecordTransformer<KeyType, PropertyType, ElementType>): Array<ElementType>;
+//# sourceMappingURL=Record.d.cts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Record.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Record/Record.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACR,yBAAyB,EACzB,SAAS,EACT,qBAAqB,EACrB,KAAK,EACL,IAAI,EACP,MAAM,mBAAmB,CAAC;AAK3B;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAC/B,UAAU,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EACnD,QAAQ,SAAS,KAAK,CAAC,UAAU,CAAC,EAElC,QAAQ,EAAE,UAAU,EACpB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,SAAS,CAAC,UAAU,EAAE,QAAQ,CAAC,GACvC,IAAI,CAkDN;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAC/B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,QAAQ,SAAS,KAAK,CAAC,UAAU,CAAC,EAElC,QAAQ,EAAE,UAAU,EACpB,IAAI,EAAE,QAAQ,GACf,SAAS,CAAC,UAAU,EAAE,QAAQ,CAAC,CAiCjC;AAID;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAK1C;AAKD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACrB,OAAO,SAAS,WAAW,EAC3B,YAAY,EACZ,WAAW,EAEX,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,EACvC,UAAU,EAAE,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC,GACtE,KAAK,CAAC,WAAW,CAAC,CAOpB;AAOD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CACzB,OAAO,SAAS,WAAW,EAC3B,YAAY,EACZ,WAAW,EAEX,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,EACvC,UAAU,EAAE,yBAAyB,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC,GAC1E,KAAK,CAAC,WAAW,CAAC,CAUpB"
+}

package/Distribution/Types/Record/Record.d.mts

@@ -0,0 +1,63 @@
+/**
+ * @file      Record.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { TFlatMapRecordTransformer, TFromPath, TMapRecordTransformer, TPath, TRef } from "./Record.Types.mjs";
+/**
+ * Set a value within a given {@link InRecord | Record} at a given {@link Path} to be a given
+ * {@link Value}.
+ *
+ * @param InRecord - The {@link Record} that holds the value with path {@link Path} to be retrieved
+ * by this function.
+ * @param Path - The {@link PathType} that describes the property to be retrieved by this.
+ * @param Value - The value to be set at the given {@link Path} of the given {@link InRecord | Record}.
+ *
+ * @throws {Error} An {@link Error} iff the given {@link Path} is an {@link Array}, rather than a
+ * `.`-delimited `string`.
+ */
+export declare function SetPropertyFromPath<RecordType extends Record<string | number, unknown>, PathType extends TPath<RecordType>>(InRecord: RecordType, Path: PathType, Value: TFromPath<RecordType, PathType>): void;
+/**
+ * Get a value within a given {@link InRecord | Record} at a given {@link Path}.
+ *
+ * @param InRecord - The {@link Record} that holds the value with path {@link Path} to be retrieved
+ * by this function.
+ * @param Path - The {@link PathType} that describes the property to be retrieved by this.
+ *
+ * @throws {Error} An {@link Error} iff the given {@link Path} is an {@link Array}, rather than a
+ * `.`-delimited `string`.
+ *
+ * @returns {TFromPath<RecordType, PathType>} The value in the {@link InRecord} at the given {@link Path}.
+ */
+export declare function GetPropertyFromPath<RecordType extends Record<string, unknown>, PathType extends TPath<RecordType>>(InRecord: RecordType, Path: PathType): TFromPath<RecordType, PathType>;
+/**
+ * Creates a {@link TRef} of a given {@link Type}.  Useful for passing
+ * primitives to functions by-reference.
+ *
+ * @template Type - The type of the value wrapped by the returned {@link TRef}.
+ *
+ * @returns {TRef<Type>} A {@link TRef} of the given {@link Type}.
+ */
+export declare function MakeRef<Type>(): TRef<Type>;
+/**
+ * Maps a {@link Record} to an {@link Array}.
+ *
+ * @param InRecord - The {@link Record} over which this function maps.
+ * @param InFunction - The {@link TFlatMapRecordTransformer | transformer} that maps
+ * the record to an {@link Array}.
+ *
+ * @returns {Array<ElementType>} An {@link Array} of elements, mapped from the given {@link InRecord}.
+ */
+export declare function MapRecord<KeyType extends PropertyKey, PropertyType, ElementType>(InRecord: Record<KeyType, PropertyType>, InFunction: TMapRecordTransformer<KeyType, PropertyType, ElementType>): Array<ElementType>;
+/**
+ * Maps a {@link Record} to an {@link Array}.
+ *
+ * @param InRecord - The {@link Record} over which this function maps.
+ * @param InFunction - The {@link TFlatMapRecordTransformer | transformer} that maps
+ * the record to an {@link Array}.
+ *
+ * @returns {Array<ElementType>} An {@link Array} of elements, mapped from the given {@link InRecord}.
+ */
+export declare function FlatMapRecord<KeyType extends PropertyKey, PropertyType, ElementType>(InRecord: Record<KeyType, PropertyType>, InFunction: TFlatMapRecordTransformer<KeyType, PropertyType, ElementType>): Array<ElementType>;
+//# sourceMappingURL=Record.d.mts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Record.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Record/Record.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACR,yBAAyB,EACzB,SAAS,EACT,qBAAqB,EACrB,KAAK,EACL,IAAI,EACP,MAAM,mBAAmB,CAAC;AAK3B;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAC/B,UAAU,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EACnD,QAAQ,SAAS,KAAK,CAAC,UAAU,CAAC,EAElC,QAAQ,EAAE,UAAU,EACpB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,SAAS,CAAC,UAAU,EAAE,QAAQ,CAAC,GACvC,IAAI,CAkDN;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAC/B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,QAAQ,SAAS,KAAK,CAAC,UAAU,CAAC,EAElC,QAAQ,EAAE,UAAU,EACpB,IAAI,EAAE,QAAQ,GACf,SAAS,CAAC,UAAU,EAAE,QAAQ,CAAC,CAiCjC;AAID;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAK1C;AAKD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACrB,OAAO,SAAS,WAAW,EAC3B,YAAY,EACZ,WAAW,EAEX,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,EACvC,UAAU,EAAE,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC,GACtE,KAAK,CAAC,WAAW,CAAC,CAOpB;AAOD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CACzB,OAAO,SAAS,WAAW,EAC3B,YAAY,EACZ,WAAW,EAEX,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,EACvC,UAAU,EAAE,yBAAyB,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC,GAC1E,KAAK,CAAC,WAAW,CAAC,CAUpB"
+}

package/Distribution/Types/Record/Record.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @file      Record.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { TFlatMapRecordTransformer, TFromPath, TMapRecordTransformer, TPath, TRef } from "./Record.Types.ts";
+/**
+ * Set a value within a given {@link InRecord | Record} at a given {@link Path} to be a given
+ * {@link Value}.
+ *
+ * @param InRecord - The {@link Record} that holds the value with path {@link Path} to be retrieved
+ * by this function.
+ * @param Path - The {@link PathType} that describes the property to be retrieved by this.
+ * @param Value - The value to be set at the given {@link Path} of the given {@link InRecord | Record}.
+ *
+ * @throws {Error} An {@link Error} iff the given {@link Path} is an {@link Array}, rather than a
+ * `.`-delimited `string`.
+ */
+export declare function SetPropertyFromPath<RecordType extends Record<string | number, unknown>, PathType extends TPath<RecordType>>(InRecord: RecordType, Path: PathType, Value: TFromPath<RecordType, PathType>): void;
+/**
+ * Get a value within a given {@link InRecord | Record} at a given {@link Path}.
+ *
+ * @param InRecord - The {@link Record} that holds the value with path {@link Path} to be retrieved
+ * by this function.
+ * @param Path - The {@link PathType} that describes the property to be retrieved by this.
+ *
+ * @throws {Error} An {@link Error} iff the given {@link Path} is an {@link Array}, rather than a
+ * `.`-delimited `string`.
+ *
+ * @returns {TFromPath<RecordType, PathType>} The value in the {@link InRecord} at the given {@link Path}.
+ */
+export declare function GetPropertyFromPath<RecordType extends Record<string, unknown>, PathType extends TPath<RecordType>>(InRecord: RecordType, Path: PathType): TFromPath<RecordType, PathType>;
+/**
+ * Creates a {@link TRef} of a given {@link Type}.  Useful for passing
+ * primitives to functions by-reference.
+ *
+ * @template Type - The type of the value wrapped by the returned {@link TRef}.
+ *
+ * @returns {TRef<Type>} A {@link TRef} of the given {@link Type}.
+ */
+export declare function MakeRef<Type>(): TRef<Type>;
+/**
+ * Maps a {@link Record} to an {@link Array}.
+ *
+ * @param InRecord - The {@link Record} over which this function maps.
+ * @param InFunction - The {@link TFlatMapRecordTransformer | transformer} that maps
+ * the record to an {@link Array}.
+ *
+ * @returns {Array<ElementType>} An {@link Array} of elements, mapped from the given {@link InRecord}.
+ */
+export declare function MapRecord<KeyType extends PropertyKey, PropertyType, ElementType>(InRecord: Record<KeyType, PropertyType>, InFunction: TMapRecordTransformer<KeyType, PropertyType, ElementType>): Array<ElementType>;
+/**
+ * Maps a {@link Record} to an {@link Array}.
+ *
+ * @param InRecord - The {@link Record} over which this function maps.
+ * @param InFunction - The {@link TFlatMapRecordTransformer | transformer} that maps
+ * the record to an {@link Array}.
+ *
+ * @returns {Array<ElementType>} An {@link Array} of elements, mapped from the given {@link InRecord}.
+ */
+export declare function FlatMapRecord<KeyType extends PropertyKey, PropertyType, ElementType>(InRecord: Record<KeyType, PropertyType>, InFunction: TFlatMapRecordTransformer<KeyType, PropertyType, ElementType>): Array<ElementType>;
+//# sourceMappingURL=Record.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Record.d.ts","sourceRoot":"","sources":["../../../Source/Record/Record.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACR,yBAAyB,EACzB,SAAS,EACT,qBAAqB,EACrB,KAAK,EACL,IAAI,EACP,MAAM,mBAAmB,CAAC;AAK3B;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAC/B,UAAU,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EACnD,QAAQ,SAAS,KAAK,CAAC,UAAU,CAAC,EAElC,QAAQ,EAAE,UAAU,EACpB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,SAAS,CAAC,UAAU,EAAE,QAAQ,CAAC,GACvC,IAAI,CAkDN;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAC/B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,QAAQ,SAAS,KAAK,CAAC,UAAU,CAAC,EAElC,QAAQ,EAAE,UAAU,EACpB,IAAI,EAAE,QAAQ,GACf,SAAS,CAAC,UAAU,EAAE,QAAQ,CAAC,CAiCjC;AAID;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAK1C;AAKD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACrB,OAAO,SAAS,WAAW,EAC3B,YAAY,EACZ,WAAW,EAEX,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,EACvC,UAAU,EAAE,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC,GACtE,KAAK,CAAC,WAAW,CAAC,CAOpB;AAOD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CACzB,OAAO,SAAS,WAAW,EAC3B,YAAY,EACZ,WAAW,EAEX,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,EACvC,UAAU,EAAE,yBAAyB,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC,GAC1E,KAAK,CAAC,WAAW,CAAC,CAUpB"}

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

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

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

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

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

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

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

package/Distribution/Types/Record/index.d.ts.map

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

package/Distribution/Types/String/String.d.cts

@@ -0,0 +1,28 @@
+/**
+ * @file      String.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @module String
+ * Functions for manipulating strings.
+ */
+/**
+ * @param In - The string that you wish to test.
+ * @returns Whether the given string contains *only* (Latin alphabet) letters.
+ */
+export declare function IsLetters(In: string): boolean;
+/**
+ * @remarks *(This is an alias for `IsOnlyLetters`).*
+ *
+ * @param In - The string that you wish to test.
+ * @returns Whether the given string contains *only* (Latin alphabet) letters.
+ */
+export declare function IsAlpha(In: string): boolean;
+/**
+ * @param In - The string that you wish to test.
+ * @returns Whether the given string contains *only* numeric digits.
+ */
+export declare function IsNumeric(In: string): boolean;
+//# sourceMappingURL=String.d.cts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "String.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/String/String.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAG7C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAG3C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAG7C"
+}

package/Distribution/Types/String/String.d.mts

@@ -0,0 +1,28 @@
+/**
+ * @file      String.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @module String
+ * Functions for manipulating strings.
+ */
+/**
+ * @param In - The string that you wish to test.
+ * @returns Whether the given string contains *only* (Latin alphabet) letters.
+ */
+export declare function IsLetters(In: string): boolean;
+/**
+ * @remarks *(This is an alias for `IsOnlyLetters`).*
+ *
+ * @param In - The string that you wish to test.
+ * @returns Whether the given string contains *only* (Latin alphabet) letters.
+ */
+export declare function IsAlpha(In: string): boolean;
+/**
+ * @param In - The string that you wish to test.
+ * @returns Whether the given string contains *only* numeric digits.
+ */
+export declare function IsNumeric(In: string): boolean;
+//# sourceMappingURL=String.d.mts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "String.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/String/String.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAG7C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAG3C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAG7C"
+}

package/Distribution/Types/String/String.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @file      String.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @module String
+ * Functions for manipulating strings.
+ */
+/**
+ * @param In - The string that you wish to test.
+ * @returns Whether the given string contains *only* (Latin alphabet) letters.
+ */
+export declare function IsLetters(In: string): boolean;
+/**
+ * @remarks *(This is an alias for `IsOnlyLetters`).*
+ *
+ * @param In - The string that you wish to test.
+ * @returns Whether the given string contains *only* (Latin alphabet) letters.
+ */
+export declare function IsAlpha(In: string): boolean;
+/**
+ * @param In - The string that you wish to test.
+ * @returns Whether the given string contains *only* numeric digits.
+ */
+export declare function IsNumeric(In: string): boolean;
+//# sourceMappingURL=String.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"String.d.ts","sourceRoot":"","sources":["../../../Source/String/String.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAG7C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAG3C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAG7C"}

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

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

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

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

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

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

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

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

package/Distribution/Types/String/index.d.ts

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

package/Distribution/Types/String/index.d.ts.map

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

package/Distribution/Types/index.d.cts

@@ -0,0 +1,24 @@
+/**
+ * @file      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @module
+ * General-purpose utility types and functions.
+ * This module barrel-exports each scoped export of this package.
+ * Use the scoped exports of this package to access only specific
+ * utilities (*e.g.*, `async`, `npm`, *etc.*).
+ */
+export * as Array from "./Array/index.cjs";
+export * as Async from "./Async/index.cjs";
+export * as Complex from "./Math/Complex.cjs";
+export * as FileSystem from "./FileSystem/index.cjs";
+export * as Functional from "./Functional/index.cjs";
+export * as Math from "./Math/index.cjs";
+export * as Miscellaneous from "./Miscellaneous/index.cjs";
+export * as Npm from "./Npm/index.cjs";
+export * as Path from "./Path/index.cjs";
+export * as String from "./String/index.cjs";
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "index.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../Source/index.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC"
+}

package/Distribution/Types/index.d.mts

@@ -0,0 +1,24 @@
+/**
+ * @file      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @module
+ * General-purpose utility types and functions.
+ * This module barrel-exports each scoped export of this package.
+ * Use the scoped exports of this package to access only specific
+ * utilities (*e.g.*, `async`, `npm`, *etc.*).
+ */
+export * as Array from "./Array/index.mjs";
+export * as Async from "./Async/index.mjs";
+export * as Complex from "./Math/Complex.mjs";
+export * as FileSystem from "./FileSystem/index.mjs";
+export * as Functional from "./Functional/index.mjs";
+export * as Math from "./Math/index.mjs";
+export * as Miscellaneous from "./Miscellaneous/index.mjs";
+export * as Npm from "./Npm/index.mjs";
+export * as Path from "./Path/index.mjs";
+export * as String from "./String/index.mjs";
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "index.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../Source/index.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC"
+}

package/Distribution/Types/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @file      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @module
+ * General-purpose utility types and functions.
+ * This module barrel-exports each scoped export of this package.
+ * Use the scoped exports of this package to access only specific
+ * utilities (*e.g.*, `async`, `npm`, *etc.*).
+ */
+export * as Array from "./Array/index.ts";
+export * as Async from "./Async/index.ts";
+export * as Complex from "./Math/Complex.ts";
+export * as FileSystem from "./FileSystem/index.ts";
+export * as Functional from "./Functional/index.ts";
+export * as Math from "./Math/index.ts";
+export * as Miscellaneous from "./Miscellaneous/index.ts";
+export * as Npm from "./Npm/index.ts";
+export * as Path from "./Path/index.ts";
+export * as String from "./String/index.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../Source/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC"}

package/Distribution/array.cjs

@@ -0,0 +1,51 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// Source/Array/index.ts
+var Array_exports = {};
+__export(Array_exports, {
+  FilterDefined: () => FilterDefined
+});
+module.exports = __toCommonJS(Array_exports);
+
+// Source/Array/Array.ts
+function FilterDefined(Array) {
+  return Array.filter((Element) => {
+    return Element !== void 0;
+  });
+}
+/**
+ * @file      Array.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @file      Array.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @file      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+//# sourceMappingURL=array.cjs.map

package/Distribution/array.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../Source/Array/index.ts", "../Source/Array/Array.ts"],
+  "sourcesContent": ["/**\n * @file      index.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\nexport * from \"./Array.ts\";\nexport * from \"./Array.Types.ts\";\n", "/**\n * @file      Array.ts\n * @author    Gage Sorrell <gage@sorrell.sh>\n * @copyright (c) 2026 Gage Sorrell\n * @license   MIT\n */\nimport type { FilteredArray, Options, TArrayType } from \"./Array.Types.ts\";\nimport type { NoOptions } from \"../Miscellaneous/Utility.Types.ts\";\n/**\n * Filter out all instances of `undefined` from a given {@link Array:param}.\n * @param Array - The array to filter.\n *\n * @template ElementType - The type of the elements in the array.\n *\n * @returns {TArrayType<Exclude<ElementType, undefined>, Exclude<OptionsType, Options.MaybeDefined>>}\n * A new `Array` of type `Exclude<ElementType, undefined>` and `OptionsType` that is the given\n * {@link OptionsType}, with the {@link Options.MaybeDefined} option removed.\n *\n * @example With the given {@link ElementType} including `undefined`.\n * ```typescript\n * const MaybeOddNumbers: TArray<number | undefined> = [ 1, 3, undefined, 5 ];\n * const OddNumbers: TArray<number> = FilterDefined(MaybeOddNumbers);\n * ```\n * @example With the given {@link OptionsType} including `Options.MaybeDefined`.\n * ```typescript\n * const MaybeOddNumbers: TArray<number, Options.MaybeDefined> = [ 1, 3, undefined, 5 ];\n * const OddNumbers: TArray<number> = FilterDefined(MaybeOddNumbers);\n * ```\n */\nexport function FilterDefined<ElementType, OptionsType extends Options = NoOptions, ArraySize extends number = number>(Array: TArrayType<ElementType, OptionsType | Options.MaybeDefined, ArraySize>): FilteredArray<ElementType>;\nexport function FilterDefined<ElementType, OptionsType extends Options = NoOptions, ArraySize extends number = number>(Array: TArrayType<ElementType | undefined, OptionsType, ArraySize>): FilteredArray<ElementType>;\nexport function FilterDefined<ElementType, OptionsType extends Options = NoOptions, ArraySize extends number = number>(Array: TArrayType<ElementType | undefined, OptionsType | Options.MaybeDefined, ArraySize>): FilteredArray<ElementType>;\nexport function FilterDefined<ElementType, OptionsType extends Options = NoOptions, ArraySize extends number = number>(Array: TArrayType<ElementType | undefined, OptionsType | Options.MaybeDefined, ArraySize>): FilteredArray<ElementType> {\n    return Array.filter((Element: ElementType | undefined): boolean => {\n        return Element !== undefined;\n    }) as FilteredArray<ElementType>;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACgCO,SAAS,cAAuG,OAAuH;AAC1O,SAAO,MAAM,OAAO,CAAC,YAA8C;AAC/D,WAAO,YAAY;AAAA,EACvB,CAAC;AACL;",
+  "names": []
+}