@oscarpalmer/atoms 0.143.0 → 0.145.0

package/dist/array/filter.js

@@ -1,5 +1,9 @@
 import { findValues } from "../internal/array/find.js";
 function filter(array, ...parameters) {
-	return findValues("all", array, parameters);
+	return findValues("all", array, parameters).matched;
+}
+filter.remove = removeFiltered;
+function removeFiltered(array, ...parameters) {
+	return findValues("all", array, parameters).notMatched;
 }
 export { filter };

package/dist/array/partition.js

@@ -0,0 +1,6 @@
+import { findValues } from "../internal/array/find.js";
+function partition(array, ...parameters) {
+	const { matched, notMatched } = findValues("all", array, parameters);
+	return [matched, notMatched];
+}
+export { partition };

package/dist/array/range.js

@@ -0,0 +1,6 @@
+function range(length, value) {
+	if (typeof length !== "number" || length <= 0) return [];
+	const isFunction = typeof value === "function";
+	return Array.from({ length }, (_, index) => isFunction ? value(index) : value ?? index);
+}
+export { range };

package/dist/array/select.js

@@ -0,0 +1,5 @@
+import { findValues } from "../internal/array/find.js";
+function select(array, ...parameters) {
+	return findValues("all", array, parameters, parameters.pop()).matched;
+}
+export { select };

package/dist/array/toggle.js

@@ -0,0 +1,5 @@
+import { updateInArray } from "../internal/array/update.js";
+function toggle(array, values, key) {
+	return updateInArray(array, values, key, false);
+}
+export { toggle };

package/dist/array/unique.js

@@ -1,6 +1,6 @@
 import { 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]) : array;
+	return array.length > 1 ? findValues("unique", array, [key, void 0]).matched : array;
 }
 export { unique };

package/dist/array/update.js

@@ -0,0 +1,5 @@
+import { updateInArray } from "../internal/array/update.js";
+function update(array, values, key) {
+	return updateInArray(array, values, key, true);
+}
+export { update };

package/dist/atoms.full.js

@@ -57,27 +57,39 @@ function findValueInArray(array, callback, value, findIndex) {
 	}
 	return findIndex ? -1 : void 0;
 }
-function findValues(type, array, parameters) {
-	if (!Array.isArray(array)) return [];
-	if (array.length === 0) return [];
+function findValues(type, array, parameters, mapper) {
+	const result = {
+		matched: [],
+		notMatched: []
+	};
+	if (!Array.isArray(array) || array.length === 0) return result;
 	const { length } = array;
 	const { bool, key, value } = getParameters(parameters);
 	const callbacks = getArrayCallbacks(bool, key);
-	if (type === "unique" && callbacks?.keyed == null && length >= UNIQUE_THRESHOLD) return [...new Set(array)];
-	if (callbacks?.bool != null) return array.filter(callbacks.bool);
-	if (type === "all" && key == null) return array.filter((item) => item === value);
+	if (type === "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) {
+		const callback = callbacks?.bool ?? ((item) => Object.is(item, value));
+		for (let index = 0; index < length; index += 1) {
+			const item = array[index];
+			if (callback(item, index, array)) result.matched.push(mapCallback?.(item, index, array) ?? item);
+			else result.notMatched.push(item);
+		}
+		return result;
+	}
 	const keys = /* @__PURE__ */ new Set();
-	const values = [];
 	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)) {
 			keys.add(keyed);
-			values.push(item);
-		}
+			result.matched.push(mapCallback?.(item, index, array) ?? item);
+		} else result.notMatched.push(item);
 	}
-	keys.clear();
-	return values;
+	return result;
 }
 function getParameters(original) {
 	const { length } = original;
@@ -93,7 +105,11 @@ function exists(array, ...parameters) {
 	return findValue("index", array, parameters) > -1;
 }
 function filter(array, ...parameters) {
-	return findValues("all", array, parameters);
+	return findValues("all", array, parameters).matched;
+}
+filter.remove = removeFiltered;
+function removeFiltered(array, ...parameters) {
+	return findValues("all", array, parameters).notMatched;
 }
 function find(array, ...parameters) {
 	return findValue("value", array, parameters);
@@ -257,6 +273,10 @@ 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 partition(array, ...parameters) {
+	const { matched, notMatched } = findValues("all", array, parameters);
+	return [matched, notMatched];
+}
 /**
 * Push items into an array _(at the end)_
 * @param array Original array
@@ -266,6 +286,14 @@ function insert(array, indexOrItems, items) {
 function push(array, pushed) {
 	return insertValues("push", array, pushed, array.length, 0);
 }
+function range(length, value) {
+	if (typeof length !== "number" || length <= 0) return [];
+	const isFunction = typeof value === "function";
+	return Array.from({ length }, (_, index) => isFunction ? value(index) : value ?? index);
+}
+function select(array, ...parameters) {
+	return findValues("all", array, parameters, parameters.pop()).matched;
+}
 function aggregate(type, array, key) {
 	const length = Array.isArray(array) ? array.length : 0;
 	if (length === 0) return {
@@ -590,9 +618,35 @@ function toSet(array, value) {
 	for (let index = 0; index < length; index += 1) set.add(callbacks.value(array[index], index, array));
 	return set;
 }
+function updateInArray(array, items, key, replace) {
+	if (!Array.isArray(array)) return [];
+	const itemsIsArray = Array.isArray(items);
+	if (array.length === 0 || !itemsIsArray) {
+		if (itemsIsArray) array.push(...items);
+		return array;
+	}
+	const { length } = items;
+	if (length === 0) return array;
+	const callback = getArrayCallback(key);
+	for (let valuesIndex = 0; valuesIndex < length; valuesIndex += 1) {
+		const item = items[valuesIndex];
+		const value = callback?.(item) ?? item;
+		const arrayIndex = callback == null ? array.indexOf(value) : array.findIndex((arrayItem, arrayIndex) => callback(arrayItem, arrayIndex, array) === value);
+		if (arrayIndex === -1) array.push(item);
+		else if (replace) array[arrayIndex] = item;
+		else array.splice(arrayIndex, 1);
+	}
+	return array;
+}
+function toggle(array, values, key) {
+	return updateInArray(array, values, key, false);
+}
 function unique(array, key) {
 	if (!Array.isArray(array)) return [];
-	return array.length > 1 ? findValues("unique", array, [key, void 0]) : array;
+	return array.length > 1 ? findValues("unique", array, [key, void 0]).matched : array;
+}
+function update(array, values, key) {
+	return updateInArray(array, values, key, true);
 }
 function getLimiter(callback, throttler, time) {
 	const interval = typeof time === "number" && time >= frame_rate_default ? time : frame_rate_default;
@@ -847,6 +901,64 @@ const DEFAULT_CACHE_SIZE = 1024;
 function throttle(callback, time) {
 	return getLimiter(callback, true, time);
 }
+function assert(condition, message, error) {
+	if (!condition()) throw new (error ?? Error)(message);
+}
+assert.condition = (condition, message, error) => {
+	return (value) => {
+		assert(() => condition(value), message, error);
+	};
+};
+assert.instanceOf = (constructor, message, error) => {
+	return (value) => {
+		assert(() => value instanceof constructor, message, error);
+	};
+};
+assert.is = (condition, message, error) => {
+	return (value) => {
+		assert(() => condition(value), message, error);
+	};
+};
+function asyncFlow(...fns) {
+	assertFlowFunctions(fns);
+	return (...args) => asyncWork(args, fns, true);
+}
+function flow(...fns) {
+	assertFlowFunctions(fns);
+	return (...args) => work(args, fns, true);
+}
+flow.async = asyncFlow;
+async function asyncPipe(value, ...pipes) {
+	assertPipeFunctions(pipes);
+	return asyncWork(value, pipes, false);
+}
+function pipe(value, ...pipes) {
+	assertPipeFunctions(pipes);
+	return work(value, pipes, false);
+}
+pipe.async = asyncPipe;
+async function asyncWork(initial, functions, flow) {
+	const { length } = functions;
+	let transformed = initial;
+	for (let index = 0; index < length; index += 1) {
+		const fn = functions[index];
+		transformed = flow && index === 0 && Array.isArray(initial) ? await fn(...initial) : await fn(transformed);
+	}
+	return transformed;
+}
+function work(initial, functions, flow) {
+	const { length } = functions;
+	let transformed = initial;
+	for (let index = 0; index < length; index += 1) {
+		const fn = functions[index];
+		transformed = flow && index === 0 && Array.isArray(initial) ? fn(...initial) : fn(transformed);
+	}
+	return transformed;
+}
+const MESSAGE_FLOW = "Flow expected to receive an array of functions";
+const MESSAGE_PIPE = "Pipe expected to receive an array of functions";
+const assertFlowFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_FLOW, TypeError);
+const assertPipeFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_PIPE, TypeError);
 function _getRandomFloat(inclusive, minimum, maximum) {
 	let maxFloat = isNumber(maximum) && maximum <= Number.MAX_SAFE_INTEGER ? maximum : Number.MAX_SAFE_INTEGER;
 	let minFloat = isNumber(minimum) && minimum >= Number.MIN_SAFE_INTEGER ? minimum : Number.MIN_SAFE_INTEGER;
@@ -1583,10 +1695,12 @@ function setChanges(parameters) {
 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;
 }
@@ -1629,7 +1743,7 @@ function mergeObjects(values, options, prefix) {
 			const full = join([prefix, key], ".");
 			const next = item[key];
 			const previous = merged[key];
-			if (isArray && options.skipNullableInArrays && next == null) continue;
+			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;
 		}
@@ -2574,6 +2688,15 @@ function isEmpty(value) {
 	return true;
 }
 /**
+* Is the value an instance of the constructor?
+* @param constructor Class constructor
+* @param value Value to check
+* @returns `true` if the value is an instance of the constructor, otherwise `false`
+*/
+function isInstanceOf(constructor, value) {
+	return isConstructor(constructor) && value instanceof constructor;
+}
+/**
 * Is the value not `undefined` or `null`?
 * @param value Value to check
 * @returns `true` if the value is not `undefined` or `null`, otherwise `false`
@@ -2746,6 +2869,15 @@ function average(array, key) {
 	const aggregated = aggregate("average", array, key);
 	return aggregated.count > 0 ? aggregated.value / aggregated.count : NaN;
 }
+/**
+* Round a number up
+* @param value Number to round up
+* @param decimals Number of decimal places to round to _(defaults to `0`)_
+* @returns Rounded number, or `NaN` if the value if unable to be rounded
+*/
+function ceil(value, decimals) {
+	return roundNumber(Math.ceil, value, decimals);
+}
 function count(array, key, value) {
 	if (!Array.isArray(array)) return NaN;
 	const { length } = array;
@@ -2758,6 +2890,15 @@ function count(array, key, value) {
 	}
 	return counted;
 }
+/**
+* Round a number down
+* @param value Number to round down
+* @param decimals Number of decimal places to round to _(defaults to `0`)_
+* @returns Rounded number, or `NaN` if the value if unable to be rounded
+*/
+function floor(value, decimals) {
+	return roundNumber(Math.floor, value, decimals);
+}
 function median(array, key) {
 	let length = Array.isArray(array) ? array.length : 0;
 	if (!Array.isArray(array) || length === 0) return NaN;
@@ -2784,10 +2925,13 @@ function min(array, key) {
 * @returns Rounded number, or `NaN` if the value if unable to be rounded
 */
 function round(value, decimals) {
+	return roundNumber(Math.round, value, decimals);
+}
+function roundNumber(callback, value, decimals) {
 	if (typeof value !== "number") return NaN;
-	if (typeof decimals !== "number" || decimals < 1) return Math.round(value);
+	if (typeof decimals !== "number" || decimals < 1) return callback(value);
 	const mod = 10 ** decimals;
-	return Math.round((value + Number.EPSILON) * mod) / mod;
+	return callback((value + Number.EPSILON) * mod) / mod;
 }
 function sum(array, key) {
 	return getAggregated("sum", array, key);
@@ -2816,6 +2960,31 @@ var PromiseTimeoutError = class extends Error {
 		this.name = ERROR_NAME$1;
 	}
 };
+async function attemptPromise(value, options) {
+	const isFunction = typeof value === "function";
+	if (!isFunction && !(value instanceof Promise)) return Promise.reject(new TypeError(MESSAGE_EXPECTATION_ATTEMPT));
+	const { signal, time } = getPromiseOptions(options);
+	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
+	function abort() {
+		rejector(signal.reason);
+	}
+	async function handler(resolve, reject) {
+		try {
+			let result = isFunction ? value() : await value;
+			if (result instanceof Promise) result = await result;
+			settlePromise(abort, resolve, result, signal);
+		} catch (error) {
+			settlePromise(abort, reject, error, signal);
+		}
+	}
+	let rejector;
+	signal?.addEventListener(EVENT_NAME$1, abort, ABORT_OPTIONS);
+	const promise = new Promise((resolve, reject) => {
+		rejector = reject;
+		handler(resolve, reject);
+	});
+	return time > 0 ? getTimed(promise, time, signal) : promise;
+}
 /**
 * Create a cancelable promise
 * @param executor Executor function for the promise
@@ -2976,31 +3145,6 @@ async function timed(promise, options) {
 	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
 	return time > 0 ? getTimed(promise, time, signal) : promise;
 }
-async function attemptPromise(value, options) {
-	const isFunction = typeof value === "function";
-	if (!isFunction && !(value instanceof Promise)) return Promise.reject(new TypeError(MESSAGE_EXPECTATION_ATTEMPT));
-	const { signal, time } = getPromiseOptions(options);
-	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
-	function abort() {
-		rejector(signal.reason);
-	}
-	async function handler(resolve, reject) {
-		try {
-			let result = isFunction ? value() : await value;
-			if (result instanceof Promise) result = await result;
-			settlePromise(abort, resolve, result, signal);
-		} catch (error) {
-			settlePromise(abort, reject, error, signal);
-		}
-	}
-	let rejector;
-	signal?.addEventListener(EVENT_NAME$1, abort, ABORT_OPTIONS);
-	const promise = new Promise((resolve, reject) => {
-		rejector = reject;
-		handler(resolve, reject);
-	});
-	return time > 0 ? getTimed(promise, time, signal) : promise;
-}
 const ABORT_OPTIONS = { once: true };
 const DEFAULT_STRATEGY = "complete";
 const ERROR_NAME$1 = "PromiseTimeoutError";
@@ -3343,6 +3487,24 @@ function _isResult(value, okValue) {
 	if (!isPlainObject(value)) return false;
 	return value.ok === okValue && (okValue ? "value" : "error") in value;
 }
+async function asyncAttempt(value, err) {
+	try {
+		let result = typeof value === "function" ? value() : await value;
+		if (result instanceof Promise) result = await result;
+		return ok(result);
+	} catch (thrown) {
+		return getError(err ?? thrown, err == null ? void 0 : thrown);
+	}
+}
+function attempt(callback, err) {
+	try {
+		return ok(callback());
+	} catch (thrown) {
+		return getError(err ?? thrown, err == null ? void 0 : thrown);
+	}
+}
+attempt.async = asyncAttempt;
+attempt.promise = attemptPromise;
 function error(value, original) {
 	return getError(value, original);
 }
@@ -3384,22 +3546,6 @@ function ok(value) {
 		value
 	};
 }
-function attempt(callback, err) {
-	try {
-		return ok(callback());
-	} catch (thrown) {
-		return getError(err ?? thrown, err == null ? void 0 : thrown);
-	}
-}
-attempt.async = asyncAttempt;
-attempt.promise = attemptPromise;
-async function asyncAttempt(value, err) {
-	try {
-		return ok(await (typeof value === "function" ? value() : value));
-	} catch (thrown) {
-		return getError(err ?? thrown, err == null ? void 0 : thrown);
-	}
-}
 function unwrap(value, defaultValue) {
 	return isOk(value) ? value.value : defaultValue;
 }
@@ -3455,4 +3601,4 @@ var SizedSet = class extends Set {
 		}
 	}
 };
-export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, 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, pascalCase, pick, promises, push, queue, rgbToHex, rgbToHsl, rgbToHsla, round, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, titleCase, toMap, toQuery, toRecord, toSet, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, upperCase, words };
+export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, 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, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, 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, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, titleCase, toMap, toQuery, toRecord, toSet, toggle, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, update, upperCase, words };

package/dist/function/assert.js

@@ -0,0 +1,19 @@
+function assert(condition, message, error) {
+	if (!condition()) throw new (error ?? Error)(message);
+}
+assert.condition = (condition, message, error) => {
+	return (value) => {
+		assert(() => condition(value), message, error);
+	};
+};
+assert.instanceOf = (constructor, message, error) => {
+	return (value) => {
+		assert(() => value instanceof constructor, message, error);
+	};
+};
+assert.is = (condition, message, error) => {
+	return (value) => {
+		assert(() => condition(value), message, error);
+	};
+};
+export { assert };

package/dist/function/work.js

@@ -0,0 +1,42 @@
+import { assert } from "./assert.js";
+function asyncFlow(...fns) {
+	assertFlowFunctions(fns);
+	return (...args) => asyncWork(args, fns, true);
+}
+function flow(...fns) {
+	assertFlowFunctions(fns);
+	return (...args) => work(args, fns, true);
+}
+flow.async = asyncFlow;
+async function asyncPipe(value, ...pipes) {
+	assertPipeFunctions(pipes);
+	return asyncWork(value, pipes, false);
+}
+function pipe(value, ...pipes) {
+	assertPipeFunctions(pipes);
+	return work(value, pipes, false);
+}
+pipe.async = asyncPipe;
+async function asyncWork(initial, functions, flow) {
+	const { length } = functions;
+	let transformed = initial;
+	for (let index = 0; index < length; index += 1) {
+		const fn = functions[index];
+		transformed = flow && index === 0 && Array.isArray(initial) ? await fn(...initial) : await fn(transformed);
+	}
+	return transformed;
+}
+function work(initial, functions, flow) {
+	const { length } = functions;
+	let transformed = initial;
+	for (let index = 0; index < length; index += 1) {
+		const fn = functions[index];
+		transformed = flow && index === 0 && Array.isArray(initial) ? fn(...initial) : fn(transformed);
+	}
+	return transformed;
+}
+var MESSAGE_FLOW = "Flow expected to receive an array of functions";
+var MESSAGE_PIPE = "Pipe expected to receive an array of functions";
+var assertFlowFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_FLOW, TypeError);
+var assertPipeFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_PIPE, TypeError);
+export { flow, pipe };

package/dist/index.js

@@ -8,7 +8,10 @@ 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 { partition } from "./array/partition.js";
 import { push } from "./array/push.js";
+import { range } from "./array/range.js";
+import { select } from "./array/select.js";
 import { max } from "./internal/math/aggregate.js";
 import { compact } from "./internal/array/compact.js";
 import { getString, ignoreKey, join, tryDecode, tryEncode, words } from "./internal/string.js";
@@ -18,7 +21,9 @@ import { splice } from "./array/splice.js";
 import { toMap } from "./array/to-map.js";
 import { toRecord } from "./array/to-record.js";
 import { toSet } from "./array/to-set.js";
+import { toggle } from "./array/toggle.js";
 import { unique } from "./array/unique.js";
+import { update } from "./array/update.js";
 import { noop } from "./internal/function/misc.js";
 import { beacon } from "./beacon.js";
 import { between, clamp, getNumber } from "./internal/number.js";
@@ -33,6 +38,7 @@ import { debounce } from "./function/debounce.js";
 import { SizedMap } from "./sized/map.js";
 import { memoize } from "./function/memoize.js";
 import { throttle } from "./function/throttle.js";
+import { flow, pipe } from "./function/work.js";
 import { getRandomFloat, getRandomInteger } from "./internal/random.js";
 import { shuffle } from "./internal/array/shuffle.js";
 import { equal } from "./internal/value/equal.js";
@@ -49,13 +55,13 @@ 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 { isEmpty, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumerical, isObject, isPrimitive } from "./is.js";
+import { isEmpty, isInstanceOf, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumerical, isObject, isPrimitive } from "./is.js";
 import { logger } from "./logger.js";
-import { average, count, median, min, round, sum } from "./math.js";
+import { average, ceil, count, floor, median, min, round, sum } from "./math.js";
 import { CancelablePromise, PromiseTimeoutError, attemptPromise, cancelable, delay, isFulfilled, isRejected, promises, timed } from "./promise.js";
 import { fromQuery, toQuery } from "./query.js";
 import { QueueError, queue } from "./queue.js";
 import { getRandomBoolean, getRandomCharacters, getRandomColor, getRandomHex, getRandomItem, getRandomItems } from "./random.js";
 import { attempt, error, isError, isOk, isResult, ok, unwrap } from "./result.js";
 import { SizedSet } from "./sized/set.js";
-export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, 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, pascalCase, pick, promises, push, queue, rgbToHex, rgbToHsl, rgbToHsla, round, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, titleCase, toMap, toQuery, toRecord, toSet, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, upperCase, words };
+export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, 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, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, 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, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, titleCase, toMap, toQuery, toRecord, toSet, toggle, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, update, upperCase, words };

package/dist/internal/array/callbacks.js

@@ -13,4 +13,4 @@ function getArrayCallbacks(bool, key, value) {
 		value: getArrayCallback(value)
 	};
 }
-export { getArrayCallbacks };
+export { getArrayCallback, getArrayCallbacks };

package/dist/internal/array/find.js

@@ -19,27 +19,39 @@ function findValueInArray(array, callback, value, findIndex) {
 	}
 	return findIndex ? -1 : void 0;
 }
-function findValues(type, array, parameters) {
-	if (!Array.isArray(array)) return [];
-	if (array.length === 0) return [];
+function findValues(type, array, parameters, mapper) {
+	const result = {
+		matched: [],
+		notMatched: []
+	};
+	if (!Array.isArray(array) || array.length === 0) return result;
 	const { length } = array;
 	const { bool, key, value } = getParameters(parameters);
 	const callbacks = getArrayCallbacks(bool, key);
-	if (type === "unique" && callbacks?.keyed == null && length >= UNIQUE_THRESHOLD) return [...new Set(array)];
-	if (callbacks?.bool != null) return array.filter(callbacks.bool);
-	if (type === "all" && key == null) return array.filter((item) => item === value);
+	if (type === "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) {
+		const callback = callbacks?.bool ?? ((item) => Object.is(item, value));
+		for (let index = 0; index < length; index += 1) {
+			const item = array[index];
+			if (callback(item, index, array)) result.matched.push(mapCallback?.(item, index, array) ?? item);
+			else result.notMatched.push(item);
+		}
+		return result;
+	}
 	const keys = /* @__PURE__ */ new Set();
-	const values = [];
 	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)) {
 			keys.add(keyed);
-			values.push(item);
-		}
+			result.matched.push(mapCallback?.(item, index, array) ?? item);
+		} else result.notMatched.push(item);
 	}
-	keys.clear();
-	return values;
+	return result;
 }
 function getParameters(original) {
 	const { length } = original;

package/dist/internal/array/update.js

@@ -0,0 +1,22 @@
+import { getArrayCallback } from "./callbacks.js";
+function updateInArray(array, items, key, replace) {
+	if (!Array.isArray(array)) return [];
+	const itemsIsArray = Array.isArray(items);
+	if (array.length === 0 || !itemsIsArray) {
+		if (itemsIsArray) array.push(...items);
+		return array;
+	}
+	const { length } = items;
+	if (length === 0) return array;
+	const callback = getArrayCallback(key);
+	for (let valuesIndex = 0; valuesIndex < length; valuesIndex += 1) {
+		const item = items[valuesIndex];
+		const value = callback?.(item) ?? item;
+		const arrayIndex = callback == null ? array.indexOf(value) : array.findIndex((arrayItem, arrayIndex) => callback(arrayItem, arrayIndex, array) === value);
+		if (arrayIndex === -1) array.push(item);
+		else if (replace) array[arrayIndex] = item;
+		else array.splice(arrayIndex, 1);
+	}
+	return array;
+}
+export { updateInArray };

package/dist/is.js

@@ -15,6 +15,15 @@ function isEmpty(value) {
 	return true;
 }
 /**
+* Is the value an instance of the constructor?
+* @param constructor Class constructor
+* @param value Value to check
+* @returns `true` if the value is an instance of the constructor, otherwise `false`
+*/
+function isInstanceOf(constructor, value) {
+	return isConstructor(constructor) && value instanceof constructor;
+}
+/**
 * Is the value not `undefined` or `null`?
 * @param value Value to check
 * @returns `true` if the value is not `undefined` or `null`, otherwise `false`
@@ -72,4 +81,4 @@ function isPrimitive(value) {
 }
 var EXPRESSION_PRIMITIVE = /^(bigint|boolean|number|string|symbol)$/;
 var EXPRESSION_WHITESPACE = /^\s*$/;
-export { isArrayOrPlainObject, isConstructor, isEmpty, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isPlainObject, isPrimitive, isTypedArray };
+export { isArrayOrPlainObject, isConstructor, isEmpty, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isPlainObject, isPrimitive, isTypedArray };