radashi 12.2.1 → 12.3.0-beta.8c8abf6

package/dist/radashi.cjs

@@ -18,6 +18,23 @@ function boil(array, compareFunc) {
   return array.reduce(compareFunc);
 }
 
+// src/array/cartesianProduct.ts
+function cartesianProduct(...arrays) {
+  let out = [[]];
+  for (const array of arrays) {
+    const result = [];
+    for (const currentArray of out) {
+      for (const item of array) {
+        const currentArrayCopy = currentArray.slice();
+        currentArrayCopy.push(item);
+        result.push(currentArrayCopy);
+      }
+    }
+    out = result;
+  }
+  return out;
+}
+
 // src/array/castArray.ts
 function castArray(value) {
   return Array.isArray(value) ? value.slice() : [value];
@@ -358,20 +375,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) {
@@ -448,17 +462,27 @@ async function map(array, asyncMapFunc) {
 }
 
 // src/async/parallel.ts
-async function parallel(limit, array, func) {
+async function parallel(options, array, func) {
+  var _a;
   const work = array.map((item, index) => ({
     index,
     item
   }));
-  const processor = async (res) => {
+  if (isNumber(options)) {
+    options = {
+      limit: options
+    };
+  }
+  (_a = options.signal) == null ? void 0 : _a.throwIfAborted();
+  const processor = async (resolve, reject) => {
+    var _a2, _b;
     const results2 = [];
+    const abortListener = () => reject(new Error("This operation was aborted"));
+    (_a2 = options.signal) == null ? void 0 : _a2.addEventListener("abort", abortListener);
     while (true) {
       const next = work.pop();
       if (!next) {
-        return res(results2);
+        break;
       }
       const [error, result] = await tryit(func)(next.item);
       results2.push({
@@ -467,8 +491,10 @@ async function parallel(limit, array, func) {
         index: next.index
       });
     }
+    (_b = options.signal) == null ? void 0 : _b.removeEventListener("abort", abortListener);
+    return resolve(results2);
   };
-  const queues = list(1, limit).map(() => new Promise(processor));
+  const queues = list(1, options.limit).map(() => new Promise(processor));
   const itemResults = await Promise.all(queues);
   const [errors, results] = fork(
     sort(flat(itemResults), (r) => r.index),
@@ -499,11 +525,13 @@ async function retry(options, func) {
   const times = (options == null ? void 0 : options.times) ?? 3;
   const delay = options == null ? void 0 : options.delay;
   const backoff = (options == null ? void 0 : options.backoff) ?? null;
+  const signal = options == null ? void 0 : options.signal;
   let i = 0;
   while (true) {
     const [err, result] = await tryit(func)((err2) => {
       throw { _exited: err2 };
     });
+    signal == null ? void 0 : signal.throwIfAborted();
     if (!err) {
       return result;
     }
@@ -527,6 +555,19 @@ function sleep(milliseconds) {
   return new Promise((res) => setTimeout(res, milliseconds));
 }
 
+// src/async/timeout.ts
+function timeout(milliseconds, error = "timeout") {
+  return new Promise(
+    (_, rej) => setTimeout(() => {
+      if (isString(error)) {
+        rej(new Error(error));
+      } else {
+        rej(error());
+      }
+    }, milliseconds)
+  );
+}
+
 // src/async/tryit.ts
 function tryit(func) {
   return (...args) => {
@@ -1372,6 +1413,30 @@ function dash(str) {
   });
 }
 
+// src/string/dedent.ts
+function dedent(text, ...values) {
+  var _a;
+  if (isArray(text)) {
+    if (values.length > 0) {
+      return dedent(
+        text.reduce((acc, input, i) => {
+          var _a2;
+          let value = String(values[i] ?? "");
+          const indent2 = value.includes("\n") && ((_a2 = input.match(/[ \t]*(?=[^\n]*$)/)) == null ? void 0 : _a2[0]);
+          if (indent2) {
+            value = value.replace(/\n(?=[^\n]*?\S)/g, "\n" + indent2);
+          }
+          return acc + input + value;
+        }, "")
+      );
+    }
+    text = text[0];
+  }
+  const indent = values[0] ?? ((_a = text.match(/^[ \t]*(?=\S)/m)) == null ? void 0 : _a[0]);
+  const output = indent ? text.replace(new RegExp(`^${indent}`, "gm"), "") : text;
+  return output.replace(/^[ \t]*\n|\n[ \t]*$/g, "");
+}
+
 // src/string/pascal.ts
 function pascal(str) {
   if (!str) {
@@ -1490,6 +1555,11 @@ function isBoolean(value) {
   return typeof value === "boolean";
 }
 
+// src/typed/isClass.ts
+function isClass(value) {
+  return isFunction(value) && Function.prototype.toString.call(value).startsWith("class ");
+}
+
 // src/typed/isDate.ts
 function isDate(value) {
   return isTagged(value, "[object Date]");
@@ -1594,6 +1664,11 @@ function isMap(value) {
   return isTagged(value, "[object Map]");
 }
 
+// src/typed/isNullish.ts
+function isNullish(value) {
+  return value === null || value === void 0;
+}
+
 // src/typed/isNumber.ts
 function isNumber(value) {
   return typeof value === "number" && !Number.isNaN(value);
@@ -1689,6 +1764,7 @@ exports.boil = boil;
 exports.callable = callable;
 exports.camel = camel;
 exports.capitalize = capitalize;
+exports.cartesianProduct = cartesianProduct;
 exports.castArray = castArray;
 exports.castArrayIfExists = castArrayIfExists;
 exports.castComparator = castComparator;
@@ -1704,6 +1780,7 @@ exports.counting = counting;
 exports.crush = crush;
 exports.dash = dash;
 exports.debounce = debounce;
+exports.dedent = dedent;
 exports.defer = defer;
 exports.diff = diff;
 exports.draw = draw;
@@ -1720,6 +1797,7 @@ exports.intersects = intersects;
 exports.invert = invert;
 exports.isArray = isArray;
 exports.isBoolean = isBoolean;
+exports.isClass = isClass;
 exports.isDate = isDate;
 exports.isEmpty = isEmpty;
 exports.isEqual = isEqual;
@@ -1730,6 +1808,7 @@ exports.isInt = isInt;
 exports.isIntString = isIntString;
 exports.isIterable = isIterable;
 exports.isMap = isMap;
+exports.isNullish = isNullish;
 exports.isNumber = isNumber;
 exports.isObject = isObject;
 exports.isPlainObject = isPlainObject;
@@ -1793,6 +1872,7 @@ exports.sort = sort;
 exports.sum = sum;
 exports.template = template;
 exports.throttle = throttle;
+exports.timeout = timeout;
 exports.title = title;
 exports.toFloat = toFloat;
 exports.toInt = toInt;

package/dist/radashi.d.cts

@@ -21,6 +21,29 @@ declare function alphabetical<T>(array: readonly T[], getter: (item: T) => strin
  */
 declare function boil<T>(array: readonly T[], compareFunc: (a: T, b: T) => T): T | null;
 
+/**
+ * Create an [n-ary Cartesian product](https://en.wikipedia.org/wiki/Cartesian_product#n-ary_Cartesian_product) from the given arrays.
+ *
+ * @see https://radashi.js.org/reference/array/cartesianProduct
+ * @example
+ * ```ts
+ * product([['red', 'blue'], ['big', 'small'], ['fast', 'slow']])
+ * // [
+ * //   ['red', 'big', 'fast'],
+ * //   ['red', 'big', 'slow'],
+ * //   ['red', 'small', 'fast'],
+ * //   ['red', 'small', 'slow'],
+ * //   ['blue', 'big', 'fast'],
+ * //   ['blue', 'big', 'slow'],
+ * //   ['blue', 'small', 'fast'],
+ * //   ['blue', 'small', 'slow']
+ * // ]
+ * ```
+ */
+declare function cartesianProduct<T extends any[][]>(...arrays: [...T]): Array<{
+    [K in keyof T]: T[K][number];
+}>;
+
 /**
  * Casts the given value to an array. If the value is already an
  * array, a shallow copy is returned. Otherwise, a new array
@@ -125,8 +148,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 +242,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 +553,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.
@@ -639,23 +668,44 @@ declare function guard<TFunction extends () => any>(func: TFunction, shouldGuard
  */
 declare function map<T, K>(array: readonly T[], asyncMapFunc: (item: T, index: number) => Promise<K>): Promise<K[]>;
 
+type AbortSignal$1 = {
+    readonly aborted: boolean;
+    addEventListener(type: 'abort', listener: () => void): void;
+    removeEventListener(type: 'abort', listener: () => void): void;
+    throwIfAborted(): void;
+};
+type ParallelOptions = {
+    limit: number;
+    signal?: AbortSignal$1;
+} | number;
 /**
  * Executes many async functions in parallel. Returns the results from
  * all functions as an array. After all functions have resolved, if
  * any errors were thrown, they are rethrown in an instance of
- * AggregateError.
+ * AggregateError. The operation can be aborted by passing optional AbortSignal,
+ * which will throw an Error if aborted.
  *
  * @see https://radashi.js.org/reference/async/parallel
  * @example
  * ```ts
  * // Process images concurrently, resizing each image to a standard size.
- * const images = await parallel(2, imageFiles, async (file) => {
+ * const abortController = new AbortController();
+ * const images = await parallel(
+ * {
+ *  limit: 2,
+ *  signal: abortController.signal,
+ * },
+ *  imageFiles,
+ *  async file => {
  *   return await resizeImage(file)
  * })
+ *
+ * // To abort the operation:
+ * // abortController.abort()
  * ```
  * @version 12.1.0
  */
-declare function parallel<T, K>(limit: number, array: readonly T[], func: (item: T) => Promise<K>): Promise<K[]>;
+declare function parallel<T, K>(options: ParallelOptions, array: readonly T[], func: (item: T) => Promise<K>): Promise<K[]>;
 
 /**
  * An async reduce function. Works like the built-in Array.reduce
@@ -672,10 +722,14 @@ declare function parallel<T, K>(limit: number, array: readonly T[], func: (item:
  */
 declare function reduce<T, K>(array: readonly T[], asyncReducer: (acc: K, item: T, index: number) => Promise<K>, initValue?: K): Promise<K>;
 
+type AbortSignal = {
+    throwIfAborted(): void;
+};
 type RetryOptions = {
     times?: number;
     delay?: number | null;
     backoff?: (count: number) => number;
+    signal?: AbortSignal;
 };
 /**
  * Retries the given function the specified number of times.
@@ -683,9 +737,12 @@ type RetryOptions = {
  * @see https://radashi.js.org/reference/async/retry
  * @example
  * ```ts
- * const result = await retry({ times: 3, delay: 1000 }, async () => {
+ * const abortController = new AbortController();
+ * const result = await retry({ times: 3, delay: 1000, signal: abortController.signal }, async () => {
  *   return await fetch('https://example.com')
  * })
+ * // To abort the operation:
+ * // abortController.abort()
  * ```
  * @version 12.1.0
  */
@@ -703,6 +760,39 @@ declare function retry<TResponse>(options: RetryOptions, func: (exit: (err: any)
  */
 declare function sleep(milliseconds: number): Promise<void>;
 
+/**
+ * Creates a promise that will reject after a specified amount of time.
+ * You can provide a custom error message or a function that returns an error.
+ *
+ * @see https://radashi.js.org/reference/async/timeout
+ *
+ * @example
+ * ```ts
+ * // Reject after 1000 milliseconds with default message "timeout"
+ * await timeout(1000)
+ *
+ * // Reject after 1000 milliseconds with a custom message
+ * await timeout(1000, "Optional message")
+ *
+ * // Reject after 1000 milliseconds with a custom error
+ * await timeout(1000, () => new Error("Custom error"))
+ *
+ * // Example usage with Promise.race to set a timeout for an asynchronous task
+ * await Promise.race([
+ *  someAsyncTask(),
+ *  timeout(1000, "Optional message"),
+ * ])
+ * ```
+ * @version 12.3.0
+ */
+declare function timeout<E extends Error>(milliseconds: number, 
+/**
+ * The error message to reject with.
+ *
+ * @default "timeout"
+ */
+error?: string | (() => E)): Promise<void>;
+
 /**
  * The result of a `tryit` function.
  *
@@ -1978,7 +2068,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
@@ -2093,6 +2183,44 @@ declare function capitalize(str: string): string;
  */
 declare function dash(str: string): string;
 
+/**
+ * Remove indentation from a string. The given string is expected to
+ * be consistently indented (i.e. the leading whitespace of the first
+ * non-empty line is the minimum required for all non-empty lines).
+ *
+ * If the `indent` argument is nullish, the indentation is detected
+ * from the first non-empty line. Detection is cheap and robust for
+ * most use cases, so you should only set an explicit `indent` if
+ * necessary.
+ *
+ * @see https://radashi-org.github.io/reference/string/dedent
+ * @example
+ * ```ts
+ * // This is indented with 4 spaces.
+ * const input = `
+ *     Hello
+ *     World
+ * `
+ *
+ * // Explicit indentation
+ * dedent(input, '  ')
+ * // => '  Hello\n  World\n'
+ *
+ * // Detected indentation
+ * dedent(input)
+ * // => 'Hello\nWorld\n'
+ *
+ * // Tagged template strings
+ * const str = dedent`
+ *   Foo ${1 + 1}
+ *   Bar ${2 * 2}
+ * `
+ * // => 'Foo 2\nBar 4'
+ * ```
+ */
+declare function dedent(template: TemplateStringsArray, ...values: unknown[]): string;
+declare function dedent(text: string, indent?: string | null): string;
+
 /**
  * Formats the given string in pascal case fashion.
  *
@@ -2219,6 +2347,27 @@ type ExtractArray<T> = T extends any ? [StrictExtract<T, readonly any[]>] extend
 
 declare function isBoolean(value: unknown): value is boolean;
 
+/**
+ * Checks if the given value is a class. This function verifies
+ * if the value was defined using the `class` syntax. Old school
+ * classes (defined with constructor functions) will return false.
+ * "Native classes" like `Error` will also return false.
+ *
+ * @see https://radashi.js.org/reference/typed/isClass
+ * @example
+ * ```ts
+ * isClass(class CustomClass {}) // => true
+ * isClass('abc') // => false
+ * isClass({}) // => false
+ * ```
+ */
+declare function isClass<T>(value: T): value is ExtractClass<T>;
+/**
+ * Used by the `isClass` type guard. It handles type narrowing for
+ * class constructors and even narrows `any` types.
+ */
+type ExtractClass<T> = [StrictExtract<T, Class>] extends [Class] ? Extract<T, Class> : T extends any ? Class<unknown[], unknown> extends T ? Class<unknown[], unknown> : never : never;
+
 /**
  * Return true if the given value is a Date object.
  *
@@ -2238,15 +2387,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 +2411,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.
@@ -2385,6 +2546,21 @@ type ExtractMap<T> = T extends any ? [StrictExtract<T, ReadonlyMap<unknown, unkn
     ReadonlyMap<unknown, unknown>
 ] ? Extract<T, ReadonlyMap<unknown, unknown>> : [StrictExtract<T, Map<unknown, unknown>>] extends [Map<unknown, unknown>] ? Extract<T, Map<unknown, unknown>> : Map<unknown, unknown> extends T ? Map<unknown, unknown> : never : never;
 
+/**
+ * Return true if the given value is null or undefined.
+ *
+ * @see https://radashi.js.org/reference/typed/isNullish
+ * @example
+ * ```ts
+ * isNullish(null) // => true
+ * isNullish(undefined) // => true
+ * isNullish('') // => false
+ * isNullish(0) // => false
+ * ```
+ * @version 12.2.0
+ */
+declare function isNullish(value: unknown): value is null | undefined;
+
 /**
  * Return true if the given value is a number.
  *
@@ -3164,6 +3340,10 @@ type Falsy = null | undefined | false | '' | 0 | 0n;
 declare class Any {
     private any;
 }
+/**
+ * Represents a class constructor.
+ */
+type Class<TArgs extends any[] = any[], TReturn = any> = new (...args: TArgs) => TReturn;
 /**
  * Extracts `T` if `T` is not `any`, otherwise `never`.
  *
@@ -3361,4 +3541,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 Class, 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 ExtractClass, 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 ParallelOptions, 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, cartesianProduct, castArray, castArrayIfExists, castComparator, castMapping, chain, clamp, clone, cloneDeep, cluster, compose, construct, counting, crush, dash, debounce, dedent, defer, diff, draw, filterKey, first, flat, flip, fork, get, group, guard, inRange, intersects, invert, isArray, isBoolean, isClass, isDate, isEmpty, isEqual, isError, isFloat, isFunction, isInt, isIntString, isIterable, isMap, isNullish, 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, timeout, title, toFloat, toInt, toggle, traverse, trim, tryit as try, tryit, uid, unique, unzip, upperize, withResolvers, zip, zipToObject };

package/dist/radashi.d.ts

@@ -21,6 +21,29 @@ declare function alphabetical<T>(array: readonly T[], getter: (item: T) => strin
  */
 declare function boil<T>(array: readonly T[], compareFunc: (a: T, b: T) => T): T | null;
 
+/**
+ * Create an [n-ary Cartesian product](https://en.wikipedia.org/wiki/Cartesian_product#n-ary_Cartesian_product) from the given arrays.
+ *
+ * @see https://radashi.js.org/reference/array/cartesianProduct
+ * @example
+ * ```ts
+ * product([['red', 'blue'], ['big', 'small'], ['fast', 'slow']])
+ * // [
+ * //   ['red', 'big', 'fast'],
+ * //   ['red', 'big', 'slow'],
+ * //   ['red', 'small', 'fast'],
+ * //   ['red', 'small', 'slow'],
+ * //   ['blue', 'big', 'fast'],
+ * //   ['blue', 'big', 'slow'],
+ * //   ['blue', 'small', 'fast'],
+ * //   ['blue', 'small', 'slow']
+ * // ]
+ * ```
+ */
+declare function cartesianProduct<T extends any[][]>(...arrays: [...T]): Array<{
+    [K in keyof T]: T[K][number];
+}>;
+
 /**
  * Casts the given value to an array. If the value is already an
  * array, a shallow copy is returned. Otherwise, a new array
@@ -125,8 +148,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 +242,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 +553,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.
@@ -639,23 +668,44 @@ declare function guard<TFunction extends () => any>(func: TFunction, shouldGuard
  */
 declare function map<T, K>(array: readonly T[], asyncMapFunc: (item: T, index: number) => Promise<K>): Promise<K[]>;
 
+type AbortSignal$1 = {
+    readonly aborted: boolean;
+    addEventListener(type: 'abort', listener: () => void): void;
+    removeEventListener(type: 'abort', listener: () => void): void;
+    throwIfAborted(): void;
+};
+type ParallelOptions = {
+    limit: number;
+    signal?: AbortSignal$1;
+} | number;
 /**
  * Executes many async functions in parallel. Returns the results from
  * all functions as an array. After all functions have resolved, if
  * any errors were thrown, they are rethrown in an instance of
- * AggregateError.
+ * AggregateError. The operation can be aborted by passing optional AbortSignal,
+ * which will throw an Error if aborted.
  *
  * @see https://radashi.js.org/reference/async/parallel
  * @example
  * ```ts
  * // Process images concurrently, resizing each image to a standard size.
- * const images = await parallel(2, imageFiles, async (file) => {
+ * const abortController = new AbortController();
+ * const images = await parallel(
+ * {
+ *  limit: 2,
+ *  signal: abortController.signal,
+ * },
+ *  imageFiles,
+ *  async file => {
  *   return await resizeImage(file)
  * })
+ *
+ * // To abort the operation:
+ * // abortController.abort()
  * ```
  * @version 12.1.0
  */
-declare function parallel<T, K>(limit: number, array: readonly T[], func: (item: T) => Promise<K>): Promise<K[]>;
+declare function parallel<T, K>(options: ParallelOptions, array: readonly T[], func: (item: T) => Promise<K>): Promise<K[]>;
 
 /**
  * An async reduce function. Works like the built-in Array.reduce
@@ -672,10 +722,14 @@ declare function parallel<T, K>(limit: number, array: readonly T[], func: (item:
  */
 declare function reduce<T, K>(array: readonly T[], asyncReducer: (acc: K, item: T, index: number) => Promise<K>, initValue?: K): Promise<K>;
 
+type AbortSignal = {
+    throwIfAborted(): void;
+};
 type RetryOptions = {
     times?: number;
     delay?: number | null;
     backoff?: (count: number) => number;
+    signal?: AbortSignal;
 };
 /**
  * Retries the given function the specified number of times.
@@ -683,9 +737,12 @@ type RetryOptions = {
  * @see https://radashi.js.org/reference/async/retry
  * @example
  * ```ts
- * const result = await retry({ times: 3, delay: 1000 }, async () => {
+ * const abortController = new AbortController();
+ * const result = await retry({ times: 3, delay: 1000, signal: abortController.signal }, async () => {
  *   return await fetch('https://example.com')
  * })
+ * // To abort the operation:
+ * // abortController.abort()
  * ```
  * @version 12.1.0
  */
@@ -703,6 +760,39 @@ declare function retry<TResponse>(options: RetryOptions, func: (exit: (err: any)
  */
 declare function sleep(milliseconds: number): Promise<void>;
 
+/**
+ * Creates a promise that will reject after a specified amount of time.
+ * You can provide a custom error message or a function that returns an error.
+ *
+ * @see https://radashi.js.org/reference/async/timeout
+ *
+ * @example
+ * ```ts
+ * // Reject after 1000 milliseconds with default message "timeout"
+ * await timeout(1000)
+ *
+ * // Reject after 1000 milliseconds with a custom message
+ * await timeout(1000, "Optional message")
+ *
+ * // Reject after 1000 milliseconds with a custom error
+ * await timeout(1000, () => new Error("Custom error"))
+ *
+ * // Example usage with Promise.race to set a timeout for an asynchronous task
+ * await Promise.race([
+ *  someAsyncTask(),
+ *  timeout(1000, "Optional message"),
+ * ])
+ * ```
+ * @version 12.3.0
+ */
+declare function timeout<E extends Error>(milliseconds: number, 
+/**
+ * The error message to reject with.
+ *
+ * @default "timeout"
+ */
+error?: string | (() => E)): Promise<void>;
+
 /**
  * The result of a `tryit` function.
  *
@@ -1978,7 +2068,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
@@ -2093,6 +2183,44 @@ declare function capitalize(str: string): string;
  */
 declare function dash(str: string): string;
 
+/**
+ * Remove indentation from a string. The given string is expected to
+ * be consistently indented (i.e. the leading whitespace of the first
+ * non-empty line is the minimum required for all non-empty lines).
+ *
+ * If the `indent` argument is nullish, the indentation is detected
+ * from the first non-empty line. Detection is cheap and robust for
+ * most use cases, so you should only set an explicit `indent` if
+ * necessary.
+ *
+ * @see https://radashi-org.github.io/reference/string/dedent
+ * @example
+ * ```ts
+ * // This is indented with 4 spaces.
+ * const input = `
+ *     Hello
+ *     World
+ * `
+ *
+ * // Explicit indentation
+ * dedent(input, '  ')
+ * // => '  Hello\n  World\n'
+ *
+ * // Detected indentation
+ * dedent(input)
+ * // => 'Hello\nWorld\n'
+ *
+ * // Tagged template strings
+ * const str = dedent`
+ *   Foo ${1 + 1}
+ *   Bar ${2 * 2}
+ * `
+ * // => 'Foo 2\nBar 4'
+ * ```
+ */
+declare function dedent(template: TemplateStringsArray, ...values: unknown[]): string;
+declare function dedent(text: string, indent?: string | null): string;
+
 /**
  * Formats the given string in pascal case fashion.
  *
@@ -2219,6 +2347,27 @@ type ExtractArray<T> = T extends any ? [StrictExtract<T, readonly any[]>] extend
 
 declare function isBoolean(value: unknown): value is boolean;
 
+/**
+ * Checks if the given value is a class. This function verifies
+ * if the value was defined using the `class` syntax. Old school
+ * classes (defined with constructor functions) will return false.
+ * "Native classes" like `Error` will also return false.
+ *
+ * @see https://radashi.js.org/reference/typed/isClass
+ * @example
+ * ```ts
+ * isClass(class CustomClass {}) // => true
+ * isClass('abc') // => false
+ * isClass({}) // => false
+ * ```
+ */
+declare function isClass<T>(value: T): value is ExtractClass<T>;
+/**
+ * Used by the `isClass` type guard. It handles type narrowing for
+ * class constructors and even narrows `any` types.
+ */
+type ExtractClass<T> = [StrictExtract<T, Class>] extends [Class] ? Extract<T, Class> : T extends any ? Class<unknown[], unknown> extends T ? Class<unknown[], unknown> : never : never;
+
 /**
  * Return true if the given value is a Date object.
  *
@@ -2238,15 +2387,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 +2411,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.
@@ -2385,6 +2546,21 @@ type ExtractMap<T> = T extends any ? [StrictExtract<T, ReadonlyMap<unknown, unkn
     ReadonlyMap<unknown, unknown>
 ] ? Extract<T, ReadonlyMap<unknown, unknown>> : [StrictExtract<T, Map<unknown, unknown>>] extends [Map<unknown, unknown>] ? Extract<T, Map<unknown, unknown>> : Map<unknown, unknown> extends T ? Map<unknown, unknown> : never : never;
 
+/**
+ * Return true if the given value is null or undefined.
+ *
+ * @see https://radashi.js.org/reference/typed/isNullish
+ * @example
+ * ```ts
+ * isNullish(null) // => true
+ * isNullish(undefined) // => true
+ * isNullish('') // => false
+ * isNullish(0) // => false
+ * ```
+ * @version 12.2.0
+ */
+declare function isNullish(value: unknown): value is null | undefined;
+
 /**
  * Return true if the given value is a number.
  *
@@ -3164,6 +3340,10 @@ type Falsy = null | undefined | false | '' | 0 | 0n;
 declare class Any {
     private any;
 }
+/**
+ * Represents a class constructor.
+ */
+type Class<TArgs extends any[] = any[], TReturn = any> = new (...args: TArgs) => TReturn;
 /**
  * Extracts `T` if `T` is not `any`, otherwise `never`.
  *
@@ -3361,4 +3541,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 Class, 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 ExtractClass, 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 ParallelOptions, 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, cartesianProduct, castArray, castArrayIfExists, castComparator, castMapping, chain, clamp, clone, cloneDeep, cluster, compose, construct, counting, crush, dash, debounce, dedent, defer, diff, draw, filterKey, first, flat, flip, fork, get, group, guard, inRange, intersects, invert, isArray, isBoolean, isClass, isDate, isEmpty, isEqual, isError, isFloat, isFunction, isInt, isIntString, isIterable, isMap, isNullish, 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, timeout, title, toFloat, toInt, toggle, traverse, trim, tryit as try, tryit, uid, unique, unzip, upperize, withResolvers, zip, zipToObject };

package/dist/radashi.js

@@ -16,6 +16,23 @@ function boil(array, compareFunc) {
   return array.reduce(compareFunc);
 }
 
+// src/array/cartesianProduct.ts
+function cartesianProduct(...arrays) {
+  let out = [[]];
+  for (const array of arrays) {
+    const result = [];
+    for (const currentArray of out) {
+      for (const item of array) {
+        const currentArrayCopy = currentArray.slice();
+        currentArrayCopy.push(item);
+        result.push(currentArrayCopy);
+      }
+    }
+    out = result;
+  }
+  return out;
+}
+
 // src/array/castArray.ts
 function castArray(value) {
   return Array.isArray(value) ? value.slice() : [value];
@@ -356,20 +373,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) {
@@ -446,17 +460,27 @@ async function map(array, asyncMapFunc) {
 }
 
 // src/async/parallel.ts
-async function parallel(limit, array, func) {
+async function parallel(options, array, func) {
+  var _a;
   const work = array.map((item, index) => ({
     index,
     item
   }));
-  const processor = async (res) => {
+  if (isNumber(options)) {
+    options = {
+      limit: options
+    };
+  }
+  (_a = options.signal) == null ? void 0 : _a.throwIfAborted();
+  const processor = async (resolve, reject) => {
+    var _a2, _b;
     const results2 = [];
+    const abortListener = () => reject(new Error("This operation was aborted"));
+    (_a2 = options.signal) == null ? void 0 : _a2.addEventListener("abort", abortListener);
     while (true) {
       const next = work.pop();
       if (!next) {
-        return res(results2);
+        break;
       }
       const [error, result] = await tryit(func)(next.item);
       results2.push({
@@ -465,8 +489,10 @@ async function parallel(limit, array, func) {
         index: next.index
       });
     }
+    (_b = options.signal) == null ? void 0 : _b.removeEventListener("abort", abortListener);
+    return resolve(results2);
   };
-  const queues = list(1, limit).map(() => new Promise(processor));
+  const queues = list(1, options.limit).map(() => new Promise(processor));
   const itemResults = await Promise.all(queues);
   const [errors, results] = fork(
     sort(flat(itemResults), (r) => r.index),
@@ -497,11 +523,13 @@ async function retry(options, func) {
   const times = (options == null ? void 0 : options.times) ?? 3;
   const delay = options == null ? void 0 : options.delay;
   const backoff = (options == null ? void 0 : options.backoff) ?? null;
+  const signal = options == null ? void 0 : options.signal;
   let i = 0;
   while (true) {
     const [err, result] = await tryit(func)((err2) => {
       throw { _exited: err2 };
     });
+    signal == null ? void 0 : signal.throwIfAborted();
     if (!err) {
       return result;
     }
@@ -525,6 +553,19 @@ function sleep(milliseconds) {
   return new Promise((res) => setTimeout(res, milliseconds));
 }
 
+// src/async/timeout.ts
+function timeout(milliseconds, error = "timeout") {
+  return new Promise(
+    (_, rej) => setTimeout(() => {
+      if (isString(error)) {
+        rej(new Error(error));
+      } else {
+        rej(error());
+      }
+    }, milliseconds)
+  );
+}
+
 // src/async/tryit.ts
 function tryit(func) {
   return (...args) => {
@@ -1370,6 +1411,30 @@ function dash(str) {
   });
 }
 
+// src/string/dedent.ts
+function dedent(text, ...values) {
+  var _a;
+  if (isArray(text)) {
+    if (values.length > 0) {
+      return dedent(
+        text.reduce((acc, input, i) => {
+          var _a2;
+          let value = String(values[i] ?? "");
+          const indent2 = value.includes("\n") && ((_a2 = input.match(/[ \t]*(?=[^\n]*$)/)) == null ? void 0 : _a2[0]);
+          if (indent2) {
+            value = value.replace(/\n(?=[^\n]*?\S)/g, "\n" + indent2);
+          }
+          return acc + input + value;
+        }, "")
+      );
+    }
+    text = text[0];
+  }
+  const indent = values[0] ?? ((_a = text.match(/^[ \t]*(?=\S)/m)) == null ? void 0 : _a[0]);
+  const output = indent ? text.replace(new RegExp(`^${indent}`, "gm"), "") : text;
+  return output.replace(/^[ \t]*\n|\n[ \t]*$/g, "");
+}
+
 // src/string/pascal.ts
 function pascal(str) {
   if (!str) {
@@ -1488,6 +1553,11 @@ function isBoolean(value) {
   return typeof value === "boolean";
 }
 
+// src/typed/isClass.ts
+function isClass(value) {
+  return isFunction(value) && Function.prototype.toString.call(value).startsWith("class ");
+}
+
 // src/typed/isDate.ts
 function isDate(value) {
   return isTagged(value, "[object Date]");
@@ -1592,6 +1662,11 @@ function isMap(value) {
   return isTagged(value, "[object Map]");
 }
 
+// src/typed/isNullish.ts
+function isNullish(value) {
+  return value === null || value === void 0;
+}
+
 // src/typed/isNumber.ts
 function isNumber(value) {
   return typeof value === "number" && !Number.isNaN(value);
@@ -1676,4 +1751,4 @@ function isWeakSet(value) {
   return isTagged(value, "[object WeakSet]");
 }
 
-export { AggregateErrorOrPolyfill as AggregateError, DefaultCloningStrategy, FastCloningStrategy, 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, DefaultCloningStrategy, FastCloningStrategy, all, alphabetical, always, assign, boil, callable, camel, capitalize, cartesianProduct, castArray, castArrayIfExists, castComparator, castMapping, chain, clamp, clone, cloneDeep, cluster, compose, construct, counting, crush, dash, debounce, dedent, defer, diff, draw, filterKey, first, flat, flip, fork, get, group, guard, inRange, intersects, invert, isArray, isBoolean, isClass, isDate, isEmpty, isEqual, isError, isFloat, isFunction, isInt, isIntString, isIterable, isMap, isNullish, 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, timeout, title, toFloat, toInt, toggle, traverse, trim, tryit as try, tryit, uid, unique, unzip, upperize, withResolvers, zip, zipToObject };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "radashi",
-  "version": "12.2.1",
+  "version": "12.3.0-beta.8c8abf6",
   "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": {