es-toolkit 1.49.0-dev.1912 → 1.49.0-dev.1914

package/dist/compat/array/filter.d.mts

@@ -9,7 +9,7 @@ import { ListIteratorTypeGuard } from "../_internal/ListIteratorTypeGuard.mjs";
  * Filters characters in a string based on the predicate function.
  *
  * @param collection - The string to filter
- * @param predicate - The function to test each character
+ * @param [predicate] - The function to test each character
  * @returns An array of characters that pass the predicate test
  *
  * @example
@@ -35,7 +35,7 @@ declare function filter<T, U extends T>(collection: ArrayLike<T> | null | undefi
  *
  * @template T
  * @param collection - The array-like object to filter
- * @param predicate - The function or shorthand to test each element
+ * @param [predicate] - The function or shorthand to test each element
  * @returns An array of elements that pass the predicate test
  *
  * @example
@@ -64,7 +64,7 @@ declare function filter<T extends object, U extends T[keyof T]>(collection: T |
  *
  * @template T
  * @param collection - The object to filter
- * @param predicate - The function or shorthand to test each value
+ * @param [predicate] - The function or shorthand to test each value
  * @returns An array of values that pass the predicate test
  *
  * @example

package/dist/compat/array/filter.d.ts

@@ -9,7 +9,7 @@ import { ListIteratorTypeGuard } from "../_internal/ListIteratorTypeGuard.js";
  * Filters characters in a string based on the predicate function.
  *
  * @param collection - The string to filter
- * @param predicate - The function to test each character
+ * @param [predicate] - The function to test each character
  * @returns An array of characters that pass the predicate test
  *
  * @example
@@ -35,7 +35,7 @@ declare function filter<T, U extends T>(collection: ArrayLike<T> | null | undefi
  *
  * @template T
  * @param collection - The array-like object to filter
- * @param predicate - The function or shorthand to test each element
+ * @param [predicate] - The function or shorthand to test each element
  * @returns An array of elements that pass the predicate test
  *
  * @example
@@ -64,7 +64,7 @@ declare function filter<T extends object, U extends T[keyof T]>(collection: T |
  *
  * @template T
  * @param collection - The object to filter
- * @param predicate - The function or shorthand to test each value
+ * @param [predicate] - The function or shorthand to test each value
  * @returns An array of values that pass the predicate test
  *
  * @example

package/dist/compat/array/filter.js

@@ -7,7 +7,7 @@ const require_iteratee = require("../util/iteratee.js");
 * If a function is provided, it is invoked for each element in the collection.
 *
 * @template T
-* @param source - The array or object to iterate over.
+* @param collection - The array or object to iterate over.
 * @param [predicate=identity] - The function invoked per iteration.
 * @returns Returns a new array of filtered elements that satisfy the predicate.
 *
@@ -24,25 +24,25 @@ const require_iteratee = require("../util/iteratee.js");
 * filter([{ a: 1 }, { a: 2 }, { a: 3 }], ['a', 2]);
 * // => [{ a: 2 }]
 */
-function filter(source, predicate = require_identity.identity) {
-	if (!source) return [];
+function filter(collection, predicate = require_identity.identity) {
+	if (!collection) return [];
 	predicate = require_iteratee.iteratee(predicate);
-	if (!Array.isArray(source)) {
+	if (!Array.isArray(collection)) {
 		const result = [];
-		const keys = Object.keys(source);
-		const length = require_isArrayLike.isArrayLike(source) ? source.length : keys.length;
+		const keys = Object.keys(collection);
+		const length = require_isArrayLike.isArrayLike(collection) ? collection.length : keys.length;
 		for (let i = 0; i < length; i++) {
 			const key = keys[i];
-			const value = source[key];
-			if (predicate(value, key, source)) result.push(value);
+			const value = collection[key];
+			if (predicate(value, key, collection)) result.push(value);
 		}
 		return result;
 	}
 	const result = [];
-	const length = source.length;
+	const length = collection.length;
 	for (let i = 0; i < length; i++) {
-		const value = source[i];
-		if (predicate(value, i, source)) result.push(value);
+		const value = collection[i];
+		if (predicate(value, i, collection)) result.push(value);
 	}
 	return result;
 }

package/dist/compat/array/filter.mjs

@@ -7,7 +7,7 @@ import { iteratee } from "../util/iteratee.mjs";
 * If a function is provided, it is invoked for each element in the collection.
 *
 * @template T
-* @param source - The array or object to iterate over.
+* @param collection - The array or object to iterate over.
 * @param [predicate=identity] - The function invoked per iteration.
 * @returns Returns a new array of filtered elements that satisfy the predicate.
 *
@@ -24,25 +24,25 @@ import { iteratee } from "../util/iteratee.mjs";
 * filter([{ a: 1 }, { a: 2 }, { a: 3 }], ['a', 2]);
 * // => [{ a: 2 }]
 */
-function filter(source, predicate = identity) {
-	if (!source) return [];
+function filter(collection, predicate = identity) {
+	if (!collection) return [];
 	predicate = iteratee(predicate);
-	if (!Array.isArray(source)) {
+	if (!Array.isArray(collection)) {
 		const result = [];
-		const keys = Object.keys(source);
-		const length = isArrayLike(source) ? source.length : keys.length;
+		const keys = Object.keys(collection);
+		const length = isArrayLike(collection) ? collection.length : keys.length;
 		for (let i = 0; i < length; i++) {
 			const key = keys[i];
-			const value = source[key];
-			if (predicate(value, key, source)) result.push(value);
+			const value = collection[key];
+			if (predicate(value, key, collection)) result.push(value);
 		}
 		return result;
 	}
 	const result = [];
-	const length = source.length;
+	const length = collection.length;
 	for (let i = 0; i < length; i++) {
-		const value = source[i];
-		if (predicate(value, i, source)) result.push(value);
+		const value = collection[i];
+		if (predicate(value, i, collection)) result.push(value);
 	}
 	return result;
 }

package/dist/compat/array/find.d.mts

@@ -10,7 +10,7 @@ import { ListIteratorTypeGuard } from "../_internal/ListIteratorTypeGuard.mjs";
  * @template T, U
  * @param collection - The array-like object to search
  * @param predicate - The type guard function to test each element
- * @param fromIndex - The index to start searching from
+ * @param [fromIndex] - The index to start searching from
  * @returns The first element that matches the type guard, or undefined if none found
  *
  * @example
@@ -23,8 +23,8 @@ declare function find<T, U extends T>(collection: ArrayLike<T> | null | undefine
  *
  * @template T
  * @param collection - The array-like object to search
- * @param predicate - The function or shorthand to test each element
- * @param fromIndex - The index to start searching from
+ * @param [predicate] - The function or shorthand to test each element
+ * @param [fromIndex] - The index to start searching from
  * @returns The first matching element, or undefined if none found
  *
  * @example
@@ -41,7 +41,7 @@ declare function find<T>(collection: ArrayLike<T> | null | undefined, predicate?
  * @template T, U
  * @param collection - The object to search
  * @param predicate - The type guard function to test each value
- * @param fromIndex - The index to start searching from
+ * @param [fromIndex] - The index to start searching from
  * @returns The first value that matches the type guard, or undefined if none found
  *
  * @example
@@ -54,8 +54,8 @@ declare function find<T extends object, U extends T[keyof T]>(collection: T | nu
  *
  * @template T
  * @param collection - The object to search
- * @param predicate - The function or shorthand to test each value
- * @param fromIndex - The index to start searching from
+ * @param [predicate] - The function or shorthand to test each value
+ * @param [fromIndex] - The index to start searching from
  * @returns The first matching value, or undefined if none found
  *
  * @example

package/dist/compat/array/find.d.ts

@@ -10,7 +10,7 @@ import { ListIteratorTypeGuard } from "../_internal/ListIteratorTypeGuard.js";
  * @template T, U
  * @param collection - The array-like object to search
  * @param predicate - The type guard function to test each element
- * @param fromIndex - The index to start searching from
+ * @param [fromIndex] - The index to start searching from
  * @returns The first element that matches the type guard, or undefined if none found
  *
  * @example
@@ -23,8 +23,8 @@ declare function find<T, U extends T>(collection: ArrayLike<T> | null | undefine
  *
  * @template T
  * @param collection - The array-like object to search
- * @param predicate - The function or shorthand to test each element
- * @param fromIndex - The index to start searching from
+ * @param [predicate] - The function or shorthand to test each element
+ * @param [fromIndex] - The index to start searching from
  * @returns The first matching element, or undefined if none found
  *
  * @example
@@ -41,7 +41,7 @@ declare function find<T>(collection: ArrayLike<T> | null | undefined, predicate?
  * @template T, U
  * @param collection - The object to search
  * @param predicate - The type guard function to test each value
- * @param fromIndex - The index to start searching from
+ * @param [fromIndex] - The index to start searching from
  * @returns The first value that matches the type guard, or undefined if none found
  *
  * @example
@@ -54,8 +54,8 @@ declare function find<T extends object, U extends T[keyof T]>(collection: T | nu
  *
  * @template T
  * @param collection - The object to search
- * @param predicate - The function or shorthand to test each value
- * @param fromIndex - The index to start searching from
+ * @param [predicate] - The function or shorthand to test each value
+ * @param [fromIndex] - The index to start searching from
  * @returns The first matching value, or undefined if none found
  *
  * @example

package/dist/compat/array/find.js

@@ -6,7 +6,7 @@ const require_iteratee = require("../util/iteratee.js");
 *
 * @template T
 * @param source - The source array or object to search through.
-* @param doesMatch - The criteria to match. It can be a function, a partial object, a key-value pair, or a property name.
+* @param [doesMatch=identity] - The criteria to match. It can be a function, a partial object, a key-value pair, or a property name.
 * @param [fromIndex=0] - The index to start the search from, defaults to 0.
 * @returns The first property value that has the specified property, or `undefined` if no match is found.
 *

package/dist/compat/array/find.mjs

@@ -6,7 +6,7 @@ import { iteratee } from "../util/iteratee.mjs";
 *
 * @template T
 * @param source - The source array or object to search through.
-* @param doesMatch - The criteria to match. It can be a function, a partial object, a key-value pair, or a property name.
+* @param [doesMatch=identity] - The criteria to match. It can be a function, a partial object, a key-value pair, or a property name.
 * @param [fromIndex=0] - The index to start the search from, defaults to 0.
 * @returns The first property value that has the specified property, or `undefined` if no match is found.
 *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "es-toolkit",
-  "version": "1.49.0-dev.1912+3552afed",
+  "version": "1.49.0-dev.1914+9bb1d03e",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
   "homepage": "https://es-toolkit.dev",
   "bugs": "https://github.com/toss/es-toolkit/issues",