@oscarpalmer/atoms 0.143.0 → 0.144.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;
@@ -1583,10 +1637,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 +1685,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;
 		}
@@ -2746,6 +2802,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 +2823,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 +2858,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);
@@ -3455,4 +3532,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, 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, partition, pascalCase, pick, 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/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";
@@ -51,11 +56,11 @@ 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 { 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, 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, partition, pascalCase, pick, 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/math.js

@@ -4,6 +4,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;
@@ -16,6 +25,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;
@@ -42,12 +60,15 @@ 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);
 }
-export { average, count, max, median, min, round, sum };
+export { average, ceil, count, floor, max, median, min, round, sum };

package/dist/value/merge.js

@@ -3,10 +3,12 @@ import { join } from "../internal/string.js";
 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;
 }
@@ -49,7 +51,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;
 		}

package/package.json

@@ -62,10 +62,22 @@
 			"types": "./types/array/insert.d.ts",
 			"default": "./dist/array/insert.js"
 		},
+		"./array/partition": {
+			"types": "./types/array/partition.d.ts",
+			"default": "./dist/array/partition.js"
+		},
 		"./array/push": {
 			"types": "./types/array/push.d.ts",
 			"default": "./dist/array/push.js"
 		},
+		"./array/range": {
+			"types": "./types/array/range.d.ts",
+			"default": "./dist/array/range.js"
+		},
+		"./array/select": {
+			"types": "./types/array/select.d.ts",
+			"default": "./dist/array/select.js"
+		},
 		"./array/sort": {
 			"types": "./types/array/sort.d.ts",
 			"default": "./dist/array/sort.js"
@@ -86,10 +98,18 @@
 			"types": "./types/array/to-set.d.ts",
 			"default": "./dist/array/to-set.js"
 		},
+		"./array/toggle": {
+			"types": "./types/array/toggle.d.ts",
+			"default": "./dist/array/toggle.js"
+		},
 		"./array/unique": {
 			"types": "./types/array/unique.d.ts",
 			"default": "./dist/array/unique.js"
 		},
+		"./array/update": {
+			"types": "./types/array/update.d.ts",
+			"default": "./dist/array/update.js"
+		},
 		"./beacon": {
 			"types": "./types/beacon.d.ts",
 			"default": "./dist/beacon.js"
@@ -236,5 +256,5 @@
 	},
 	"type": "module",
 	"types": "./types/index.d.ts",
-	"version": "0.143.0"
+	"version": "0.144.0"
 }

package/src/array/exists.ts

@@ -10,11 +10,10 @@ import type {PlainObject} from '../models';
  * @param value Value to match against
  * @returns `true` if the item exists in the array, otherwise `false`
  */
-export function exists<Item>(
-	array: Item[],
-	callback: (item: Item, index: number, array: Item[]) => unknown,
-	value: unknown,
-): boolean;
+export function exists<
+	Item,
+	Callback extends (item: Item, index: number, array: Item[]) => unknown,
+>(array: Item[], callback: Callback, value: ReturnType<Callback>): boolean;
 
 /**
  * Does an item with a specific value exist in the array?
@@ -23,10 +22,10 @@ export function exists<Item>(
  * @param value Value to match against
  * @returns `true` if the item exists in the array, otherwise `false`
  */
-export function exists<Item extends PlainObject>(
+export function exists<Item extends PlainObject, Key extends keyof Item>(
 	array: Item[],
-	key: keyof Item,
-	value: unknown,
+	key: Key,
+	value: Item[Key],
 ): boolean;
 
 /**

package/src/array/filter.ts

@@ -10,11 +10,10 @@ import type {PlainObject} from '../models';
  * @param value Value to match against
  * @returns Filtered array of items
  */
-export function filter<Item>(
-	array: Item[],
-	callback: (item: Item, index: number, array: Item[]) => unknown,
-	value: unknown,
-): Item[];
+export function filter<
+	Item,
+	Callback extends (item: Item, index: number, array: Item[]) => unknown,
+>(array: Item[], callback: Callback, value: ReturnType<Callback>): Item[];
 
 /**
  * Get a filtered array of items
@@ -23,10 +22,10 @@ export function filter<Item>(
  * @param value Value to match against
  * @returns Filtered array of items
  */
-export function filter<Item extends PlainObject>(
+export function filter<Item extends PlainObject, Key extends keyof Item>(
 	array: Item[],
-	key: keyof Item,
-	value: unknown,
+	key: Key,
+	value: Item[Key],
 ): Item[];
 
 /**
@@ -49,7 +48,31 @@ 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);
+	return findValues('all', array, parameters).matched;
+}
+
+filter.remove = removeFiltered;
+
+function removeFiltered<
+	Item,
+	Callback extends (item: Item, index: number, array: Item[]) => unknown,
+>(array: Item[], callback: Callback, value: ReturnType<Callback>): unknown[];
+
+function removeFiltered<Item extends PlainObject, Key extends keyof Item>(
+	array: Item[],
+	key: Key,
+	value: Item[Key],
+): unknown[];
+
+function removeFiltered<Item>(
+	array: Item[],
+	filter: (item: Item, index: number, array: Item[]) => boolean,
+): unknown[];
+
+function removeFiltered<Item>(array: Item[], item: Item): unknown[];
+
+function removeFiltered(array: unknown[], ...parameters: unknown[]): unknown[] {
+	return findValues('all', array, parameters).notMatched;
 }
 
 // #endregion

package/src/array/find.ts

@@ -10,10 +10,10 @@ import type {PlainObject} from '../models';
  * @param value Value to match against
  * @returns First item that matches the value, or `undefined` if no match is found
  */
-export function find<Item>(
+export function find<Item, Callback extends (item: Item, index: number, array: Item[]) => unknown>(
 	array: Item[],
-	callback: (item: Item, index: number, array: Item[]) => unknown,
-	value: unknown,
+	callback: Callback,
+	value: ReturnType<Callback>,
 ): Item | undefined;
 
 /**
@@ -23,10 +23,10 @@ export function find<Item>(
  * @param value Value to match against
  * @returns First item that matches the value, or `undefined` if no match is found
  */
-export function find<Item extends PlainObject>(
+export function find<Item extends PlainObject, Key extends keyof Item>(
 	array: Item[],
-	key: keyof Item,
-	value: unknown,
+	key: Key,
+	value: Item[Key],
 ): Item | undefined;
 
 /**

package/src/array/index-of.ts

@@ -10,11 +10,10 @@ import type {PlainObject} from '../models';
  * @param value Value to match against
  * @returns Index of the first matching item, or `-1` if no match is found
  */
-export function indexOf<Item>(
-	array: Item[],
-	callback: (item: Item, index: number, array: Item[]) => unknown,
-	value: unknown,
-): number;
+export function indexOf<
+	Item,
+	Callback extends (item: Item, index: number, array: Item[]) => unknown,
+>(array: Item[], callback: Callback, value: ReturnType<Callback>): number;
 
 /**
  * Get the index of the first matching item by key
@@ -23,10 +22,10 @@ export function indexOf<Item>(
  * @param value Value to match against
  * @returns Index of the first matching item, or `-1` if no match is found
  */
-export function indexOf<Item extends PlainObject>(
+export function indexOf<Item extends PlainObject, Key extends keyof Item>(
 	array: Item[],
-	key: keyof Item,
-	value: unknown,
+	key: Key,
+	value: Item[Key],
 ): number;
 
 /**