radashi 12.2.2 → 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];
@@ -445,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({
@@ -464,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),
@@ -496,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;
     }
@@ -524,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) => {
@@ -1369,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) {
@@ -1487,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]");
@@ -1591,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);
@@ -1686,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;
@@ -1701,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;
@@ -1717,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;
@@ -1727,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;
@@ -1790,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
@@ -645,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
@@ -678,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.
@@ -689,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
  */
@@ -709,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.
  *
@@ -2099,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.
  *
@@ -2225,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.
  *
@@ -2403,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.
  *
@@ -3182,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`.
  *
@@ -3379,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 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 };
+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
@@ -645,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
@@ -678,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.
@@ -689,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
  */
@@ -709,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.
  *
@@ -2099,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.
  *
@@ -2225,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.
  *
@@ -2403,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.
  *
@@ -3182,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`.
  *
@@ -3379,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 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 };
+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];
@@ -443,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({
@@ -462,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),
@@ -494,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;
     }
@@ -522,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) => {
@@ -1367,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) {
@@ -1485,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]");
@@ -1589,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);
@@ -1673,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.2",
+  "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": {