es-toolkit 1.50.0-dev.2057 → 1.50.0-dev.2059

package/dist/compat/function/rest.js

@@ -24,7 +24,7 @@ const require_rest = require("../../function/rest.js");
 *
 * // Using start index 1
 * const transformedFnWithStart = rest(fn, 1);
-* console.log(transformedFnWithStart(1, 2, 3, 4)); // [1, [2, 3, 4]]
+* console.log(transformedFnWithStart(1, 2, 3, 4)); // [1, [2, 3, 4], undefined]
 *
 * // With fewer arguments than the start index
 * console.log(transformedFn(1)); // [1, undefined, []]

package/dist/compat/function/rest.mjs

@@ -24,7 +24,7 @@ import { rest as rest$1 } from "../../function/rest.mjs";
 *
 * // Using start index 1
 * const transformedFnWithStart = rest(fn, 1);
-* console.log(transformedFnWithStart(1, 2, 3, 4)); // [1, [2, 3, 4]]
+* console.log(transformedFnWithStart(1, 2, 3, 4)); // [1, [2, 3, 4], undefined]
 *
 * // With fewer arguments than the start index
 * console.log(transformedFn(1)); // [1, undefined, []]

package/dist/compat/object/cloneDeep.d.mts

@@ -16,30 +16,30 @@
  * @example
  * // Clone an array
  * const arr = [1, 2, 3];
- * const clonedArr = clone(arr);
+ * const clonedArr = cloneDeep(arr);
  * console.log(clonedArr); // [1, 2, 3]
  * console.log(clonedArr === arr); // false
  *
  * @example
  * // Clone an array with nested objects
  * const arr = [1, { a: 1 }, [1, 2, 3]];
- * const clonedArr = clone(arr);
+ * const clonedArr = cloneDeep(arr);
  * arr[1].a = 2;
- * console.log(arr); // [2, { a: 2 }, [1, 2, 3]]
+ * console.log(arr); // [1, { a: 2 }, [1, 2, 3]]
  * console.log(clonedArr); // [1, { a: 1 }, [1, 2, 3]]
  * console.log(clonedArr === arr); // false
  *
  * @example
  * // Clone an object
  * const obj = { a: 1, b: 'es-toolkit', c: [1, 2, 3] };
- * const clonedObj = clone(obj);
+ * const clonedObj = cloneDeep(obj);
  * console.log(clonedObj); // { a: 1, b: 'es-toolkit', c: [1, 2, 3] }
  * console.log(clonedObj === obj); // false
  *
  * @example
  * // Clone an object with nested objects
  * const obj = { a: 1, b: { c: 1 } };
- * const clonedObj = clone(obj);
+ * const clonedObj = cloneDeep(obj);
  * obj.b.c = 2;
  * console.log(obj); // { a: 1, b: { c: 2 } }
  * console.log(clonedObj); // { a: 1, b: { c: 1 } }

package/dist/compat/object/cloneDeep.d.ts

@@ -16,30 +16,30 @@
  * @example
  * // Clone an array
  * const arr = [1, 2, 3];
- * const clonedArr = clone(arr);
+ * const clonedArr = cloneDeep(arr);
  * console.log(clonedArr); // [1, 2, 3]
  * console.log(clonedArr === arr); // false
  *
  * @example
  * // Clone an array with nested objects
  * const arr = [1, { a: 1 }, [1, 2, 3]];
- * const clonedArr = clone(arr);
+ * const clonedArr = cloneDeep(arr);
  * arr[1].a = 2;
- * console.log(arr); // [2, { a: 2 }, [1, 2, 3]]
+ * console.log(arr); // [1, { a: 2 }, [1, 2, 3]]
  * console.log(clonedArr); // [1, { a: 1 }, [1, 2, 3]]
  * console.log(clonedArr === arr); // false
  *
  * @example
  * // Clone an object
  * const obj = { a: 1, b: 'es-toolkit', c: [1, 2, 3] };
- * const clonedObj = clone(obj);
+ * const clonedObj = cloneDeep(obj);
  * console.log(clonedObj); // { a: 1, b: 'es-toolkit', c: [1, 2, 3] }
  * console.log(clonedObj === obj); // false
  *
  * @example
  * // Clone an object with nested objects
  * const obj = { a: 1, b: { c: 1 } };
- * const clonedObj = clone(obj);
+ * const clonedObj = cloneDeep(obj);
  * obj.b.c = 2;
  * console.log(obj); // { a: 1, b: { c: 2 } }
  * console.log(clonedObj); // { a: 1, b: { c: 1 } }

package/dist/compat/object/cloneDeep.js

@@ -17,30 +17,30 @@ const require_cloneDeepWith = require("./cloneDeepWith.js");
 * @example
 * // Clone an array
 * const arr = [1, 2, 3];
-* const clonedArr = clone(arr);
+* const clonedArr = cloneDeep(arr);
 * console.log(clonedArr); // [1, 2, 3]
 * console.log(clonedArr === arr); // false
 *
 * @example
 * // Clone an array with nested objects
 * const arr = [1, { a: 1 }, [1, 2, 3]];
-* const clonedArr = clone(arr);
+* const clonedArr = cloneDeep(arr);
 * arr[1].a = 2;
-* console.log(arr); // [2, { a: 2 }, [1, 2, 3]]
+* console.log(arr); // [1, { a: 2 }, [1, 2, 3]]
 * console.log(clonedArr); // [1, { a: 1 }, [1, 2, 3]]
 * console.log(clonedArr === arr); // false
 *
 * @example
 * // Clone an object
 * const obj = { a: 1, b: 'es-toolkit', c: [1, 2, 3] };
-* const clonedObj = clone(obj);
+* const clonedObj = cloneDeep(obj);
 * console.log(clonedObj); // { a: 1, b: 'es-toolkit', c: [1, 2, 3] }
 * console.log(clonedObj === obj); // false
 *
 * @example
 * // Clone an object with nested objects
 * const obj = { a: 1, b: { c: 1 } };
-* const clonedObj = clone(obj);
+* const clonedObj = cloneDeep(obj);
 * obj.b.c = 2;
 * console.log(obj); // { a: 1, b: { c: 2 } }
 * console.log(clonedObj); // { a: 1, b: { c: 1 } }

package/dist/compat/object/cloneDeep.mjs

@@ -17,30 +17,30 @@ import { cloneDeepWith } from "./cloneDeepWith.mjs";
 * @example
 * // Clone an array
 * const arr = [1, 2, 3];
-* const clonedArr = clone(arr);
+* const clonedArr = cloneDeep(arr);
 * console.log(clonedArr); // [1, 2, 3]
 * console.log(clonedArr === arr); // false
 *
 * @example
 * // Clone an array with nested objects
 * const arr = [1, { a: 1 }, [1, 2, 3]];
-* const clonedArr = clone(arr);
+* const clonedArr = cloneDeep(arr);
 * arr[1].a = 2;
-* console.log(arr); // [2, { a: 2 }, [1, 2, 3]]
+* console.log(arr); // [1, { a: 2 }, [1, 2, 3]]
 * console.log(clonedArr); // [1, { a: 1 }, [1, 2, 3]]
 * console.log(clonedArr === arr); // false
 *
 * @example
 * // Clone an object
 * const obj = { a: 1, b: 'es-toolkit', c: [1, 2, 3] };
-* const clonedObj = clone(obj);
+* const clonedObj = cloneDeep(obj);
 * console.log(clonedObj); // { a: 1, b: 'es-toolkit', c: [1, 2, 3] }
 * console.log(clonedObj === obj); // false
 *
 * @example
 * // Clone an object with nested objects
 * const obj = { a: 1, b: { c: 1 } };
-* const clonedObj = clone(obj);
+* const clonedObj = cloneDeep(obj);
 * obj.b.c = 2;
 * console.log(obj); // { a: 1, b: { c: 2 } }
 * console.log(clonedObj); // { a: 1, b: { c: 1 } }

package/dist/compat/object/cloneDeepWith.js

@@ -32,7 +32,9 @@ const require_cloneDeepWith = require("../../object/cloneDeepWith.js");
 * // Clone an array with a customizer
 * const arr = [1, 2, 3];
 * const clonedArr = cloneDeepWith(arr, (value) => {
-*   return value + 1; // Increment each value
+*   if (typeof value === 'number') {
+*     return value + 1; // Increment each number
+*   }
 * });
 * console.log(clonedArr); // [2, 3, 4]
 * console.log(clonedArr === arr); // false

package/dist/compat/object/cloneDeepWith.mjs

@@ -32,7 +32,9 @@ import { cloneDeepWith as cloneDeepWith$1, copyProperties } from "../../object/c
 * // Clone an array with a customizer
 * const arr = [1, 2, 3];
 * const clonedArr = cloneDeepWith(arr, (value) => {
-*   return value + 1; // Increment each value
+*   if (typeof value === 'number') {
+*     return value + 1; // Increment each number
+*   }
 * });
 * console.log(clonedArr); // [2, 3, 4]
 * console.log(clonedArr === arr); // false

package/dist/compat/object/cloneWith.d.mts

@@ -35,7 +35,7 @@ declare function cloneWith<T, R extends object | string | number | boolean | nul
  *     return value * 2;
  *   }
  * });
- * // => { a: 2, b: 4 }
+ * // => { a: 1, b: 2 } (customizer returns undefined for objects, so the default shallow clone is used)
  */
 declare function cloneWith<T, R>(value: T, customizer: CloneWithCustomizer<T, R | undefined>): R | T;
 /**

package/dist/compat/object/cloneWith.d.ts

@@ -35,7 +35,7 @@ declare function cloneWith<T, R extends object | string | number | boolean | nul
  *     return value * 2;
  *   }
  * });
- * // => { a: 2, b: 4 }
+ * // => { a: 1, b: 2 } (customizer returns undefined for objects, so the default shallow clone is used)
  */
 declare function cloneWith<T, R>(value: T, customizer: CloneWithCustomizer<T, R | undefined>): R | T;
 /**

package/dist/compat/object/cloneWith.js

@@ -43,7 +43,7 @@ const require_clone = require("./clone.js");
 *   }
 *   // Returning undefined uses the default cloning
 * });
-* console.log(clonedObj); // { a: 2, b: 4 }
+* console.log(clonedObj); // { a: 1, b: 2 } (customizer returns undefined for objects, so the default shallow clone is used)
 */
 function cloneWith(value, customizer) {
 	if (!customizer) return require_clone.clone(value);

package/dist/compat/object/cloneWith.mjs

@@ -43,7 +43,7 @@ import { clone } from "./clone.mjs";
 *   }
 *   // Returning undefined uses the default cloning
 * });
-* console.log(clonedObj); // { a: 2, b: 4 }
+* console.log(clonedObj); // { a: 1, b: 2 } (customizer returns undefined for objects, so the default shallow clone is used)
 */
 function cloneWith(value, customizer) {
 	if (!customizer) return clone(value);

package/dist/compat/object/transform.js

@@ -23,7 +23,7 @@ The traversal is interrupted when the `iteratee` function returns `false`.
 * @example
 * // Transform an array
 * const array = [2, 3, 4];
-* transform(array, (acc, value) => { acc += value; return value % 2 === 0; }, 0) // => 5
+* transform(array, (acc, value) => { acc.sum += value; return value % 2 === 0; }, { sum: 0 }) // => { sum: 5 }
 *
 * @example
 * // Transform an object

package/dist/compat/object/transform.mjs

@@ -23,7 +23,7 @@ The traversal is interrupted when the `iteratee` function returns `false`.
 * @example
 * // Transform an array
 * const array = [2, 3, 4];
-* transform(array, (acc, value) => { acc += value; return value % 2 === 0; }, 0) // => 5
+* transform(array, (acc, value) => { acc.sum += value; return value % 2 === 0; }, { sum: 0 }) // => { sum: 5 }
 *
 * @example
 * // Transform an object

package/dist/compat/string/words.js

@@ -10,17 +10,21 @@ const rUnicodeOptContrUpper = "(?:['’](?:D|LL|M|RE|S|T|VE))?";
 const rUnicodeBreak = `[\\p{Z}\\p{P}${rNonCharLatin}]`;
 const rUnicodeMiscUpper = `(?:${rUnicodeUpper}|${rMisc})`;
 const rUnicodeMiscLower = `(?:${rUnicodeLower}|${rMisc})`;
-const rUnicodeWord = RegExp([
-	`${rUnicodeUpper}?${rUnicodeLower}+${rUnicodeOptContrLower}(?=${rUnicodeBreak}|${rUnicodeUpper}|$)`,
-	`${rUnicodeMiscUpper}+${rUnicodeOptContrUpper}(?=${rUnicodeBreak}|${rUnicodeUpper}${rUnicodeMiscLower}|$)`,
-	`${rUnicodeUpper}?${rUnicodeMiscLower}+${rUnicodeOptContrLower}`,
-	`${rUnicodeUpper}+${rUnicodeOptContrUpper}`,
-	`${rNumber}*(?:1ST|2ND|3RD|(?![123])${rNumber}TH)(?=\\b|[a-z_])`,
-	`${rNumber}*(?:1st|2nd|3rd|(?![123])${rNumber}th)(?=\\b|[A-Z_])`,
-	`${rNumber}+`,
-	"\\p{Emoji_Presentation}",
-	"\\p{Extended_Pictographic}"
-].join("|"), "gu");
+let rUnicodeWord;
+function getUnicodeWordPattern() {
+	if (rUnicodeWord == null) rUnicodeWord = RegExp([
+		`${rUnicodeUpper}?${rUnicodeLower}+${rUnicodeOptContrLower}(?=${rUnicodeBreak}|${rUnicodeUpper}|$)`,
+		`${rUnicodeMiscUpper}+${rUnicodeOptContrUpper}(?=${rUnicodeBreak}|${rUnicodeUpper}${rUnicodeMiscLower}|$)`,
+		`${rUnicodeUpper}?${rUnicodeMiscLower}+${rUnicodeOptContrLower}`,
+		`${rUnicodeUpper}+${rUnicodeOptContrUpper}`,
+		`${rNumber}*(?:1ST|2ND|3RD|(?![123])${rNumber}TH)(?=\\b|[a-z_])`,
+		`${rNumber}*(?:1st|2nd|3rd|(?![123])${rNumber}th)(?=\\b|[A-Z_])`,
+		`${rNumber}+`,
+		"\\p{Emoji_Presentation}",
+		"\\p{Extended_Pictographic}"
+	].join("|"), "gu");
+	return rUnicodeWord;
+}
 /**
 * Splits `string` into an array of its words.
 *
@@ -32,9 +36,9 @@ const rUnicodeWord = RegExp([
 * const wordsArray1 = words('fred, barney, & pebbles');
 * // => ['fred', 'barney', 'pebbles']
 */
-function words(str, pattern = rUnicodeWord, guard) {
+function words(str, pattern, guard) {
 	const input = require_toString.toString(str);
-	if (guard) pattern = rUnicodeWord;
+	if (guard || pattern === void 0) pattern = getUnicodeWordPattern();
 	if (typeof pattern === "number") pattern = pattern.toString();
 	return Array.from(input.match(pattern) ?? []).filter((x) => x !== "");
 }

package/dist/compat/string/words.mjs

@@ -10,17 +10,21 @@ const rUnicodeOptContrUpper = "(?:['’](?:D|LL|M|RE|S|T|VE))?";
 const rUnicodeBreak = `[\\p{Z}\\p{P}${rNonCharLatin}]`;
 const rUnicodeMiscUpper = `(?:${rUnicodeUpper}|${rMisc})`;
 const rUnicodeMiscLower = `(?:${rUnicodeLower}|${rMisc})`;
-const rUnicodeWord = RegExp([
-	`${rUnicodeUpper}?${rUnicodeLower}+${rUnicodeOptContrLower}(?=${rUnicodeBreak}|${rUnicodeUpper}|$)`,
-	`${rUnicodeMiscUpper}+${rUnicodeOptContrUpper}(?=${rUnicodeBreak}|${rUnicodeUpper}${rUnicodeMiscLower}|$)`,
-	`${rUnicodeUpper}?${rUnicodeMiscLower}+${rUnicodeOptContrLower}`,
-	`${rUnicodeUpper}+${rUnicodeOptContrUpper}`,
-	`${rNumber}*(?:1ST|2ND|3RD|(?![123])${rNumber}TH)(?=\\b|[a-z_])`,
-	`${rNumber}*(?:1st|2nd|3rd|(?![123])${rNumber}th)(?=\\b|[A-Z_])`,
-	`${rNumber}+`,
-	"\\p{Emoji_Presentation}",
-	"\\p{Extended_Pictographic}"
-].join("|"), "gu");
+let rUnicodeWord;
+function getUnicodeWordPattern() {
+	if (rUnicodeWord == null) rUnicodeWord = RegExp([
+		`${rUnicodeUpper}?${rUnicodeLower}+${rUnicodeOptContrLower}(?=${rUnicodeBreak}|${rUnicodeUpper}|$)`,
+		`${rUnicodeMiscUpper}+${rUnicodeOptContrUpper}(?=${rUnicodeBreak}|${rUnicodeUpper}${rUnicodeMiscLower}|$)`,
+		`${rUnicodeUpper}?${rUnicodeMiscLower}+${rUnicodeOptContrLower}`,
+		`${rUnicodeUpper}+${rUnicodeOptContrUpper}`,
+		`${rNumber}*(?:1ST|2ND|3RD|(?![123])${rNumber}TH)(?=\\b|[a-z_])`,
+		`${rNumber}*(?:1st|2nd|3rd|(?![123])${rNumber}th)(?=\\b|[A-Z_])`,
+		`${rNumber}+`,
+		"\\p{Emoji_Presentation}",
+		"\\p{Extended_Pictographic}"
+	].join("|"), "gu");
+	return rUnicodeWord;
+}
 /**
 * Splits `string` into an array of its words.
 *
@@ -32,9 +36,9 @@ const rUnicodeWord = RegExp([
 * const wordsArray1 = words('fred, barney, & pebbles');
 * // => ['fred', 'barney', 'pebbles']
 */
-function words(str, pattern = rUnicodeWord, guard) {
+function words(str, pattern, guard) {
 	const input = toString(str);
-	if (guard) pattern = rUnicodeWord;
+	if (guard || pattern === void 0) pattern = getUnicodeWordPattern();
 	if (typeof pattern === "number") pattern = pattern.toString();
 	return Array.from(input.match(pattern) ?? []).filter((x) => x !== "");
 }

package/dist/compat/util/toArray.d.mts

@@ -7,8 +7,8 @@
  * @returns Returns an array of the record's values or an empty array if null/undefined.
  *
  * @example
- * toArray({ 'a': 1, 'b': 2 }) // => returns [1, 2]
- * toArray(null) // => returns []
+ * toArray({ 'a': 1, 'b': 2 }) // => [1, 2]
+ * toArray(null) // => []
  */
 declare function toArray<T>(value: Record<string, T> | Record<number, T> | null | undefined): T[];
 /**
@@ -19,8 +19,8 @@ declare function toArray<T>(value: Record<string, T> | Record<number, T> | null
  * @returns Returns an array of the value's values.
  *
  * @example
- * toArray({ x: 10, y: 20 }) // => returns [10, 20]
- * toArray('abc') // => returns ['a', 'b', 'c']
+ * toArray({ x: 10, y: 20 }) // => [10, 20]
+ * toArray('abc') // => ['a', 'b', 'c']
  */
 declare function toArray<T>(value: T): Array<T[keyof T]>;
 /**
@@ -29,7 +29,7 @@ declare function toArray<T>(value: T): Array<T[keyof T]>;
  * @returns Returns an empty array.
  *
  * @example
- * toArray() // => returns []
+ * toArray() // => []
  */
 declare function toArray(): any[];
 //#endregion

package/dist/compat/util/toArray.d.ts

@@ -7,8 +7,8 @@
  * @returns Returns an array of the record's values or an empty array if null/undefined.
  *
  * @example
- * toArray({ 'a': 1, 'b': 2 }) // => returns [1, 2]
- * toArray(null) // => returns []
+ * toArray({ 'a': 1, 'b': 2 }) // => [1, 2]
+ * toArray(null) // => []
  */
 declare function toArray<T>(value: Record<string, T> | Record<number, T> | null | undefined): T[];
 /**
@@ -19,8 +19,8 @@ declare function toArray<T>(value: Record<string, T> | Record<number, T> | null
  * @returns Returns an array of the value's values.
  *
  * @example
- * toArray({ x: 10, y: 20 }) // => returns [10, 20]
- * toArray('abc') // => returns ['a', 'b', 'c']
+ * toArray({ x: 10, y: 20 }) // => [10, 20]
+ * toArray('abc') // => ['a', 'b', 'c']
  */
 declare function toArray<T>(value: T): Array<T[keyof T]>;
 /**
@@ -29,7 +29,7 @@ declare function toArray<T>(value: T): Array<T[keyof T]>;
  * @returns Returns an empty array.
  *
  * @example
- * toArray() // => returns []
+ * toArray() // => []
  */
 declare function toArray(): any[];
 //#endregion

package/dist/compat/util/toArray.js

@@ -10,10 +10,10 @@ const require_isSet = require("../predicate/isSet.js");
 * @returns Returns the converted array.
 *
 * @example
-* toArray({ 'a': 1, 'b': 2 }) // => returns [1,2]
-* toArray('abc') // => returns ['a', 'b', 'c']
-* toArray(1) // => returns []
-* toArray(null) // => returns []
+* toArray({ 'a': 1, 'b': 2 }) // => [1,2]
+* toArray('abc') // => ['a', 'b', 'c']
+* toArray(1) // => []
+* toArray(null) // => []
 */
 function toArray(value) {
 	if (value == null) return [];

package/dist/compat/util/toArray.mjs

@@ -10,10 +10,10 @@ import { isSet } from "../predicate/isSet.mjs";
 * @returns Returns the converted array.
 *
 * @example
-* toArray({ 'a': 1, 'b': 2 }) // => returns [1,2]
-* toArray('abc') // => returns ['a', 'b', 'c']
-* toArray(1) // => returns []
-* toArray(null) // => returns []
+* toArray({ 'a': 1, 'b': 2 }) // => [1,2]
+* toArray('abc') // => ['a', 'b', 'c']
+* toArray(1) // => []
+* toArray(null) // => []
 */
 function toArray(value) {
 	if (value == null) return [];

package/dist/function/memoize.d.mts

@@ -67,8 +67,9 @@
  * }
  * const customCache = new CustomCache<string, number>();
  * const memoizedSumWithCustomCache = memoize(sum, { cache: customCache });
- * console.log(memoizedSumWithCustomCache([1, 2])); // 3
- * console.log(memoizedSumWithCustomCache([1, 2])); // 3 (cached result)
+ * const arr = [1, 2];
+ * console.log(memoizedSumWithCustomCache(arr)); // 3
+ * console.log(memoizedSumWithCustomCache(arr)); // 3 (cached result)
  * console.log(memoizedSumWithCustomCache.cache.size); // 1
  */
 declare function memoize<F extends (...args: any) => any>(fn: F, options?: {

package/dist/function/memoize.d.ts

@@ -67,8 +67,9 @@
  * }
  * const customCache = new CustomCache<string, number>();
  * const memoizedSumWithCustomCache = memoize(sum, { cache: customCache });
- * console.log(memoizedSumWithCustomCache([1, 2])); // 3
- * console.log(memoizedSumWithCustomCache([1, 2])); // 3 (cached result)
+ * const arr = [1, 2];
+ * console.log(memoizedSumWithCustomCache(arr)); // 3
+ * console.log(memoizedSumWithCustomCache(arr)); // 3 (cached result)
  * console.log(memoizedSumWithCustomCache.cache.size); // 1
  */
 declare function memoize<F extends (...args: any) => any>(fn: F, options?: {

package/dist/function/memoize.js

@@ -67,8 +67,9 @@
 * }
 * const customCache = new CustomCache<string, number>();
 * const memoizedSumWithCustomCache = memoize(sum, { cache: customCache });
-* console.log(memoizedSumWithCustomCache([1, 2])); // 3
-* console.log(memoizedSumWithCustomCache([1, 2])); // 3 (cached result)
+* const arr = [1, 2];
+* console.log(memoizedSumWithCustomCache(arr)); // 3
+* console.log(memoizedSumWithCustomCache(arr)); // 3 (cached result)
 * console.log(memoizedSumWithCustomCache.cache.size); // 1
 */
 function memoize(fn, options = {}) {

package/dist/function/memoize.mjs

@@ -67,8 +67,9 @@
 * }
 * const customCache = new CustomCache<string, number>();
 * const memoizedSumWithCustomCache = memoize(sum, { cache: customCache });
-* console.log(memoizedSumWithCustomCache([1, 2])); // 3
-* console.log(memoizedSumWithCustomCache([1, 2])); // 3 (cached result)
+* const arr = [1, 2];
+* console.log(memoizedSumWithCustomCache(arr)); // 3
+* console.log(memoizedSumWithCustomCache(arr)); // 3 (cached result)
 * console.log(memoizedSumWithCustomCache.cache.size); // 1
 */
 function memoize(fn, options = {}) {

package/dist/function/partial.d.mts

@@ -330,7 +330,7 @@ declare function partial<T1, T2, T3, T4, R>(func: (arg1: T1, arg2: T2, arg3: T3,
  * @returns A new function that takes the first and third arguments and returns the result of the original function.
  *
  * @example
- * const multiply = (x: number, y: number, z: number, w: number) => x * y * z * w;
+ * const multiply = (x: number, y: number, z: number) => x * y * z;
  * const multiplyWithPlaceholder = partial(multiply, partial.placeholder, 2, 3);
  * console.log(multiplyWithPlaceholder(4)); // => 24
  */
@@ -540,7 +540,7 @@ declare function partial<TS extends any[], T1, R>(func: (arg1: T1, ...args: TS)
  *
  * @example
  * const greet = (greeting: string, name: string, punctuation: string) => `${greeting}, ${name}${punctuation}`;
- * const greetWithHello = partial(greet, 'Hello', '!');
+ * const greetWithHello = partial(greet, 'Hello', partial.placeholder, '!');
  * console.log(greetWithHello('John')); // => 'Hello, John!'
  */
 declare function partial<TS extends any[], T1, T2, R>(func: (arg1: T1, arg2: T2, ...args: TS) => R, t1: T1, arg2: T2): (...args: TS) => R;

package/dist/function/partial.d.ts

@@ -330,7 +330,7 @@ declare function partial<T1, T2, T3, T4, R>(func: (arg1: T1, arg2: T2, arg3: T3,
  * @returns A new function that takes the first and third arguments and returns the result of the original function.
  *
  * @example
- * const multiply = (x: number, y: number, z: number, w: number) => x * y * z * w;
+ * const multiply = (x: number, y: number, z: number) => x * y * z;
  * const multiplyWithPlaceholder = partial(multiply, partial.placeholder, 2, 3);
  * console.log(multiplyWithPlaceholder(4)); // => 24
  */
@@ -540,7 +540,7 @@ declare function partial<TS extends any[], T1, R>(func: (arg1: T1, ...args: TS)
  *
  * @example
  * const greet = (greeting: string, name: string, punctuation: string) => `${greeting}, ${name}${punctuation}`;
- * const greetWithHello = partial(greet, 'Hello', '!');
+ * const greetWithHello = partial(greet, 'Hello', partial.placeholder, '!');
  * console.log(greetWithHello('John')); // => 'Hello, John!'
  */
 declare function partial<TS extends any[], T1, T2, R>(func: (arg1: T1, arg2: T2, ...args: TS) => R, t1: T1, arg2: T2): (...args: TS) => R;

package/dist/function/partialRight.d.mts

@@ -203,7 +203,7 @@ declare function partialRight<T1, T2, T3, R>(func: (arg1: T1, arg2: T2, arg3: T3
  * @returns Returns the new partially applied function.
  * @example
  * const createUser = (name: string, age: number, country: string) => `${name}, ${age} years old from ${country}`;
- * const createUserFromUSA = partialRight(createUser, 'USA', partialRight.placeholder);
+ * const createUserFromUSA = partialRight(createUser, 'USA');
  * console.log(createUserFromUSA('John', 30)); // => 'John, 30 years old from USA'
  */
 declare function partialRight<T1, T2, T3, R>(func: (arg1: T1, arg2: T2, arg3: T3) => R, arg2: T2, arg3: Placeholder): (arg1: T1, arg3: T3) => R;
@@ -225,7 +225,7 @@ declare function partialRight<T1, T2, T3, R>(func: (arg1: T1, arg2: T2, arg3: T3
  * @returns Returns the new partially applied function.
  * @example
  * const logMessage = (level: string, message: string, timestamp: string) => `[${level}] ${message} at ${timestamp}`;
- * const logError = partialRight(logMessage, 'ERROR', '2023-10-01');
+ * const logError = partialRight(logMessage, 'ERROR', partialRight.placeholder, '2023-10-01');
  * console.log(logError('Something went wrong!')); // => '[ERROR] Something went wrong! at 2023-10-01'
  */
 declare function partialRight<T1, T2, T3, R>(func: (arg1: T1, arg2: T2, arg3: T3) => R, arg1: T1, arg2: T2, arg3: Placeholder): (arg3: T3) => R;
@@ -288,7 +288,7 @@ declare function partialRight<T1, T2, T3, R>(func: (arg1: T1, arg2: T2, arg3: T3
  * @returns Returns the new partially applied function.
  * @example
  * const createProfile = (name: string, age: number, country: string) => `${name}, ${age} from ${country}`;
- * const createProfileFromCanada = partialRight(createProfile, 'Canada', 'John');
+ * const createProfileFromCanada = partialRight(createProfile, 'John', partialRight.placeholder, 'Canada');
  * console.log(createProfileFromCanada(30)); // => 'John, 30 from Canada'
  */
 declare function partialRight<T1, T2, T3, R>(func: (arg1: T1, arg2: T2, arg3: T3) => R, arg2: T2, arg3: T3): (arg1: T1) => R;
@@ -615,9 +615,9 @@ declare function partialRight<T1, T2, T3, T4, R>(func: (arg1: T1, arg2: T2, arg3
  * @param args The arguments to be partially applied.
  * @returns Returns the new partially applied function.
  * @example
- * const log = (...messages: string[]) => console.log(...messages);
+ * const log = (...messages: string[]) => messages.join(' ');
  * const logError = partialRight(log, 'Error:');
- * logError('Something went wrong!'); // => 'Error: Something went wrong!'
+ * logError('Something went wrong!'); // => 'Something went wrong! Error:'
  */
 declare function partialRight(func: (...args: any[]) => any, ...args: any[]): (...args: any[]) => any;
 declare namespace partialRight {

package/dist/function/partialRight.d.ts

@@ -203,7 +203,7 @@ declare function partialRight<T1, T2, T3, R>(func: (arg1: T1, arg2: T2, arg3: T3
  * @returns Returns the new partially applied function.
  * @example
  * const createUser = (name: string, age: number, country: string) => `${name}, ${age} years old from ${country}`;
- * const createUserFromUSA = partialRight(createUser, 'USA', partialRight.placeholder);
+ * const createUserFromUSA = partialRight(createUser, 'USA');
  * console.log(createUserFromUSA('John', 30)); // => 'John, 30 years old from USA'
  */
 declare function partialRight<T1, T2, T3, R>(func: (arg1: T1, arg2: T2, arg3: T3) => R, arg2: T2, arg3: Placeholder): (arg1: T1, arg3: T3) => R;
@@ -225,7 +225,7 @@ declare function partialRight<T1, T2, T3, R>(func: (arg1: T1, arg2: T2, arg3: T3
  * @returns Returns the new partially applied function.
  * @example
  * const logMessage = (level: string, message: string, timestamp: string) => `[${level}] ${message} at ${timestamp}`;
- * const logError = partialRight(logMessage, 'ERROR', '2023-10-01');
+ * const logError = partialRight(logMessage, 'ERROR', partialRight.placeholder, '2023-10-01');
  * console.log(logError('Something went wrong!')); // => '[ERROR] Something went wrong! at 2023-10-01'
  */
 declare function partialRight<T1, T2, T3, R>(func: (arg1: T1, arg2: T2, arg3: T3) => R, arg1: T1, arg2: T2, arg3: Placeholder): (arg3: T3) => R;
@@ -288,7 +288,7 @@ declare function partialRight<T1, T2, T3, R>(func: (arg1: T1, arg2: T2, arg3: T3
  * @returns Returns the new partially applied function.
  * @example
  * const createProfile = (name: string, age: number, country: string) => `${name}, ${age} from ${country}`;
- * const createProfileFromCanada = partialRight(createProfile, 'Canada', 'John');
+ * const createProfileFromCanada = partialRight(createProfile, 'John', partialRight.placeholder, 'Canada');
  * console.log(createProfileFromCanada(30)); // => 'John, 30 from Canada'
  */
 declare function partialRight<T1, T2, T3, R>(func: (arg1: T1, arg2: T2, arg3: T3) => R, arg2: T2, arg3: T3): (arg1: T1) => R;
@@ -615,9 +615,9 @@ declare function partialRight<T1, T2, T3, T4, R>(func: (arg1: T1, arg2: T2, arg3
  * @param args The arguments to be partially applied.
  * @returns Returns the new partially applied function.
  * @example
- * const log = (...messages: string[]) => console.log(...messages);
+ * const log = (...messages: string[]) => messages.join(' ');
  * const logError = partialRight(log, 'Error:');
- * logError('Something went wrong!'); // => 'Error: Something went wrong!'
+ * logError('Something went wrong!'); // => 'Something went wrong! Error:'
  */
 declare function partialRight(func: (...args: any[]) => any, ...args: any[]): (...args: any[]) => any;
 declare namespace partialRight {

package/dist/function/rest.d.mts

@@ -24,7 +24,7 @@
  *
  * // Using start index 1
  * const transformedFnWithStart = rest(fn, 1);
- * console.log(transformedFnWithStart(1, 2, 3, 4)); // [1, [2, 3, 4]]
+ * console.log(transformedFnWithStart(1, 2, 3, 4)); // [1, [2, 3, 4], undefined]
  *
  * // With fewer arguments than the start index
  * console.log(transformedFn(1)); // [1, undefined, []]

package/dist/function/rest.d.ts

@@ -24,7 +24,7 @@
  *
  * // Using start index 1
  * const transformedFnWithStart = rest(fn, 1);
- * console.log(transformedFnWithStart(1, 2, 3, 4)); // [1, [2, 3, 4]]
+ * console.log(transformedFnWithStart(1, 2, 3, 4)); // [1, [2, 3, 4], undefined]
  *
  * // With fewer arguments than the start index
  * console.log(transformedFn(1)); // [1, undefined, []]