es-toolkit 1.12.0-dev.271 → 1.12.0-dev.273

package/dist/array/index.mjs

@@ -1,4 +1,10 @@
 import "../chunk-DDH7K4QM.mjs";
+import {
+  zipWith
+} from "../chunk-4KYXHZ4R.mjs";
+import {
+  unzip
+} from "../chunk-UYZKMBDO.mjs";
 import {
   unzipWith
 } from "../chunk-IFNXROZR.mjs";
@@ -21,8 +27,8 @@ import {
   zipObject
 } from "../chunk-6GWEY5EL.mjs";
 import {
-  zipWith
-} from "../chunk-4KYXHZ4R.mjs";
+  takeWhile
+} from "../chunk-2IXFGSUA.mjs";
 import {
   toFilled
 } from "../chunk-OP4OAKQJ.mjs";
@@ -45,8 +51,8 @@ import {
   uniqWith
 } from "../chunk-237HGSZS.mjs";
 import {
-  unzip
-} from "../chunk-UYZKMBDO.mjs";
+  partition
+} from "../chunk-DN3NOZ3H.mjs";
 import {
   sample
 } from "../chunk-2KNLZB7V.mjs";
@@ -71,8 +77,8 @@ import {
   takeRightWhile
 } from "../chunk-NTLX2MPV.mjs";
 import {
-  takeWhile
-} from "../chunk-2IXFGSUA.mjs";
+  intersection
+} from "../chunk-FVVSE2F2.mjs";
 import {
   intersectionBy
 } from "../chunk-O6UXZR3U.mjs";
@@ -95,11 +101,14 @@ import {
   orderBy
 } from "../chunk-7B7W36UP.mjs";
 import {
-  partition
-} from "../chunk-DN3NOZ3H.mjs";
+  flatMap
+} from "../chunk-UY76KTPE.mjs";
 import {
   flattenDeep
 } from "../chunk-ML727RRJ.mjs";
+import {
+  flatten
+} from "../chunk-33MSBDC6.mjs";
 import {
   forEachRight
 } from "../chunk-IEA53J7P.mjs";
@@ -113,8 +122,8 @@ import {
   initial
 } from "../chunk-XPSOKBRZ.mjs";
 import {
-  intersection
-} from "../chunk-FVVSE2F2.mjs";
+  difference
+} from "../chunk-JPUKH67K.mjs";
 import {
   differenceBy
 } from "../chunk-LVWX5B43.mjs";
@@ -136,12 +145,6 @@ import {
 import {
   fill
 } from "../chunk-YFN6KOC4.mjs";
-import {
-  flatMap
-} from "../chunk-UY76KTPE.mjs";
-import {
-  flatten
-} from "../chunk-33MSBDC6.mjs";
 import {
   chunk
 } from "../chunk-E6C5EZQA.mjs";
@@ -151,9 +154,6 @@ import {
 import {
   countBy
 } from "../chunk-CRSKT4WW.mjs";
-import {
-  difference
-} from "../chunk-JPUKH67K.mjs";
 import "../chunk-424M7IR7.mjs";
 export {
   chunk,

package/dist/compat/index.d.mts

@@ -109,6 +109,35 @@ export { capitalize } from '../string/capitalize.mjs';
  */
 declare function chunk<T>(arr: readonly T[], size?: number): T[][];
 
+/**
+ * Concatenates multiple arrays and values into a single array.
+ *
+ * @template T The type of elements in the array.
+ * @param {...(T | readonly T[])} values - The values and/or arrays to concatenate.
+ * @returns {T[]} A new array containing all the input values.
+ *
+ * @example
+ * // Concatenate individual values
+ * concat(1, 2, 3);
+ * // returns [1, 2, 3]
+ *
+ * @example
+ * // Concatenate arrays of values
+ * concat([1, 2], [3, 4]);
+ * // returns [1, 2, 3, 4]
+ *
+ * @example
+ * // Concatenate a mix of individual values and arrays
+ * concat(1, [2, 3], 4);
+ * // returns [1, 2, 3, 4]
+ *
+ * @example
+ * // Concatenate nested arrays
+ * concat([1, [2, 3]], 4);
+ * // returns [1, [2, 3], 4]
+ */
+declare function concat<T>(...values: Array<T | readonly T[]>): T[];
+
 declare function difference<T>(arr: readonly T[], ...values: Array<readonly T[]>): T[];
 
 /**
@@ -498,4 +527,4 @@ declare function max<T>(items?: readonly T[]): T;
  */
 declare function min<T>(items?: readonly T[]): T;
 
-export { chunk, difference, endsWith, get, max, min, set, startsWith, zipObjectDeep };
+export { chunk, concat, difference, endsWith, get, max, min, set, startsWith, zipObjectDeep };

package/dist/compat/index.d.ts

@@ -109,6 +109,35 @@ export { capitalize } from '../string/capitalize.js';
  */
 declare function chunk<T>(arr: readonly T[], size?: number): T[][];
 
+/**
+ * Concatenates multiple arrays and values into a single array.
+ *
+ * @template T The type of elements in the array.
+ * @param {...(T | readonly T[])} values - The values and/or arrays to concatenate.
+ * @returns {T[]} A new array containing all the input values.
+ *
+ * @example
+ * // Concatenate individual values
+ * concat(1, 2, 3);
+ * // returns [1, 2, 3]
+ *
+ * @example
+ * // Concatenate arrays of values
+ * concat([1, 2], [3, 4]);
+ * // returns [1, 2, 3, 4]
+ *
+ * @example
+ * // Concatenate a mix of individual values and arrays
+ * concat(1, [2, 3], 4);
+ * // returns [1, 2, 3, 4]
+ *
+ * @example
+ * // Concatenate nested arrays
+ * concat([1, [2, 3]], 4);
+ * // returns [1, [2, 3], 4]
+ */
+declare function concat<T>(...values: Array<T | readonly T[]>): T[];
+
 declare function difference<T>(arr: readonly T[], ...values: Array<readonly T[]>): T[];
 
 /**
@@ -498,4 +527,4 @@ declare function max<T>(items?: readonly T[]): T;
  */
 declare function min<T>(items?: readonly T[]): T;
 
-export { chunk, difference, endsWith, get, max, min, set, startsWith, zipObjectDeep };
+export { chunk, concat, difference, endsWith, get, max, min, set, startsWith, zipObjectDeep };

package/dist/compat/index.js

@@ -62,6 +62,7 @@ __export(compat_exports, {
   clamp: () => clamp,
   clone: () => clone,
   compact: () => compact,
+  concat: () => concat,
   countBy: () => countBy,
   debounce: () => debounce,
   delay: () => delay,
@@ -1076,6 +1077,11 @@ function chunk2(arr, size = 1) {
   return chunk(arr, size);
 }
 
+// src/compat/array/concat.ts
+function concat(...values) {
+  return flatten(values);
+}
+
 // src/compat/array/difference.ts
 function difference2(arr, ...values) {
   const arr1 = arr;
@@ -1249,6 +1255,7 @@ function min(items = []) {
   clamp,
   clone,
   compact,
+  concat,
   countBy,
   debounce,
   delay,