@oscarpalmer/atoms 0.176.0 → 0.178.0

package/dist/index.mjs

@@ -16,26 +16,34 @@ function getArrayCallbacks(bool, key, value) {
 }
 //#endregion
 //#region src/internal/array/find.ts
-function findValue(type, array, parameters) {
+function findValue(type, array, parameters, reversed) {
 	const findIndex = type === FIND_VALUE_INDEX;
 	if (!Array.isArray(array) || array.length === 0) return findIndex ? -1 : void 0;
-	const { bool, key, value } = getParameters(parameters);
+	const { bool, key, value } = getFindParameters(parameters);
 	const callbacks = getArrayCallbacks(bool, key);
 	if (callbacks?.bool == null && callbacks?.keyed == null) return findIndex ? array.indexOf(value) : array.find((item) => Object.is(item, value));
 	if (callbacks.bool != null) {
 		const index = array.findIndex(callbacks.bool);
 		return findIndex ? index : array[index];
 	}
-	return findValueInArray(array, callbacks.keyed, value, findIndex);
+	return findValueInArray(array, callbacks.keyed, value, findIndex, reversed);
 }
-function findValueInArray(array, callback, value, findIndex) {
+function findValueInArray(array, callback, value, findIndex, reversed) {
 	const { length } = array;
 	for (let index = 0; index < length; index += 1) {
-		const item = array[index];
+		const item = reversed ? array.at(-(index + 1)) : array[index];
 		if (Object.is(callback?.(item, index, array), value)) return findIndex ? index : item;
 	}
 	return findIndex ? -1 : void 0;
 }
+function findAbsoluteValueOrDefault(array, parameters, defaultValue, useDefaultValue, reversed) {
+	if (parameters.length === 0) {
+		if (Array.isArray(array) && array.length > 0) return reversed ? array.at(-1) : array[0];
+		return useDefaultValue ? defaultValue : void 0;
+	}
+	const index = findValue(FIND_VALUE_INDEX, array, parameters, reversed);
+	return index > -1 ? array[index] : useDefaultValue ? defaultValue : void 0;
+}
 function findValues(type, array, parameters, mapper) {
 	const result = {
 		matched: [],
@@ -43,13 +51,13 @@ function findValues(type, array, parameters, mapper) {
 	};
 	if (!Array.isArray(array) || array.length === 0) return result;
 	const { length } = array;
-	const { bool, key, value } = getParameters(parameters);
+	const { bool, key, value } = getFindParameters(parameters);
 	const callbacks = getArrayCallbacks(bool, key);
 	if (type === "unique" && callbacks?.keyed == null && length >= UNIQUE_THRESHOLD) {
 		result.matched = [...new Set(array)];
 		return result;
 	}
-	const mapCallback = typeof mapper === "function" ? mapper : void 0;
+	const mapCallback = getArrayCallback(mapper);
 	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) {
@@ -70,7 +78,7 @@ function findValues(type, array, parameters, mapper) {
 	}
 	return result;
 }
-function getParameters(original) {
+function getFindParameters(original) {
 	const { length } = original;
 	return {
 		bool: length === 1 && typeof original[0] === "function" ? original[0] : void 0,
@@ -79,7 +87,7 @@ function getParameters(original) {
 	};
 }
 const FIND_VALUE_INDEX = "index";
-const FIND_VALUE_VALUE = "value";
+const FIND_VALUE_ITEM = "item";
 const FIND_VALUES_UNIQUE = "unique";
 const UNIQUE_THRESHOLD = 100;
 //#endregion
@@ -92,6 +100,15 @@ function removeFiltered(array, ...parameters) {
 	return findValues("all", array, parameters).notMatched;
 }
 //#endregion
+//#region src/array/first.ts
+function first(array, ...parameters) {
+	return findAbsoluteValueOrDefault(array, parameters, void 0, false, false);
+}
+first.default = firstOrDefault;
+function firstOrDefault(array, defaultValue, ...parameters) {
+	return findAbsoluteValueOrDefault(array, parameters, defaultValue, true, false);
+}
+//#endregion
 //#region src/internal/array/group.ts
 function groupValues(array, key, value, arrays) {
 	if (!Array.isArray(array) || array.length === 0) return {};
@@ -196,6 +213,71 @@ function isKey(value) {
 	return typeof value === "number" || typeof value === "string";
 }
 /**
+* Is the value not an array or a plain object?
+* @param value Value to check
+* @returns `true` if the value is not an array or a plain object, otherwise `false`
+*/
+function isNonArrayOrPlainObject(value) {
+	return !isArrayOrPlainObject(value);
+}
+/**
+* Is the value not a constructor function?
+* @param value Value to check
+* @returns `true` if the value is not a constructor function, otherwise `false`
+*/
+function isNonConstructor(value) {
+	return !isConstructor(value);
+}
+/**
+* Is the value not an instance of the constructor?
+* @param constructor Class constructor
+* @param value Value to check
+* @returns `true` if the value is not an instance of the constructor, otherwise `false`
+*/
+function isNonInstanceOf(constructor, value) {
+	return !isInstanceOf(constructor, value);
+}
+/**
+* Is the value not a key?
+* @param value Value to check
+* @returns `true` if the value is not a `Key` _(`number` or `string`)_, otherwise `false`
+*/
+function isNonKey(value) {
+	return !isKey(value);
+}
+/**
+* Is the value not a number?
+* @param value Value to check
+* @returns `true` if the value is not a `number`, otherwise `false`
+*/
+function isNonNumber(value) {
+	return !isNumber(value);
+}
+/**
+* Is the value not a plain object?
+* @param value Value to check
+* @returns `true` if the value is not a plain object, otherwise `false`
+*/
+function isNonPlainObject(value) {
+	return !isPlainObject(value);
+}
+/**
+* Is the value not a primitive value?
+* @param value Value to check
+* @returns `true` if the value is not a primitive value, otherwise `false`
+*/
+function isNonPrimitive(value) {
+	return !isPrimitive(value);
+}
+/**
+* Is the value not a typed array?
+* @param value Value to check
+* @returns `true` if the value is not a typed array, otherwise `false`
+*/
+function isNonTypedArray(value) {
+	return !isTypedArray(value);
+}
+/**
 * Is the value a number?
 * @param value Value to check
 * @returns `true` if the value is a `number`, otherwise `false`
@@ -220,7 +302,17 @@ function isPlainObject(value) {
 * @returns `true` if the value matches, otherwise `false`
 */
 function isPrimitive(value) {
-	return value == null || EXPRESSION_PRIMITIVE.test(typeof value);
+	if (value == null) return true;
+	const type = typeof value;
+	return type === "bigint" || type === "boolean" || type === "number" || type === "string" || type === "symbol";
+}
+/**
+* Is the value a template strings array?
+* @param value Value to check
+* @returns `true` if the value is a `TemplateStringsArray`, otherwise `false`
+*/
+function isTemplateStringsArray(value) {
+	return Array.isArray(value) && Array.isArray(value.raw);
 }
 /**
 * Is the value a typed array?
@@ -228,7 +320,7 @@ function isPrimitive(value) {
 * @returns `true` if the value is a typed array, otherwise `false`
 */
 function isTypedArray(value) {
-	TYPED_ARRAYS ??= new Set([
+	isTypedArray.types ??= new Set([
 		Int8Array,
 		Uint8Array,
 		Uint8ClampedArray,
@@ -241,10 +333,8 @@ function isTypedArray(value) {
 		BigInt64Array,
 		BigUint64Array
 	]);
-	return TYPED_ARRAYS.has(value?.constructor);
+	return isTypedArray.types.has(value?.constructor);
 }
-const EXPRESSION_PRIMITIVE = /^(bigint|boolean|number|string|symbol)$/;
-let TYPED_ARRAYS;
 //#endregion
 //#region src/internal/random.ts
 function _getRandomFloat(inclusive, minimum, maximum) {
@@ -329,12 +419,12 @@ function difference(first, second, key) {
 //#region src/array/exists.ts
 function exists(array, ...parameters) {
 	if (parameters.length === 1 && typeof parameters[0] !== "function") return Array.isArray(array) ? array.includes(parameters[0]) : false;
-	return findValue(FIND_VALUE_INDEX, array, parameters) > -1;
+	return findValue(FIND_VALUE_INDEX, array, parameters, false) > -1;
 }
 //#endregion
 //#region src/array/find.ts
 function find(array, ...parameters) {
-	return findValue(FIND_VALUE_VALUE, array, parameters);
+	return findValue(FIND_VALUE_ITEM, array, parameters, false);
 }
 //#endregion
 //#region src/array/flatten.ts
@@ -491,11 +581,34 @@ function push(array, pushed) {
 	return insertValues(INSERT_TYPE_PUSH, array, pushed, array.length, 0);
 }
 //#endregion
+//#region src/array/reverse.ts
+function reverse(array) {
+	if (!Array.isArray(array)) return [];
+	const { length } = array;
+	if (length < 2) return array;
+	const half = Math.floor(length / 2);
+	for (let firstIndex = 0; firstIndex < half; firstIndex += 1) {
+		const temporaryItem = array[firstIndex];
+		const secondIndex = length - 1 - firstIndex;
+		array[firstIndex] = array[secondIndex];
+		array[secondIndex] = temporaryItem;
+	}
+	return array;
+}
+//#endregion
 //#region src/array/select.ts
 function select(array, ...parameters) {
 	return findValues("all", array, parameters, parameters.pop()).matched;
 }
 //#endregion
+//#region src/array/single.ts
+function single(array, ...parameters) {
+	const { matched } = findValues("all", array, parameters);
+	if (matched.length > 1) throw new Error(MESSAGE);
+	return matched[0];
+}
+const MESSAGE = "Multiple items were found";
+//#endregion
 //#region src/array/slice.ts
 function drop(array, first, second) {
 	return extract(EXTRACT_DROP, array, first, second);
@@ -606,6 +719,15 @@ function update(array, values, key) {
 	return updateInArray(array, values, key, true);
 }
 //#endregion
+//#region src/array/last.ts
+function last(array, ...parameters) {
+	return findAbsoluteValueOrDefault(array, parameters, void 0, false, true);
+}
+last.default = lastOrDefault;
+function lastOrDefault(array, defaultValue, ...parameters) {
+	return findAbsoluteValueOrDefault(array, parameters, defaultValue, true, true);
+}
+//#endregion
 //#region src/internal/array/overlap.ts
 function arraysOverlap(first, second) {
 	const firstArray = first.index < second.index ? first.array : second.array;
@@ -2195,6 +2317,30 @@ let memoizedCapitalize;
 let memoizedTitleCase;
 //#endregion
 //#region src/string/index.ts
+function dedent(value, ...values) {
+	let actual;
+	if (isTemplateStringsArray(value)) actual = interpolate(value, values);
+	else actual = value;
+	if (typeof actual !== "string") return "";
+	const lines = actual.split("\n");
+	const { length } = lines;
+	if (length === 1) return actual.trim();
+	const lastIndex = length - 1;
+	const lengths = [];
+	for (let index = 0; index < length; index += 1) {
+		const [, indentation] = /^(\s+)/.exec(lines[index]) ?? [];
+		if (indentation != null) lengths.push(indentation.length);
+	}
+	if (lengths.length === 0) return actual.trim();
+	const minimum = Math.min(...lengths);
+	const pattern = new RegExp(`^\\s{0,${minimum}}`);
+	let result = "";
+	for (let index = 0; index < length; index += 1) {
+		const line = lines[index];
+		result += line.replace(pattern, "") + (index === lastIndex ? "" : "\n");
+	}
+	return result.trim();
+}
 /**
 * Get a new UUID-string _(version 4)_
 * @returns UUID string
@@ -2213,6 +2359,12 @@ function getUuid() {
 		hex.substring(20, 32)
 	].join("-");
 }
+function interpolate(strings, values) {
+	const { length } = strings;
+	let interpolated = "";
+	for (let index = 0; index < length; index += 1) interpolated += `${strings[index]}${getString(values[index])}`;
+	return interpolated;
+}
 /**
 * Parse a JSON string into its proper value _(or `undefined` if it fails)_
 * @param value JSON string to parse
@@ -3600,6 +3752,14 @@ function isEmpty(value) {
 	return true;
 }
 /**
+* Is the value not empty, or holding non-empty values?
+* @param value Value to check
+* @returns `true` if the value is not considered empty, otherwise `false`
+*/
+function isNonEmpty(value) {
+	return !isEmpty(value);
+}
+/**
 * Is the value not `undefined` or `null`?
 * @param value Value to check
 * @returns `true` if the value is not `undefined` or `null`, otherwise `false`
@@ -3608,6 +3768,38 @@ function isNonNullable(value) {
 	return value != null;
 }
 /**
+* Is the value not `undefined`, `null`, or stringified as an empty _(no whitespace)_ string?
+* @param value Value to check
+* @returns `true` if the value is not `undefined`, `null`, or matches an empty string, otherwise `false`
+*/
+function isNonNullableOrEmpty(value) {
+	return value != null && getString(value) !== "";
+}
+/**
+* Is the value not `undefined`, `null`, or stringified as a whitespace-only string?
+* @param value Value to check
+* @returns `true` if the value is not `undefined`, `null`, or matches a whitespace-only string, otherwise `false`
+*/
+function isNonNullableOrWhitespace(value) {
+	return value != null && !EXPRESSION_WHITESPACE.test(getString(value));
+}
+/**
+* Is the value not a number or a number-like string?
+* @param value Value to check
+* @returns `true` if the value is not a number or a number-like string, otherwise `false`
+*/
+function isNonNumerical(value) {
+	return !isNumerical(value);
+}
+/**
+* Is the value not an object _(or function)_?
+* @param value Value to check
+* @returns `true` if the value is not an object, otherwise `false`
+*/
+function isNonObject(value) {
+	return !isObject(value);
+}
+/**
 * Is the value `undefined` or `null`?
 * @param value Value to check
 * @returns `true` if the value is `undefined` or `null`, otherwise `false`
@@ -3616,17 +3808,17 @@ function isNullable(value) {
 	return value == null;
 }
 /**
-* Is the value `undefined`, `null`, or an empty _(no whitespace)_ string?
+* Is the value `undefined`, `null`, or stringified as an empty _(no whitespace)_ string?
 * @param value Value to check
-* @returns `true` if the value is nullable or an empty string, otherwise `false`
+* @returns `true` if the value is nullable or matches an empty string, otherwise `false`
 */
 function isNullableOrEmpty(value) {
 	return value == null || getString(value) === "";
 }
 /**
-* Is the value `undefined`, `null`, or a whitespace-only string?
+* Is the value `undefined`, `null`, or stringified as a whitespace-only string?
 * @param value Value to check
-* @returns `true` if the value is nullable or a whitespace-only string, otherwise `false`
+* @returns `true` if the value is nullable or matches a whitespace-only string, otherwise `false`
 */
 function isNullableOrWhitespace(value) {
 	return value == null || EXPRESSION_WHITESPACE.test(getString(value));
@@ -3634,7 +3826,7 @@ function isNullableOrWhitespace(value) {
 /**
 * Is the value a number or a number-like string?
 * @param value Value to check
-* @returns `true` if the value is a number or a parseable string, otherwise `false`
+* @returns `true` if the value is a number or a number-like string, otherwise `false`
 */
 function isNumerical(value) {
 	return isNumber(value) || typeof value === "string" && value.trim().length > 0 && !Number.isNaN(+value);
@@ -4608,4 +4800,4 @@ var SizedSet = class extends Set {
 	}
 };
 //#endregion
-export { CancelablePromise, PROMISE_ABORT_EVENT, PROMISE_ABORT_OPTIONS, PROMISE_ERROR_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_RESULT, PROMISE_MESSAGE_EXPECTATION_TIMED, PROMISE_MESSAGE_TIMEOUT, PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED, PromiseTimeoutError, QueueError, RetryError, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, SizedMap, SizedSet, assert, attempt, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, difference, drop, endsWith, endsWithArray, equal, error, exists, filter, find, flatten, floor, flow, fromQuery, toPromise as fromResult, toPromise, getArray, getArrayPosition, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getTimedPromise, getUuid, getValue, groupBy, handleResult, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, 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, matchResult, max, median, memoize, merge, min, move, noop, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, retry, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, settlePromise, shuffle, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toQuery, toRecord, toResult, toSet, toggle, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };
+export { CancelablePromise, PROMISE_ABORT_EVENT, PROMISE_ABORT_OPTIONS, PROMISE_ERROR_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_RESULT, PROMISE_MESSAGE_EXPECTATION_TIMED, PROMISE_MESSAGE_TIMEOUT, PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED, PromiseTimeoutError, QueueError, RetryError, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, SizedMap, SizedSet, assert, attempt, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, dedent, delay, diff, difference, drop, endsWith, endsWithArray, equal, error, exists, filter, find, first, flatten, floor, flow, fromQuery, toPromise as fromResult, toPromise, getArray, getArrayPosition, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getTimedPromise, getUuid, getValue, groupBy, handleResult, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, insert, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, last, logger, lowerCase, matchResult, max, median, memoize, merge, min, move, noop, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, retry, reverse, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, settlePromise, shuffle, single, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toQuery, toRecord, toResult, toSet, toggle, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };

package/dist/internal/array/find.d.mts

@@ -1,15 +1,22 @@
 //#region src/internal/array/find.d.ts
-type FindValueType = 'index' | 'value';
+type FindValueType = 'index' | 'item';
 type FindValuesResult = {
   matched: unknown[];
   notMatched: unknown[];
 };
 type FindValuesType = 'all' | 'unique';
-declare function findValue(type: FindValueType, array: unknown[], parameters: unknown[]): unknown;
+type Parameters = {
+  bool?: unknown;
+  key?: unknown;
+  value?: unknown;
+};
+declare function findValue(type: FindValueType, array: unknown[], parameters: unknown[], reversed: boolean): unknown;
+declare function findAbsoluteValueOrDefault(array: unknown[], parameters: unknown[], defaultValue: unknown, useDefaultValue: boolean, reversed: boolean): unknown;
 declare function findValues(type: FindValuesType, array: unknown[], parameters: unknown[], mapper?: unknown): FindValuesResult;
+declare function getFindParameters(original: unknown[]): Parameters;
 declare const FIND_VALUE_INDEX: FindValueType;
-declare const FIND_VALUE_VALUE: FindValueType;
+declare const FIND_VALUE_ITEM: FindValueType;
 declare const FIND_VALUES_ALL: FindValuesType;
 declare const FIND_VALUES_UNIQUE: FindValuesType;
 //#endregion
-export { FIND_VALUES_ALL, FIND_VALUES_UNIQUE, FIND_VALUE_INDEX, FIND_VALUE_VALUE, findValue, findValues };
+export { FIND_VALUES_ALL, FIND_VALUES_UNIQUE, FIND_VALUE_INDEX, FIND_VALUE_ITEM, findAbsoluteValueOrDefault, findValue, findValues, getFindParameters };

package/dist/internal/array/find.mjs

@@ -1,25 +1,33 @@
-import { getArrayCallbacks } from "./callbacks.mjs";
+import { getArrayCallback, getArrayCallbacks } from "./callbacks.mjs";
 //#region src/internal/array/find.ts
-function findValue(type, array, parameters) {
+function findValue(type, array, parameters, reversed) {
 	const findIndex = type === FIND_VALUE_INDEX;
 	if (!Array.isArray(array) || array.length === 0) return findIndex ? -1 : void 0;
-	const { bool, key, value } = getParameters(parameters);
+	const { bool, key, value } = getFindParameters(parameters);
 	const callbacks = getArrayCallbacks(bool, key);
 	if (callbacks?.bool == null && callbacks?.keyed == null) return findIndex ? array.indexOf(value) : array.find((item) => Object.is(item, value));
 	if (callbacks.bool != null) {
 		const index = array.findIndex(callbacks.bool);
 		return findIndex ? index : array[index];
 	}
-	return findValueInArray(array, callbacks.keyed, value, findIndex);
+	return findValueInArray(array, callbacks.keyed, value, findIndex, reversed);
 }
-function findValueInArray(array, callback, value, findIndex) {
+function findValueInArray(array, callback, value, findIndex, reversed) {
 	const { length } = array;
 	for (let index = 0; index < length; index += 1) {
-		const item = array[index];
+		const item = reversed ? array.at(-(index + 1)) : array[index];
 		if (Object.is(callback?.(item, index, array), value)) return findIndex ? index : item;
 	}
 	return findIndex ? -1 : void 0;
 }
+function findAbsoluteValueOrDefault(array, parameters, defaultValue, useDefaultValue, reversed) {
+	if (parameters.length === 0) {
+		if (Array.isArray(array) && array.length > 0) return reversed ? array.at(-1) : array[0];
+		return useDefaultValue ? defaultValue : void 0;
+	}
+	const index = findValue(FIND_VALUE_INDEX, array, parameters, reversed);
+	return index > -1 ? array[index] : useDefaultValue ? defaultValue : void 0;
+}
 function findValues(type, array, parameters, mapper) {
 	const result = {
 		matched: [],
@@ -27,13 +35,13 @@ function findValues(type, array, parameters, mapper) {
 	};
 	if (!Array.isArray(array) || array.length === 0) return result;
 	const { length } = array;
-	const { bool, key, value } = getParameters(parameters);
+	const { bool, key, value } = getFindParameters(parameters);
 	const callbacks = getArrayCallbacks(bool, key);
 	if (type === "unique" && callbacks?.keyed == null && length >= UNIQUE_THRESHOLD) {
 		result.matched = [...new Set(array)];
 		return result;
 	}
-	const mapCallback = typeof mapper === "function" ? mapper : void 0;
+	const mapCallback = getArrayCallback(mapper);
 	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) {
@@ -54,7 +62,7 @@ function findValues(type, array, parameters, mapper) {
 	}
 	return result;
 }
-function getParameters(original) {
+function getFindParameters(original) {
 	const { length } = original;
 	return {
 		bool: length === 1 && typeof original[0] === "function" ? original[0] : void 0,
@@ -63,9 +71,9 @@ function getParameters(original) {
 	};
 }
 const FIND_VALUE_INDEX = "index";
-const FIND_VALUE_VALUE = "value";
+const FIND_VALUE_ITEM = "item";
 const FIND_VALUES_ALL = "all";
 const FIND_VALUES_UNIQUE = "unique";
 const UNIQUE_THRESHOLD = 100;
 //#endregion
-export { FIND_VALUES_ALL, FIND_VALUES_UNIQUE, FIND_VALUE_INDEX, FIND_VALUE_VALUE, findValue, findValues };
+export { FIND_VALUES_ALL, FIND_VALUES_UNIQUE, FIND_VALUE_INDEX, FIND_VALUE_ITEM, findAbsoluteValueOrDefault, findValue, findValues, getFindParameters };

package/dist/internal/is.d.mts

@@ -26,6 +26,61 @@ declare function isInstanceOf<Instance>(constructor: Constructor<Instance>, valu
  * @returns `true` if the value is a `Key` _(`number` or `string`)_, otherwise `false`
  */
 declare function isKey(value: unknown): value is Key;
+/**
+ * Is the value not an array or a plain object?
+ * @param value Value to check
+ * @returns `true` if the value is not an array or a plain object, otherwise `false`
+ */
+declare function isNonArrayOrPlainObject<Value>(value: Value): value is Exclude<Value, ArrayOrPlainObject>;
+/**
+ * Is the value not a constructor function?
+ * @param value Value to check
+ * @returns `true` if the value is not a constructor function, otherwise `false`
+ */
+declare function isNonConstructor<Value>(value: Value): value is Exclude<Value, Constructor>;
+/**
+ * Is the value not an instance of the constructor?
+ * @param constructor Class constructor
+ * @param value Value to check
+ * @returns `true` if the value is not an instance of the constructor, otherwise `false`
+ */
+declare function isNonInstanceOf<Instance, Value>(constructor: Constructor<Instance>, value: Value): value is Exclude<Value, Instance>;
+/**
+ * Is the value not a key?
+ * @param value Value to check
+ * @returns `true` if the value is not a `Key` _(`number` or `string`)_, otherwise `false`
+ */
+declare function isNonKey<Value>(value: Value): value is Exclude<Value, Key>;
+/**
+ * Is the value not a number?
+ * @param value Value to check
+ * @returns `true` if the value is not a `number`, otherwise `false`
+ */
+declare function isNonNumber<Value>(value: Value): value is Exclude<Value, number>;
+/**
+ * Is the value not a plain object?
+ * @param value Value to check
+ * @returns `true` if the value is not a plain object, otherwise `false`
+ */
+declare function isNonPlainObject<Value>(value: Value): value is Exclude<Value, PlainObject>;
+/**
+ * Is the value not a primitive value?
+ * @param value Value to check
+ * @returns `true` if the value is not a primitive value, otherwise `false`
+ */
+declare function isNonPrimitive<Value>(value: Value): value is Exclude<Value, Primitive>;
+/**
+ * Is the value not a template strings array?
+ * @param value Value to check
+ * @returns `true` if the value is not a `TemplateStringsArray`, otherwise `false`
+ */
+declare function isNonTemplateStringsArray<Value>(value: Value): value is Exclude<Value, TemplateStringsArray>;
+/**
+ * Is the value not a typed array?
+ * @param value Value to check
+ * @returns `true` if the value is not a typed array, otherwise `false`
+ */
+declare function isNonTypedArray<Value>(value: Value): value is Exclude<Value, TypedArray>;
 /**
  * Is the value a number?
  * @param value Value to check
@@ -44,6 +99,12 @@ declare function isPlainObject(value: unknown): value is PlainObject;
  * @returns `true` if the value matches, otherwise `false`
  */
 declare function isPrimitive(value: unknown): value is Primitive;
+/**
+ * Is the value a template strings array?
+ * @param value Value to check
+ * @returns `true` if the value is a `TemplateStringsArray`, otherwise `false`
+ */
+declare function isTemplateStringsArray(value: unknown): value is TemplateStringsArray;
 /**
  * Is the value a typed array?
  * @param value Value to check
@@ -51,4 +112,4 @@ declare function isPrimitive(value: unknown): value is Primitive;
  */
 declare function isTypedArray(value: unknown): value is TypedArray;
 //#endregion
-export { isArrayOrPlainObject, isConstructor, isInstanceOf, isKey, isNumber, isPlainObject, isPrimitive, isTypedArray };
+export { isArrayOrPlainObject, isConstructor, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonInstanceOf, isNonKey, isNonNumber, isNonPlainObject, isNonPrimitive, isNonTemplateStringsArray, isNonTypedArray, isNumber, isPlainObject, isPrimitive, isTemplateStringsArray, isTypedArray };