es-toolkit 1.25.0 → 1.25.1-dev.796

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

@@ -2,7 +2,7 @@
  * Checks if all elements in an array are truthy.
  *
  * @template T
- * @param {T[]} arr - The array to check through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to check through.
  * @returns {boolean} - `true` if all elements are truthy, or `false` if at least one element is falsy.
  *
  * @example
@@ -14,12 +14,12 @@
  * const resultWithFalsy = every(itemsWithFalsy);
  * console.log(resultWithFalsy); // false
  */
-declare function every<T>(arr: readonly T[]): boolean;
+declare function every<T>(arr: ArrayLike<T> | null | undefined): boolean;
 /**
  * Checks if every item in an array matches the given predicate function.
  *
  * @template T
- * @param {T[]} arr - The array to check through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to check through.
  * @param {(item: T, index: number, arr: T[]) => unknown} doesMatch - A function that takes an item, its index, and the array, and returns a truthy value if the item matches the criteria.
  * @returns {boolean} - `true` if every item matches the predicate, or `false` if at least one item does not match.
  *
@@ -29,12 +29,12 @@ declare function every<T>(arr: readonly T[]): boolean;
  * const result = every(items, (item) => item > 0);
  * console.log(result); // true
  */
-declare function every<T>(arr: readonly T[], doesMatch: (item: T, index: number, arr: readonly T[]) => unknown): boolean;
+declare function every<T>(arr: ArrayLike<T> | null | undefined, doesMatch: (item: T, index: number, arr: readonly T[]) => unknown): boolean;
 /**
  * Checks if every item in an array matches the given partial object.
  *
  * @template T
- * @param {T[]} arr - The array to check through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to check through.
  * @param {Partial<T>} doesMatch - A partial object that specifies the properties to match.
  * @returns {boolean} - `true` if every item matches the partial object, or `false` if at least one item does not match.
  *
@@ -44,12 +44,12 @@ declare function every<T>(arr: readonly T[], doesMatch: (item: T, index: number,
  * const result = every(items, { name: 'Bob' });
  * console.log(result); // false
  */
-declare function every<T>(arr: readonly T[], doesMatch: Partial<T>): boolean;
+declare function every<T>(arr: ArrayLike<T> | null | undefined, doesMatch: Partial<T>): boolean;
 /**
  * Checks if every item in an array matches a property with a specific value.
  *
  * @template T
- * @param {T[]} arr - The array to check through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to check through.
  * @param {[keyof T, unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
  * @returns {boolean} - `true` if every item has the specified property value, or `false` if at least one item does not match.
  *
@@ -59,12 +59,12 @@ declare function every<T>(arr: readonly T[], doesMatch: Partial<T>): boolean;
  * const result = every(items, ['name', 'Alice']);
  * console.log(result); // false
  */
-declare function every<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknown]): boolean;
+declare function every<T>(arr: ArrayLike<T> | null | undefined, doesMatchProperty: [keyof T, unknown]): boolean;
 /**
  * Checks if every item in an array has a specific property, where the property name is provided as a string.
  *
  * @template T
- * @param {T[]} arr - The array to check through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to check through.
  * @param {string} propertyToCheck - The property name to check.
  * @returns {boolean} - `true` if every item has the specified property, or `false` if at least one item does not match.
  *
@@ -74,12 +74,12 @@ declare function every<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknow
  * const result = every(items, 'name');
  * console.log(result); // true
  */
-declare function every<T>(arr: readonly T[], propertyToCheck: string): boolean;
+declare function every<T>(arr: ArrayLike<T> | null | undefined, propertyToCheck: string): boolean;
 /**
  * Checks if every item in an object matches the given predicate function.
  *
  * @template T
- * @param {T} object - The object to check through.
+ * @param {T | null | undefined} object - The object to check through.
  * @param {(value: T[keyof T], key: keyof T, object: T) => unknown} doesMatch - A function that takes an value, its key, and the object, and returns a truthy value if the item matches the criteria.
  * @returns {boolean} - `true` if every property value matches the predicate, or `false` if at least one does not match.
  *
@@ -89,12 +89,12 @@ declare function every<T>(arr: readonly T[], propertyToCheck: string): boolean;
  * const result = every(obj, (value) => value > 0);
  * console.log(result); // true
  */
-declare function every<T extends Record<string, unknown>>(object: T, doesMatch: (value: T[keyof T], key: keyof T, object: T) => unknown): boolean;
+declare function every<T extends Record<string, unknown>>(object: T | null | undefined, doesMatch: (value: T[keyof T], key: keyof T, object: T) => unknown): boolean;
 /**
  * Checks if every item in an object matches the given partial value.
  *
  * @template T
- * @param {T} object - The object to check through.
+ * @param {T | null | undefined} object - The object to check through.
  * @param {Partial<T[keyof T]>} doesMatch - A partial value to match against the values of the object.
  * @returns {boolean} - `true` if every property value matches the partial value, or `false` if at least one does not match.
  *
@@ -104,12 +104,12 @@ declare function every<T extends Record<string, unknown>>(object: T, doesMatch:
  * const result = every(obj, { name: 'Bob' });
  * console.log(result); // false
  */
-declare function every<T extends Record<string, unknown>>(object: T, doesMatch: Partial<T[keyof T]>): boolean;
+declare function every<T extends Record<string, unknown>>(object: T | null | undefined, doesMatch: Partial<T[keyof T]>): boolean;
 /**
  * Checks if every item in an object matches a property with a specific value.
  *
  * @template T
- * @param {T[]} object - The object to check through.
+ * @param {T | null | undefined} object - The object to check through.
  * @param {[keyof T, unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
  * @returns {boolean} - `true` if every item has the specified property value, or `false` if at least one item does not match.
  *
@@ -119,12 +119,12 @@ declare function every<T extends Record<string, unknown>>(object: T, doesMatch:
  * const result = every(obj, ['name', 'Alice']);
  * console.log(result); // false
  */
-declare function every<T extends Record<string, unknown>>(object: T, doesMatchProperty: [keyof T, unknown]): boolean;
+declare function every<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T, unknown]): boolean;
 /**
  * Checks if every item in an object has a specific property, where the property name is provided as a string.
  *
  * @template T
- * @param {T} object - The object to check through.
+ * @param {T | null | undefined} object - The object to check through.
  * @param {string} propertyToCheck - The property name to check.
  * @returns {boolean} - `true` if every property value has the specified property, or `false` if at least one does not match.
  *
@@ -134,6 +134,6 @@ declare function every<T extends Record<string, unknown>>(object: T, doesMatchPr
  * const result = every(obj, 'name');
  * console.log(result); // true
  */
-declare function every<T extends Record<string, unknown>>(object: T, propertyToCheck: string): boolean;
+declare function every<T extends Record<string, unknown>>(object: T | null | undefined, propertyToCheck: string): boolean;
 
 export { every };

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

@@ -2,7 +2,7 @@
  * Checks if all elements in an array are truthy.
  *
  * @template T
- * @param {T[]} arr - The array to check through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to check through.
  * @returns {boolean} - `true` if all elements are truthy, or `false` if at least one element is falsy.
  *
  * @example
@@ -14,12 +14,12 @@
  * const resultWithFalsy = every(itemsWithFalsy);
  * console.log(resultWithFalsy); // false
  */
-declare function every<T>(arr: readonly T[]): boolean;
+declare function every<T>(arr: ArrayLike<T> | null | undefined): boolean;
 /**
  * Checks if every item in an array matches the given predicate function.
  *
  * @template T
- * @param {T[]} arr - The array to check through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to check through.
  * @param {(item: T, index: number, arr: T[]) => unknown} doesMatch - A function that takes an item, its index, and the array, and returns a truthy value if the item matches the criteria.
  * @returns {boolean} - `true` if every item matches the predicate, or `false` if at least one item does not match.
  *
@@ -29,12 +29,12 @@ declare function every<T>(arr: readonly T[]): boolean;
  * const result = every(items, (item) => item > 0);
  * console.log(result); // true
  */
-declare function every<T>(arr: readonly T[], doesMatch: (item: T, index: number, arr: readonly T[]) => unknown): boolean;
+declare function every<T>(arr: ArrayLike<T> | null | undefined, doesMatch: (item: T, index: number, arr: readonly T[]) => unknown): boolean;
 /**
  * Checks if every item in an array matches the given partial object.
  *
  * @template T
- * @param {T[]} arr - The array to check through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to check through.
  * @param {Partial<T>} doesMatch - A partial object that specifies the properties to match.
  * @returns {boolean} - `true` if every item matches the partial object, or `false` if at least one item does not match.
  *
@@ -44,12 +44,12 @@ declare function every<T>(arr: readonly T[], doesMatch: (item: T, index: number,
  * const result = every(items, { name: 'Bob' });
  * console.log(result); // false
  */
-declare function every<T>(arr: readonly T[], doesMatch: Partial<T>): boolean;
+declare function every<T>(arr: ArrayLike<T> | null | undefined, doesMatch: Partial<T>): boolean;
 /**
  * Checks if every item in an array matches a property with a specific value.
  *
  * @template T
- * @param {T[]} arr - The array to check through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to check through.
  * @param {[keyof T, unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
  * @returns {boolean} - `true` if every item has the specified property value, or `false` if at least one item does not match.
  *
@@ -59,12 +59,12 @@ declare function every<T>(arr: readonly T[], doesMatch: Partial<T>): boolean;
  * const result = every(items, ['name', 'Alice']);
  * console.log(result); // false
  */
-declare function every<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknown]): boolean;
+declare function every<T>(arr: ArrayLike<T> | null | undefined, doesMatchProperty: [keyof T, unknown]): boolean;
 /**
  * Checks if every item in an array has a specific property, where the property name is provided as a string.
  *
  * @template T
- * @param {T[]} arr - The array to check through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to check through.
  * @param {string} propertyToCheck - The property name to check.
  * @returns {boolean} - `true` if every item has the specified property, or `false` if at least one item does not match.
  *
@@ -74,12 +74,12 @@ declare function every<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknow
  * const result = every(items, 'name');
  * console.log(result); // true
  */
-declare function every<T>(arr: readonly T[], propertyToCheck: string): boolean;
+declare function every<T>(arr: ArrayLike<T> | null | undefined, propertyToCheck: string): boolean;
 /**
  * Checks if every item in an object matches the given predicate function.
  *
  * @template T
- * @param {T} object - The object to check through.
+ * @param {T | null | undefined} object - The object to check through.
  * @param {(value: T[keyof T], key: keyof T, object: T) => unknown} doesMatch - A function that takes an value, its key, and the object, and returns a truthy value if the item matches the criteria.
  * @returns {boolean} - `true` if every property value matches the predicate, or `false` if at least one does not match.
  *
@@ -89,12 +89,12 @@ declare function every<T>(arr: readonly T[], propertyToCheck: string): boolean;
  * const result = every(obj, (value) => value > 0);
  * console.log(result); // true
  */
-declare function every<T extends Record<string, unknown>>(object: T, doesMatch: (value: T[keyof T], key: keyof T, object: T) => unknown): boolean;
+declare function every<T extends Record<string, unknown>>(object: T | null | undefined, doesMatch: (value: T[keyof T], key: keyof T, object: T) => unknown): boolean;
 /**
  * Checks if every item in an object matches the given partial value.
  *
  * @template T
- * @param {T} object - The object to check through.
+ * @param {T | null | undefined} object - The object to check through.
  * @param {Partial<T[keyof T]>} doesMatch - A partial value to match against the values of the object.
  * @returns {boolean} - `true` if every property value matches the partial value, or `false` if at least one does not match.
  *
@@ -104,12 +104,12 @@ declare function every<T extends Record<string, unknown>>(object: T, doesMatch:
  * const result = every(obj, { name: 'Bob' });
  * console.log(result); // false
  */
-declare function every<T extends Record<string, unknown>>(object: T, doesMatch: Partial<T[keyof T]>): boolean;
+declare function every<T extends Record<string, unknown>>(object: T | null | undefined, doesMatch: Partial<T[keyof T]>): boolean;
 /**
  * Checks if every item in an object matches a property with a specific value.
  *
  * @template T
- * @param {T[]} object - The object to check through.
+ * @param {T | null | undefined} object - The object to check through.
  * @param {[keyof T, unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
  * @returns {boolean} - `true` if every item has the specified property value, or `false` if at least one item does not match.
  *
@@ -119,12 +119,12 @@ declare function every<T extends Record<string, unknown>>(object: T, doesMatch:
  * const result = every(obj, ['name', 'Alice']);
  * console.log(result); // false
  */
-declare function every<T extends Record<string, unknown>>(object: T, doesMatchProperty: [keyof T, unknown]): boolean;
+declare function every<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T, unknown]): boolean;
 /**
  * Checks if every item in an object has a specific property, where the property name is provided as a string.
  *
  * @template T
- * @param {T} object - The object to check through.
+ * @param {T | null | undefined} object - The object to check through.
  * @param {string} propertyToCheck - The property name to check.
  * @returns {boolean} - `true` if every property value has the specified property, or `false` if at least one does not match.
  *
@@ -134,6 +134,6 @@ declare function every<T extends Record<string, unknown>>(object: T, doesMatchPr
  * const result = every(obj, 'name');
  * console.log(result); // true
  */
-declare function every<T extends Record<string, unknown>>(object: T, propertyToCheck: string): boolean;
+declare function every<T extends Record<string, unknown>>(object: T | null | undefined, propertyToCheck: string): boolean;
 
 export { every };

package/dist/compat/array/every.mjs

@@ -5,12 +5,9 @@ import { matchesProperty } from '../predicate/matchesProperty.mjs';
 
 function every(source, doesMatch) {
     if (!source) {
-        source = [];
-    }
-    let values = source;
-    if (!Array.isArray(source)) {
-        values = Object.values(source);
+        return true;
     }
+    const values = Array.isArray(source) ? source : Object.values(source);
     if (!doesMatch) {
         doesMatch = identity;
     }

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

@@ -5,10 +5,37 @@
  * start index up to the end index (non-inclusive). If the start or end indices are not provided, it defaults to filling the
  * entire array.
  *
- * @template T, U, S, V
- * @param {Array<T | U>} array - The array to fill.
- * @param {U} value - The value to fill the array with.
- * @returns {Array<T | U>} The array with the filled values.
+ * @template T
+ * @param {unknown[] | null | undefined} array - The array to fill.
+ * @param {T} value - The value to fill the array with.
+ * @returns {T[]} The array with the filled values.
+ *
+ * @example
+ * const array = [1, 2, 3];
+ * const result = fill(array, 'a');
+ * // => ['a', 'a', 'a']
+ *
+ * const result = fill(Array(3), 2);
+ * // => [2, 2, 2]
+ *
+ * const result = fill([4, 6, 8, 10], '*', 1, 3);
+ * // => [4, '*', '*', 10]
+ *
+ * const result = fill(array, '*', -2, -1);
+ * // => [1, '*', 3]
+ */
+declare function fill<T>(array: unknown[] | null | undefined, value?: T): T[];
+/**
+ * Fills the whole array with a specified value.
+ *
+ * This function mutates the original array and replaces its elements with the provided value, starting from the specified
+ * start index up to the end index (non-inclusive). If the start or end indices are not provided, it defaults to filling the
+ * entire array.
+ *
+ * @template T
+ * @param {ArrayLike<unknown> | null | undefined} array - The array to fill.
+ * @param {T} value - The value to fill the array with.
+ * @returns {ArrayLike<T>} The array with the filled values.
  *
  * @example
  * const array = [1, 2, 3];
@@ -24,18 +51,19 @@
  * const result = fill(array, '*', -2, -1);
  * // => [1, '*', 3]
  */
-declare function fill<T>(array: unknown[], value?: T): T[];
+declare function fill<T>(array: ArrayLike<unknown> | null | undefined, value?: T): ArrayLike<T>;
 /**
- * Fills elements of an array with a specified value from the start position to the end.
+ * Fills elements of an array with a specified value from the start position up to, but not including, the end position.
  *
  * This function mutates the original array and replaces its elements with the provided value, starting from the specified
  * start index up to the end index (non-inclusive). If the start or end indices are not provided, it defaults to filling the
  * entire array.
  *
- * @template T, U, S, V
- * @param {Array<T | U>} array - The array to fill.
+ * @template T, U
+ * @param {Array<T | U> | null | undefined} array - The array to fill.
  * @param {U} value - The value to fill the array with.
- * @param {S} [start=0] - The start position. Defaults to 0.
+ * @param {number} [start=0] - The start position. Defaults to 0.
+ * @param {number} [end=arr.length] - The end position. Defaults to the array's length.
  * @returns {Array<T | U>} The array with the filled values.
  *
  * @example
@@ -52,7 +80,7 @@ declare function fill<T>(array: unknown[], value?: T): T[];
  * const result = fill(array, '*', -2, -1);
  * // => [1, '*', 3]
  */
-declare function fill<T, U, S>(array: Array<T | U>, value: U, start: S): Array<T | U>;
+declare function fill<T, U>(array: Array<T | U> | null | undefined, value: U, start?: number, end?: number): Array<T | U>;
 /**
  * Fills elements of an array with a specified value from the start position up to, but not including, the end position.
  *
@@ -60,12 +88,12 @@ declare function fill<T, U, S>(array: Array<T | U>, value: U, start: S): Array<T
  * start index up to the end index (non-inclusive). If the start or end indices are not provided, it defaults to filling the
  * entire array.
  *
- * @template T, U, S, V
- * @param {Array<T | U>} array - The array to fill.
+ * @template T, U
+ * @param {ArrayLike<T | U> | null | undefined} array - The array to fill.
  * @param {U} value - The value to fill the array with.
- * @param {S} [start=0] - The start position. Defaults to 0.
- * @param {V} [end=arr.length] - The end position. Defaults to the array's length.
- * @returns {Array<T | U>} The array with the filled values.
+ * @param {number} [start=0] - The start position. Defaults to 0.
+ * @param {number} [end=arr.length] - The end position. Defaults to the array's length.
+ * @returns {ArrayLike<T | U>} The array with the filled values.
  *
  * @example
  * const array = [1, 2, 3];
@@ -81,6 +109,6 @@ declare function fill<T, U, S>(array: Array<T | U>, value: U, start: S): Array<T
  * const result = fill(array, '*', -2, -1);
  * // => [1, '*', 3]
  */
-declare function fill<T, U, S, V>(array: Array<T | U>, value: U, start: S, end: V): Array<T | U>;
+declare function fill<T, U>(array: ArrayLike<T | U> | null | undefined, value: U, start?: number, end?: number): ArrayLike<T | U>;
 
 export { fill };

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

@@ -5,10 +5,37 @@
  * start index up to the end index (non-inclusive). If the start or end indices are not provided, it defaults to filling the
  * entire array.
  *
- * @template T, U, S, V
- * @param {Array<T | U>} array - The array to fill.
- * @param {U} value - The value to fill the array with.
- * @returns {Array<T | U>} The array with the filled values.
+ * @template T
+ * @param {unknown[] | null | undefined} array - The array to fill.
+ * @param {T} value - The value to fill the array with.
+ * @returns {T[]} The array with the filled values.
+ *
+ * @example
+ * const array = [1, 2, 3];
+ * const result = fill(array, 'a');
+ * // => ['a', 'a', 'a']
+ *
+ * const result = fill(Array(3), 2);
+ * // => [2, 2, 2]
+ *
+ * const result = fill([4, 6, 8, 10], '*', 1, 3);
+ * // => [4, '*', '*', 10]
+ *
+ * const result = fill(array, '*', -2, -1);
+ * // => [1, '*', 3]
+ */
+declare function fill<T>(array: unknown[] | null | undefined, value?: T): T[];
+/**
+ * Fills the whole array with a specified value.
+ *
+ * This function mutates the original array and replaces its elements with the provided value, starting from the specified
+ * start index up to the end index (non-inclusive). If the start or end indices are not provided, it defaults to filling the
+ * entire array.
+ *
+ * @template T
+ * @param {ArrayLike<unknown> | null | undefined} array - The array to fill.
+ * @param {T} value - The value to fill the array with.
+ * @returns {ArrayLike<T>} The array with the filled values.
  *
  * @example
  * const array = [1, 2, 3];
@@ -24,18 +51,19 @@
  * const result = fill(array, '*', -2, -1);
  * // => [1, '*', 3]
  */
-declare function fill<T>(array: unknown[], value?: T): T[];
+declare function fill<T>(array: ArrayLike<unknown> | null | undefined, value?: T): ArrayLike<T>;
 /**
- * Fills elements of an array with a specified value from the start position to the end.
+ * Fills elements of an array with a specified value from the start position up to, but not including, the end position.
  *
  * This function mutates the original array and replaces its elements with the provided value, starting from the specified
  * start index up to the end index (non-inclusive). If the start or end indices are not provided, it defaults to filling the
  * entire array.
  *
- * @template T, U, S, V
- * @param {Array<T | U>} array - The array to fill.
+ * @template T, U
+ * @param {Array<T | U> | null | undefined} array - The array to fill.
  * @param {U} value - The value to fill the array with.
- * @param {S} [start=0] - The start position. Defaults to 0.
+ * @param {number} [start=0] - The start position. Defaults to 0.
+ * @param {number} [end=arr.length] - The end position. Defaults to the array's length.
  * @returns {Array<T | U>} The array with the filled values.
  *
  * @example
@@ -52,7 +80,7 @@ declare function fill<T>(array: unknown[], value?: T): T[];
  * const result = fill(array, '*', -2, -1);
  * // => [1, '*', 3]
  */
-declare function fill<T, U, S>(array: Array<T | U>, value: U, start: S): Array<T | U>;
+declare function fill<T, U>(array: Array<T | U> | null | undefined, value: U, start?: number, end?: number): Array<T | U>;
 /**
  * Fills elements of an array with a specified value from the start position up to, but not including, the end position.
  *
@@ -60,12 +88,12 @@ declare function fill<T, U, S>(array: Array<T | U>, value: U, start: S): Array<T
  * start index up to the end index (non-inclusive). If the start or end indices are not provided, it defaults to filling the
  * entire array.
  *
- * @template T, U, S, V
- * @param {Array<T | U>} array - The array to fill.
+ * @template T, U
+ * @param {ArrayLike<T | U> | null | undefined} array - The array to fill.
  * @param {U} value - The value to fill the array with.
- * @param {S} [start=0] - The start position. Defaults to 0.
- * @param {V} [end=arr.length] - The end position. Defaults to the array's length.
- * @returns {Array<T | U>} The array with the filled values.
+ * @param {number} [start=0] - The start position. Defaults to 0.
+ * @param {number} [end=arr.length] - The end position. Defaults to the array's length.
+ * @returns {ArrayLike<T | U>} The array with the filled values.
  *
  * @example
  * const array = [1, 2, 3];
@@ -81,6 +109,6 @@ declare function fill<T, U, S>(array: Array<T | U>, value: U, start: S): Array<T
  * const result = fill(array, '*', -2, -1);
  * // => [1, '*', 3]
  */
-declare function fill<T, U, S, V>(array: Array<T | U>, value: U, start: S, end: V): Array<T | U>;
+declare function fill<T, U>(array: ArrayLike<T | U> | null | undefined, value: U, start?: number, end?: number): ArrayLike<T | U>;
 
 export { fill };

package/dist/compat/array/fill.mjs

@@ -1,6 +1,14 @@
 import { fill as fill$1 } from '../../array/fill.mjs';
+import { isArrayLike } from '../predicate/isArrayLike.mjs';
+import { isString } from '../predicate/isString.mjs';
 
-function fill(array, value, start = 0, end = array.length) {
+function fill(array, value, start = 0, end = array ? array.length : 0) {
+    if (!isArrayLike(array)) {
+        return [];
+    }
+    if (isString(array)) {
+        return array;
+    }
     start = Math.floor(start);
     end = Math.floor(end);
     if (!start) {

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

@@ -2,7 +2,7 @@
  * Filters items from a array and returns an array of elements.
  *
  * @template T
- * @param {T[]} arr - The array to iterate over.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to iterate over.
  * @param {(item: T, index: number, arr: T[]) => unknown} doesMatch - The function invoked per iteration.
  * @returns {T[]} - Returns a new array of elements that satisfy the given doesMatch function.
  *
@@ -10,12 +10,12 @@
  * filter([1, 2, 3], n => n % 2 === 0)
  * // => [2]
  */
-declare function filter<T>(arr: readonly T[], doesMatch?: (item: T, index: number, arr: readonly T[]) => unknown): T[];
+declare function filter<T>(arr: ArrayLike<T> | null | undefined, doesMatch?: (item: T, index: number, arr: readonly T[]) => unknown): T[];
 /**
  * Filters elements in a arr that match the properties of the given partial object.
  *
  * @template T
- * @param {T[]} arr - The array to iterate over.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to iterate over.
  * @param {Partial<T>} doesMatch - A partial object that specifies the properties to match.
  * @returns {T[]} - Returns a new array of elements that match the given properties.
  *
@@ -24,12 +24,12 @@ declare function filter<T>(arr: readonly T[], doesMatch?: (item: T, index: numbe
  * filter(arr, { name: 'Bob' });
  * // => [{ id: 2, name: 'Bob' }]
  */
-declare function filter<T>(arr: readonly T[], doesMatch: Partial<T>): T[];
+declare function filter<T>(arr: ArrayLike<T> | null | undefined, doesMatch: Partial<T>): T[];
 /**
  * Filters elements in a arr that match the given key-value pair.
  *
  * @template T
- * @param {T[]} arr - The array to iterate over.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to iterate over.
  * @param {[keyof T, unknown]} doesMatchProperty - The key-value pair to match.
  * @returns {T[]} - Returns a new array of elements that match the given key-value pair.
  *
@@ -38,12 +38,12 @@ declare function filter<T>(arr: readonly T[], doesMatch: Partial<T>): T[];
  * filter(arr, ['name', 'Alice']);
  * // => [{ id: 1, name: 'Alice' }]
  */
-declare function filter<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknown]): T[];
+declare function filter<T>(arr: ArrayLike<T> | null | undefined, doesMatchProperty: [keyof T, unknown]): T[];
 /**
  * Filters the arr, returning elements that contain the given property name.
  *
  * @template T
- * @param {T[]} arr - The array to iterate over.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to iterate over.
  * @param {string} propertyToCheck - The property name to check.
  * @returns {T[]} - Returns a new array of elements that match the given property name.
  *
@@ -52,7 +52,7 @@ declare function filter<T>(arr: readonly T[], doesMatchProperty: [keyof T, unkno
  * filter(arr, 'name');
  * // => [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }]
  */
-declare function filter<T>(arr: readonly T[], propertyToCheck: string): T[];
+declare function filter<T>(arr: ArrayLike<T> | null | undefined, propertyToCheck: string): T[];
 /**
  * Filters items from a object and returns an array of elements that match the given predicate function.
  *
@@ -70,12 +70,12 @@ declare function filter<T>(arr: readonly T[], propertyToCheck: string): T[];
  * filter(obj, value => value > 2)
  * // => [3]
  */
-declare function filter<T extends Record<string, unknown>>(object: T, doesMatch: (value: T[keyof T], key: keyof T, object: T) => unknown): T[];
+declare function filter<T extends Record<string, unknown>>(object: T | null | undefined, doesMatch: (value: T[keyof T], key: keyof T, object: T) => unknown): T[];
 /**
  * Filters elements in a object that match the properties of the given partial object.
  *
  * @template T
- * @param {T} object - The object to iterate over.
+ * @param {T | null | undefined} object - The object to iterate over.
  * @param {Partial<T[keyof T]>} doesMatch - The partial object to match
  * @returns {T[]} - Returns a new array of elements that match the given properties.pair.
  *
@@ -84,12 +84,12 @@ declare function filter<T extends Record<string, unknown>>(object: T, doesMatch:
  * filter(obj, { name: 'Bob' });
  * // => [{ id: 2, name: 'Bob' }]
  */
-declare function filter<T extends Record<string, unknown>>(object: T, doesMatch: Partial<T[keyof T]>): T[];
+declare function filter<T extends Record<string, unknown>>(object: T | null | undefined, doesMatch: Partial<T[keyof T]>): T[];
 /**
  * Filters elements in a arr that match the given key-value pair.
  *
  * @template T
- * @param {T} object - The object to iterate over.
+ * @param {T | null | undefined} object - The object to iterate over.
  * @param {[keyof T, unknown]} doesMatchProperty - The key-value pair to match.
  * @returns {T[]} - Returns a new array of elements that match the given key-value pair.
  *
@@ -98,12 +98,12 @@ declare function filter<T extends Record<string, unknown>>(object: T, doesMatch:
  * filter(obj, ['name', 'Alice']);
  * // => [{ id: 1, name: 'Alice' }]
  */
-declare function filter<T extends Record<string, unknown>>(object: T, doesMatchProperty: [keyof T, unknown]): T[];
+declare function filter<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T, unknown]): T[];
 /**
  * Filters the object, returning elements that contain the given property name.
  *
  * @template T
- * @param {T} object - The object to iterate over.
+ * @param {T | null | undefined} object - The object to iterate over.
  * @param {string} propertyToCheck - The property name to check.
  * @returns {T[]} - Returns a new array of elements that match the given property name.
  *
@@ -112,6 +112,6 @@ declare function filter<T extends Record<string, unknown>>(object: T, doesMatchP
  * filter(obj, 'name');
  * // => [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }]
  */
-declare function filter<T extends Record<string, unknown>>(object: T, propertyToCheck: string): T[];
+declare function filter<T extends Record<string, unknown>>(object: T | null | undefined, propertyToCheck: string): T[];
 
 export { filter };