@oscarpalmer/atoms 0.155.0 → 0.156.0

package/dist/array/difference.js

@@ -0,0 +1,5 @@
+import { COMPARE_SETS_DIFFERENCE, compareSets } from "../internal/array/sets.js";
+function difference(first, second, key) {
+	return compareSets(COMPARE_SETS_DIFFERENCE, first, second, key);
+}
+export { difference };

package/dist/array/exists.js

@@ -1,6 +1,6 @@
-import { findValue } from "../internal/array/find.js";
+import { FIND_VALUE_INDEX, findValue } from "../internal/array/find.js";
 function exists(array, ...parameters) {
 	if (parameters.length === 1 && typeof parameters[0] !== "function") return Array.isArray(array) ? array.includes(parameters[0]) : false;
-	return findValue("index", array, parameters) > -1;
+	return findValue(FIND_VALUE_INDEX, array, parameters) > -1;
 }
 export { exists };

package/dist/array/find.js

@@ -1,5 +1,5 @@
-import { findValue } from "../internal/array/find.js";
+import { FIND_VALUE_VALUE, findValue } from "../internal/array/find.js";
 function find(array, ...parameters) {
-	return findValue("value", array, parameters);
+	return findValue(FIND_VALUE_VALUE, array, parameters);
 }
 export { find };

package/dist/array/index-of.js

@@ -1,5 +1,5 @@
-import { findValue } from "../internal/array/find.js";
+import { FIND_VALUE_INDEX, findValue } from "../internal/array/find.js";
 function indexOf(array, ...parameters) {
-	return findValue("index", array, parameters);
+	return findValue(FIND_VALUE_INDEX, array, parameters);
 }
 export { indexOf };

package/dist/array/{misc.js → index.js}

@@ -1,3 +1,4 @@
+import { difference } from "./difference.js";
 import { exists } from "./exists.js";
 import { filter } from "./filter.js";
 import { find } from "./find.js";
@@ -6,9 +7,10 @@ import { range, times } from "./from.js";
 import { getArray } from "./get.js";
 import { indexOf } from "./index-of.js";
 import { chunk } from "../internal/array/chunk.js";
-import { insert } from "./insert.js";
 import { compact } from "../internal/array/compact.js";
 import { shuffle } from "../internal/array/shuffle.js";
+import { insert } from "./insert.js";
+import { intersection } from "./intersection.js";
 import { partition } from "./partition.js";
 import { push } from "./push.js";
 import { select } from "./select.js";
@@ -16,5 +18,6 @@ import { sort } from "./sort.js";
 import { splice } from "./splice.js";
 import { toSet } from "./to-set.js";
 import { toggle } from "./toggle.js";
+import { union } from "./union.js";
 import { update } from "./update.js";
-export { chunk, compact, exists, filter, find, flatten, getArray, indexOf, insert, partition, push, range, select, shuffle, sort, splice, times, toSet, toggle, update };
+export { chunk, compact, difference, exists, filter, find, flatten, getArray, indexOf, insert, intersection, partition, push, range, select, shuffle, sort, splice, times, toSet, toggle, union, update };

package/dist/array/intersection.js

@@ -0,0 +1,5 @@
+import { COMPARE_SETS_INTERSECTION, compareSets } from "../internal/array/sets.js";
+function intersection(first, second, key) {
+	return compareSets(COMPARE_SETS_INTERSECTION, first, second, key);
+}
+export { intersection };

package/dist/array/union.js

@@ -0,0 +1,5 @@
+import { COMPARE_SETS_UNION, compareSets } from "../internal/array/sets.js";
+function union(first, second, key) {
+	return compareSets(COMPARE_SETS_UNION, first, second, key);
+}
+export { union };

package/dist/array/unique.js

@@ -1,6 +1,6 @@
-import { findValues } from "../internal/array/find.js";
+import { FIND_VALUES_UNIQUE, findValues } from "../internal/array/find.js";
 function unique(array, key) {
 	if (!Array.isArray(array)) return [];
-	return array.length > 1 ? findValues("unique", array, [key, void 0]).matched : array;
+	return array.length > 1 ? findValues(FIND_VALUES_UNIQUE, array, [key, void 0]).matched : array;
 }
 export { unique };

package/dist/atoms.full.js

@@ -184,6 +184,37 @@ function shuffle(array) {
 	}
 	return shuffled;
 }
+function compareSets(type, first, second, key) {
+	if (!Array.isArray(first)) return [];
+	const isDifference = type === COMPARE_SETS_DIFFERENCE;
+	const isIntersection = type === COMPARE_SETS_INTERSECTION;
+	const isUnion = type === COMPARE_SETS_UNION;
+	if (first.length === 0) return isDifference ? [...first] : isIntersection ? [] : [...second];
+	if (!Array.isArray(second) || second.length === 0) return isIntersection ? [] : [...first];
+	const callback = getArrayCallback(key);
+	const values = isUnion ? first : second;
+	let { length } = values;
+	const set = /* @__PURE__ */ new Set([]);
+	for (let index = 0; index < length; index += 1) {
+		const item = values[index];
+		set.add(callback?.(item, index, values) ?? item);
+	}
+	const source = isUnion ? second : first;
+	length = source.length;
+	const result = isUnion ? [...first] : [];
+	for (let index = 0; index < length; index += 1) {
+		const item = source[index];
+		const value = callback?.(item, index, source) ?? item;
+		if (isIntersection ? set.has(value) : !set.has(value)) result.push(item);
+	}
+	return result;
+}
+const COMPARE_SETS_DIFFERENCE = "difference";
+const COMPARE_SETS_INTERSECTION = "intersection";
+const COMPARE_SETS_UNION = "union";
+function difference(first, second, key) {
+	return compareSets(COMPARE_SETS_DIFFERENCE, first, second, key);
+}
 function findValue(type, array, parameters) {
 	const findIndex = type === "index";
 	if (!Array.isArray(array) || array.length === 0) return findIndex ? -1 : void 0;
@@ -213,12 +244,12 @@ function findValues(type, array, parameters, mapper) {
 	const { length } = array;
 	const { bool, key, value } = getParameters(parameters);
 	const callbacks = getArrayCallbacks(bool, key);
-	if (type === "unique" && callbacks?.keyed == null && length >= UNIQUE_THRESHOLD) {
+	if (type === FIND_VALUES_UNIQUE && callbacks?.keyed == null && length >= UNIQUE_THRESHOLD) {
 		result.matched = [...new Set(array)];
 		return result;
 	}
 	const mapCallback = typeof mapper === "function" ? mapper : void 0;
-	if (callbacks?.bool != null || type === "all" && key == null) {
+	if (callbacks?.bool != null || type === FIND_VALUES_ALL && key == null) {
 		const callback = callbacks?.bool ?? ((item) => Object.is(item, value));
 		for (let index = 0; index < length; index += 1) {
 			const item = array[index];
@@ -231,7 +262,7 @@ function findValues(type, array, parameters, mapper) {
 	for (let index = 0; index < length; index += 1) {
 		const item = array[index];
 		const keyed = callbacks?.keyed?.(item, index, array) ?? item;
-		if (type === "all" && Object.is(keyed, value) || type === "unique" && !keys.has(keyed)) {
+		if (type === FIND_VALUES_ALL && Object.is(keyed, value) || type === FIND_VALUES_UNIQUE && !keys.has(keyed)) {
 			keys.add(keyed);
 			result.matched.push(mapCallback?.(item, index, array) ?? item);
 		} else result.notMatched.push(item);
@@ -246,20 +277,24 @@ function getParameters(original) {
 		value: length === 1 && typeof original[0] !== "function" ? original[0] : original[1]
 	};
 }
+const FIND_VALUE_INDEX = "index";
+const FIND_VALUE_VALUE = "value";
+const FIND_VALUES_ALL = "all";
+const FIND_VALUES_UNIQUE = "unique";
 const UNIQUE_THRESHOLD = 100;
 function exists(array, ...parameters) {
 	if (parameters.length === 1 && typeof parameters[0] !== "function") return Array.isArray(array) ? array.includes(parameters[0]) : false;
-	return findValue("index", array, parameters) > -1;
+	return findValue(FIND_VALUE_INDEX, array, parameters) > -1;
 }
 function filter(array, ...parameters) {
-	return findValues("all", array, parameters).matched;
+	return findValues(FIND_VALUES_ALL, array, parameters).matched;
 }
 filter.remove = removeFiltered;
 function removeFiltered(array, ...parameters) {
-	return findValues("all", array, parameters).notMatched;
+	return findValues(FIND_VALUES_ALL, array, parameters).notMatched;
 }
 function find(array, ...parameters) {
-	return findValue("value", array, parameters);
+	return findValue(FIND_VALUE_VALUE, array, parameters);
 }
 /**
 * Flatten an array _(using native `flat` and maximum depth)_
@@ -301,7 +336,7 @@ function getArray(value, indiced) {
 	return array;
 }
 function indexOf(array, ...parameters) {
-	return findValue("index", array, parameters);
+	return findValue(FIND_VALUE_INDEX, array, parameters);
 }
 function insertChunkedValues(type, array, items, start, deleteCount) {
 	const actualDeleteCount = deleteCount < 0 ? 0 : deleteCount;
@@ -327,8 +362,11 @@ function insertValues(type, array, items, start, deleteCount) {
 function insert(array, indexOrItems, items) {
 	return insertValues("insert", array, items == null ? indexOrItems : items, typeof indexOrItems === "number" ? indexOrItems : array?.length, 0);
 }
+function intersection(first, second, key) {
+	return compareSets(COMPARE_SETS_INTERSECTION, first, second, key);
+}
 function partition(array, ...parameters) {
-	const { matched, notMatched } = findValues("all", array, parameters);
+	const { matched, notMatched } = findValues(FIND_VALUES_ALL, array, parameters);
 	return [matched, notMatched];
 }
 /**
@@ -341,7 +379,7 @@ function push(array, pushed) {
 	return insertValues("push", array, pushed, array.length, 0);
 }
 function select(array, ...parameters) {
-	return findValues("all", array, parameters, parameters.pop()).matched;
+	return findValues(FIND_VALUES_ALL, array, parameters, parameters.pop()).matched;
 }
 function aggregate(type, array, key) {
 	const length = Array.isArray(array) ? array.length : 0;
@@ -648,6 +686,9 @@ function updateInArray(array, items, key, replace) {
 function toggle(array, values, key) {
 	return updateInArray(array, values, key, false);
 }
+function union(first, second, key) {
+	return compareSets(COMPARE_SETS_UNION, first, second, key);
+}
 function update(array, values, key) {
 	return updateInArray(array, values, key, true);
 }
@@ -684,7 +725,7 @@ function toRecordArrays(array, first, second) {
 }
 function unique(array, key) {
 	if (!Array.isArray(array)) return [];
-	return array.length > 1 ? findValues("unique", array, [key, void 0]).matched : array;
+	return array.length > 1 ? findValues(FIND_VALUES_UNIQUE, array, [key, void 0]).matched : array;
 }
 function getInterval(value) {
 	return typeof value === "number" && value > 0 ? value : 0;
@@ -1527,45 +1568,6 @@ const REPLACEMENT_CAMEL_CASE = "$1-$2";
 let memoizedCapitalize;
 let memoizedTitleCase;
 /**
-* Check if a string ends with a specified substring
-* @param haystack String to look in
-* @param needle String to look for
-* @param ignoreCase Ignore case when matching? _(defaults to `false`)_
-* @returns `true` if the string ends with the given substring, otherwise `false`
-*/
-function endsWith(haystack, needle, ignoreCase) {
-	return match("endsWith", haystack, needle, ignoreCase === true);
-}
-/**
-* Check if a string includes a specified substring
-* @param haystack String to look in
-* @param needle String to look for
-* @param ignoreCase Ignore case when matching? _(defaults to `false`)_
-* @returns `true` if the string includes the given substring, otherwise `false`
-*/
-function includes(haystack, needle, ignoreCase) {
-	return match("includes", haystack, needle, ignoreCase === true);
-}
-function match(type, haystack, needle, ignoreCase) {
-	if (typeof haystack !== "string" || typeof needle !== "string") return false;
-	matchMemoizers[type] ??= memoize(matchCallback.bind(type));
-	return matchMemoizers[type].run(haystack, needle, ignoreCase);
-}
-function matchCallback(haystack, needle, ignoreCase) {
-	return (ignoreCase ? haystack.toLocaleLowerCase() : haystack)[this](ignoreCase ? needle.toLocaleLowerCase() : needle);
-}
-/**
-* Check if a string starts with a specified substring
-* @param haystack String to look in
-* @param needle String to look for
-* @param ignoreCase Ignore case when matching? _(defaults to `false`)_
-* @returns `true` if the string starts with the given substring, otherwise `false`
-*/
-function startsWith(haystack, needle, ignoreCase) {
-	return match("startsWith", haystack, needle, ignoreCase === true);
-}
-const matchMemoizers = {};
-/**
 * Get a new UUID-string _(version 4)_
 * @returns UUID string
 */
@@ -1620,6 +1622,45 @@ function truncate(value, length, suffix) {
 	const truncatedLength = length - actualSuffixLength;
 	return `${value.slice(0, truncatedLength)}${actualSuffix}`;
 }
+/**
+* Check if a string ends with a specified substring
+* @param haystack String to look in
+* @param needle String to look for
+* @param ignoreCase Ignore case when matching? _(defaults to `false`)_
+* @returns `true` if the string ends with the given substring, otherwise `false`
+*/
+function endsWith(haystack, needle, ignoreCase) {
+	return match("endsWith", haystack, needle, ignoreCase === true);
+}
+/**
+* Check if a string includes a specified substring
+* @param haystack String to look in
+* @param needle String to look for
+* @param ignoreCase Ignore case when matching? _(defaults to `false`)_
+* @returns `true` if the string includes the given substring, otherwise `false`
+*/
+function includes(haystack, needle, ignoreCase) {
+	return match("includes", haystack, needle, ignoreCase === true);
+}
+function match(type, haystack, needle, ignoreCase) {
+	if (typeof haystack !== "string" || typeof needle !== "string") return false;
+	matchMemoizers[type] ??= memoize(matchCallback.bind(type));
+	return matchMemoizers[type].run(haystack, needle, ignoreCase);
+}
+function matchCallback(haystack, needle, ignoreCase) {
+	return (ignoreCase ? haystack.toLocaleLowerCase() : haystack)[this](ignoreCase ? needle.toLocaleLowerCase() : needle);
+}
+/**
+* Check if a string starts with a specified substring
+* @param haystack String to look in
+* @param needle String to look for
+* @param ignoreCase Ignore case when matching? _(defaults to `false`)_
+* @returns `true` if the string starts with the given substring, otherwise `false`
+*/
+function startsWith(haystack, needle, ignoreCase) {
+	return match("startsWith", haystack, needle, ignoreCase === true);
+}
+const matchMemoizers = {};
 function getTemplateOptions(input) {
 	const options = isPlainObject(input) ? input : {};
 	return {
@@ -1876,68 +1917,6 @@ function setChanges(parameters) {
 	const diffsLength = diffs.length;
 	for (let diffIndex = 0; diffIndex < diffsLength; diffIndex += 1) changes.push(diffs[diffIndex]);
 }
-function getMergeOptions(options) {
-	const actual = {
-		replaceableObjects: void 0,
-		skipNullableAny: false,
-		skipNullableInArrays: false
-	};
-	if (typeof options !== "object" || options == null) return actual;
-	actual.replaceableObjects = getReplaceableObjects(options.replaceableObjects);
-	actual.skipNullableAny = options.skipNullableAny === true;
-	actual.skipNullableInArrays = options.skipNullableInArrays === true;
-	return actual;
-}
-function getReplaceableObjects(value) {
-	const items = (Array.isArray(value) ? value : [value]).filter((item) => typeof item === "string" || item instanceof RegExp);
-	if (items.length > 0) return (name) => items.some((item) => typeof item === "string" ? item === name : item.test(name));
-}
-function handleMerge(values, options) {
-	return !Array.isArray(values) || values.length === 0 ? {} : mergeValues(values, options, true);
-}
-/**
-* Merge multiple arrays or objects into a single one
-* @param values Values to merge
-* @param options Merging options
-* @returns Merged value
-*/
-function merge(values, options) {
-	return handleMerge(values, getMergeOptions(options));
-}
-merge.initialize = initializeMerger;
-/**
-* Create a merger with predefined options
-* @param options Merging options
-* @returns Merger function
-*/
-function initializeMerger(options) {
-	const actual = getMergeOptions(options);
-	return (values) => handleMerge(values, actual);
-}
-function mergeObjects(values, options, prefix) {
-	const { length } = values;
-	const isArray = values.every(Array.isArray);
-	const merged = isArray ? [] : {};
-	for (let outerIndex = 0; outerIndex < length; outerIndex += 1) {
-		const item = values[outerIndex];
-		const keys = Object.keys(item);
-		const size = keys.length;
-		for (let innerIndex = 0; innerIndex < size; innerIndex += 1) {
-			const key = keys[innerIndex];
-			const full = join([prefix, key], ".");
-			const next = item[key];
-			const previous = merged[key];
-			if (next == null && (options.skipNullableAny || isArray && options.skipNullableInArrays)) continue;
-			if (isArrayOrPlainObject(next) && isArrayOrPlainObject(previous) && !(options.replaceableObjects?.(full) ?? false)) merged[key] = mergeValues([previous, next], options, false, full);
-			else merged[key] = next;
-		}
-	}
-	return merged;
-}
-function mergeValues(values, options, validate, prefix) {
-	const actual = validate ? values.filter(isArrayOrPlainObject) : values;
-	return actual.length > 1 ? mergeObjects(actual, options, prefix) : actual[0] ?? {};
-}
 function partial(value, providedKeys, omit) {
 	if (typeof value !== "object" || value === null) return {};
 	const keys = omit ? Object.keys(value) : Array.isArray(providedKeys) ? providedKeys : [];
@@ -2034,6 +2013,62 @@ function unsmush(value) {
 	}
 	return unsmushed;
 }
+function getMergeOptions(options) {
+	const actual = {
+		replaceableObjects: void 0,
+		skipNullableAny: false,
+		skipNullableInArrays: false
+	};
+	if (typeof options !== "object" || options == null) return actual;
+	actual.replaceableObjects = getReplaceableObjects(options.replaceableObjects);
+	actual.skipNullableAny = options.skipNullableAny === true;
+	actual.skipNullableInArrays = options.skipNullableInArrays === true;
+	return actual;
+}
+function getReplaceableObjects(value) {
+	const items = (Array.isArray(value) ? value : [value]).filter((item) => typeof item === "string" || item instanceof RegExp);
+	if (items.length > 0) return (name) => items.some((item) => typeof item === "string" ? item === name : item.test(name));
+}
+function handleMerge(values, options) {
+	return !Array.isArray(values) || values.length === 0 ? {} : mergeValues(values, options, true);
+}
+function merge(values, options) {
+	return handleMerge(values, getMergeOptions(options));
+}
+merge.initialize = initializeMerger;
+/**
+* Create a merger with predefined options
+* @param options Merging options
+* @returns Merger function
+*/
+function initializeMerger(options) {
+	const actual = getMergeOptions(options);
+	return (values) => handleMerge(values, actual);
+}
+function mergeObjects(values, options, prefix) {
+	const { length } = values;
+	const isArray = values.every(Array.isArray);
+	const merged = isArray ? [] : {};
+	for (let outerIndex = 0; outerIndex < length; outerIndex += 1) {
+		const item = values[outerIndex];
+		const keys = Object.keys(item);
+		const size = keys.length;
+		for (let innerIndex = 0; innerIndex < size; innerIndex += 1) {
+			const key = keys[innerIndex];
+			const full = join([prefix, key], ".");
+			const next = item[key];
+			const previous = merged[key];
+			if (next == null && (options.skipNullableAny || isArray && options.skipNullableInArrays)) continue;
+			if (isArrayOrPlainObject(next) && isArrayOrPlainObject(previous) && !(options.replaceableObjects?.(full) ?? false)) merged[key] = mergeValues([previous, next], options, false, full);
+			else merged[key] = next;
+		}
+	}
+	return merged;
+}
+function mergeValues(values, options, validate, prefix) {
+	const actual = validate ? values.filter(isArrayOrPlainObject) : values;
+	return actual.length > 1 ? mergeObjects(actual, options, prefix) : actual[0] ?? {};
+}
 var Beacon = class {
 	#options;
 	#state;
@@ -3839,4 +3874,4 @@ var SizedSet = class extends Set {
 		}
 	}
 };
-export { CancelablePromise, PromiseTimeoutError, QueueError, RetryError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, floor, flow, toResult as fromPromise, toResult, fromQuery, toPromise as fromResult, toPromise, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, median, memoize, merge, min, noop, ok, omit, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, retry, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, times, titleCase, toMap, toQuery, toRecord, toSet, toggle, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, update, upperCase, words };
+export { CancelablePromise, PromiseTimeoutError, QueueError, RetryError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, difference, endsWith, equal, error, exists, filter, find, flatten, floor, flow, toResult as fromPromise, toResult, fromQuery, toPromise as fromResult, toPromise, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, median, memoize, merge, min, noop, ok, omit, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, retry, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, times, titleCase, toMap, toQuery, toRecord, toSet, toggle, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };

package/dist/index.js

@@ -1,3 +1,4 @@
+import { difference } from "./array/difference.js";
 import { exists } from "./array/exists.js";
 import { filter } from "./array/filter.js";
 import { find } from "./array/find.js";
@@ -8,10 +9,11 @@ import { getArray } from "./array/get.js";
 import { groupBy } from "./array/group-by.js";
 import { indexOf } from "./array/index-of.js";
 import { chunk } from "./internal/array/chunk.js";
-import { insert } from "./array/insert.js";
 import { compact } from "./internal/array/compact.js";
 import { getRandomFloat, getRandomInteger } from "./internal/random.js";
 import { shuffle } from "./internal/array/shuffle.js";
+import { insert } from "./array/insert.js";
+import { intersection } from "./array/intersection.js";
 import { partition } from "./array/partition.js";
 import { push } from "./array/push.js";
 import { select } from "./array/select.js";
@@ -22,8 +24,9 @@ import { sort } from "./array/sort.js";
 import { splice } from "./array/splice.js";
 import { toSet } from "./array/to-set.js";
 import { toggle } from "./array/toggle.js";
+import { union } from "./array/union.js";
 import { update } from "./array/update.js";
-import "./array/misc.js";
+import "./array/index.js";
 import { toMap } from "./array/to-map.js";
 import { toRecord } from "./array/to-record.js";
 import { unique } from "./array/unique.js";
@@ -47,16 +50,16 @@ import { getValue } from "./internal/value/get.js";
 import { hasValue } from "./internal/value/has.js";
 import { setValue } from "./internal/value/set.js";
 import { camelCase, capitalize, kebabCase, lowerCase, pascalCase, snakeCase, titleCase, upperCase } from "./string/case.js";
+import { getUuid, parse, trim, truncate } from "./string/index.js";
 import { endsWith, includes, startsWith } from "./string/match.js";
-import { getUuid, parse, trim, truncate } from "./string/misc.js";
 import { template } from "./string/template.js";
 import { clone } from "./value/clone.js";
 import { diff } from "./value/diff.js";
-import { merge } from "./value/merge.js";
 import { omit } from "./value/omit.js";
 import { pick } from "./value/pick.js";
 import { smush } from "./value/smush.js";
 import { unsmush } from "./value/unsmush.js";
+import { merge } from "./value/merge.js";
 import { isEmpty, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumerical, isObject, isPrimitive } from "./is.js";
 import { logger } from "./logger.js";
 import { average, ceil, count, floor, median, min, round, sum } from "./math.js";
@@ -72,4 +75,4 @@ import { QueueError, queue } from "./queue.js";
 import { getRandomBoolean, getRandomCharacters, getRandomColor, getRandomHex, getRandomItem, getRandomItems } from "./random.js";
 import { attempt } from "./result/index.js";
 import { SizedSet } from "./sized/set.js";
-export { CancelablePromise, PromiseTimeoutError, QueueError, RetryError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, floor, flow, toResult as fromPromise, fromQuery, toPromise as fromResult, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, median, memoize, merge, min, noop, ok, omit, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, retry, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, times, titleCase, toMap, toPromise, toQuery, toRecord, toResult, toSet, toggle, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, update, upperCase, words };
+export { CancelablePromise, PromiseTimeoutError, QueueError, RetryError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, difference, endsWith, equal, error, exists, filter, find, flatten, floor, flow, toResult as fromPromise, fromQuery, toPromise as fromResult, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, median, memoize, merge, min, noop, ok, omit, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, retry, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, times, titleCase, toMap, toPromise, toQuery, toRecord, toResult, toSet, toggle, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };

package/dist/internal/array/find.js

@@ -61,5 +61,9 @@ function getParameters(original) {
 		value: length === 1 && typeof original[0] !== "function" ? original[0] : original[1]
 	};
 }
+const FIND_VALUE_INDEX = "index";
+const FIND_VALUE_VALUE = "value";
+const FIND_VALUES_ALL = "all";
+const FIND_VALUES_UNIQUE = "unique";
 var UNIQUE_THRESHOLD = 100;
-export { findValue, findValues };
+export { FIND_VALUES_ALL, FIND_VALUES_UNIQUE, FIND_VALUE_INDEX, FIND_VALUE_VALUE, findValue, findValues };

package/dist/internal/array/sets.js

@@ -0,0 +1,30 @@
+import { getArrayCallback } from "./callbacks.js";
+function compareSets(type, first, second, key) {
+	if (!Array.isArray(first)) return [];
+	const isDifference = type === COMPARE_SETS_DIFFERENCE;
+	const isIntersection = type === COMPARE_SETS_INTERSECTION;
+	const isUnion = type === COMPARE_SETS_UNION;
+	if (first.length === 0) return isDifference ? [...first] : isIntersection ? [] : [...second];
+	if (!Array.isArray(second) || second.length === 0) return isIntersection ? [] : [...first];
+	const callback = getArrayCallback(key);
+	const values = isUnion ? first : second;
+	let { length } = values;
+	const set = /* @__PURE__ */ new Set([]);
+	for (let index = 0; index < length; index += 1) {
+		const item = values[index];
+		set.add(callback?.(item, index, values) ?? item);
+	}
+	const source = isUnion ? second : first;
+	length = source.length;
+	const result = isUnion ? [...first] : [];
+	for (let index = 0; index < length; index += 1) {
+		const item = source[index];
+		const value = callback?.(item, index, source) ?? item;
+		if (isIntersection ? set.has(value) : !set.has(value)) result.push(item);
+	}
+	return result;
+}
+const COMPARE_SETS_DIFFERENCE = "difference";
+const COMPARE_SETS_INTERSECTION = "intersection";
+const COMPARE_SETS_UNION = "union";
+export { COMPARE_SETS_DIFFERENCE, COMPARE_SETS_INTERSECTION, COMPARE_SETS_UNION, compareSets };

package/dist/value/merge.js

@@ -19,12 +19,6 @@ function getReplaceableObjects(value) {
 function handleMerge(values, options) {
 	return !Array.isArray(values) || values.length === 0 ? {} : mergeValues(values, options, true);
 }
-/**
-* Merge multiple arrays or objects into a single one
-* @param values Values to merge
-* @param options Merging options
-* @returns Merged value
-*/
 function merge(values, options) {
 	return handleMerge(values, getMergeOptions(options));
 }

package/package.json

@@ -26,9 +26,9 @@
 			"types": "./types/array/group-by.d.ts",
 			"default": "./dist/array/group-by.js"
 		},
-		"./array/misc": {
-			"types": "./types/array/misc.d.ts",
-			"default": "./dist/array/misc.js"
+		"./array": {
+			"types": "./types/array/index.d.ts",
+			"default": "./dist/array/index.js"
 		},
 		"./array/to-map": {
 			"types": "./types/array/to-map.d.ts",
@@ -113,6 +113,10 @@
 			"types": "./types/sized/set.d.ts",
 			"default": "./dist/sized/set.js"
 		},
+		"./string": {
+			"types": "./types/string/index.d.ts",
+			"default": "./dist/string/index.js"
+		},
 		"./string/case": {
 			"types": "./types/string/case.d.ts",
 			"default": "./dist/string/case.js"
@@ -121,14 +125,14 @@
 			"types": "./types/string/match.d.ts",
 			"default": "./dist/string/match.js"
 		},
-		"./string/misc": {
-			"types": "./types/string/misc.d.ts",
-			"default": "./dist/string/misc.js"
-		},
 		"./string/template": {
 			"types": "./types/string/template.d.ts",
 			"default": "./dist/string/template.js"
 		},
+		"./value": {
+			"types": "./types/value/index.d.ts",
+			"default": "./dist/value/index.js"
+		},
 		"./value/clone": {
 			"types": "./types/value/clone.d.ts",
 			"default": "./dist/value/clone.js"
@@ -152,10 +156,6 @@
 		"./value/merge": {
 			"types": "./types/value/merge.d.ts",
 			"default": "./dist/value/merge.js"
-		},
-		"./value/misc": {
-			"types": "./types/value/misc.d.ts",
-			"default": "./dist/value/misc.js"
 		}
 	},
 	"files": [
@@ -184,5 +184,5 @@
 	},
 	"type": "module",
 	"types": "./types/index.d.ts",
-	"version": "0.155.0"
+	"version": "0.156.0"
 }

package/src/array/difference.ts

@@ -0,0 +1,40 @@
+import {COMPARE_SETS_DIFFERENCE, compareSets} from '../internal/array/sets';
+import type {PlainObject} from '../models';
+
+/**
+ * Get the items from the first array that are not in the second array
+ * @param first First array
+ * @param second Second array
+ * @param callback Callback to get an item's value for comparison
+ * @returns Unique values from the first array
+ */
+export function difference<First, Second>(
+	first: First[],
+	second: Second[],
+	callback: (item: First | Second) => unknown,
+): First[];
+
+/**
+ * Get the items from the first array that are not in the second array
+ * @param first First array
+ * @param second Second array
+ * @param key Key to get an item's value for comparison
+ * @returns Unique values from the first array
+ */
+export function difference<
+	First extends PlainObject,
+	Second extends PlainObject,
+	Key extends keyof First & keyof Second,
+>(first: First[], second: Second[], key: Key): First[];
+
+/**
+ * Get the items from the first array that are not in the second array
+ * @param first First array
+ * @param second Second array
+ * @returns Unique values from the first array
+ */
+export function difference<First, Second>(first: First[], second: Second[]): First[];
+
+export function difference(first: unknown[], second: unknown[], key?: unknown): unknown[] {
+	return compareSets(COMPARE_SETS_DIFFERENCE, first, second, key);
+}

package/src/array/exists.ts

@@ -1,4 +1,4 @@
-import {findValue} from '../internal/array/find';
+import {FIND_VALUE_INDEX, findValue} from '../internal/array/find';
 import type {PlainObject} from '../models';
 
 // #region Functions
@@ -52,7 +52,7 @@ export function exists(array: unknown[], ...parameters: unknown[]): boolean {
 		return Array.isArray(array) ? array.includes(parameters[0]) : false;
 	}
 
-	return (findValue('index', array, parameters) as number) > -1;
+	return (findValue(FIND_VALUE_INDEX, array, parameters) as number) > -1;
 }
 
 // #endregion

package/src/array/filter.ts

@@ -1,4 +1,4 @@
-import {findValues} from '../internal/array/find';
+import {FIND_VALUES_ALL, findValues} from '../internal/array/find';
 import type {PlainObject} from '../models';
 
 // #region Functions
@@ -48,7 +48,7 @@ export function filter<Item>(
 export function filter<Item>(array: Item[], item: Item): Item[];
 
 export function filter(array: unknown[], ...parameters: unknown[]): unknown[] {
-	return findValues('all', array, parameters).matched;
+	return findValues(FIND_VALUES_ALL, array, parameters).matched;
 }
 
 filter.remove = removeFiltered;
@@ -72,7 +72,7 @@ function removeFiltered<Item>(
 function removeFiltered<Item>(array: Item[], item: Item): unknown[];
 
 function removeFiltered(array: unknown[], ...parameters: unknown[]): unknown[] {
-	return findValues('all', array, parameters).notMatched;
+	return findValues(FIND_VALUES_ALL, array, parameters).notMatched;
 }
 
 // #endregion

package/src/array/find.ts

@@ -1,4 +1,4 @@
-import {findValue} from '../internal/array/find';
+import {FIND_VALUE_VALUE, findValue} from '../internal/array/find';
 import type {PlainObject} from '../models';
 
 // #region Functions
@@ -49,7 +49,7 @@ export function find<Item>(
 export function find<Item>(array: Item[], value: Item): Item | undefined;
 
 export function find<Item>(array: unknown[], ...parameters: unknown[]): Item | undefined {
-	return findValue('value', array, parameters) as Item | undefined;
+	return findValue(FIND_VALUE_VALUE, array, parameters) as Item | undefined;
 }
 
 // #endregion

package/src/array/index-of.ts

@@ -1,4 +1,4 @@
-import {findValue} from '../internal/array/find';
+import {FIND_VALUE_INDEX, findValue} from '../internal/array/find';
 import type {PlainObject} from '../models';
 
 // #region Functions
@@ -48,7 +48,7 @@ export function indexOf<Item>(
 export function indexOf<Item>(array: Item[], item: Item): number;
 
 export function indexOf(array: unknown[], ...parameters: unknown[]): number {
-	return findValue('index', array, parameters) as number;
+	return findValue(FIND_VALUE_INDEX, array, parameters) as number;
 }
 
 // #endregion

package/src/array/{misc.ts → index.ts}

@@ -2,6 +2,7 @@ export * from '../internal/array/chunk';
 export * from '../internal/array/compact';
 export * from '../internal/array/shuffle';
 
+export * from './difference';
 export * from './exists';
 export * from './filter';
 export * from './find';
@@ -10,6 +11,7 @@ export * from './from';
 export * from './get';
 export * from './index-of';
 export * from './insert';
+export * from './intersection';
 export * from './partition';
 export * from './push';
 export * from './select';
@@ -17,4 +19,5 @@ export * from './sort';
 export * from './splice';
 export * from './to-set';
 export * from './toggle';
+export * from './union';
 export * from './update';

package/src/array/intersection.ts

@@ -0,0 +1,39 @@
+import {COMPARE_SETS_INTERSECTION, compareSets} from '../internal/array/sets';
+
+/**
+ * Get the common values between two arrays
+ * @param first First array
+ * @param second Second array
+ * @param callback Callback to get an item's value for comparison
+ * @returns Common values from both arrays
+ */
+export function intersection<First, Second>(
+	first: First[],
+	second: Second[],
+	callback: (item: First | Second) => unknown,
+): First[];
+
+/**
+ * Get the common values between two arrays
+ * @param first First array
+ * @param second Second array
+ * @param key Key to get an item's value for comparison
+ * @returns Common values from both arrays
+ */
+export function intersection<
+	First extends Record<string, unknown>,
+	Second extends Record<string, unknown>,
+	Key extends keyof First & keyof Second,
+>(first: First[], second: Second[], key: Key): First[];
+
+/**
+ * Get the common values between two arrays
+ * @param first First array
+ * @param second Second array
+ * @returns Common values from both arrays
+ */
+export function intersection<First, Second>(first: First[], second: Second[]): First[];
+
+export function intersection(first: unknown[], second: unknown[], key?: unknown): unknown[] {
+	return compareSets(COMPARE_SETS_INTERSECTION, first, second, key);
+}

package/src/array/partition.ts

@@ -1,4 +1,4 @@
-import {findValues} from '../internal/array/find';
+import {FIND_VALUES_ALL, findValues} from '../internal/array/find';
 import type {PlainObject} from '../models';
 
 // #region Functions
@@ -48,7 +48,7 @@ export function partition<Item>(
 export function partition<Item>(array: Item[], item: Item): Item[][];
 
 export function partition(array: unknown[], ...parameters: unknown[]): unknown[][] {
-	const {matched, notMatched} = findValues('all', array, parameters);
+	const {matched, notMatched} = findValues(FIND_VALUES_ALL, array, parameters);
 
 	return [matched, notMatched];
 }

package/src/array/select.ts

@@ -1,4 +1,4 @@
-import {findValues} from '../internal/array/find';
+import {FIND_VALUES_ALL, findValues} from '../internal/array/find';
 import type {PlainObject} from '../models';
 
 /**
@@ -88,5 +88,5 @@ export function select<
 export function select(array: unknown[], ...parameters: unknown[]): unknown[] {
 	const mapper = parameters.pop();
 
-	return findValues('all', array, parameters, mapper).matched;
+	return findValues(FIND_VALUES_ALL, array, parameters, mapper).matched;
 }

package/src/array/union.ts

@@ -0,0 +1,39 @@
+import {COMPARE_SETS_UNION, compareSets} from '../internal/array/sets';
+
+/**
+ * Get the combined, unique values from two arrays
+ * @param first First array
+ * @param second Second array
+ * @param callback Callback to get an item's value for comparison
+ * @returns Combined, unique values from both arrays
+ */
+export function union<First, Second>(
+	first: First[],
+	second: Second[],
+	callback: (item: First | Second) => unknown,
+): (First | Second)[];
+
+/**
+ * Get the combined, unique values from two arrays
+ * @param first First array
+ * @param second Second array
+ * @param key Key to get an item's value for comparison
+ * @returns Combined, unique values from both arrays
+ */
+export function union<
+	First extends Record<string, unknown>,
+	Second extends Record<string, unknown>,
+	Key extends keyof First & keyof Second,
+>(first: First[], second: Second[], key: Key): (First | Second)[];
+
+/**
+ * Get the combined, unique values from two arrays
+ * @param first First array
+ * @param second Second array
+ * @returns Combined, unique values from both arrays
+ */
+export function union<First, Second>(first: First[], second: Second[]): (First | Second)[];
+
+export function union(first: unknown[], second: unknown[], key?: unknown): unknown[] {
+	return compareSets(COMPARE_SETS_UNION, first, second, key);
+}

package/src/array/unique.ts

@@ -1,4 +1,4 @@
-import {findValues} from '../internal/array/find';
+import {FIND_VALUES_UNIQUE, findValues} from '../internal/array/find';
 import type {PlainObject} from '../models';
 
 // #region Functions
@@ -37,7 +37,7 @@ export function unique(array: unknown[], key?: unknown): unknown[] {
 		return [];
 	}
 
-	return array.length > 1 ? findValues('unique', array, [key, undefined]).matched : array;
+	return array.length > 1 ? findValues(FIND_VALUES_UNIQUE, array, [key, undefined]).matched : array;
 }
 
 // #endregion

package/src/index.ts

@@ -1,5 +1,5 @@
 export * from './array/group-by';
-export * from './array/misc';
+export * from './array/index';
 export * from './array/to-map';
 export * from './array/to-record';
 export * from './array/unique';
@@ -17,17 +17,14 @@ export * from './internal/value/has';
 export * from './internal/value/set';
 
 export * from './string/case';
+export * from './string/index';
 export * from './string/match';
-export * from './string/misc';
 export * from './string/template';
 
 export * from './value/clone';
 export * from './value/diff';
+export * from './value/index';
 export * from './value/merge';
-export * from './value/omit';
-export * from './value/pick';
-export * from './value/smush';
-export * from './value/unsmush';
 
 export * from './beacon';
 export * from './color';

package/src/internal/array/find.ts

@@ -83,7 +83,7 @@ export function findValues(
 	const {bool, key, value} = getParameters(parameters);
 	const callbacks = getArrayCallbacks(bool, key);
 
-	if (type === 'unique' && callbacks?.keyed == null && length >= UNIQUE_THRESHOLD) {
+	if (type === FIND_VALUES_UNIQUE && callbacks?.keyed == null && length >= UNIQUE_THRESHOLD) {
 		result.matched = [...new Set(array)];
 
 		return result;
@@ -91,7 +91,7 @@ export function findValues(
 
 	const mapCallback = typeof mapper === 'function' ? mapper : undefined;
 
-	if (callbacks?.bool != null || (type === 'all' && key == null)) {
+	if (callbacks?.bool != null || (type === FIND_VALUES_ALL && key == null)) {
 		const callback = callbacks?.bool ?? (item => Object.is(item, value));
 
 		for (let index = 0; index < length; index += 1) {
@@ -113,7 +113,10 @@ export function findValues(
 		const item = array[index];
 		const keyed = callbacks?.keyed?.(item, index, array) ?? item;
 
-		if ((type === 'all' && Object.is(keyed, value)) || (type === 'unique' && !keys.has(keyed))) {
+		if (
+			(type === FIND_VALUES_ALL && Object.is(keyed, value)) ||
+			(type === FIND_VALUES_UNIQUE && !keys.has(keyed))
+		) {
 			keys.add(keyed);
 			result.matched.push(mapCallback?.(item, index, array) ?? item);
 		} else {
@@ -138,6 +141,14 @@ function getParameters(original: unknown[]): Parameters {
 
 // #region Variables
 
+export const FIND_VALUE_INDEX: FindValueType = 'index';
+
+export const FIND_VALUE_VALUE: FindValueType = 'value';
+
+export const FIND_VALUES_ALL: FindValuesType = 'all';
+
+export const FIND_VALUES_UNIQUE: FindValuesType = 'unique';
+
 const UNIQUE_THRESHOLD = 100;
 
 // #endregion

package/src/internal/array/sets.ts

@@ -0,0 +1,74 @@
+import {getArrayCallback} from './callbacks';
+
+// #region Types
+
+type CompareSetsType = 'difference' | 'intersection' | 'union';
+
+// #endregion
+
+// #region Functions
+
+export function compareSets(
+	type: CompareSetsType,
+	first: unknown[],
+	second: unknown[],
+	key?: unknown,
+): unknown[] {
+	if (!Array.isArray(first)) {
+		return [];
+	}
+
+	const isDifference = type === COMPARE_SETS_DIFFERENCE;
+	const isIntersection = type === COMPARE_SETS_INTERSECTION;
+	const isUnion = type === COMPARE_SETS_UNION;
+
+	if (first.length === 0) {
+		return isDifference ? [...first] : isIntersection ? [] : [...second];
+	}
+
+	if (!Array.isArray(second) || second.length === 0) {
+		return isIntersection ? [] : [...first];
+	}
+
+	const callback = getArrayCallback(key);
+
+	const values = isUnion ? first : second;
+	let {length} = values;
+
+	const set = new Set<unknown>([]);
+
+	for (let index = 0; index < length; index += 1) {
+		const item = values[index];
+
+		set.add(callback?.(item, index, values) ?? item);
+	}
+
+	const source = isUnion ? second : first;
+
+	length = source.length;
+
+	const result: unknown[] = isUnion ? [...first] : [];
+
+	for (let index = 0; index < length; index += 1) {
+		const item = source[index];
+		const value = callback?.(item, index, source) ?? item;
+
+		if (isIntersection ? set.has(value) : !set.has(value)) {
+			result.push(item);
+		}
+	}
+
+	return result;
+}
+
+// #endregion
+
+// #region Variables
+
+export const COMPARE_SETS_DIFFERENCE: CompareSetsType = 'difference';
+
+export const COMPARE_SETS_INTERSECTION: CompareSetsType = 'intersection';
+
+export const COMPARE_SETS_UNION: CompareSetsType = 'union';
+
+// #endregion

package/src/value/merge.ts

@@ -89,8 +89,24 @@ function handleMerge(values: ArrayOrPlainObject[], options: Options): ArrayOrPla
 export function merge<Model extends ArrayOrPlainObject>(
 	values: NestedPartial<Model>[],
 	options?: MergeOptions,
-): Model {
-	return handleMerge(values, getMergeOptions(options)) as Model;
+): Model;
+
+/**
+ * Merge multiple arrays or objects into a single one
+ * @param values Values to merge
+ * @param options Merging options
+ * @returns Merged value
+ */
+export function merge(
+	values: NestedPartial<ArrayOrPlainObject>[],
+	options?: MergeOptions,
+): ArrayOrPlainObject;
+
+export function merge(
+	values: NestedPartial<ArrayOrPlainObject>[],
+	options?: MergeOptions,
+): ArrayOrPlainObject {
+	return handleMerge(values, getMergeOptions(options));
 }
 
 merge.initialize = initializeMerger;

package/types/array/difference.d.ts

@@ -0,0 +1,24 @@
+import type { PlainObject } from '../models';
+/**
+ * Get the items from the first array that are not in the second array
+ * @param first First array
+ * @param second Second array
+ * @param callback Callback to get an item's value for comparison
+ * @returns Unique values from the first array
+ */
+export declare function difference<First, Second>(first: First[], second: Second[], callback: (item: First | Second) => unknown): First[];
+/**
+ * Get the items from the first array that are not in the second array
+ * @param first First array
+ * @param second Second array
+ * @param key Key to get an item's value for comparison
+ * @returns Unique values from the first array
+ */
+export declare function difference<First extends PlainObject, Second extends PlainObject, Key extends keyof First & keyof Second>(first: First[], second: Second[], key: Key): First[];
+/**
+ * Get the items from the first array that are not in the second array
+ * @param first First array
+ * @param second Second array
+ * @returns Unique values from the first array
+ */
+export declare function difference<First, Second>(first: First[], second: Second[]): First[];

package/types/array/{misc.d.ts → index.d.ts}

@@ -1,6 +1,7 @@
 export * from '../internal/array/chunk';
 export * from '../internal/array/compact';
 export * from '../internal/array/shuffle';
+export * from './difference';
 export * from './exists';
 export * from './filter';
 export * from './find';
@@ -9,6 +10,7 @@ export * from './from';
 export * from './get';
 export * from './index-of';
 export * from './insert';
+export * from './intersection';
 export * from './partition';
 export * from './push';
 export * from './select';
@@ -16,4 +18,5 @@ export * from './sort';
 export * from './splice';
 export * from './to-set';
 export * from './toggle';
+export * from './union';
 export * from './update';

package/types/array/intersection.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Get the common values between two arrays
+ * @param first First array
+ * @param second Second array
+ * @param callback Callback to get an item's value for comparison
+ * @returns Common values from both arrays
+ */
+export declare function intersection<First, Second>(first: First[], second: Second[], callback: (item: First | Second) => unknown): First[];
+/**
+ * Get the common values between two arrays
+ * @param first First array
+ * @param second Second array
+ * @param key Key to get an item's value for comparison
+ * @returns Common values from both arrays
+ */
+export declare function intersection<First extends Record<string, unknown>, Second extends Record<string, unknown>, Key extends keyof First & keyof Second>(first: First[], second: Second[], key: Key): First[];
+/**
+ * Get the common values between two arrays
+ * @param first First array
+ * @param second Second array
+ * @returns Common values from both arrays
+ */
+export declare function intersection<First, Second>(first: First[], second: Second[]): First[];

package/types/array/union.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Get the combined, unique values from two arrays
+ * @param first First array
+ * @param second Second array
+ * @param callback Callback to get an item's value for comparison
+ * @returns Combined, unique values from both arrays
+ */
+export declare function union<First, Second>(first: First[], second: Second[], callback: (item: First | Second) => unknown): (First | Second)[];
+/**
+ * Get the combined, unique values from two arrays
+ * @param first First array
+ * @param second Second array
+ * @param key Key to get an item's value for comparison
+ * @returns Combined, unique values from both arrays
+ */
+export declare function union<First extends Record<string, unknown>, Second extends Record<string, unknown>, Key extends keyof First & keyof Second>(first: First[], second: Second[], key: Key): (First | Second)[];
+/**
+ * Get the combined, unique values from two arrays
+ * @param first First array
+ * @param second Second array
+ * @returns Combined, unique values from both arrays
+ */
+export declare function union<First, Second>(first: First[], second: Second[]): (First | Second)[];

package/types/index.d.ts

@@ -1,5 +1,5 @@
 export * from './array/group-by';
-export * from './array/misc';
+export * from './array/index';
 export * from './array/to-map';
 export * from './array/to-record';
 export * from './array/unique';
@@ -14,16 +14,13 @@ export * from './internal/value/get';
 export * from './internal/value/has';
 export * from './internal/value/set';
 export * from './string/case';
+export * from './string/index';
 export * from './string/match';
-export * from './string/misc';
 export * from './string/template';
 export * from './value/clone';
 export * from './value/diff';
+export * from './value/index';
 export * from './value/merge';
-export * from './value/omit';
-export * from './value/pick';
-export * from './value/smush';
-export * from './value/unsmush';
 export * from './beacon';
 export * from './color';
 export * from './is';

package/types/internal/array/find.d.ts

@@ -6,4 +6,8 @@ type FindValuesResult = {
 type FindValuesType = 'all' | 'unique';
 export declare function findValue(type: FindValueType, array: unknown[], parameters: unknown[]): unknown;
 export declare function findValues(type: FindValuesType, array: unknown[], parameters: unknown[], mapper?: unknown): FindValuesResult;
+export declare const FIND_VALUE_INDEX: FindValueType;
+export declare const FIND_VALUE_VALUE: FindValueType;
+export declare const FIND_VALUES_ALL: FindValuesType;
+export declare const FIND_VALUES_UNIQUE: FindValuesType;
 export {};

package/types/internal/array/sets.d.ts

@@ -0,0 +1,6 @@
+type CompareSetsType = 'difference' | 'intersection' | 'union';
+export declare function compareSets(type: CompareSetsType, first: unknown[], second: unknown[], key?: unknown): unknown[];
+export declare const COMPARE_SETS_DIFFERENCE: CompareSetsType;
+export declare const COMPARE_SETS_INTERSECTION: CompareSetsType;
+export declare const COMPARE_SETS_UNION: CompareSetsType;
+export {};

package/types/value/merge.d.ts

@@ -32,6 +32,13 @@ export type Merger<Model extends ArrayOrPlainObject = ArrayOrPlainObject> = (val
  * @returns Merged value
  */
 export declare function merge<Model extends ArrayOrPlainObject>(values: NestedPartial<Model>[], options?: MergeOptions): Model;
+/**
+ * Merge multiple arrays or objects into a single one
+ * @param values Values to merge
+ * @param options Merging options
+ * @returns Merged value
+ */
+export declare function merge(values: NestedPartial<ArrayOrPlainObject>[], options?: MergeOptions): ArrayOrPlainObject;
 export declare namespace merge {
     var initialize: typeof initializeMerger;
 }