radashi 12.2.1 → 12.2.2

package/dist/radashi.cjs

@@ -358,20 +358,17 @@ function zipToObject(keys2, values) {
 }
 
 // src/async/AggregateError.ts
-var AggregateErrorOrPolyfill = /* @__PURE__ */ (() => (
-  // eslint-disable-next-line compat/compat
-  globalThis.AggregateError ?? class AggregateError extends Error {
-    constructor(errors = []) {
-      var _a, _b;
-      super();
-      const name = ((_a = errors.find((e) => e.name)) == null ? void 0 : _a.name) ?? "";
-      this.name = `AggregateError(${name}...)`;
-      this.message = `AggregateError with ${errors.length} errors`;
-      this.stack = ((_b = errors.find((e) => e.stack)) == null ? void 0 : _b.stack) ?? this.stack;
-      this.errors = errors;
-    }
+var AggregateErrorOrPolyfill = /* @__PURE__ */ (() => globalThis.AggregateError ?? class AggregateError extends Error {
+  constructor(errors = []) {
+    var _a, _b;
+    super();
+    const name = ((_a = errors.find((e) => e.name)) == null ? void 0 : _a.name) ?? "";
+    this.name = `AggregateError(${name}...)`;
+    this.message = `AggregateError with ${errors.length} errors`;
+    this.stack = ((_b = errors.find((e) => e.stack)) == null ? void 0 : _b.stack) ?? this.stack;
+    this.errors = errors;
   }
-))();
+})();
 
 // src/async/all.ts
 async function all(promises) {

package/dist/radashi.d.cts

@@ -125,8 +125,7 @@ declare function diff<T>(root: readonly T[], other: readonly T[], identity?: (it
  * ```
  * @version 12.1.0
  */
-declare function first<T>(array: readonly T[]): T | undefined;
-declare function first<T, U>(array: readonly T[], defaultValue: U): T | U;
+declare function first<const TArray extends readonly any[], const TDefault = undefined>(array: TArray, defaultValue?: TDefault): TArray extends readonly [infer TFirst, ...any[]] ? TFirst : TArray[number] | TDefault;
 
 /**
  * Given an array of arrays, returns a single dimensional array with
@@ -220,8 +219,7 @@ declare function iterate<T>(count: number, func: (currentValue: T, iteration: nu
  * ```
  * @version 12.1.0
  */
-declare function last<T>(array: readonly T[]): T | undefined;
-declare function last<T, U>(array: readonly T[], defaultValue: U): T | U;
+declare function last<const TArray extends readonly any[], const TDefault = undefined>(array: TArray, defaultValue?: TDefault): TArray extends readonly [...any[], infer TLast] ? TLast : TArray[number] | TDefault;
 
 /**
  * Creates a list of given start, end, value, and step parameters.
@@ -532,6 +530,14 @@ declare function zip<T1, T2>(array1: readonly T1[], array2: readonly T2[]): [T1,
  */
 declare function zipToObject<K extends string | number | symbol, V>(keys: readonly K[], values: V | ((key: K, idx: number) => V) | readonly V[]): Record<K, V>;
 
+interface AggregateError extends Error {
+    errors: any[];
+}
+interface AggregateErrorConstructor {
+    new (errors: Iterable<any>, message?: string): AggregateError;
+    (errors: Iterable<any>, message?: string): AggregateError;
+    readonly prototype: AggregateError;
+}
 /**
  * The `AggregateError` object represents an error when several errors
  * need to be wrapped in a single error.
@@ -1978,7 +1984,7 @@ declare function upperize<T extends Record<string, any>>(obj: T): UppercaseKeys<
  * ```
  * @version 12.1.0
  */
-declare function draw<T>(array: readonly T[]): T | null;
+declare function draw<const T extends readonly any[]>(array: T): T extends readonly [any, ...any[]] ? T[number] : T[number] | null;
 
 /**
  * Generates a random integer between min and max. Both min and max
@@ -2238,15 +2244,14 @@ declare function isDate(value: unknown): value is Date;
 
 /**
  * Return true if the given value is empty.
+ * This function also uses [Type Guards](https://www.typescriptlang.org/docs/handbook/advanced-types.html#user-defined-type-guards) to ensure type safety
  *
  * Empty values include:
  * - `null`
  * - `undefined`
  * - `0`
- * - `NaN`
- * - `''`
- * - `[]`
- * - `{}`
+ * - empty string
+ * - empty array
  * - invalid `Date` time
  * - object with `length` property of `0`
  * - object with `size` property of `0`
@@ -2263,7 +2268,20 @@ declare function isDate(value: unknown): value is Date;
  * ```
  * @version 12.1.0
  */
-declare function isEmpty(value: any): boolean;
+declare function isEmpty<T extends ToEmptyAble>(value: T): value is ToEmpty<T>;
+declare function isEmpty(value: unknown): boolean;
+type NeverEmpty = symbol | Function;
+/**
+ * A type that can be narrowed by `isEmpty`.
+ */
+type ToEmptyAble = NeverEmpty | boolean | number | string | readonly any[] | null | undefined;
+/**
+ * Narrow a type to an empty value.
+ *
+ * Due to TypeScript limitations, object types cannot be narrowed,
+ * except for arrays and functions.
+ */
+type ToEmpty<T extends ToEmptyAble> = (T extends any[] ? never[] : Extract<false | 0 | '' | readonly never[] | null | undefined, T>) extends infer U ? Extract<U, T> : never;
 
 /**
  * Return true if the given values are equal.
@@ -3361,4 +3379,4 @@ type GlobalObjectType<Identifier extends string> = [Identifier] extends [Any] ?
     [P in Identifier]: any;
 } ? InstanceType<(typeof globalThis)[Identifier]> : never;
 
-export { AggregateErrorOrPolyfill as AggregateError, Any, type Assign, type BoxedPrimitive, type BuiltInType, type CastArray, type CastArrayIfExists, type CloningStrategy, type Comparable, type ComparableProperty, type Comparator, type ComparatorMapping, type CompatibleProperty, type Crush, type CustomClass, type CustomClassRegistry, type DebounceFunction, type DebounceOptions, DefaultCloningStrategy, type Err, type ExtractArray, type ExtractMap, type ExtractNotAny, type ExtractSet, type Falsy, FastCloningStrategy, type FilteredKeys, type Flip, type Intersect, type IsExactType, type KeyFilter, type KeyFilterFunction, type LowercaseKeys, type MappedInput, type MappedOutput, type Mapping, type MappingFunction, type MemoOptions, type NoInfer, type Ok, type OnceFunction, type OptionalKeys, type OptionalMapping, type Primitive, type RequiredKeys, type Result, type ResultPromise, type RetryOptions, type Series, type Simplify, type StrictExtract, type SwitchAny, type SwitchNever, type ThrottledFunction, type TraverseContext, type TraverseOptions, type TraverseVisitor, type TryitResult, type TypedArray, type UppercaseKeys, all, alphabetical, always, assign, boil, callable, camel, capitalize, castArray, castArrayIfExists, castComparator, castMapping, chain, clamp, clone, cloneDeep, cluster, compose, construct, counting, crush, dash, debounce, defer, diff, draw, filterKey, first, flat, flip, fork, get, group, guard, inRange, intersects, invert, isArray, isBoolean, isDate, isEmpty, isEqual, isError, isFloat, isFunction, isInt, isIntString, isIterable, isMap, isNumber, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isResult, isResultErr, isResultOk, isSet, isString, isSymbol, isTagged, isWeakMap, isWeakSet, iterate, keys, last, lerp, list, listify, lowerize, map, mapEntries, mapKeys, mapValues, mapify, max, memo, merge, min, noop, objectify, omit, once, parallel, partial, partob, pascal, pick, proxied, random, range, reduce, replace, replaceOrAppend, retry, round, select, selectFirst, series, set, shake, shift, shuffle, sift, similarity, sleep, snake, sort, sum, template, throttle, title, toFloat, toInt, toggle, traverse, trim, tryit as try, tryit, uid, unique, unzip, upperize, withResolvers, zip, zipToObject };
+export { AggregateErrorOrPolyfill as AggregateError, Any, type Assign, type BoxedPrimitive, type BuiltInType, type CastArray, type CastArrayIfExists, type CloningStrategy, type Comparable, type ComparableProperty, type Comparator, type ComparatorMapping, type CompatibleProperty, type Crush, type CustomClass, type CustomClassRegistry, type DebounceFunction, type DebounceOptions, DefaultCloningStrategy, type Err, type ExtractArray, type ExtractMap, type ExtractNotAny, type ExtractSet, type Falsy, FastCloningStrategy, type FilteredKeys, type Flip, type Intersect, type IsExactType, type KeyFilter, type KeyFilterFunction, type LowercaseKeys, type MappedInput, type MappedOutput, type Mapping, type MappingFunction, type MemoOptions, type NoInfer, type Ok, type OnceFunction, type OptionalKeys, type OptionalMapping, type Primitive, type PromiseWithResolvers, type RequiredKeys, type Result, type ResultPromise, type RetryOptions, type Series, type Simplify, type StrictExtract, type SwitchAny, type SwitchNever, type ThrottledFunction, type ToEmpty, type ToEmptyAble, type TraverseContext, type TraverseOptions, type TraverseVisitor, type TryitResult, type TypedArray, type UppercaseKeys, all, alphabetical, always, assign, boil, callable, camel, capitalize, castArray, castArrayIfExists, castComparator, castMapping, chain, clamp, clone, cloneDeep, cluster, compose, construct, counting, crush, dash, debounce, defer, diff, draw, filterKey, first, flat, flip, fork, get, group, guard, inRange, intersects, invert, isArray, isBoolean, isDate, isEmpty, isEqual, isError, isFloat, isFunction, isInt, isIntString, isIterable, isMap, isNumber, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isResult, isResultErr, isResultOk, isSet, isString, isSymbol, isTagged, isWeakMap, isWeakSet, iterate, keys, last, lerp, list, listify, lowerize, map, mapEntries, mapKeys, mapValues, mapify, max, memo, merge, min, noop, objectify, omit, once, parallel, partial, partob, pascal, pick, proxied, random, range, reduce, replace, replaceOrAppend, retry, round, select, selectFirst, series, set, shake, shift, shuffle, sift, similarity, sleep, snake, sort, sum, template, throttle, title, toFloat, toInt, toggle, traverse, trim, tryit as try, tryit, uid, unique, unzip, upperize, withResolvers, zip, zipToObject };

package/dist/radashi.d.ts

@@ -125,8 +125,7 @@ declare function diff<T>(root: readonly T[], other: readonly T[], identity?: (it
  * ```
  * @version 12.1.0
  */
-declare function first<T>(array: readonly T[]): T | undefined;
-declare function first<T, U>(array: readonly T[], defaultValue: U): T | U;
+declare function first<const TArray extends readonly any[], const TDefault = undefined>(array: TArray, defaultValue?: TDefault): TArray extends readonly [infer TFirst, ...any[]] ? TFirst : TArray[number] | TDefault;
 
 /**
  * Given an array of arrays, returns a single dimensional array with
@@ -220,8 +219,7 @@ declare function iterate<T>(count: number, func: (currentValue: T, iteration: nu
  * ```
  * @version 12.1.0
  */
-declare function last<T>(array: readonly T[]): T | undefined;
-declare function last<T, U>(array: readonly T[], defaultValue: U): T | U;
+declare function last<const TArray extends readonly any[], const TDefault = undefined>(array: TArray, defaultValue?: TDefault): TArray extends readonly [...any[], infer TLast] ? TLast : TArray[number] | TDefault;
 
 /**
  * Creates a list of given start, end, value, and step parameters.
@@ -532,6 +530,14 @@ declare function zip<T1, T2>(array1: readonly T1[], array2: readonly T2[]): [T1,
  */
 declare function zipToObject<K extends string | number | symbol, V>(keys: readonly K[], values: V | ((key: K, idx: number) => V) | readonly V[]): Record<K, V>;
 
+interface AggregateError extends Error {
+    errors: any[];
+}
+interface AggregateErrorConstructor {
+    new (errors: Iterable<any>, message?: string): AggregateError;
+    (errors: Iterable<any>, message?: string): AggregateError;
+    readonly prototype: AggregateError;
+}
 /**
  * The `AggregateError` object represents an error when several errors
  * need to be wrapped in a single error.
@@ -1978,7 +1984,7 @@ declare function upperize<T extends Record<string, any>>(obj: T): UppercaseKeys<
  * ```
  * @version 12.1.0
  */
-declare function draw<T>(array: readonly T[]): T | null;
+declare function draw<const T extends readonly any[]>(array: T): T extends readonly [any, ...any[]] ? T[number] : T[number] | null;
 
 /**
  * Generates a random integer between min and max. Both min and max
@@ -2238,15 +2244,14 @@ declare function isDate(value: unknown): value is Date;
 
 /**
  * Return true if the given value is empty.
+ * This function also uses [Type Guards](https://www.typescriptlang.org/docs/handbook/advanced-types.html#user-defined-type-guards) to ensure type safety
  *
  * Empty values include:
  * - `null`
  * - `undefined`
  * - `0`
- * - `NaN`
- * - `''`
- * - `[]`
- * - `{}`
+ * - empty string
+ * - empty array
  * - invalid `Date` time
  * - object with `length` property of `0`
  * - object with `size` property of `0`
@@ -2263,7 +2268,20 @@ declare function isDate(value: unknown): value is Date;
  * ```
  * @version 12.1.0
  */
-declare function isEmpty(value: any): boolean;
+declare function isEmpty<T extends ToEmptyAble>(value: T): value is ToEmpty<T>;
+declare function isEmpty(value: unknown): boolean;
+type NeverEmpty = symbol | Function;
+/**
+ * A type that can be narrowed by `isEmpty`.
+ */
+type ToEmptyAble = NeverEmpty | boolean | number | string | readonly any[] | null | undefined;
+/**
+ * Narrow a type to an empty value.
+ *
+ * Due to TypeScript limitations, object types cannot be narrowed,
+ * except for arrays and functions.
+ */
+type ToEmpty<T extends ToEmptyAble> = (T extends any[] ? never[] : Extract<false | 0 | '' | readonly never[] | null | undefined, T>) extends infer U ? Extract<U, T> : never;
 
 /**
  * Return true if the given values are equal.
@@ -3361,4 +3379,4 @@ type GlobalObjectType<Identifier extends string> = [Identifier] extends [Any] ?
     [P in Identifier]: any;
 } ? InstanceType<(typeof globalThis)[Identifier]> : never;
 
-export { AggregateErrorOrPolyfill as AggregateError, Any, type Assign, type BoxedPrimitive, type BuiltInType, type CastArray, type CastArrayIfExists, type CloningStrategy, type Comparable, type ComparableProperty, type Comparator, type ComparatorMapping, type CompatibleProperty, type Crush, type CustomClass, type CustomClassRegistry, type DebounceFunction, type DebounceOptions, DefaultCloningStrategy, type Err, type ExtractArray, type ExtractMap, type ExtractNotAny, type ExtractSet, type Falsy, FastCloningStrategy, type FilteredKeys, type Flip, type Intersect, type IsExactType, type KeyFilter, type KeyFilterFunction, type LowercaseKeys, type MappedInput, type MappedOutput, type Mapping, type MappingFunction, type MemoOptions, type NoInfer, type Ok, type OnceFunction, type OptionalKeys, type OptionalMapping, type Primitive, type RequiredKeys, type Result, type ResultPromise, type RetryOptions, type Series, type Simplify, type StrictExtract, type SwitchAny, type SwitchNever, type ThrottledFunction, type TraverseContext, type TraverseOptions, type TraverseVisitor, type TryitResult, type TypedArray, type UppercaseKeys, all, alphabetical, always, assign, boil, callable, camel, capitalize, castArray, castArrayIfExists, castComparator, castMapping, chain, clamp, clone, cloneDeep, cluster, compose, construct, counting, crush, dash, debounce, defer, diff, draw, filterKey, first, flat, flip, fork, get, group, guard, inRange, intersects, invert, isArray, isBoolean, isDate, isEmpty, isEqual, isError, isFloat, isFunction, isInt, isIntString, isIterable, isMap, isNumber, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isResult, isResultErr, isResultOk, isSet, isString, isSymbol, isTagged, isWeakMap, isWeakSet, iterate, keys, last, lerp, list, listify, lowerize, map, mapEntries, mapKeys, mapValues, mapify, max, memo, merge, min, noop, objectify, omit, once, parallel, partial, partob, pascal, pick, proxied, random, range, reduce, replace, replaceOrAppend, retry, round, select, selectFirst, series, set, shake, shift, shuffle, sift, similarity, sleep, snake, sort, sum, template, throttle, title, toFloat, toInt, toggle, traverse, trim, tryit as try, tryit, uid, unique, unzip, upperize, withResolvers, zip, zipToObject };
+export { AggregateErrorOrPolyfill as AggregateError, Any, type Assign, type BoxedPrimitive, type BuiltInType, type CastArray, type CastArrayIfExists, type CloningStrategy, type Comparable, type ComparableProperty, type Comparator, type ComparatorMapping, type CompatibleProperty, type Crush, type CustomClass, type CustomClassRegistry, type DebounceFunction, type DebounceOptions, DefaultCloningStrategy, type Err, type ExtractArray, type ExtractMap, type ExtractNotAny, type ExtractSet, type Falsy, FastCloningStrategy, type FilteredKeys, type Flip, type Intersect, type IsExactType, type KeyFilter, type KeyFilterFunction, type LowercaseKeys, type MappedInput, type MappedOutput, type Mapping, type MappingFunction, type MemoOptions, type NoInfer, type Ok, type OnceFunction, type OptionalKeys, type OptionalMapping, type Primitive, type PromiseWithResolvers, type RequiredKeys, type Result, type ResultPromise, type RetryOptions, type Series, type Simplify, type StrictExtract, type SwitchAny, type SwitchNever, type ThrottledFunction, type ToEmpty, type ToEmptyAble, type TraverseContext, type TraverseOptions, type TraverseVisitor, type TryitResult, type TypedArray, type UppercaseKeys, all, alphabetical, always, assign, boil, callable, camel, capitalize, castArray, castArrayIfExists, castComparator, castMapping, chain, clamp, clone, cloneDeep, cluster, compose, construct, counting, crush, dash, debounce, defer, diff, draw, filterKey, first, flat, flip, fork, get, group, guard, inRange, intersects, invert, isArray, isBoolean, isDate, isEmpty, isEqual, isError, isFloat, isFunction, isInt, isIntString, isIterable, isMap, isNumber, isObject, isPlainObject, isPrimitive, isPromise, isRegExp, isResult, isResultErr, isResultOk, isSet, isString, isSymbol, isTagged, isWeakMap, isWeakSet, iterate, keys, last, lerp, list, listify, lowerize, map, mapEntries, mapKeys, mapValues, mapify, max, memo, merge, min, noop, objectify, omit, once, parallel, partial, partob, pascal, pick, proxied, random, range, reduce, replace, replaceOrAppend, retry, round, select, selectFirst, series, set, shake, shift, shuffle, sift, similarity, sleep, snake, sort, sum, template, throttle, title, toFloat, toInt, toggle, traverse, trim, tryit as try, tryit, uid, unique, unzip, upperize, withResolvers, zip, zipToObject };

package/dist/radashi.js

@@ -356,20 +356,17 @@ function zipToObject(keys2, values) {
 }
 
 // src/async/AggregateError.ts
-var AggregateErrorOrPolyfill = /* @__PURE__ */ (() => (
-  // eslint-disable-next-line compat/compat
-  globalThis.AggregateError ?? class AggregateError extends Error {
-    constructor(errors = []) {
-      var _a, _b;
-      super();
-      const name = ((_a = errors.find((e) => e.name)) == null ? void 0 : _a.name) ?? "";
-      this.name = `AggregateError(${name}...)`;
-      this.message = `AggregateError with ${errors.length} errors`;
-      this.stack = ((_b = errors.find((e) => e.stack)) == null ? void 0 : _b.stack) ?? this.stack;
-      this.errors = errors;
-    }
+var AggregateErrorOrPolyfill = /* @__PURE__ */ (() => globalThis.AggregateError ?? class AggregateError extends Error {
+  constructor(errors = []) {
+    var _a, _b;
+    super();
+    const name = ((_a = errors.find((e) => e.name)) == null ? void 0 : _a.name) ?? "";
+    this.name = `AggregateError(${name}...)`;
+    this.message = `AggregateError with ${errors.length} errors`;
+    this.stack = ((_b = errors.find((e) => e.stack)) == null ? void 0 : _b.stack) ?? this.stack;
+    this.errors = errors;
   }
-))();
+})();
 
 // src/async/all.ts
 async function all(promises) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "radashi",
-  "version": "12.2.1",
+  "version": "12.2.2",
   "type": "module",
   "description": "The modern, community-first TypeScript toolkit with all of the fast, readable, and minimal utility functions you need. Type-safe, dependency-free, tree-shakeable, fully tested.",
   "repository": {