es-toolkit 1.13.1-dev.358 → 1.13.1-dev.359

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

@@ -0,0 +1,19 @@
+/**
+ * Flattens an array up to the specified depth.
+ *
+ * @template T - The type of elements within the array.
+ * @template D - The depth to which the array should be flattened.
+ * @param {T[] | object} value - The object to flatten.
+ * @param {D} depth - The depth level specifying how deep a nested array structure should be flattened. Defaults to 1.
+ * @returns {Array<FlatArray<T[], D>> | []} A new array that has been flattened.
+ *
+ * @example
+ * const arr = flatten([1, [2, 3], [4, [5, 6]]], 1);
+ * // Returns: [1, 2, 3, 4, [5, 6]]
+ *
+ * const arr = flatten([1, [2, 3], [4, [5, 6]]], 2);
+ * // Returns: [1, 2, 3, 4, 5, 6]
+ */
+declare function flatten<T, D extends number = 1>(value: T[] | object, depth?: D): Array<FlatArray<T[], D>> | [];
+
+export { flatten };

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

@@ -0,0 +1,19 @@
+/**
+ * Flattens an array up to the specified depth.
+ *
+ * @template T - The type of elements within the array.
+ * @template D - The depth to which the array should be flattened.
+ * @param {T[] | object} value - The object to flatten.
+ * @param {D} depth - The depth level specifying how deep a nested array structure should be flattened. Defaults to 1.
+ * @returns {Array<FlatArray<T[], D>> | []} A new array that has been flattened.
+ *
+ * @example
+ * const arr = flatten([1, [2, 3], [4, [5, 6]]], 1);
+ * // Returns: [1, 2, 3, 4, [5, 6]]
+ *
+ * const arr = flatten([1, [2, 3], [4, [5, 6]]], 2);
+ * // Returns: [1, 2, 3, 4, 5, 6]
+ */
+declare function flatten<T, D extends number = 1>(value: T[] | object, depth?: D): Array<FlatArray<T[], D>> | [];
+
+export { flatten };

package/dist/compat/array/flatten.mjs

@@ -0,0 +1,29 @@
+function flatten(value, depth = 1) {
+    const result = [];
+    const flooredDepth = Math.floor(depth);
+    if (!Array.isArray(value)) {
+        return result;
+    }
+    const recursive = (arr, currentDepth) => {
+        for (const item of arr) {
+            if (currentDepth < flooredDepth &&
+                (Array.isArray(item) ||
+                    Boolean(item?.[Symbol.isConcatSpreadable]) ||
+                    (item !== null && typeof item === 'object' && Object.prototype.toString.call(item) === '[object Arguments]'))) {
+                if (Array.isArray(item)) {
+                    recursive(item, currentDepth + 1);
+                }
+                else {
+                    recursive(Array.from(item), currentDepth + 1);
+                }
+            }
+            else {
+                result.push(item);
+            }
+        }
+    };
+    recursive(value, 0);
+    return result;
+}
+
+export { flatten };

package/dist/compat/index.d.mts

@@ -7,7 +7,6 @@ export { dropRight } from '../array/dropRight.mjs';
 export { dropRightWhile } from '../array/dropRightWhile.mjs';
 export { dropWhile } from '../array/dropWhile.mjs';
 export { flatMap } from '../array/flatMap.mjs';
-export { flatten } from '../array/flatten.mjs';
 export { flattenDeep } from '../array/flattenDeep.mjs';
 export { forEachRight } from '../array/forEachRight.mjs';
 export { groupBy } from '../array/groupBy.mjs';
@@ -97,6 +96,7 @@ export { chunk } from './array/chunk.mjs';
 export { concat } from './array/concat.mjs';
 export { difference } from './array/difference.mjs';
 export { fill } from './array/fill.mjs';
+export { flatten } from './array/flatten.mjs';
 export { zipObjectDeep } from './array/zipObjectDeep.mjs';
 export { get } from './object/get.mjs';
 export { set } from './object/set.mjs';

package/dist/compat/index.d.ts

@@ -7,7 +7,6 @@ export { dropRight } from '../array/dropRight.js';
 export { dropRightWhile } from '../array/dropRightWhile.js';
 export { dropWhile } from '../array/dropWhile.js';
 export { flatMap } from '../array/flatMap.js';
-export { flatten } from '../array/flatten.js';
 export { flattenDeep } from '../array/flattenDeep.js';
 export { forEachRight } from '../array/forEachRight.js';
 export { groupBy } from '../array/groupBy.js';
@@ -97,6 +96,7 @@ export { chunk } from './array/chunk.js';
 export { concat } from './array/concat.js';
 export { difference } from './array/difference.js';
 export { fill } from './array/fill.js';
+export { flatten } from './array/flatten.js';
 export { zipObjectDeep } from './array/zipObjectDeep.js';
 export { get } from './object/get.js';
 export { set } from './object/set.js';

package/dist/compat/index.js

@@ -43,6 +43,34 @@ function fill(array, value, start = 0, end = array.length) {
     return array_index.fill(array, value, start, end);
 }
 
+function flatten(value, depth = 1) {
+    const result = [];
+    const flooredDepth = Math.floor(depth);
+    if (!Array.isArray(value)) {
+        return result;
+    }
+    const recursive = (arr, currentDepth) => {
+        for (const item of arr) {
+            if (currentDepth < flooredDepth &&
+                (Array.isArray(item) ||
+                    Boolean(item?.[Symbol.isConcatSpreadable]) ||
+                    (item !== null && typeof item === 'object' && Object.prototype.toString.call(item) === '[object Arguments]'))) {
+                if (Array.isArray(item)) {
+                    recursive(item, currentDepth + 1);
+                }
+                else {
+                    recursive(Array.from(item), currentDepth + 1);
+                }
+            }
+            else {
+                result.push(item);
+            }
+        }
+    };
+    recursive(value, 0);
+    return result;
+}
+
 const IS_UNSIGNED_INTEGER = /^(?:0|[1-9]\d*)$/;
 function isIndex(value) {
     switch (typeof value) {
@@ -380,7 +408,6 @@ exports.dropRightWhile = array_index.dropRightWhile;
 exports.dropWhile = array_index.dropWhile;
 exports.first = array_index.head;
 exports.flatMap = array_index.flatMap;
-exports.flatten = array_index.flatten;
 exports.flattenDeep = array_index.flattenDeep;
 exports.forEachRight = array_index.forEachRight;
 exports.groupBy = array_index.groupBy;
@@ -471,6 +498,7 @@ exports.concat = concat;
 exports.difference = difference;
 exports.endsWith = endsWith;
 exports.fill = fill;
+exports.flatten = flatten;
 exports.get = get;
 exports.isArray = isArray;
 exports.isMatch = isMatch;

package/dist/compat/index.mjs

@@ -7,7 +7,6 @@ export { dropRight } from '../array/dropRight.mjs';
 export { dropRightWhile } from '../array/dropRightWhile.mjs';
 export { dropWhile } from '../array/dropWhile.mjs';
 export { flatMap } from '../array/flatMap.mjs';
-export { flatten } from '../array/flatten.mjs';
 export { flattenDeep } from '../array/flattenDeep.mjs';
 export { forEachRight } from '../array/forEachRight.mjs';
 export { groupBy } from '../array/groupBy.mjs';
@@ -97,6 +96,7 @@ export { chunk } from './array/chunk.mjs';
 export { concat } from './array/concat.mjs';
 export { difference } from './array/difference.mjs';
 export { fill } from './array/fill.mjs';
+export { flatten } from './array/flatten.mjs';
 export { zipObjectDeep } from './array/zipObjectDeep.mjs';
 export { get } from './object/get.mjs';
 export { set } from './object/set.mjs';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "es-toolkit",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
-  "version": "1.13.1-dev.358+25217a57",
+  "version": "1.13.1-dev.359+2d1c4063",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {