@oscarpalmer/atoms 0.155.0 → 0.157.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,15 +7,18 @@ 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";
+import { drop, slice, take } from "./slice.js";
 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, drop, exists, filter, find, flatten, getArray, indexOf, insert, intersection, partition, push, range, select, shuffle, slice, sort, splice, take, 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/slice.js

@@ -0,0 +1,51 @@
+import { getArrayCallbacks } from "../internal/array/callbacks.js";
+function drop(array, first, second) {
+	return extract(EXTRACT_DROP, array, first, second);
+}
+function extract(type, array, first, second) {
+	if (!Array.isArray(array)) return [];
+	const { length } = array;
+	if (length === 0) return [];
+	const isTake = type === EXTRACT_TAKE;
+	if (typeof first === "number") {
+		if (Math.abs(first) >= length) return isTake ? array.slice() : [];
+		if (first === 0) return isTake ? [] : array.slice();
+		if (isTake) return first >= 0 ? array.slice(0, first) : array.slice(array.length + first);
+		return first >= 0 ? array.slice(first) : array.slice(0, array.length + first);
+	}
+	const callbacks = second == null ? getArrayCallbacks(first) : getArrayCallbacks(void 0, void 0, first);
+	const isBoolean = callbacks?.bool != null;
+	if (callbacks?.bool == null && callbacks?.value == null) return isTake ? array.slice() : [];
+	const extracted = [];
+	let push = false;
+	for (let index = 0; index < length; index += 1) {
+		const item = array[index];
+		const matches = isBoolean ? callbacks.bool(item, index, array) : Object.is(callbacks.value(item, index, array), second);
+		if (isTake) {
+			if (isBoolean ? !matches : matches) break;
+			extracted.push(item);
+			continue;
+		}
+		if (push) extracted.push(item);
+		else if (isBoolean ? !matches : matches) {
+			push = true;
+			if (isBoolean) extracted.push(item);
+		}
+	}
+	return extracted;
+}
+function slice(array, first, second) {
+	if (!Array.isArray(array) || array.length === 0) return [];
+	const firstIsNumber = typeof first === "number";
+	const secondIsNumber = typeof second === "number";
+	if (!firstIsNumber && !secondIsNumber) return array.slice();
+	if (!secondIsNumber) return first >= 0 ? array.slice(0, first) : array.slice(array.length + first);
+	if (!firstIsNumber) return array.slice();
+	return first >= 0 ? array.slice(first, second) : array.slice(array.length + first, array.length + second);
+}
+function take(array, first, second) {
+	return extract(EXTRACT_TAKE, array, first, second);
+}
+var EXTRACT_DROP = "drop";
+var EXTRACT_TAKE = "take";
+export { drop, slice, take };

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,8 +379,57 @@ 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 drop(array, first, second) {
+	return extract(EXTRACT_DROP, array, first, second);
+}
+function extract(type, array, first, second) {
+	if (!Array.isArray(array)) return [];
+	const { length } = array;
+	if (length === 0) return [];
+	const isTake = type === EXTRACT_TAKE;
+	if (typeof first === "number") {
+		if (Math.abs(first) >= length) return isTake ? array.slice() : [];
+		if (first === 0) return isTake ? [] : array.slice();
+		if (isTake) return first >= 0 ? array.slice(0, first) : array.slice(array.length + first);
+		return first >= 0 ? array.slice(first) : array.slice(0, array.length + first);
+	}
+	const callbacks = second == null ? getArrayCallbacks(first) : getArrayCallbacks(void 0, void 0, first);
+	const isBoolean = callbacks?.bool != null;
+	if (callbacks?.bool == null && callbacks?.value == null) return isTake ? array.slice() : [];
+	const extracted = [];
+	let push = false;
+	for (let index = 0; index < length; index += 1) {
+		const item = array[index];
+		const matches = isBoolean ? callbacks.bool(item, index, array) : Object.is(callbacks.value(item, index, array), second);
+		if (isTake) {
+			if (isBoolean ? !matches : matches) break;
+			extracted.push(item);
+			continue;
+		}
+		if (push) extracted.push(item);
+		else if (isBoolean ? !matches : matches) {
+			push = true;
+			if (isBoolean) extracted.push(item);
+		}
+	}
+	return extracted;
+}
+function slice(array, first, second) {
+	if (!Array.isArray(array) || array.length === 0) return [];
+	const firstIsNumber = typeof first === "number";
+	const secondIsNumber = typeof second === "number";
+	if (!firstIsNumber && !secondIsNumber) return array.slice();
+	if (!secondIsNumber) return first >= 0 ? array.slice(0, first) : array.slice(array.length + first);
+	if (!firstIsNumber) return array.slice();
+	return first >= 0 ? array.slice(first, second) : array.slice(array.length + first, array.length + second);
+}
+function take(array, first, second) {
+	return extract(EXTRACT_TAKE, array, first, second);
+}
+const EXTRACT_DROP = "drop";
+const EXTRACT_TAKE = "take";
 function aggregate(type, array, key) {
 	const length = Array.isArray(array) ? array.length : 0;
 	if (length === 0) return {
@@ -648,6 +735,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 +774,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 +1617,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 +1671,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 +1966,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 +2062,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 +3923,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, drop, 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, slice, smush, snakeCase, sort, splice, startsWith, sum, take, 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,13 +9,15 @@ 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";
+import { drop, slice, take } from "./array/slice.js";
 import { max } from "./internal/math/aggregate.js";
 import { getString, ignoreKey, join, tryDecode, tryEncode, words } from "./internal/string.js";
 import { compare } from "./internal/value/compare.js";
@@ -22,8 +25,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 +51,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 +76,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, drop, 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, slice, smush, snakeCase, sort, splice, startsWith, sum, take, 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 };