radashi 12.2.0-beta.dc9ade1 → 12.2.0-beta.ef0154b

package/dist/radashi.cjs

@@ -43,6 +43,7 @@ __export(mod_exports, {
   filterKey: () => filterKey,
   first: () => first,
   flat: () => flat,
+  flip: () => flip,
   fork: () => fork,
   get: () => get,
   group: () => group,
@@ -68,6 +69,7 @@ __export(mod_exports, {
   iterate: () => iterate,
   keys: () => keys,
   last: () => last,
+  lerp: () => lerp,
   list: () => list,
   listify: () => listify,
   lowerize: () => lowerize,
@@ -82,6 +84,7 @@ __export(mod_exports, {
   min: () => min,
   objectify: () => objectify,
   omit: () => omit,
+  once: () => once,
   parallel: () => parallel,
   partial: () => partial,
   partob: () => partob,
@@ -657,7 +660,7 @@ async function retry(options, func) {
     if (err._exited) {
       throw err._exited;
     }
-    if (++i === times) {
+    if (++i >= times) {
       throw err;
     }
     if (delay) {
@@ -739,6 +742,11 @@ function debounce({ delay }, func) {
   return debounced;
 }
 
+// src/curry/flip.ts
+function flip(fn) {
+  return (arg2, arg1, ...args) => fn(arg1, arg2, ...args);
+}
+
 // src/curry/memo.ts
 function memoize(cache, func, keyFunc, ttl) {
   return function callWithMemo(...args) {
@@ -764,6 +772,22 @@ function memo(func, options = {}) {
   return memoize({}, func, options.key ?? null, options.ttl ?? null);
 }
 
+// src/curry/once.ts
+var onceSymbol = Symbol();
+var once = (fn) => {
+  const onceFn = function(...args) {
+    if (onceFn[onceSymbol] === onceSymbol) {
+      onceFn[onceSymbol] = fn.apply(this, args);
+    }
+    return onceFn[onceSymbol];
+  };
+  onceFn[onceSymbol] = onceSymbol;
+  return onceFn;
+};
+once.reset = (fn) => {
+  fn[onceSymbol] = onceSymbol;
+};
+
 // src/curry/partial.ts
 function partial(fn, ...args) {
   return (...rest) => fn(...[...args, ...rest]);
@@ -818,6 +842,11 @@ function inRange(number, start, end) {
   return number >= Math.min(start, end) && number < Math.max(start, end);
 }
 
+// src/number/lerp.ts
+function lerp(from, to, amount) {
+  return from + (to - from) * amount;
+}
+
 // src/number/round.ts
 function round(value, precision, toInteger = Math.round) {
   if (precision) {
@@ -831,22 +860,14 @@ function round(value, precision, toInteger = Math.round) {
 
 // src/number/toFloat.ts
 function toFloat(value, defaultValue) {
-  const def = defaultValue === void 0 ? 0 : defaultValue;
-  if (value === null || value === void 0) {
-    return def;
-  }
-  const result = Number.parseFloat(value);
-  return Number.isNaN(result) ? def : result;
+  const parsedValue = isSymbol(value) ? Number.NaN : Number.parseFloat(value);
+  return Number.isNaN(parsedValue) ? defaultValue !== void 0 ? defaultValue : 0 : parsedValue;
 }
 
 // src/number/toInt.ts
 function toInt(value, defaultValue) {
-  const def = defaultValue === void 0 ? 0 : defaultValue;
-  if (value === null || value === void 0) {
-    return def;
-  }
-  const result = Number.parseInt(value);
-  return Number.isNaN(result) ? def : result;
+  const parsedValue = isSymbol(value) ? Number.NaN : Number.parseInt(value);
+  return Number.isNaN(parsedValue) ? defaultValue !== void 0 ? defaultValue : 0 : parsedValue;
 }
 
 // src/object/assign.ts
@@ -1050,19 +1071,22 @@ function omit(obj, keys2) {
 }
 
 // src/object/pick.ts
-function pick(obj, keys2) {
+function pick(obj, filter) {
   if (!obj) {
     return {};
   }
-  return keys2.reduce(
-    (acc, key) => {
-      if (Object.hasOwnProperty.call(obj, key)) {
-        acc[key] = obj[key];
-      }
-      return acc;
-    },
-    {}
-  );
+  let keys2 = filter;
+  if (isArray(filter)) {
+    filter = null;
+  } else {
+    keys2 = Reflect.ownKeys(obj);
+  }
+  return keys2.reduce((acc, key) => {
+    if (filterKey(obj, key, filter)) {
+      acc[key] = obj[key];
+    }
+    return acc;
+  }, {});
 }
 
 // src/object/set.ts
@@ -1119,8 +1143,15 @@ function random(min2, max2) {
 }
 
 // src/random/shuffle.ts
-function shuffle(array) {
-  return array.map((a) => ({ rand: Math.random(), value: a })).sort((a, b) => a.rand - b.rand).map((a) => a.value);
+function shuffle(array, random2 = random) {
+  const newArray = array.slice();
+  for (let idx = 0, randomIdx, item; idx < array.length; idx++) {
+    randomIdx = random2(0, array.length - 1);
+    item = newArray[randomIdx];
+    newArray[randomIdx] = newArray[idx];
+    newArray[idx] = item;
+  }
+  return newArray;
 }
 
 // src/random/uid.ts
@@ -1444,6 +1475,7 @@ function isSymbol(value) {
   filterKey,
   first,
   flat,
+  flip,
   fork,
   get,
   group,
@@ -1469,6 +1501,7 @@ function isSymbol(value) {
   iterate,
   keys,
   last,
+  lerp,
   list,
   listify,
   lowerize,
@@ -1483,6 +1516,7 @@ function isSymbol(value) {
   min,
   objectify,
   omit,
+  once,
   parallel,
   partial,
   partob,

package/dist/radashi.d.cts

@@ -274,7 +274,8 @@ declare function replaceOrAppend<T>(array: readonly T[], newItem: T, match: (a:
  * // => [9, 16]
  * ```
  */
-declare function select<T, U>(array: readonly T[], mapper: (item: T, index: number) => U, condition?: (item: T, index: number) => boolean): U[];
+declare function select<T, U>(array: readonly T[], mapper: (item: T, index: number) => U, condition: (item: T, index: number) => boolean): U[];
+declare function select<T, U>(array: readonly T[], mapper: (item: T, index: number) => U | null | undefined): U[];
 
 /**
  * Select performs a find + map operation, short-circuiting on the first
@@ -621,6 +622,9 @@ declare function debounce<TArgs extends any[]>({ delay }: {
     delay: number;
 }, func: (...args: TArgs) => any): DebounceFunction<TArgs>;
 
+declare function flip<Args extends any[], Result>(fn: (...args: Args) => Result): (...args: Flip<Args>) => Result;
+type Flip<T extends any[]> = T extends [infer A, infer B, ...infer R] ? [B, A, ...R] : never;
+
 interface MemoOptions<TArgs extends any[]> {
     key?: (...args: TArgs) => string;
     ttl?: number;
@@ -633,6 +637,45 @@ interface MemoOptions<TArgs extends any[]> {
  */
 declare function memo<TArgs extends any[], TResult>(func: (...args: TArgs) => TResult, options?: MemoOptions<TArgs>): (...args: TArgs) => TResult;
 
+declare const onceSymbol: unique symbol;
+/**
+ * The type of a function wrapped with `once`.
+ */
+interface OnceFunction<Args extends unknown[] = unknown[], Return = unknown, This = unknown> {
+    (this: This, ...args: Args): Return;
+    [onceSymbol]?: Return | typeof onceSymbol;
+}
+/**
+ * Create a function that runs at most once, no matter how many times
+ * it's called. If it was already called before, returns the result
+ * from the first call. This is a lighter version of `memo()`.
+ *
+ * To allow the function to be called again, use `onceReset()`.
+ *
+ * ```ts
+ * const fn = once(() => Math.random())
+ * fn() // 0.5
+ * fn() // 0.5
+ * ```
+ */
+declare const once: {
+    <Args extends unknown[], Return, This = unknown>(fn: (this: This, ...args: Args) => Return): (this: This, ...args: Args) => Return;
+    /**
+     * Reset the result of a function that was created with `once`,
+     * allowing it to be called again.
+     *
+     * ```ts
+     * const fn = once(() => Math.random())
+     * fn() // 0.5
+     * fn() // 0.5
+     * once.reset(fn)
+     * fn() // 0.3
+     * fn() // 0.3
+     * ```
+     */
+    reset(fn: OnceFunction): void;
+};
+
 /**
  * This type produces the type array of `TItems` with all the type items
  * in `TItemsToRemove` removed from the start of the array type.
@@ -716,6 +759,17 @@ declare function inRange(number: number, end: number): boolean;
  */
 declare function inRange(number: number, start: number, end: number): boolean;
 
+/**
+ * Linearly interpolates between two numbers.
+ *
+ * ```
+ * lerp(0, 10, 0.5) // => 5
+ * lerp(5, 15, 0.2) // => 7
+ * lerp(-10, 10, 0.75) // => 5
+ * ```
+ */
+declare function lerp(from: number, to: number, amount: number): number;
+
 /**
  * Rounds a number to the given precision. The default `precision` is
  * zero. An optional rounding function (e.g. `Math.floor` or
@@ -741,9 +795,13 @@ declare function inRange(number: number, start: number, end: number): boolean;
  */
 declare function round(value: number, precision?: number, toInteger?: (value: number) => number): number;
 
-declare function toFloat<T extends number | null = number>(value: any, defaultValue?: T): number | T;
+declare function toFloat(value: unknown): number;
+declare function toFloat(value: unknown, defaultValue: number): number;
+declare function toFloat<T>(value: unknown, defaultValue: T): number | Exclude<T, undefined>;
 
-declare function toInt<T extends number | null = number>(value: any, defaultValue?: T): number | T;
+declare function toInt(value: unknown): number;
+declare function toInt(value: unknown, defaultValue: number): number;
+declare function toInt<T>(value: unknown, defaultValue: T): number | Exclude<T, undefined>;
 
 /**
  * Merges two objects together recursivly into a new object applying
@@ -789,10 +847,15 @@ type KeyFilterFunction<T extends object = object> = (value: ValueOf<T>, key: Key
  * filter function.
  */
 type KeyFilter<T extends object = object, Key extends keyof any = keyof any> = KeyFilterFunction<T> | readonly Key[];
+/**
+ * Extract the keys of an object that pass a filter.
+ */
+type FilteredKeys<T extends object, F extends KeyFilter<T> | null | undefined> = Extract<keyof T, F extends readonly any[] ? F[number] : any>;
 /**
  * Returns true if the key is in the “keys array” or if the “filter
  * function” returns true.
  */
+declare function filterKey<T extends object>(obj: T, key: keyof T, filter: KeyFilter<T, keyof T> | null | undefined): boolean;
 declare function filterKey(obj: object, key: keyof any, filter: KeyFilter | null | undefined): boolean;
 
 /**
@@ -875,7 +938,7 @@ declare function omit<T, TKeys extends keyof T>(obj: T, keys: TKeys[]): Omit<T,
 /**
  * Pick a list of properties from an object into a new object
  */
-declare function pick<T extends object, TKeys extends keyof T>(obj: T, keys: TKeys[]): Pick<T, TKeys>;
+declare function pick<T extends object, F extends KeyFilter<T, keyof T>>(obj: T, filter: F): Pick<T, FilteredKeys<T, F>>;
 
 /**
  * Opposite of get, dynamically set a nested value into an object
@@ -912,7 +975,7 @@ declare function draw<T>(array: readonly T[]): T | null;
  */
 declare function random(min: number, max: number): number;
 
-declare function shuffle<T>(array: readonly T[]): T[];
+declare function shuffle<T>(array: readonly T[], random?: (min: number, max: number) => number): T[];
 
 declare function uid(length: number, specials?: string): string;
 
@@ -1010,7 +1073,7 @@ declare function title(str: string | null | undefined): string;
  */
 declare function trim(str: string | null | undefined, charsToTrim?: string): string;
 
-declare const isArray: (value: unknown) => value is readonly any[];
+declare const isArray: <Input>(value: Input) => value is readonly any[] extends ExtractNotAny<Input, readonly any[]> ? Extract<Input, readonly any[]> : any[] extends ExtractNotAny<Input, any[]> ? Extract<Input, any[]> : unknown[] extends Input ? unknown[] : never;
 
 declare function isDate(value: any): value is Date;
 
@@ -1054,4 +1117,27 @@ declare function isString(value: any): value is string;
 
 declare function isSymbol(value: any): value is symbol;
 
-export { AggregateError, type DebounceFunction, type KeyFilter, type KeyFilterFunction, type LowercaseKeys, type MemoOptions, type RetryOptions, type Series, type ThrottledFunction, type TryitResult, type UppercaseKeys, all, alphabetical, assign, boil, callable, camel, capitalize, chain, clone, cluster, compose, construct, counting, crush, dash, debounce, defer, diff, draw, filterKey, first, flat, fork, get, group, guard, inRange, intersects, invert, isArray, isDate, isEmpty, isEqual, isFloat, isFunction, isInt, isIntString, isNumber, isObject, isPlainObject, isPrimitive, isPromise, isString, isSymbol, iterate, keys, last, list, listify, lowerize, map, mapEntries, mapKeys, mapValues, mapify, max, memo, merge, min, objectify, omit, parallel, partial, partob, pascal, pick, proxied, random, range, reduce, replace, replaceOrAppend, retry, round, select, selectFirst, series, set, shake, shift, shuffle, sift, sleep, snake, sort, sum, template, throttle, title, toFloat, toInt, toggle, trim, tryit as try, tryit, uid, unique, unzip, upperize, zip, zipToObject };
+/**
+ * The `Any` class does not exist at runtime. It's used in type
+ * definitions to detect an `any` type.
+ *
+ * ```ts
+ * type IsAny<T> = [T] extends [Any] ? 'is any' : 'is not any'
+ * ```
+ */
+declare class Any {
+    private any;
+}
+/**
+ * Extracts `T` if `T` is not `any`, otherwise `never`.
+ *
+ * ```ts
+ * type A = ExtractNotAny<any, string>
+ * //   ^? never
+ * type B = ExtractNotAny<string | number, string>
+ * //   ^? string
+ * ```
+ */
+type ExtractNotAny<T, U> = Extract<[T] extends [Any] ? never : T, U>;
+
+export { AggregateError, Any, type DebounceFunction, type ExtractNotAny, type FilteredKeys, type Flip, type KeyFilter, type KeyFilterFunction, type LowercaseKeys, type MemoOptions, type OnceFunction, type RetryOptions, type Series, type ThrottledFunction, type TryitResult, type UppercaseKeys, all, alphabetical, assign, boil, callable, camel, capitalize, chain, clone, cluster, compose, construct, counting, crush, dash, debounce, defer, diff, draw, filterKey, first, flat, flip, fork, get, group, guard, inRange, intersects, invert, isArray, isDate, isEmpty, isEqual, isFloat, isFunction, isInt, isIntString, isNumber, isObject, isPlainObject, isPrimitive, isPromise, isString, isSymbol, iterate, keys, last, lerp, list, listify, lowerize, map, mapEntries, mapKeys, mapValues, mapify, max, memo, merge, min, objectify, omit, once, parallel, partial, partob, pascal, pick, proxied, random, range, reduce, replace, replaceOrAppend, retry, round, select, selectFirst, series, set, shake, shift, shuffle, sift, sleep, snake, sort, sum, template, throttle, title, toFloat, toInt, toggle, trim, tryit as try, tryit, uid, unique, unzip, upperize, zip, zipToObject };

package/dist/radashi.d.ts

@@ -274,7 +274,8 @@ declare function replaceOrAppend<T>(array: readonly T[], newItem: T, match: (a:
  * // => [9, 16]
  * ```
  */
-declare function select<T, U>(array: readonly T[], mapper: (item: T, index: number) => U, condition?: (item: T, index: number) => boolean): U[];
+declare function select<T, U>(array: readonly T[], mapper: (item: T, index: number) => U, condition: (item: T, index: number) => boolean): U[];
+declare function select<T, U>(array: readonly T[], mapper: (item: T, index: number) => U | null | undefined): U[];
 
 /**
  * Select performs a find + map operation, short-circuiting on the first
@@ -621,6 +622,9 @@ declare function debounce<TArgs extends any[]>({ delay }: {
     delay: number;
 }, func: (...args: TArgs) => any): DebounceFunction<TArgs>;
 
+declare function flip<Args extends any[], Result>(fn: (...args: Args) => Result): (...args: Flip<Args>) => Result;
+type Flip<T extends any[]> = T extends [infer A, infer B, ...infer R] ? [B, A, ...R] : never;
+
 interface MemoOptions<TArgs extends any[]> {
     key?: (...args: TArgs) => string;
     ttl?: number;
@@ -633,6 +637,45 @@ interface MemoOptions<TArgs extends any[]> {
  */
 declare function memo<TArgs extends any[], TResult>(func: (...args: TArgs) => TResult, options?: MemoOptions<TArgs>): (...args: TArgs) => TResult;
 
+declare const onceSymbol: unique symbol;
+/**
+ * The type of a function wrapped with `once`.
+ */
+interface OnceFunction<Args extends unknown[] = unknown[], Return = unknown, This = unknown> {
+    (this: This, ...args: Args): Return;
+    [onceSymbol]?: Return | typeof onceSymbol;
+}
+/**
+ * Create a function that runs at most once, no matter how many times
+ * it's called. If it was already called before, returns the result
+ * from the first call. This is a lighter version of `memo()`.
+ *
+ * To allow the function to be called again, use `onceReset()`.
+ *
+ * ```ts
+ * const fn = once(() => Math.random())
+ * fn() // 0.5
+ * fn() // 0.5
+ * ```
+ */
+declare const once: {
+    <Args extends unknown[], Return, This = unknown>(fn: (this: This, ...args: Args) => Return): (this: This, ...args: Args) => Return;
+    /**
+     * Reset the result of a function that was created with `once`,
+     * allowing it to be called again.
+     *
+     * ```ts
+     * const fn = once(() => Math.random())
+     * fn() // 0.5
+     * fn() // 0.5
+     * once.reset(fn)
+     * fn() // 0.3
+     * fn() // 0.3
+     * ```
+     */
+    reset(fn: OnceFunction): void;
+};
+
 /**
  * This type produces the type array of `TItems` with all the type items
  * in `TItemsToRemove` removed from the start of the array type.
@@ -716,6 +759,17 @@ declare function inRange(number: number, end: number): boolean;
  */
 declare function inRange(number: number, start: number, end: number): boolean;
 
+/**
+ * Linearly interpolates between two numbers.
+ *
+ * ```
+ * lerp(0, 10, 0.5) // => 5
+ * lerp(5, 15, 0.2) // => 7
+ * lerp(-10, 10, 0.75) // => 5
+ * ```
+ */
+declare function lerp(from: number, to: number, amount: number): number;
+
 /**
  * Rounds a number to the given precision. The default `precision` is
  * zero. An optional rounding function (e.g. `Math.floor` or
@@ -741,9 +795,13 @@ declare function inRange(number: number, start: number, end: number): boolean;
  */
 declare function round(value: number, precision?: number, toInteger?: (value: number) => number): number;
 
-declare function toFloat<T extends number | null = number>(value: any, defaultValue?: T): number | T;
+declare function toFloat(value: unknown): number;
+declare function toFloat(value: unknown, defaultValue: number): number;
+declare function toFloat<T>(value: unknown, defaultValue: T): number | Exclude<T, undefined>;
 
-declare function toInt<T extends number | null = number>(value: any, defaultValue?: T): number | T;
+declare function toInt(value: unknown): number;
+declare function toInt(value: unknown, defaultValue: number): number;
+declare function toInt<T>(value: unknown, defaultValue: T): number | Exclude<T, undefined>;
 
 /**
  * Merges two objects together recursivly into a new object applying
@@ -789,10 +847,15 @@ type KeyFilterFunction<T extends object = object> = (value: ValueOf<T>, key: Key
  * filter function.
  */
 type KeyFilter<T extends object = object, Key extends keyof any = keyof any> = KeyFilterFunction<T> | readonly Key[];
+/**
+ * Extract the keys of an object that pass a filter.
+ */
+type FilteredKeys<T extends object, F extends KeyFilter<T> | null | undefined> = Extract<keyof T, F extends readonly any[] ? F[number] : any>;
 /**
  * Returns true if the key is in the “keys array” or if the “filter
  * function” returns true.
  */
+declare function filterKey<T extends object>(obj: T, key: keyof T, filter: KeyFilter<T, keyof T> | null | undefined): boolean;
 declare function filterKey(obj: object, key: keyof any, filter: KeyFilter | null | undefined): boolean;
 
 /**
@@ -875,7 +938,7 @@ declare function omit<T, TKeys extends keyof T>(obj: T, keys: TKeys[]): Omit<T,
 /**
  * Pick a list of properties from an object into a new object
  */
-declare function pick<T extends object, TKeys extends keyof T>(obj: T, keys: TKeys[]): Pick<T, TKeys>;
+declare function pick<T extends object, F extends KeyFilter<T, keyof T>>(obj: T, filter: F): Pick<T, FilteredKeys<T, F>>;
 
 /**
  * Opposite of get, dynamically set a nested value into an object
@@ -912,7 +975,7 @@ declare function draw<T>(array: readonly T[]): T | null;
  */
 declare function random(min: number, max: number): number;
 
-declare function shuffle<T>(array: readonly T[]): T[];
+declare function shuffle<T>(array: readonly T[], random?: (min: number, max: number) => number): T[];
 
 declare function uid(length: number, specials?: string): string;
 
@@ -1010,7 +1073,7 @@ declare function title(str: string | null | undefined): string;
  */
 declare function trim(str: string | null | undefined, charsToTrim?: string): string;
 
-declare const isArray: (value: unknown) => value is readonly any[];
+declare const isArray: <Input>(value: Input) => value is readonly any[] extends ExtractNotAny<Input, readonly any[]> ? Extract<Input, readonly any[]> : any[] extends ExtractNotAny<Input, any[]> ? Extract<Input, any[]> : unknown[] extends Input ? unknown[] : never;
 
 declare function isDate(value: any): value is Date;
 
@@ -1054,4 +1117,27 @@ declare function isString(value: any): value is string;
 
 declare function isSymbol(value: any): value is symbol;
 
-export { AggregateError, type DebounceFunction, type KeyFilter, type KeyFilterFunction, type LowercaseKeys, type MemoOptions, type RetryOptions, type Series, type ThrottledFunction, type TryitResult, type UppercaseKeys, all, alphabetical, assign, boil, callable, camel, capitalize, chain, clone, cluster, compose, construct, counting, crush, dash, debounce, defer, diff, draw, filterKey, first, flat, fork, get, group, guard, inRange, intersects, invert, isArray, isDate, isEmpty, isEqual, isFloat, isFunction, isInt, isIntString, isNumber, isObject, isPlainObject, isPrimitive, isPromise, isString, isSymbol, iterate, keys, last, list, listify, lowerize, map, mapEntries, mapKeys, mapValues, mapify, max, memo, merge, min, objectify, omit, parallel, partial, partob, pascal, pick, proxied, random, range, reduce, replace, replaceOrAppend, retry, round, select, selectFirst, series, set, shake, shift, shuffle, sift, sleep, snake, sort, sum, template, throttle, title, toFloat, toInt, toggle, trim, tryit as try, tryit, uid, unique, unzip, upperize, zip, zipToObject };
+/**
+ * The `Any` class does not exist at runtime. It's used in type
+ * definitions to detect an `any` type.
+ *
+ * ```ts
+ * type IsAny<T> = [T] extends [Any] ? 'is any' : 'is not any'
+ * ```
+ */
+declare class Any {
+    private any;
+}
+/**
+ * Extracts `T` if `T` is not `any`, otherwise `never`.
+ *
+ * ```ts
+ * type A = ExtractNotAny<any, string>
+ * //   ^? never
+ * type B = ExtractNotAny<string | number, string>
+ * //   ^? string
+ * ```
+ */
+type ExtractNotAny<T, U> = Extract<[T] extends [Any] ? never : T, U>;
+
+export { AggregateError, Any, type DebounceFunction, type ExtractNotAny, type FilteredKeys, type Flip, type KeyFilter, type KeyFilterFunction, type LowercaseKeys, type MemoOptions, type OnceFunction, type RetryOptions, type Series, type ThrottledFunction, type TryitResult, type UppercaseKeys, all, alphabetical, assign, boil, callable, camel, capitalize, chain, clone, cluster, compose, construct, counting, crush, dash, debounce, defer, diff, draw, filterKey, first, flat, flip, fork, get, group, guard, inRange, intersects, invert, isArray, isDate, isEmpty, isEqual, isFloat, isFunction, isInt, isIntString, isNumber, isObject, isPlainObject, isPrimitive, isPromise, isString, isSymbol, iterate, keys, last, lerp, list, listify, lowerize, map, mapEntries, mapKeys, mapValues, mapify, max, memo, merge, min, objectify, omit, once, parallel, partial, partob, pascal, pick, proxied, random, range, reduce, replace, replaceOrAppend, retry, round, select, selectFirst, series, set, shake, shift, shuffle, sift, sleep, snake, sort, sum, template, throttle, title, toFloat, toInt, toggle, trim, tryit as try, tryit, uid, unique, unzip, upperize, zip, zipToObject };

package/dist/radashi.js

@@ -530,7 +530,7 @@ async function retry(options, func) {
     if (err._exited) {
       throw err._exited;
     }
-    if (++i === times) {
+    if (++i >= times) {
       throw err;
     }
     if (delay) {
@@ -612,6 +612,11 @@ function debounce({ delay }, func) {
   return debounced;
 }
 
+// src/curry/flip.ts
+function flip(fn) {
+  return (arg2, arg1, ...args) => fn(arg1, arg2, ...args);
+}
+
 // src/curry/memo.ts
 function memoize(cache, func, keyFunc, ttl) {
   return function callWithMemo(...args) {
@@ -637,6 +642,22 @@ function memo(func, options = {}) {
   return memoize({}, func, options.key ?? null, options.ttl ?? null);
 }
 
+// src/curry/once.ts
+var onceSymbol = Symbol();
+var once = (fn) => {
+  const onceFn = function(...args) {
+    if (onceFn[onceSymbol] === onceSymbol) {
+      onceFn[onceSymbol] = fn.apply(this, args);
+    }
+    return onceFn[onceSymbol];
+  };
+  onceFn[onceSymbol] = onceSymbol;
+  return onceFn;
+};
+once.reset = (fn) => {
+  fn[onceSymbol] = onceSymbol;
+};
+
 // src/curry/partial.ts
 function partial(fn, ...args) {
   return (...rest) => fn(...[...args, ...rest]);
@@ -691,6 +712,11 @@ function inRange(number, start, end) {
   return number >= Math.min(start, end) && number < Math.max(start, end);
 }
 
+// src/number/lerp.ts
+function lerp(from, to, amount) {
+  return from + (to - from) * amount;
+}
+
 // src/number/round.ts
 function round(value, precision, toInteger = Math.round) {
   if (precision) {
@@ -704,22 +730,14 @@ function round(value, precision, toInteger = Math.round) {
 
 // src/number/toFloat.ts
 function toFloat(value, defaultValue) {
-  const def = defaultValue === void 0 ? 0 : defaultValue;
-  if (value === null || value === void 0) {
-    return def;
-  }
-  const result = Number.parseFloat(value);
-  return Number.isNaN(result) ? def : result;
+  const parsedValue = isSymbol(value) ? Number.NaN : Number.parseFloat(value);
+  return Number.isNaN(parsedValue) ? defaultValue !== void 0 ? defaultValue : 0 : parsedValue;
 }
 
 // src/number/toInt.ts
 function toInt(value, defaultValue) {
-  const def = defaultValue === void 0 ? 0 : defaultValue;
-  if (value === null || value === void 0) {
-    return def;
-  }
-  const result = Number.parseInt(value);
-  return Number.isNaN(result) ? def : result;
+  const parsedValue = isSymbol(value) ? Number.NaN : Number.parseInt(value);
+  return Number.isNaN(parsedValue) ? defaultValue !== void 0 ? defaultValue : 0 : parsedValue;
 }
 
 // src/object/assign.ts
@@ -923,19 +941,22 @@ function omit(obj, keys2) {
 }
 
 // src/object/pick.ts
-function pick(obj, keys2) {
+function pick(obj, filter) {
   if (!obj) {
     return {};
   }
-  return keys2.reduce(
-    (acc, key) => {
-      if (Object.hasOwnProperty.call(obj, key)) {
-        acc[key] = obj[key];
-      }
-      return acc;
-    },
-    {}
-  );
+  let keys2 = filter;
+  if (isArray(filter)) {
+    filter = null;
+  } else {
+    keys2 = Reflect.ownKeys(obj);
+  }
+  return keys2.reduce((acc, key) => {
+    if (filterKey(obj, key, filter)) {
+      acc[key] = obj[key];
+    }
+    return acc;
+  }, {});
 }
 
 // src/object/set.ts
@@ -992,8 +1013,15 @@ function random(min2, max2) {
 }
 
 // src/random/shuffle.ts
-function shuffle(array) {
-  return array.map((a) => ({ rand: Math.random(), value: a })).sort((a, b) => a.rand - b.rand).map((a) => a.value);
+function shuffle(array, random2 = random) {
+  const newArray = array.slice();
+  for (let idx = 0, randomIdx, item; idx < array.length; idx++) {
+    randomIdx = random2(0, array.length - 1);
+    item = newArray[randomIdx];
+    newArray[randomIdx] = newArray[idx];
+    newArray[idx] = item;
+  }
+  return newArray;
 }
 
 // src/random/uid.ts
@@ -1316,6 +1344,7 @@ export {
   filterKey,
   first,
   flat,
+  flip,
   fork,
   get,
   group,
@@ -1341,6 +1370,7 @@ export {
   iterate,
   keys,
   last,
+  lerp,
   list,
   listify,
   lowerize,
@@ -1355,6 +1385,7 @@ export {
   min,
   objectify,
   omit,
+  once,
   parallel,
   partial,
   partob,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "radashi",
-  "version": "12.2.0-beta.dc9ade1",
+  "version": "12.2.0-beta.ef0154b",
   "description": "Functional utility library - modern, simple, typed, powerful",
   "sideEffects": false,
   "author": "Alec Larson",