@sorrell/utilities 1.1.60 → 1.2.0

package/Distribution/PackageExports.Generated.json

@@ -0,0 +1,122 @@
+{
+    ".": {
+        "import": {
+            "default": "./Distribution/index.js",
+            "types": "./Distribution/index.d.mts"
+        },
+        "require": {
+            "default": "./Distribution/index.cjs",
+            "types": "./Distribution/index.d.cts"
+        }
+    },
+    "./array": {
+        "import": {
+            "default": "./Distribution/array.js",
+            "types": "./Distribution/array.d.mts"
+        },
+        "require": {
+            "default": "./Distribution/array.cjs",
+            "types": "./Distribution/array.d.cts"
+        }
+    },
+    "./async": {
+        "import": {
+            "default": "./Distribution/async.js",
+            "types": "./Distribution/async.d.mts"
+        },
+        "require": {
+            "default": "./Distribution/async.cjs",
+            "types": "./Distribution/async.d.cts"
+        }
+    },
+    "./complex": {
+        "import": {
+            "default": "./Distribution/complex.js",
+            "types": "./Distribution/complex.d.mts"
+        },
+        "require": {
+            "default": "./Distribution/complex.cjs",
+            "types": "./Distribution/complex.d.cts"
+        }
+    },
+    "./effect": {
+        "import": {
+            "default": "./Distribution/effect.js",
+            "types": "./Distribution/effect.d.mts"
+        },
+        "require": {
+            "default": "./Distribution/effect.cjs",
+            "types": "./Distribution/effect.d.cts"
+        }
+    },
+    "./fs": {
+        "import": {
+            "default": "./Distribution/fs.js",
+            "types": "./Distribution/fs.d.mts"
+        },
+        "require": {
+            "default": "./Distribution/fs.cjs",
+            "types": "./Distribution/fs.d.cts"
+        }
+    },
+    "./functional": {
+        "import": {
+            "default": "./Distribution/functional.js",
+            "types": "./Distribution/functional.d.mts"
+        },
+        "require": {
+            "default": "./Distribution/functional.cjs",
+            "types": "./Distribution/functional.d.cts"
+        }
+    },
+    "./math": {
+        "import": {
+            "default": "./Distribution/math.js",
+            "types": "./Distribution/math.d.mts"
+        },
+        "require": {
+            "default": "./Distribution/math.cjs",
+            "types": "./Distribution/math.d.cts"
+        }
+    },
+    "./misc": {
+        "import": {
+            "default": "./Distribution/misc.js",
+            "types": "./Distribution/misc.d.mts"
+        },
+        "require": {
+            "default": "./Distribution/misc.cjs",
+            "types": "./Distribution/misc.d.cts"
+        }
+    },
+    "./npm": {
+        "import": {
+            "default": "./Distribution/npm.js",
+            "types": "./Distribution/npm.d.mts"
+        },
+        "require": {
+            "default": "./Distribution/npm.cjs",
+            "types": "./Distribution/npm.d.cts"
+        }
+    },
+    "./npm-effect": {
+        "import": {
+            "default": "./Distribution/npm-effect.js",
+            "types": "./Distribution/npm-effect.d.mts"
+        },
+        "require": {
+            "default": "./Distribution/npm-effect.cjs",
+            "types": "./Distribution/npm-effect.d.cts"
+        }
+    },
+    "./path": {
+        "import": {
+            "default": "./Distribution/path.js",
+            "types": "./Distribution/path.d.mts"
+        },
+        "require": {
+            "default": "./Distribution/path.cjs",
+            "types": "./Distribution/path.d.cts"
+        }
+    }
+}

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

@@ -0,0 +1,43 @@
+/**
+ * @file      Array.Internal.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { Options, TArrayType } from "./Array.Types.cjs";
+import type { NoOptions } from "../Miscellaneous/Utility.Types.cjs";
+/**
+ * @module Array.Internal
+ * Internal types for the {@link Array} module.
+ *
+ * @internal
+ */
+type TBuildStaticTArrayReadonly<ElementType, ArraySize extends number, Accumulator extends ReadonlyArray<ElementType> = readonly []> = Accumulator["length"] extends ArraySize ? Accumulator : TBuildStaticTArrayReadonly<ElementType, ArraySize, readonly [...Accumulator, ElementType]>;
+export type TBuildStaticTArrayMutable<ElementType, ArraySize extends number, Accumulator extends Array<ElementType> = []> = Accumulator["length"] extends ArraySize ? Accumulator : TBuildStaticTArrayMutable<ElementType, ArraySize, [
+    ...Accumulator,
+    ElementType
+]>;
+/**
+ * Used to define {@link Array.TStaticArray}.
+ * @template ElementType - The type of this, or the type of this `Array`.
+ * @template ArraySize - The number of {@link ElementType | ElementTypes} in this `Array`.  The
+ * @template ReadonlyType - Whether the built {@link Array} type will be `readonly`.
+ * this type.
+ * @internal
+ */
+export type TBuildStaticTArrayBase<ElementType, ArraySize extends number, ReadonlyType extends boolean> = ReadonlyType extends true ? TBuildStaticTArrayReadonly<ElementType, ArraySize> : ReadonlyType extends false ? TBuildStaticTArrayMutable<ElementType, ArraySize> : never;
+export type TBuildStaticTArray<ElementType, ArraySize extends number, OptionsType extends Options = NoOptions> = Options.DefinedOnly extends OptionsType ? Options.MaybeDefined extends OptionsType ? never : Options.Readonly extends OptionsType ? TBuildStaticTArrayReadonly<Exclude<ElementType, undefined>, ArraySize> : TBuildStaticTArrayMutable<Exclude<ElementType, undefined>, ArraySize> : Options.MaybeDefined extends OptionsType ? Options.Readonly extends OptionsType ? TBuildStaticTArrayReadonly<ElementType | undefined, ArraySize> : TBuildStaticTArrayMutable<ElementType | undefined, ArraySize> : Options.Readonly extends OptionsType ? TBuildStaticTArrayReadonly<ElementType, ArraySize> : TBuildStaticTArrayMutable<ElementType, ArraySize>;
+/**
+ * Wrap a `TArrayType` type with this to change the {@link ElementType} to `ElementType | undefined`.
+ *
+ * @template ArrayType - The type of `TArrayType` to transform.
+ */
+export type TWithUndefined<ArrayType> = ArrayType extends TArrayType<infer ElementType, infer OptionsType, infer ArraySize> ? TArrayType<ElementType | undefined, OptionsType, ArraySize> : never;
+/**
+ * The opposite of {@link TWithUndefined}.
+ *
+ * @template ArrayType - The type of `TArrayType` to transform.
+ */
+export type TWithDefined<ArrayType> = ArrayType extends TArrayType<infer ElementType, infer OptionsType, infer ArraySize> ? TArrayType<Exclude<ElementType, undefined>, OptionsType, ArraySize> : never;
+export {};
+//# sourceMappingURL=Array.Internal.Types.d.cts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Array.Internal.Types.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Array/Array.Internal.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAEnE;;;;;GAKG;AAEH,KAAK,0BAA0B,CAC3B,WAAW,EACX,SAAS,SAAS,MAAM,EACxB,WAAW,SAAS,aAAa,CAAC,WAAW,CAAC,GAAG,SAAS,EAAG,IAE7D,WAAW,CAAC,QAAQ,CAAC,SAAS,SAAS,GACjC,WAAW,GACX,0BAA0B,CACxB,WAAW,EACX,SAAS,EACT,SAAS,CAAE,GAAG,WAAW,EAAE,WAAW,CAAE,CAC3C,CAAC;AAEV,MAAM,MAAM,yBAAyB,CACjC,WAAW,EACX,SAAS,SAAS,MAAM,EACxB,WAAW,SAAS,KAAK,CAAC,WAAW,CAAC,GAAG,EAAG,IAE5C,WAAW,CAAC,QAAQ,CAAC,SAAS,SAAS,GACjC,WAAW,GACX,yBAAyB,CACvB,WAAW,EACX,SAAS,EACT;IAAE,GAAG,WAAW;IAAE,WAAW;CAAE,CAClC,CAAC;AAEV;;;;;;;GAOG;AACH,MAAM,MAAM,sBAAsB,CAC9B,WAAW,EACX,SAAS,SAAS,MAAM,EACxB,YAAY,SAAS,OAAO,IAE5B,YAAY,SAAS,IAAI,GACnB,0BAA0B,CAAC,WAAW,EAAE,SAAS,CAAC,GAClD,YAAY,SAAS,KAAK,GACtB,yBAAyB,CAAC,WAAW,EAAE,SAAS,CAAC,GACjD,KAAK,CAAC;AAEpB,MAAM,MAAM,kBAAkB,CAC1B,WAAW,EACX,SAAS,SAAS,MAAM,EACxB,WAAW,SAAS,OAAO,GAAG,SAAS,IAEvC,OAAO,CAAC,WAAW,SAAS,WAAW,GACjC,OAAO,CAAC,YAAY,SAAS,WAAW,GACpC,KAAK,GACL,OAAO,CAAC,QAAQ,SAAS,WAAW,GAChC,0BAA0B,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,GACtE,yBAAyB,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,GAC7E,OAAO,CAAC,YAAY,SAAS,WAAW,GACpC,OAAO,CAAC,QAAQ,SAAS,WAAW,GAChC,0BAA0B,CAAC,WAAW,GAAG,SAAS,EAAE,SAAS,CAAC,GAC9D,yBAAyB,CAAC,WAAW,GAAG,SAAS,EAAE,SAAS,CAAC,GACjE,OAAO,CAAC,QAAQ,SAAS,WAAW,GAChC,0BAA0B,CAAC,WAAW,EAAE,SAAS,CAAC,GAClD,yBAAyB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAEpE;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,SAAS,IAChC,SAAS,SAAS,UAAU,CAAC,MAAM,WAAW,EAAE,MAAM,WAAW,EAAE,MAAM,SAAS,CAAC,GAC7E,UAAU,CAAC,WAAW,GAAG,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,GAC3D,KAAK,CAAC;AAEhB;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,SAAS,IAC9B,SAAS,SAAS,UAAU,CAAC,MAAM,WAAW,EAAE,MAAM,WAAW,EAAE,MAAM,SAAS,CAAC,GAC7E,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,GACnE,KAAK,CAAC"
+}

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

@@ -0,0 +1,43 @@
+/**
+ * @file      Array.Internal.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { Options, TArrayType } from "./Array.Types.mjs";
+import type { NoOptions } from "../Miscellaneous/Utility.Types.mjs";
+/**
+ * @module Array.Internal
+ * Internal types for the {@link Array} module.
+ *
+ * @internal
+ */
+type TBuildStaticTArrayReadonly<ElementType, ArraySize extends number, Accumulator extends ReadonlyArray<ElementType> = readonly []> = Accumulator["length"] extends ArraySize ? Accumulator : TBuildStaticTArrayReadonly<ElementType, ArraySize, readonly [...Accumulator, ElementType]>;
+export type TBuildStaticTArrayMutable<ElementType, ArraySize extends number, Accumulator extends Array<ElementType> = []> = Accumulator["length"] extends ArraySize ? Accumulator : TBuildStaticTArrayMutable<ElementType, ArraySize, [
+    ...Accumulator,
+    ElementType
+]>;
+/**
+ * Used to define {@link Array.TStaticArray}.
+ * @template ElementType - The type of this, or the type of this `Array`.
+ * @template ArraySize - The number of {@link ElementType | ElementTypes} in this `Array`.  The
+ * @template ReadonlyType - Whether the built {@link Array} type will be `readonly`.
+ * this type.
+ * @internal
+ */
+export type TBuildStaticTArrayBase<ElementType, ArraySize extends number, ReadonlyType extends boolean> = ReadonlyType extends true ? TBuildStaticTArrayReadonly<ElementType, ArraySize> : ReadonlyType extends false ? TBuildStaticTArrayMutable<ElementType, ArraySize> : never;
+export type TBuildStaticTArray<ElementType, ArraySize extends number, OptionsType extends Options = NoOptions> = Options.DefinedOnly extends OptionsType ? Options.MaybeDefined extends OptionsType ? never : Options.Readonly extends OptionsType ? TBuildStaticTArrayReadonly<Exclude<ElementType, undefined>, ArraySize> : TBuildStaticTArrayMutable<Exclude<ElementType, undefined>, ArraySize> : Options.MaybeDefined extends OptionsType ? Options.Readonly extends OptionsType ? TBuildStaticTArrayReadonly<ElementType | undefined, ArraySize> : TBuildStaticTArrayMutable<ElementType | undefined, ArraySize> : Options.Readonly extends OptionsType ? TBuildStaticTArrayReadonly<ElementType, ArraySize> : TBuildStaticTArrayMutable<ElementType, ArraySize>;
+/**
+ * Wrap a `TArrayType` type with this to change the {@link ElementType} to `ElementType | undefined`.
+ *
+ * @template ArrayType - The type of `TArrayType` to transform.
+ */
+export type TWithUndefined<ArrayType> = ArrayType extends TArrayType<infer ElementType, infer OptionsType, infer ArraySize> ? TArrayType<ElementType | undefined, OptionsType, ArraySize> : never;
+/**
+ * The opposite of {@link TWithUndefined}.
+ *
+ * @template ArrayType - The type of `TArrayType` to transform.
+ */
+export type TWithDefined<ArrayType> = ArrayType extends TArrayType<infer ElementType, infer OptionsType, infer ArraySize> ? TArrayType<Exclude<ElementType, undefined>, OptionsType, ArraySize> : never;
+export {};
+//# sourceMappingURL=Array.Internal.Types.d.mts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Array.Internal.Types.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Array/Array.Internal.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAEnE;;;;;GAKG;AAEH,KAAK,0BAA0B,CAC3B,WAAW,EACX,SAAS,SAAS,MAAM,EACxB,WAAW,SAAS,aAAa,CAAC,WAAW,CAAC,GAAG,SAAS,EAAG,IAE7D,WAAW,CAAC,QAAQ,CAAC,SAAS,SAAS,GACjC,WAAW,GACX,0BAA0B,CACxB,WAAW,EACX,SAAS,EACT,SAAS,CAAE,GAAG,WAAW,EAAE,WAAW,CAAE,CAC3C,CAAC;AAEV,MAAM,MAAM,yBAAyB,CACjC,WAAW,EACX,SAAS,SAAS,MAAM,EACxB,WAAW,SAAS,KAAK,CAAC,WAAW,CAAC,GAAG,EAAG,IAE5C,WAAW,CAAC,QAAQ,CAAC,SAAS,SAAS,GACjC,WAAW,GACX,yBAAyB,CACvB,WAAW,EACX,SAAS,EACT;IAAE,GAAG,WAAW;IAAE,WAAW;CAAE,CAClC,CAAC;AAEV;;;;;;;GAOG;AACH,MAAM,MAAM,sBAAsB,CAC9B,WAAW,EACX,SAAS,SAAS,MAAM,EACxB,YAAY,SAAS,OAAO,IAE5B,YAAY,SAAS,IAAI,GACnB,0BAA0B,CAAC,WAAW,EAAE,SAAS,CAAC,GAClD,YAAY,SAAS,KAAK,GACtB,yBAAyB,CAAC,WAAW,EAAE,SAAS,CAAC,GACjD,KAAK,CAAC;AAEpB,MAAM,MAAM,kBAAkB,CAC1B,WAAW,EACX,SAAS,SAAS,MAAM,EACxB,WAAW,SAAS,OAAO,GAAG,SAAS,IAEvC,OAAO,CAAC,WAAW,SAAS,WAAW,GACjC,OAAO,CAAC,YAAY,SAAS,WAAW,GACpC,KAAK,GACL,OAAO,CAAC,QAAQ,SAAS,WAAW,GAChC,0BAA0B,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,GACtE,yBAAyB,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,GAC7E,OAAO,CAAC,YAAY,SAAS,WAAW,GACpC,OAAO,CAAC,QAAQ,SAAS,WAAW,GAChC,0BAA0B,CAAC,WAAW,GAAG,SAAS,EAAE,SAAS,CAAC,GAC9D,yBAAyB,CAAC,WAAW,GAAG,SAAS,EAAE,SAAS,CAAC,GACjE,OAAO,CAAC,QAAQ,SAAS,WAAW,GAChC,0BAA0B,CAAC,WAAW,EAAE,SAAS,CAAC,GAClD,yBAAyB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAEpE;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,SAAS,IAChC,SAAS,SAAS,UAAU,CAAC,MAAM,WAAW,EAAE,MAAM,WAAW,EAAE,MAAM,SAAS,CAAC,GAC7E,UAAU,CAAC,WAAW,GAAG,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,GAC3D,KAAK,CAAC;AAEhB;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,SAAS,IAC9B,SAAS,SAAS,UAAU,CAAC,MAAM,WAAW,EAAE,MAAM,WAAW,EAAE,MAAM,SAAS,CAAC,GAC7E,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,GACnE,KAAK,CAAC"
+}

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

@@ -0,0 +1,16 @@
+/**
+ * @file      Array.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @module Array.Internal
+ * Internal content for the {@link Array} module.
+ *
+ * @internal
+ */
+export declare const ReadonlyOption: unique symbol;
+export declare const DefinedOnlyOption: unique symbol;
+export declare const MaybeDefinedOption: unique symbol;
+//# sourceMappingURL=Array.Internal.d.cts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Array.Internal.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Array/Array.Internal.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH;;;;;GAKG;AAEH,eAIA,MAAM,cAAc,EAAE,OAAO,MAAiC,CAAC;AAE/D,eAIA,MAAM,iBAAiB,EAAE,OAAO,MAAoC,CAAC;AAErE,eAIA,MAAM,kBAAkB,EAAE,OAAO,MAAqC,CAAC"
+}

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

@@ -0,0 +1,16 @@
+/**
+ * @file      Array.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @module Array.Internal
+ * Internal content for the {@link Array} module.
+ *
+ * @internal
+ */
+export declare const ReadonlyOption: unique symbol;
+export declare const DefinedOnlyOption: unique symbol;
+export declare const MaybeDefinedOption: unique symbol;
+//# sourceMappingURL=Array.Internal.d.mts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Array.Internal.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Array/Array.Internal.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH;;;;;GAKG;AAEH,eAIA,MAAM,cAAc,EAAE,OAAO,MAAiC,CAAC;AAE/D,eAIA,MAAM,iBAAiB,EAAE,OAAO,MAAoC,CAAC;AAErE,eAIA,MAAM,kBAAkB,EAAE,OAAO,MAAqC,CAAC"
+}

package/Distribution/Types/Array/Array.Types.d.cts

@@ -0,0 +1,92 @@
+/**
+ * @file      Array.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { DefinedOnlyOption, MaybeDefinedOption, ReadonlyOption } from "./Array.Internal.cjs";
+import type { NoOptions, TOptions } from "../Miscellaneous/Utility.Types.cjs";
+import type { TBuildStaticTArray } from "./Array.Internal.Types.cjs";
+import type { TIsNonNegativeInteger } from "../Math/Math.Types.cjs";
+/**
+ * An `Array` type, which is optionally customizable via an {@link OptionsType}.
+ *
+ * @template ElementType - The type of the elements in the array.
+ * @template OptionsType - *(Optional)* The {@link Options:type | options type} for this type.
+ */
+export type TArray<ElementType, OptionsType extends Options = NoOptions> = Options.DefinedOnly extends OptionsType ? Options.MaybeDefined extends OptionsType ? never : Options.Readonly extends OptionsType ? ReadonlyArray<Exclude<ElementType, undefined>> : Array<Exclude<ElementType, undefined>> : Options.MaybeDefined extends OptionsType ? Options.Readonly extends OptionsType ? ReadonlyArray<ElementType | undefined> : Array<ElementType | undefined> : Options.Readonly extends OptionsType ? ReadonlyArray<ElementType> : Array<ElementType>;
+/**
+ * The union of all `Array` types exported by the `@sorrell/utilities` {@link Array}
+ * module, as well as the built-in `Array` type.
+ *
+ * @note This union does *not* include {@link TMaybeArray}.
+ * If you wish to include {@link TMaybeArray}, use {@link TArrayTypeUnsafe}.
+ *
+ * @template ElementType - The type of the elements in the array.
+ * @template OptionsType - *(Optional)* The {@link Options:type | options type} for this type.
+ * @template ArraySize - The number of {@link ElementType | ElementTypes} in this `Array`.  The
+ * only type in this union that uses this type parameter is {@link TStaticArray}.
+ */
+export type TArrayType<ElementType = unknown, OptionsType extends Options = NoOptions, ArraySize extends number = number> = TArray<ElementType, OptionsType> | TNonemptyArray<ElementType, OptionsType> | TStaticArray<ElementType, ArraySize, OptionsType> | Array<ElementType>;
+/**
+ * The union of all `Array` types exported by the `@sorrell/utilities` {@link Array}
+ * module, as well as the built-in `Array` type.
+ *
+ * @note This union includes {@link TMaybeArray}.  If you do not wish to include
+ * {@link TMaybeArray} in the union, use {@link TArrayType} instead.
+ *
+ * @template ElementType - The type of the elements in the array.
+ * @template OptionsType - *(Optional)* The {@link Options:type | options type} for this type.
+ * @template ArraySize - The number of {@link ElementType | ElementTypes} in this `Array`.  The
+ * only type in this union that uses this type parameter is {@link TStaticArray}.
+ */
+export type TArrayTypeUnsafe<ElementType, OptionsType extends Options = NoOptions, ArraySize extends number = number> = TArrayType<ElementType, OptionsType, ArraySize> | TMaybeArray<ElementType>;
+/**
+ * The union of a given {@link ElementType}, and `Array<ElementType>`.
+ *
+ * @template ElementType - The type of this, or the type of this `Array`.
+ * @template OptionsType - *(Optional)* The {@link Options:type | options type} for this type.
+ */
+export type TMaybeArray<ElementType, OptionsType extends Options = NoOptions> = ElementType | TArray<ElementType, OptionsType>;
+/**
+ * The union of a given {@link ElementType}, and `Array<ElementType>`.
+ *
+ * @template ElementType - The type of this, or the type of this `Array`.
+ * @template ArraySize - The number of {@link ElementType | ElementTypes} in this `Array`.
+ * This must be an integer.
+ * @template OptionsType - *(Optional)* The {@link Options:type | options type} for this type.
+ */
+export type TStaticArray<ElementType, ArraySize extends number, OptionsType extends Options = NoOptions> = ArraySize extends ArraySize ? number extends ArraySize ? TArray<ElementType, OptionsType> : TIsNonNegativeInteger<ArraySize> extends true ? TBuildStaticTArray<ElementType, ArraySize, OptionsType> : never : never;
+/**
+ * An `Array<ElementType>` that is nonempty.
+ *
+ * @template ElementType - The type of the elements in the array.
+ * @template OptionsType - *(Optional)* The {@link Options:type | options type} for this type.
+ */
+export type TNonemptyArray<ElementType, OptionsType extends Options = NoOptions> = Options.DefinedOnly extends OptionsType ? Options.MaybeDefined extends OptionsType ? never : Options.Readonly extends OptionsType ? readonly [Exclude<ElementType, undefined>, ...Array<Exclude<ElementType, undefined>>] : [Exclude<ElementType, undefined>, ...Array<Exclude<ElementType, undefined>>] : Options.MaybeDefined extends OptionsType ? Options.Readonly extends OptionsType ? readonly [ElementType | undefined, ...Array<ElementType | undefined>] : [ElementType | undefined, ...Array<ElementType | undefined>] : Options.Readonly extends OptionsType ? readonly [ElementType, ...Array<ElementType>] : [ElementType, ...Array<ElementType>];
+/**
+ * Options for the types defined in the {@link Array} module.
+ *
+ * The only invalid combinations are those that contain both
+ * {@link Options!DefinedOnly} *and* {@link Options!MaybeDefined}.
+ */
+export type Options = TOptions<Options.Readonly | Options.DefinedOnly | Options.MaybeDefined>;
+export declare namespace Options {
+    /**
+     * Specifies that the given array type in the `@sorrell/utilities` `Array` module
+     * should use `ReadonlyArray` internally.
+     */
+    type Readonly = typeof ReadonlyOption;
+    /** Specifies that `undefined` must extend the given `ElementType`. */
+    type MaybeDefined = typeof MaybeDefinedOption;
+    /** Specifies that the given `ElementType` must *not* include `undefined`. */
+    type DefinedOnly = typeof DefinedOnlyOption;
+    type None = NoOptions;
+}
+/**
+ * The type returned by {@link FilterDefined}.
+ *
+ * @template ElementType - The type of the elements in the array.
+ */
+export type FilteredArray<ElementType> = TArray<Exclude<ElementType, undefined>>;
+//# sourceMappingURL=Array.Types.d.cts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Array.Types.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Array/Array.Types.ts"
+    ],
+    "names": [],
+    "mappings": "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"
+}

package/Distribution/Types/Array/Array.Types.d.mts

@@ -0,0 +1,92 @@
+/**
+ * @file      Array.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { DefinedOnlyOption, MaybeDefinedOption, ReadonlyOption } from "./Array.Internal.mjs";
+import type { NoOptions, TOptions } from "../Miscellaneous/Utility.Types.mjs";
+import type { TBuildStaticTArray } from "./Array.Internal.Types.mjs";
+import type { TIsNonNegativeInteger } from "../Math/Math.Types.mjs";
+/**
+ * An `Array` type, which is optionally customizable via an {@link OptionsType}.
+ *
+ * @template ElementType - The type of the elements in the array.
+ * @template OptionsType - *(Optional)* The {@link Options:type | options type} for this type.
+ */
+export type TArray<ElementType, OptionsType extends Options = NoOptions> = Options.DefinedOnly extends OptionsType ? Options.MaybeDefined extends OptionsType ? never : Options.Readonly extends OptionsType ? ReadonlyArray<Exclude<ElementType, undefined>> : Array<Exclude<ElementType, undefined>> : Options.MaybeDefined extends OptionsType ? Options.Readonly extends OptionsType ? ReadonlyArray<ElementType | undefined> : Array<ElementType | undefined> : Options.Readonly extends OptionsType ? ReadonlyArray<ElementType> : Array<ElementType>;
+/**
+ * The union of all `Array` types exported by the `@sorrell/utilities` {@link Array}
+ * module, as well as the built-in `Array` type.
+ *
+ * @note This union does *not* include {@link TMaybeArray}.
+ * If you wish to include {@link TMaybeArray}, use {@link TArrayTypeUnsafe}.
+ *
+ * @template ElementType - The type of the elements in the array.
+ * @template OptionsType - *(Optional)* The {@link Options:type | options type} for this type.
+ * @template ArraySize - The number of {@link ElementType | ElementTypes} in this `Array`.  The
+ * only type in this union that uses this type parameter is {@link TStaticArray}.
+ */
+export type TArrayType<ElementType = unknown, OptionsType extends Options = NoOptions, ArraySize extends number = number> = TArray<ElementType, OptionsType> | TNonemptyArray<ElementType, OptionsType> | TStaticArray<ElementType, ArraySize, OptionsType> | Array<ElementType>;
+/**
+ * The union of all `Array` types exported by the `@sorrell/utilities` {@link Array}
+ * module, as well as the built-in `Array` type.
+ *
+ * @note This union includes {@link TMaybeArray}.  If you do not wish to include
+ * {@link TMaybeArray} in the union, use {@link TArrayType} instead.
+ *
+ * @template ElementType - The type of the elements in the array.
+ * @template OptionsType - *(Optional)* The {@link Options:type | options type} for this type.
+ * @template ArraySize - The number of {@link ElementType | ElementTypes} in this `Array`.  The
+ * only type in this union that uses this type parameter is {@link TStaticArray}.
+ */
+export type TArrayTypeUnsafe<ElementType, OptionsType extends Options = NoOptions, ArraySize extends number = number> = TArrayType<ElementType, OptionsType, ArraySize> | TMaybeArray<ElementType>;
+/**
+ * The union of a given {@link ElementType}, and `Array<ElementType>`.
+ *
+ * @template ElementType - The type of this, or the type of this `Array`.
+ * @template OptionsType - *(Optional)* The {@link Options:type | options type} for this type.
+ */
+export type TMaybeArray<ElementType, OptionsType extends Options = NoOptions> = ElementType | TArray<ElementType, OptionsType>;
+/**
+ * The union of a given {@link ElementType}, and `Array<ElementType>`.
+ *
+ * @template ElementType - The type of this, or the type of this `Array`.
+ * @template ArraySize - The number of {@link ElementType | ElementTypes} in this `Array`.
+ * This must be an integer.
+ * @template OptionsType - *(Optional)* The {@link Options:type | options type} for this type.
+ */
+export type TStaticArray<ElementType, ArraySize extends number, OptionsType extends Options = NoOptions> = ArraySize extends ArraySize ? number extends ArraySize ? TArray<ElementType, OptionsType> : TIsNonNegativeInteger<ArraySize> extends true ? TBuildStaticTArray<ElementType, ArraySize, OptionsType> : never : never;
+/**
+ * An `Array<ElementType>` that is nonempty.
+ *
+ * @template ElementType - The type of the elements in the array.
+ * @template OptionsType - *(Optional)* The {@link Options:type | options type} for this type.
+ */
+export type TNonemptyArray<ElementType, OptionsType extends Options = NoOptions> = Options.DefinedOnly extends OptionsType ? Options.MaybeDefined extends OptionsType ? never : Options.Readonly extends OptionsType ? readonly [Exclude<ElementType, undefined>, ...Array<Exclude<ElementType, undefined>>] : [Exclude<ElementType, undefined>, ...Array<Exclude<ElementType, undefined>>] : Options.MaybeDefined extends OptionsType ? Options.Readonly extends OptionsType ? readonly [ElementType | undefined, ...Array<ElementType | undefined>] : [ElementType | undefined, ...Array<ElementType | undefined>] : Options.Readonly extends OptionsType ? readonly [ElementType, ...Array<ElementType>] : [ElementType, ...Array<ElementType>];
+/**
+ * Options for the types defined in the {@link Array} module.
+ *
+ * The only invalid combinations are those that contain both
+ * {@link Options!DefinedOnly} *and* {@link Options!MaybeDefined}.
+ */
+export type Options = TOptions<Options.Readonly | Options.DefinedOnly | Options.MaybeDefined>;
+export declare namespace Options {
+    /**
+     * Specifies that the given array type in the `@sorrell/utilities` `Array` module
+     * should use `ReadonlyArray` internally.
+     */
+    type Readonly = typeof ReadonlyOption;
+    /** Specifies that `undefined` must extend the given `ElementType`. */
+    type MaybeDefined = typeof MaybeDefinedOption;
+    /** Specifies that the given `ElementType` must *not* include `undefined`. */
+    type DefinedOnly = typeof DefinedOnlyOption;
+    type None = NoOptions;
+}
+/**
+ * The type returned by {@link FilterDefined}.
+ *
+ * @template ElementType - The type of the elements in the array.
+ */
+export type FilteredArray<ElementType> = TArray<Exclude<ElementType, undefined>>;
+//# sourceMappingURL=Array.Types.d.mts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Array.Types.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Array/Array.Types.ts"
+    ],
+    "names": [],
+    "mappings": "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"
+}

package/Distribution/Types/Array/Array.d.cts

@@ -0,0 +1,33 @@
+/**
+ * @file      Array.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { FilteredArray, Options, TArrayType } from "./Array.Types.cjs";
+import type { NoOptions } from "../Miscellaneous/Utility.Types.cjs";
+/**
+ * Filter out all instances of `undefined` from a given {@link Array:param}.
+ * @param Array - The array to filter.
+ *
+ * @template ElementType - The type of the elements in the array.
+ *
+ * @returns {TArrayType<Exclude<ElementType, undefined>, Exclude<OptionsType, Options.MaybeDefined>>}
+ * A new `Array` of type `Exclude<ElementType, undefined>` and `OptionsType` that is the given
+ * {@link OptionsType}, with the {@link Options.MaybeDefined} option removed.
+ *
+ * @example With the given {@link ElementType} including `undefined`.
+ * ```typescript
+ * const MaybeOddNumbers: TArray<number | undefined> = [ 1, 3, undefined, 5 ];
+ * const OddNumbers: TArray<number> = FilterDefined(MaybeOddNumbers);
+ * ```
+ * @example With the given {@link OptionsType} including `Options.MaybeDefined`.
+ * ```typescript
+ * const MaybeOddNumbers: TArray<number, Options.MaybeDefined> = [ 1, 3, undefined, 5 ];
+ * const OddNumbers: TArray<number> = FilterDefined(MaybeOddNumbers);
+ * ```
+ */
+export declare function FilterDefined<ElementType, OptionsType extends Options = NoOptions, ArraySize extends number = number>(Array: TArrayType<ElementType, OptionsType | Options.MaybeDefined, ArraySize>): FilteredArray<ElementType>;
+export declare function FilterDefined<ElementType, OptionsType extends Options = NoOptions, ArraySize extends number = number>(Array: TArrayType<ElementType | undefined, OptionsType, ArraySize>): FilteredArray<ElementType>;
+export declare function FilterDefined<ElementType, OptionsType extends Options = NoOptions, ArraySize extends number = number>(Array: TArrayType<ElementType | undefined, OptionsType | Options.MaybeDefined, ArraySize>): FilteredArray<ElementType>;
+//# sourceMappingURL=Array.d.cts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Array.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Array/Array.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CACzB,WAAW,EACX,WAAW,SAAS,OAAO,GAAG,SAAS,EACvC,SAAS,SAAS,MAAM,GAAG,MAAM,EAEjC,KAAK,EAAE,UAAU,CACb,WAAW,EACX,WAAW,GAAG,OAAO,CAAC,YAAY,EAClC,SAAS,CACZ,GACF,aAAa,CAAC,WAAW,CAAC,CAAC;AAC9B,wBAAgB,aAAa,CACzB,WAAW,EACX,WAAW,SAAS,OAAO,GAAG,SAAS,EACvC,SAAS,SAAS,MAAM,GAAG,MAAM,EAEjC,KAAK,EAAE,UAAU,CACb,WAAW,GAAG,SAAS,EACvB,WAAW,EACX,SAAS,CACZ,GACF,aAAa,CAAC,WAAW,CAAC,CAAC;AAC9B,wBAAgB,aAAa,CACzB,WAAW,EACX,WAAW,SAAS,OAAO,GAAG,SAAS,EACvC,SAAS,SAAS,MAAM,GAAG,MAAM,EAEjC,KAAK,EAAE,UAAU,CACb,WAAW,GAAG,SAAS,EACvB,WAAW,GAAG,OAAO,CAAC,YAAY,EAClC,SAAS,CACZ,GACF,aAAa,CAAC,WAAW,CAAC,CAAC"
+}

package/Distribution/Types/Array/Array.d.mts

@@ -0,0 +1,33 @@
+/**
+ * @file      Array.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { FilteredArray, Options, TArrayType } from "./Array.Types.mjs";
+import type { NoOptions } from "../Miscellaneous/Utility.Types.mjs";
+/**
+ * Filter out all instances of `undefined` from a given {@link Array:param}.
+ * @param Array - The array to filter.
+ *
+ * @template ElementType - The type of the elements in the array.
+ *
+ * @returns {TArrayType<Exclude<ElementType, undefined>, Exclude<OptionsType, Options.MaybeDefined>>}
+ * A new `Array` of type `Exclude<ElementType, undefined>` and `OptionsType` that is the given
+ * {@link OptionsType}, with the {@link Options.MaybeDefined} option removed.
+ *
+ * @example With the given {@link ElementType} including `undefined`.
+ * ```typescript
+ * const MaybeOddNumbers: TArray<number | undefined> = [ 1, 3, undefined, 5 ];
+ * const OddNumbers: TArray<number> = FilterDefined(MaybeOddNumbers);
+ * ```
+ * @example With the given {@link OptionsType} including `Options.MaybeDefined`.
+ * ```typescript
+ * const MaybeOddNumbers: TArray<number, Options.MaybeDefined> = [ 1, 3, undefined, 5 ];
+ * const OddNumbers: TArray<number> = FilterDefined(MaybeOddNumbers);
+ * ```
+ */
+export declare function FilterDefined<ElementType, OptionsType extends Options = NoOptions, ArraySize extends number = number>(Array: TArrayType<ElementType, OptionsType | Options.MaybeDefined, ArraySize>): FilteredArray<ElementType>;
+export declare function FilterDefined<ElementType, OptionsType extends Options = NoOptions, ArraySize extends number = number>(Array: TArrayType<ElementType | undefined, OptionsType, ArraySize>): FilteredArray<ElementType>;
+export declare function FilterDefined<ElementType, OptionsType extends Options = NoOptions, ArraySize extends number = number>(Array: TArrayType<ElementType | undefined, OptionsType | Options.MaybeDefined, ArraySize>): FilteredArray<ElementType>;
+//# sourceMappingURL=Array.d.mts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Array.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Array/Array.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CACzB,WAAW,EACX,WAAW,SAAS,OAAO,GAAG,SAAS,EACvC,SAAS,SAAS,MAAM,GAAG,MAAM,EAEjC,KAAK,EAAE,UAAU,CACb,WAAW,EACX,WAAW,GAAG,OAAO,CAAC,YAAY,EAClC,SAAS,CACZ,GACF,aAAa,CAAC,WAAW,CAAC,CAAC;AAC9B,wBAAgB,aAAa,CACzB,WAAW,EACX,WAAW,SAAS,OAAO,GAAG,SAAS,EACvC,SAAS,SAAS,MAAM,GAAG,MAAM,EAEjC,KAAK,EAAE,UAAU,CACb,WAAW,GAAG,SAAS,EACvB,WAAW,EACX,SAAS,CACZ,GACF,aAAa,CAAC,WAAW,CAAC,CAAC;AAC9B,wBAAgB,aAAa,CACzB,WAAW,EACX,WAAW,SAAS,OAAO,GAAG,SAAS,EACvC,SAAS,SAAS,MAAM,GAAG,MAAM,EAEjC,KAAK,EAAE,UAAU,CACb,WAAW,GAAG,SAAS,EACvB,WAAW,GAAG,OAAO,CAAC,YAAY,EAClC,SAAS,CACZ,GACF,aAAa,CAAC,WAAW,CAAC,CAAC"
+}

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

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

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