radashi 12.3.3 → 13.0.0-beta.ffa4778

package/dist/radashi.cjs

@@ -2,9 +2,6 @@
 
 // src/array/alphabetical.ts
 function alphabetical(array, getter, direction = "asc") {
-  if (!array) {
-    return [];
-  }
   const asc = (a, b) => `${getter(a)}`.localeCompare(getter(b));
   const dsc = (a, b) => `${getter(b)}`.localeCompare(getter(a));
   return array.slice().sort(direction === "desc" ? dsc : asc);
@@ -12,10 +9,7 @@ function alphabetical(array, getter, direction = "asc") {
 
 // src/array/boil.ts
 function boil(array, compareFunc) {
-  if (!array || (array.length ?? 0) === 0) {
-    return null;
-  }
-  return array.reduce(compareFunc);
+  return array.length ? array.reduce(compareFunc) : null;
 }
 
 // src/array/cartesianProduct.ts
@@ -56,9 +50,6 @@ function cluster(array, size = 2) {
 
 // src/array/counting.ts
 function counting(array, identity) {
-  if (!array) {
-    return {};
-  }
   return array.reduce(
     (acc, item) => {
       const id = identity(item);
@@ -71,15 +62,6 @@ function counting(array, identity) {
 
 // src/array/diff.ts
 function diff(root, other, identity = (t) => t) {
-  if (!(root == null ? void 0 : root.length) && !(other == null ? void 0 : other.length)) {
-    return [];
-  }
-  if ((root == null ? void 0 : root.length) === void 0) {
-    return [...other];
-  }
-  if (!(other == null ? void 0 : other.length)) {
-    return [...root];
-  }
   const bKeys = other.reduce(
     (acc, item) => {
       acc[identity(item)] = true;
@@ -92,7 +74,7 @@ function diff(root, other, identity = (t) => t) {
 
 // src/array/first.ts
 function first(array, defaultValue) {
-  return (array == null ? void 0 : array.length) > 0 ? array[0] : defaultValue;
+  return array.length > 0 ? array[0] : defaultValue;
 }
 
 // src/array/flat.ts
@@ -106,10 +88,8 @@ function flat(lists) {
 // src/array/fork.ts
 function fork(array, condition) {
   const forked = [[], []];
-  if (array) {
-    for (const item of array) {
-      forked[condition(item) ? 0 : 1].push(item);
-    }
+  for (const item of array) {
+    forked[condition(item) ? 0 : 1].push(item);
   }
   return forked;
 }
@@ -131,9 +111,6 @@ function group(array, getGroupId) {
 
 // src/array/intersects.ts
 function intersects(listA, listB, identity) {
-  if (!listA || !listB) {
-    return false;
-  }
   if (identity) {
     const known = new Set(listA.map(identity));
     return listB.some((item) => known.has(identity(item)));
@@ -152,7 +129,7 @@ function iterate(count, func, initValue) {
 
 // src/array/last.ts
 function last(array, defaultValue) {
-  return (array == null ? void 0 : array.length) > 0 ? array[array.length - 1] : defaultValue;
+  return array.length > 0 ? array[array.length - 1] : defaultValue;
 }
 
 // src/array/list.ts
@@ -171,18 +148,6 @@ function mapify(array, getKey, getValue = (item) => item) {
 
 // src/array/merge.ts
 function merge(prev, array, toKey) {
-  if (!array && !prev) {
-    return [];
-  }
-  if (!array) {
-    return [...prev];
-  }
-  if (!prev) {
-    return [];
-  }
-  if (!toKey) {
-    return [...prev];
-  }
   const keys2 = /* @__PURE__ */ new Map();
   for (const item of array) {
     keys2.set(toKey(item), item);
@@ -206,9 +171,6 @@ function objectify(array, getKey, getValue = (item) => item) {
 
 // src/array/replace.ts
 function replace(array, newItem, match) {
-  if (!array) {
-    return [];
-  }
   if (newItem === void 0) {
     return [...array];
   }
@@ -224,15 +186,9 @@ function replace(array, newItem, match) {
 
 // src/array/replaceOrAppend.ts
 function replaceOrAppend(array, newItem, match) {
-  if (!array && !newItem) {
-    return [];
-  }
-  if (!newItem) {
+  if (newItem === void 0) {
     return [...array];
   }
-  if (!array) {
-    return [newItem];
-  }
   const out = array.slice();
   for (let index = 0; index < array.length; index++) {
     if (match(array[index], index)) {
@@ -246,9 +202,6 @@ function replaceOrAppend(array, newItem, match) {
 
 // src/array/select.ts
 function select(array, mapper, condition) {
-  if (!array) {
-    return [];
-  }
   let mapped;
   return array.reduce((acc, item, index) => {
     if (condition) {
@@ -262,9 +215,6 @@ function select(array, mapper, condition) {
 
 // src/array/selectFirst.ts
 function selectFirst(array, mapper, condition) {
-  if (!array) {
-    return void 0;
-  }
   let foundIndex = -1;
   const found = array.find((item, index) => {
     foundIndex = index;
@@ -292,9 +242,6 @@ function sift(array) {
 
 // src/array/sort.ts
 function sort(array, getter, desc = false) {
-  if (!array) {
-    return [];
-  }
   const asc = (a, b) => getter(a) - getter(b);
   const dsc = (a, b) => getter(b) - getter(a);
   return array.slice().sort(desc === true ? dsc : asc);
@@ -302,9 +249,6 @@ function sort(array, getter, desc = false) {
 
 // src/array/toggle.ts
 function toggle(array, item, toKey, options) {
-  if (!array) {
-    return item !== void 0 ? [item] : [];
-  }
   if (item === void 0) {
     return [...array];
   }
@@ -340,9 +284,6 @@ function unique(array, toKey) {
 
 // src/array/unzip.ts
 function unzip(arrays) {
-  if (!arrays || !arrays.length) {
-    return [];
-  }
   const out = new Array(
     arrays.reduce((max2, arr) => Math.max(max2, arr.length), 0)
   );
@@ -361,9 +302,6 @@ function zip(...arrays) {
 
 // src/array/zipToObject.ts
 function zipToObject(keys2, values) {
-  if (!keys2 || !keys2.length) {
-    return {};
-  }
   const getValue = isFunction(values) ? values : isArray(values) ? (_k, i) => values[i] : (_k, _i) => values;
   return keys2.reduce(
     (acc, key, idx) => {
@@ -450,9 +388,6 @@ function guard(func, shouldGuard) {
 
 // src/async/map.ts
 async function map(array, asyncMapFunc) {
-  if (!array) {
-    return [];
-  }
   const result = [];
   let index = 0;
   for (const value of array) {
@@ -521,17 +456,20 @@ async function parallel(options, array, func) {
 }
 
 // src/async/reduce.ts
-async function reduce(array, asyncReducer, initValue) {
-  const initProvided = initValue !== void 0;
-  if (!initProvided && (array == null ? void 0 : array.length) < 1) {
-    throw new Error("Cannot reduce empty array with no init value");
+async function reduce(array, reducer, initialValue) {
+  const indices = array.keys();
+  let acc = initialValue;
+  if (acc === void 0 && arguments.length < 3) {
+    if (!array.length) {
+      throw new TypeError("Reduce of empty array with no initial value");
+    }
+    acc = array[0];
+    indices.next();
   }
-  const iter = initProvided ? array : array.slice(1);
-  let value = initProvided ? initValue : array[0];
-  for (const [i, item] of iter.entries()) {
-    value = await asyncReducer(value, item, i);
+  for (const index of indices) {
+    acc = await reducer(acc, array[index], index);
   }
-  return value;
+  return acc;
 }
 
 // src/async/retry.ts
@@ -638,31 +576,30 @@ function compose(...funcs) {
 }
 
 // src/curry/debounce.ts
-function debounce({ delay, leading }, func) {
-  let timer = void 0;
-  let active = true;
+function debounce({ delay, leading }, callee) {
+  let timeout2;
   const debounced = (...args) => {
-    if (active) {
-      clearTimeout(timer);
-      timer = setTimeout(() => {
-        active && func(...args);
-        timer = void 0;
-      }, delay);
-      if (leading) {
-        func(...args);
-        leading = false;
-      }
+    clearTimeout(timeout2);
+    if (leading) {
+      leading = false;
+      callee(...args);
     } else {
-      func(...args);
+      timeout2 = setTimeout(
+        debounced.flush = () => {
+          debounced.flush = noop;
+          clearTimeout(timeout2);
+          callee(...args);
+        },
+        delay
+      );
     }
   };
-  debounced.isPending = () => {
-    return timer !== void 0;
-  };
+  debounced.callee = callee;
+  debounced.flush = noop;
   debounced.cancel = () => {
-    active = false;
+    debounced.flush = noop;
+    clearTimeout(timeout2);
   };
-  debounced.flush = (...args) => func(...args);
   return debounced;
 }
 
@@ -801,15 +738,7 @@ function clamp(n, min2, max2) {
 }
 
 // src/number/inRange.ts
-function inRange(number, start, end) {
-  const isTypeSafe = typeof number === "number" && typeof start === "number" && (typeof end === "undefined" || typeof end === "number");
-  if (!isTypeSafe) {
-    return false;
-  }
-  if (typeof end === "undefined") {
-    end = start;
-    start = 0;
-  }
+function inRange(number, start, end = 0) {
   return number >= Math.min(start, end) && number < Math.max(start, end);
 }
 
@@ -820,7 +749,7 @@ function lerp(from, to, amount) {
 
 // src/number/max.ts
 function max(array, getter) {
-  if (!array || (array.length ?? 0) === 0) {
+  if (!array.length) {
     return null;
   }
   const get2 = getter ?? ((v) => v);
@@ -829,7 +758,7 @@ function max(array, getter) {
 
 // src/number/min.ts
 function min(array, getter) {
-  if (!array || (array.length ?? 0) === 0) {
+  if (!array.length) {
     return null;
   }
   const get2 = getter ?? ((v) => v);
@@ -879,9 +808,6 @@ function toInt(value, defaultValue) {
 
 // src/object/assign.ts
 function assign(initial, override) {
-  if (!initial || !override) {
-    return initial ?? override ?? {};
-  }
   const proto = Object.getPrototypeOf(initial);
   const merged = proto ? { ...initial } : Object.assign(Object.create(proto), initial);
   for (const key of Object.keys(override)) {
@@ -892,12 +818,6 @@ function assign(initial, override) {
 
 // src/object/clone.ts
 function clone(obj) {
-  if (isPrimitive(obj)) {
-    return obj;
-  }
-  if (typeof obj === "function") {
-    return obj.bind({});
-  }
   const proto = Object.getPrototypeOf(obj);
   const newObj = typeof (proto == null ? void 0 : proto.constructor) === "function" ? new proto.constructor() : Object.create(proto);
   for (const key of Object.getOwnPropertyNames(obj)) {
@@ -975,9 +895,6 @@ function cloneDeep(root, customStrategy) {
 
 // src/object/construct.ts
 function construct(obj) {
-  if (!obj) {
-    return {};
-  }
   return Object.keys(obj).reduce((acc, path) => {
     return set(acc, path, obj[path]);
   }, {});
@@ -985,9 +902,6 @@ function construct(obj) {
 
 // src/object/crush.ts
 function crush(value) {
-  if (!value) {
-    return {};
-  }
   return function crushReducer(crushed, value2, path) {
     if (isObject(value2) || isArray(value2)) {
       for (const [prop, propValue] of Object.entries(value2)) {
@@ -1030,9 +944,6 @@ function get(value, path, defaultValue) {
 
 // src/object/invert.ts
 function invert(obj) {
-  if (!obj) {
-    return {};
-  }
   const keys2 = Object.keys(obj);
   return keys2.reduce(
     (acc, key) => {
@@ -1045,9 +956,6 @@ function invert(obj) {
 
 // src/object/keys.ts
 function keys(value) {
-  if (!value) {
-    return [];
-  }
   const keys2 = [];
   const keyPath = [];
   const recurse = (value2) => {
@@ -1073,14 +981,7 @@ function keys(value) {
 
 // src/object/listify.ts
 function listify(obj, toItem) {
-  if (!obj) {
-    return [];
-  }
-  const entries = Object.entries(obj);
-  if (entries.length === 0) {
-    return [];
-  }
-  return entries.reduce((acc, entry) => {
+  return Object.entries(obj).reduce((acc, entry) => {
     acc.push(toItem(entry[0], entry[1]));
     return acc;
   }, []);
@@ -1093,9 +994,6 @@ function lowerize(obj) {
 
 // src/object/mapEntries.ts
 function mapEntries(obj, toEntry) {
-  if (!obj) {
-    return {};
-  }
   return Object.entries(obj).reduce(
     (acc, [key, value]) => {
       const [newKey, newValue] = toEntry(key, value);
@@ -1131,10 +1029,7 @@ function mapValues(obj, mapFunc) {
 
 // src/object/omit.ts
 function omit(obj, keys2) {
-  if (!obj) {
-    return {};
-  }
-  if (!keys2 || keys2.length === 0) {
+  if (keys2.length === 0) {
     return obj;
   }
   return keys2.reduce(
@@ -1148,9 +1043,6 @@ function omit(obj, keys2) {
 
 // src/object/pick.ts
 function pick(obj, filter) {
-  if (!obj) {
-    return {};
-  }
   let keys2 = filter;
   if (isArray(filter)) {
     filter = null;
@@ -1167,28 +1059,20 @@ function pick(obj, filter) {
 
 // src/object/set.ts
 function set(initial, path, value) {
-  if (!initial) {
-    return {};
-  }
-  if (!path || value === void 0) {
+  if (value === void 0) {
     return initial;
   }
   const root = clone(initial);
   const keys2 = path.match(/[^.[\]]+/g);
-  if (keys2) {
-    keys2.reduce(
-      (object, key, i) => i < keys2.length - 1 ? object[key] ??= isIntString(keys2[i + 1]) ? [] : {} : object[key] = value,
-      root
-    );
-  }
+  keys2 == null ? void 0 : keys2.reduce(
+    (object, key, i) => i < keys2.length - 1 ? object[key] ??= isIntString(keys2[i + 1]) ? [] : {} : object[key] = value,
+    root
+  );
   return root;
 }
 
 // src/object/shake.ts
 function shake(obj, filter = (value) => value === void 0) {
-  if (!obj) {
-    return {};
-  }
   return Object.keys(obj).reduce((acc, key) => {
     if (!filter(obj[key])) {
       acc[key] = obj[key];
@@ -1395,14 +1279,7 @@ var series = (items, toKey = (item) => `${item}`) => {
 
 // src/string/camel.ts
 function camel(str) {
-  var _a;
-  const parts = ((_a = str == null ? void 0 : str.replace(/([A-Z])+/g, capitalize)) == null ? void 0 : _a.split(/(?=[A-Z])|[\.\-\s_]/).map((x) => x.toLowerCase())) ?? [];
-  if (parts.length === 0) {
-    return "";
-  }
-  if (parts.length === 1) {
-    return parts[0];
-  }
+  const parts = str.replace(/([A-Z])+/g, capitalize).split(/(?=[A-Z])|[\.\-\s_]/).map((x) => x.toLowerCase());
   return parts.reduce((acc, part) => {
     return `${acc}${part.charAt(0).toUpperCase()}${part.slice(1)}`;
   });
@@ -1410,23 +1287,13 @@ function camel(str) {
 
 // src/string/capitalize.ts
 function capitalize(str) {
-  if (!str || str.length === 0) {
-    return "";
-  }
   const lower = str.toLowerCase();
   return lower.substring(0, 1).toUpperCase() + lower.substring(1, lower.length);
 }
 
 // src/string/dash.ts
 function dash(str) {
-  var _a;
-  const parts = ((_a = str == null ? void 0 : str.replace(/([A-Z])+/g, capitalize)) == null ? void 0 : _a.split(/(?=[A-Z])|[\.\-\s_]/).map((x) => x.toLowerCase())) ?? [];
-  if (parts.length === 0) {
-    return "";
-  }
-  if (parts.length === 1) {
-    return parts[0];
-  }
+  const parts = str.replace(/([A-Z])+/g, capitalize).split(/(?=[A-Z])|[\.\-\s_]/).map((x) => x.toLowerCase());
   return parts.reduce((acc, part) => {
     return `${acc}-${part.toLowerCase()}`;
   });
@@ -1458,9 +1325,6 @@ function dedent(text, ...values) {
 
 // src/string/pascal.ts
 function pascal(str) {
-  if (!str) {
-    return "";
-  }
   const result = str.replace(
     /(?:[^\w\d]|_|\s)+(\w)([A-Z]+)?/g,
     (_, firstCharacter, capitalizedLetters) => {
@@ -1523,13 +1387,7 @@ function similarity(str1, str2) {
 
 // src/string/snake.ts
 function snake(str, options) {
-  const parts = (str == null ? void 0 : str.replace(/([A-Z])+/g, capitalize).split(/(?=[A-Z])|[\.\-\s_]/).map((x) => x.toLowerCase())) ?? [];
-  if (parts.length === 0) {
-    return "";
-  }
-  if (parts.length === 1) {
-    return parts[0];
-  }
+  const parts = str.replace(/([A-Z])+/g, capitalize).split(/(?=[A-Z])|[\.\-\s_]/).map((x) => x.toLowerCase());
   const result = parts.reduce((acc, part) => {
     return `${acc}_${part.toLowerCase()}`;
   });
@@ -1550,17 +1408,11 @@ function template(str, data, regex = /\{\{(.+?)\}\}/g) {
 
 // src/string/title.ts
 function title(str) {
-  if (!str) {
-    return "";
-  }
   return str.split(/(?=[A-Z])|[\.\-\s_]/).map((s) => s.trim()).filter((s) => !!s).map((s) => capitalize(s.toLowerCase())).join(" ");
 }
 
 // src/string/trim.ts
 function trim(str, charsToTrim = " ") {
-  if (!str) {
-    return "";
-  }
   const toTrim = charsToTrim.replace(/[\W]{1}/g, "\\$&");
   const regex = new RegExp(`^[${toTrim}]+|[${toTrim}]+$`, "g");
   return str.replace(regex, "");
@@ -1653,7 +1505,7 @@ function isError(value) {
 
 // src/typed/isFloat.ts
 function isFloat(value) {
-  return isNumber(value) && value % 1 !== 0;
+  return isNumber(value) && !Number.isNaN(value) && value % 1 !== 0;
 }
 
 // src/typed/isFunction.ts
@@ -1690,7 +1542,7 @@ function isNullish(value) {
 
 // src/typed/isNumber.ts
 function isNumber(value) {
-  return typeof value === "number" && !Number.isNaN(value);
+  return typeof value === "number";
 }
 
 // src/typed/isObject.ts

package/dist/radashi.d.cts

@@ -332,6 +332,7 @@ declare function merge<T>(prev: readonly T[], array: readonly T[], toKey: (item:
  */
 declare function objectify<T, Key extends string | number | symbol, Value = T>(array: readonly T[], getKey: (item: T) => Key, getValue?: (item: T) => Value): Record<Key, Value>;
 
+type Defined$1<T> = T & ({} | null);
 /**
  * Replace an element in an array with a new item without modifying
  * the array and return the new value.
@@ -344,8 +345,9 @@ declare function objectify<T, Key extends string | number | symbol, Value = T>(a
  * ```
  * @version 12.1.0
  */
-declare function replace<T>(array: readonly T[], newItem: T, match: (item: T, idx: number) => boolean): T[];
+declare function replace<T, U>(array: readonly T[], newItem: U, match: (item: T, idx: number) => boolean): (T | Defined$1<U>)[];
 
+type Defined<T> = T & ({} | null);
 /**
  * Replace the first occurrence of an item in an array where the
  * `match` function returns true. If no items match, append the new
@@ -362,7 +364,7 @@ declare function replace<T>(array: readonly T[], newItem: T, match: (item: T, id
  * ```
  * @version 12.1.0
  */
-declare function replaceOrAppend<T>(array: readonly T[], newItem: T, match: (a: T, idx: number) => boolean): T[];
+declare function replaceOrAppend<T, U>(array: readonly T[], newItem: U, match: (a: T, idx: number) => boolean): (T | Defined<U>)[];
 
 /**
  * Select performs a filter and a mapper inside of a reduce, only
@@ -738,7 +740,8 @@ declare function parallel<T, K>(options: ParallelOptions | number, array: readon
  * ```
  * @version 12.1.0
  */
-declare function reduce<T, K>(array: readonly T[], asyncReducer: (acc: K, item: T, index: number) => Promise<K>, initValue?: K): Promise<K>;
+declare function reduce<T, K>(array: readonly T[], reducer: (acc: K, item: T, index: number) => Promise<K>, initialValue: K): Promise<K>;
+declare function reduce<T, K>(array: readonly T[], reducer: (acc: K, item: T, index: number) => Promise<K>): Promise<K>;
 
 type AbortSignal = {
     throwIfAborted(): void;
@@ -944,7 +947,7 @@ declare function compose<F1Result, F1Args extends any[], F1NextArgs extends any[
 declare function compose<F1Result, F1Args extends any[], F1NextArgs extends any[], F2NextArgs extends any[], F2Result, F3NextArgs extends any[], F3Result, F4NextArgs extends any[], F4Result, F5NextArgs extends any[], F5Result, F6NextArgs extends any[], F6Result, F7NextArgs extends any[], F7Result, F8NextArgs extends any[], F8Result, LastResult>(f1: (next: (...args: F1NextArgs) => F2Result) => (...args: F1Args) => F1Result, f2: (next: (...args: F2NextArgs) => F3Result) => (...args: F1NextArgs) => F2Result, f3: (next: (...args: F3NextArgs) => F4Result) => (...args: F2NextArgs) => F3Result, f4: (next: (...args: F4NextArgs) => F5Result) => (...args: F3NextArgs) => F4Result, f5: (next: (...args: F5NextArgs) => F6Result) => (...args: F4NextArgs) => F5Result, f6: (next: (...args: F6NextArgs) => F7Result) => (...args: F5NextArgs) => F6Result, f7: (next: (...args: F7NextArgs) => LastResult) => (...args: F6NextArgs) => F7Result, f8: (next: (...args: F8NextArgs) => LastResult) => (...args: F7NextArgs) => F8Result, last: (...args: F8NextArgs) => LastResult): (...args: F1Args) => F1Result;
 declare function compose<F1Result, F1Args extends any[], F1NextArgs extends any[], F2NextArgs extends any[], F2Result, F3NextArgs extends any[], F3Result, F4NextArgs extends any[], F4Result, F5NextArgs extends any[], F5Result, F6NextArgs extends any[], F6Result, F7NextArgs extends any[], F7Result, F8NextArgs extends any[], F8Result, F9NextArgs extends any[], F9Result, LastResult>(f1: (next: (...args: F1NextArgs) => F2Result) => (...args: F1Args) => F1Result, f2: (next: (...args: F2NextArgs) => F3Result) => (...args: F1NextArgs) => F2Result, f3: (next: (...args: F3NextArgs) => F4Result) => (...args: F2NextArgs) => F3Result, f4: (next: (...args: F4NextArgs) => F5Result) => (...args: F3NextArgs) => F4Result, f5: (next: (...args: F5NextArgs) => F6Result) => (...args: F4NextArgs) => F5Result, f6: (next: (...args: F6NextArgs) => F7Result) => (...args: F5NextArgs) => F6Result, f7: (next: (...args: F7NextArgs) => LastResult) => (...args: F6NextArgs) => F7Result, f8: (next: (...args: F8NextArgs) => LastResult) => (...args: F7NextArgs) => F8Result, f9: (next: (...args: F9NextArgs) => LastResult) => (...args: F8NextArgs) => F9Result, last: (...args: F9NextArgs) => LastResult): (...args: F1Args) => F1Result;
 
-type DebounceFunction<TArgs extends any[]> = {
+interface DebounceFunction<TArgs extends any[] = any> {
     (...args: TArgs): void;
     /**
      * When called, future invocations of the debounced function are
@@ -952,15 +955,16 @@ type DebounceFunction<TArgs extends any[]> = {
      */
     cancel(): void;
     /**
-     * Returns `true` if the underlying function is scheduled to be
-     * called once the delay has passed.
+     * If the debounced function is pending, it will be invoked
+     * immediately and the result will be returned. Otherwise,
+     * `undefined` will be returned.
      */
-    isPending(): boolean;
+    flush(...args: TArgs): void;
     /**
-     * Invoke the underlying function immediately.
+     * The underlying function
      */
-    flush(...args: TArgs): void;
-};
+    readonly callee: (...args: TArgs) => unknown;
+}
 interface DebounceOptions {
     delay: number;
     /**
@@ -973,11 +977,11 @@ interface DebounceOptions {
     leading?: boolean;
 }
 /**
- * Returns a new function that will only call your callback after
- * `delay` milliseconds have passed without any invocations.
+ * Returns a new function that will only call the source function
+ * after `delay` milliseconds have passed without any invocations.
  *
- * The debounced function has a few methods, such as `cancel`,
- * `isPending`, and `flush`.
+ * See the documentation (or the `DebounceFunction` type) for details
+ * on the methods and properties available on the returned function.
  *
  * @see https://radashi.js.org/reference/curry/debounce
  * @example
@@ -992,7 +996,7 @@ interface DebounceOptions {
  * ```
  * @version 12.1.0
  */
-declare function debounce<TArgs extends any[]>({ delay, leading }: DebounceOptions, func: (...args: TArgs) => any): DebounceFunction<TArgs>;
+declare function debounce<TArgs extends any[]>({ delay, leading }: DebounceOptions, callee: (...args: TArgs) => unknown): DebounceFunction<TArgs>;
 
 /**
  * Flip the first two arguments of a function.
@@ -1468,7 +1472,7 @@ declare function range<T = number>(startOrLength: number, end?: number, valueOrM
  * @example
  * ```ts
  * round(123.456)
- * // => 123.5
+ * // => 123
  *
  * round(1234.56, -2)
  * // => 1200
@@ -1634,7 +1638,7 @@ TOverride | (IsOptional extends true ? TInitial : never) : Extract<TOverride, ob
  * ```
  * @version 12.1.0
  */
-declare function clone<T>(obj: T): T;
+declare function clone<T extends object>(obj: T): T;
 
 /**
  * A strategy for cloning objects with `cloneDeep`.
@@ -2356,7 +2360,7 @@ declare function template(str: string, data: Record<string, any>, regex?: RegExp
  * ```
  * @version 12.1.0
  */
-declare function title(str: string | null | undefined): string;
+declare function title(str: string): string;
 
 /**
  * Trims all prefix and suffix characters from the given string. Like
@@ -2373,7 +2377,7 @@ declare function title(str: string | null | undefined): string;
  * ```
  * @version 12.1.0
  */
-declare function trim(str: string | null | undefined, charsToTrim?: string): string;
+declare function trim(str: string, charsToTrim?: string): string;
 
 /**
  * Literally just `Array.isArray` but with better type inference.
@@ -2619,7 +2623,7 @@ declare function isNullish(value: unknown): value is null | undefined;
  * ```ts
  * isNumber(0) // => true
  * isNumber('0') // => false
- * isNumber(NaN) // => false
+ * isNumber(NaN) // => true
  * ```
  * @version 12.1.0
  */