es-toolkit 1.26.1-dev.864 → 1.26.1-dev.865

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

@@ -0,0 +1,30 @@
+/**
+ * This function takes multiple arrays and returns a new array containing only the unique values
+ * from all input arrays, preserving the order of their first occurrence.
+ *
+ * @template T - The type of elements in the arrays.
+ * @param {Array<ArrayLike<T> | null | undefined>} arrays - The arrays to inspect.
+ * @returns {T[]} Returns the new array of combined unique values.
+ *
+ * @example
+ * // Returns [2, 1]
+ * union([2], [1, 2]);
+ *
+ * @example
+ * // Returns [2, 1, 3]
+ * union([2], [1, 2], [2, 3]);
+ *
+ * @example
+ * // Returns [1, 3, 2, [5], [4]] (does not deeply flatten nested arrays)
+ * union([1, 3, 2], [1, [5]], [2, [4]]);
+ *
+ * @example
+ * // Returns [0, 2, 1] (ignores non-array values like 3 and { '0': 1 })
+ * union([0], 3, { '0': 1 }, null, [2, 1]);
+ * @example
+ * // Returns [0, 'a', 2, 1] (treats array-like object { 0: 'a', length: 1 } as a valid array)
+ * union([0], { 0: 'a', length: 1 }, [2, 1]);
+ */
+declare function union<T>(...arrays: Array<ArrayLike<T> | null | undefined>): T[];
+
+export { union };

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

@@ -0,0 +1,30 @@
+/**
+ * This function takes multiple arrays and returns a new array containing only the unique values
+ * from all input arrays, preserving the order of their first occurrence.
+ *
+ * @template T - The type of elements in the arrays.
+ * @param {Array<ArrayLike<T> | null | undefined>} arrays - The arrays to inspect.
+ * @returns {T[]} Returns the new array of combined unique values.
+ *
+ * @example
+ * // Returns [2, 1]
+ * union([2], [1, 2]);
+ *
+ * @example
+ * // Returns [2, 1, 3]
+ * union([2], [1, 2], [2, 3]);
+ *
+ * @example
+ * // Returns [1, 3, 2, [5], [4]] (does not deeply flatten nested arrays)
+ * union([1, 3, 2], [1, [5]], [2, [4]]);
+ *
+ * @example
+ * // Returns [0, 2, 1] (ignores non-array values like 3 and { '0': 1 })
+ * union([0], 3, { '0': 1 }, null, [2, 1]);
+ * @example
+ * // Returns [0, 'a', 2, 1] (treats array-like object { 0: 'a', length: 1 } as a valid array)
+ * union([0], { 0: 'a', length: 1 }, [2, 1]);
+ */
+declare function union<T>(...arrays: Array<ArrayLike<T> | null | undefined>): T[];
+
+export { union };

package/dist/compat/array/union.mjs

@@ -0,0 +1,11 @@
+import { flatten } from './flatten.mjs';
+import { uniq } from '../../array/uniq.mjs';
+import { isArrayLikeObject } from '../predicate/isArrayLikeObject.mjs';
+
+function union(...arrays) {
+    const validArrays = arrays.filter(isArrayLikeObject);
+    const flattened = flatten(validArrays, 1);
+    return uniq(flattened);
+}
+
+export { union };

package/dist/compat/index.d.mts

@@ -19,7 +19,6 @@ export { shuffle } from '../array/shuffle.mjs';
 export { takeRightWhile } from '../array/takeRightWhile.mjs';
 export { takeWhile } from '../array/takeWhile.mjs';
 export { toFilled } from '../array/toFilled.mjs';
-export { union } from '../array/union.mjs';
 export { unionBy } from '../array/unionBy.mjs';
 export { unionWith } from '../array/unionWith.mjs';
 export { uniqBy } from '../array/uniqBy.mjs';
@@ -113,6 +112,7 @@ export { sortBy } from './array/sortBy.mjs';
 export { tail } from './array/tail.mjs';
 export { take } from './array/take.mjs';
 export { takeRight } from './array/takeRight.mjs';
+export { union } from './array/union.mjs';
 export { uniq } from './array/uniq.mjs';
 export { unzip } from './array/unzip.mjs';
 export { without } from './array/without.mjs';

package/dist/compat/index.d.ts

@@ -19,7 +19,6 @@ export { shuffle } from '../array/shuffle.js';
 export { takeRightWhile } from '../array/takeRightWhile.js';
 export { takeWhile } from '../array/takeWhile.js';
 export { toFilled } from '../array/toFilled.js';
-export { union } from '../array/union.js';
 export { unionBy } from '../array/unionBy.js';
 export { unionWith } from '../array/unionWith.js';
 export { uniqBy } from '../array/uniqBy.js';
@@ -113,6 +112,7 @@ export { sortBy } from './array/sortBy.js';
 export { tail } from './array/tail.js';
 export { take } from './array/take.js';
 export { takeRight } from './array/takeRight.js';
+export { union } from './array/union.js';
 export { uniq } from './array/uniq.js';
 export { unzip } from './array/unzip.js';
 export { without } from './array/without.js';

package/dist/compat/index.js

@@ -1201,6 +1201,12 @@ function takeRight(arr, count = 1, guard) {
     return zipWith.takeRight(toArray(arr), count);
 }
 
+function union(...arrays) {
+    const validArrays = arrays.filter(isArrayLikeObject);
+    const flattened = flatten(validArrays, 1);
+    return zipWith.uniq(flattened);
+}
+
 function uniq(arr) {
     if (!isArrayLike(arr)) {
         return [];
@@ -2546,7 +2552,6 @@ exports.shuffle = zipWith.shuffle;
 exports.takeRightWhile = zipWith.takeRightWhile;
 exports.takeWhile = zipWith.takeWhile;
 exports.toFilled = zipWith.toFilled;
-exports.union = zipWith.union;
 exports.unionBy = zipWith.unionBy;
 exports.unionWith = zipWith.unionWith;
 exports.uniqBy = zipWith.uniqBy;
@@ -2748,6 +2753,7 @@ exports.toString = toString;
 exports.trim = trim;
 exports.trimEnd = trimEnd;
 exports.trimStart = trimStart;
+exports.union = union;
 exports.uniq = uniq;
 exports.uniqueId = uniqueId;
 exports.unset = unset;

package/dist/compat/index.mjs

@@ -19,7 +19,6 @@ export { shuffle } from '../array/shuffle.mjs';
 export { takeRightWhile } from '../array/takeRightWhile.mjs';
 export { takeWhile } from '../array/takeWhile.mjs';
 export { toFilled } from '../array/toFilled.mjs';
-export { union } from '../array/union.mjs';
 export { unionBy } from '../array/unionBy.mjs';
 export { unionWith } from '../array/unionWith.mjs';
 export { uniqBy } from '../array/uniqBy.mjs';
@@ -115,6 +114,7 @@ export { sortBy } from './array/sortBy.mjs';
 export { tail } from './array/tail.mjs';
 export { take } from './array/take.mjs';
 export { takeRight } from './array/takeRight.mjs';
+export { union } from './array/union.mjs';
 export { uniq } from './array/uniq.mjs';
 export { unzip } from './array/unzip.mjs';
 export { without } from './array/without.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.26.1-dev.864+a0f61e4b",
+  "version": "1.26.1-dev.865+ab6e7c57",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {