@oscarpalmer/atoms 0.176.0 → 0.177.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 {};
@@ -195,6 +212,30 @@ function isInstanceOf(constructor, value) {
 function isKey(value) {
 	return typeof value === "number" || typeof value === "string";
 }
+function isNonArrayOrPlainObject(value) {
+	return !isArrayOrPlainObject(value);
+}
+function isNonConstructor(value) {
+	return !isConstructor(value);
+}
+function isNonInstanceOf(constructor, value) {
+	return !isInstanceOf(constructor, value);
+}
+function isNonKey(value) {
+	return !isKey(value);
+}
+function isNonNumber(value) {
+	return !isNumber(value);
+}
+function isNonPlainObject(value) {
+	return !isPlainObject(value);
+}
+function isNonPrimitive(value) {
+	return !isPrimitive(value);
+}
+function isNonTypedArray(value) {
+	return !isTypedArray(value);
+}
 /**
 * Is the value a number?
 * @param value Value to check
@@ -220,7 +261,9 @@ 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 typed array?
@@ -228,7 +271,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 +284,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 +370,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
@@ -496,6 +537,14 @@ 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 +655,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;
@@ -3600,6 +3658,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 +3674,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 +3714,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 +3732,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 +4706,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, 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, 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,14 @@ 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;
+declare function isNonArrayOrPlainObject<Value>(value: Value): value is Exclude<Value, ArrayOrPlainObject>;
+declare function isNonConstructor<Value>(value: Value): value is Exclude<Value, Constructor>;
+declare function isNonInstanceOf<Instance, Value>(constructor: Constructor<Instance>, value: Value): value is Exclude<Value, Instance>;
+declare function isNonKey<Value>(value: Value): value is Exclude<Value, Key>;
+declare function isNonNumber<Value>(value: Value): value is Exclude<Value, number>;
+declare function isNonPlainObject<Value>(value: Value): value is Exclude<Value, PlainObject>;
+declare function isNonPrimitive<Value>(value: Value): value is Exclude<Value, Primitive>;
+declare function isNonTypedArray<Value>(value: Value): value is Exclude<Value, TypedArray>;
 /**
  * Is the value a number?
  * @param value Value to check
@@ -51,4 +59,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, isNonTypedArray, isNumber, isPlainObject, isPrimitive, isTypedArray };

package/dist/internal/is.mjs

@@ -32,6 +32,30 @@ function isInstanceOf(constructor, value) {
 function isKey(value) {
 	return typeof value === "number" || typeof value === "string";
 }
+function isNonArrayOrPlainObject(value) {
+	return !isArrayOrPlainObject(value);
+}
+function isNonConstructor(value) {
+	return !isConstructor(value);
+}
+function isNonInstanceOf(constructor, value) {
+	return !isInstanceOf(constructor, value);
+}
+function isNonKey(value) {
+	return !isKey(value);
+}
+function isNonNumber(value) {
+	return !isNumber(value);
+}
+function isNonPlainObject(value) {
+	return !isPlainObject(value);
+}
+function isNonPrimitive(value) {
+	return !isPrimitive(value);
+}
+function isNonTypedArray(value) {
+	return !isTypedArray(value);
+}
 /**
 * Is the value a number?
 * @param value Value to check
@@ -57,7 +81,9 @@ 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 typed array?
@@ -65,7 +91,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,
@@ -78,9 +104,7 @@ 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
-export { isArrayOrPlainObject, isConstructor, isInstanceOf, isKey, isNumber, isPlainObject, isPrimitive, isTypedArray };
+export { isArrayOrPlainObject, isConstructor, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonInstanceOf, isNonKey, isNonNumber, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNumber, isPlainObject, isPrimitive, isTypedArray };

package/dist/is.d.mts

@@ -1,4 +1,4 @@
-import { isArrayOrPlainObject, isConstructor, isInstanceOf, isKey, isNumber, isPlainObject, isPrimitive, isTypedArray } from "./internal/is.mjs";
+import { isArrayOrPlainObject, isConstructor, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonInstanceOf, isNonKey, isNonNumber, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNumber, isPlainObject, isPrimitive, isTypedArray } from "./internal/is.mjs";
 
 //#region src/is.d.ts
 /**
@@ -7,12 +7,42 @@ import { isArrayOrPlainObject, isConstructor, isInstanceOf, isKey, isNumber, isP
  * @returns `true` if the value is considered empty, otherwise `false`
  */
 declare function isEmpty(value: unknown): boolean;
+/**
+ * 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`
+ */
+declare function isNonEmpty(value: unknown): boolean;
 /**
  * Is the value not `undefined` or `null`?
  * @param value Value to check
  * @returns `true` if the value is not `undefined` or `null`, otherwise `false`
  */
-declare function isNonNullable(value: unknown): value is Exclude<unknown, undefined | null>;
+declare function isNonNullable<Value>(value: Value): value is Exclude<Value, undefined | 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`
+ */
+declare function isNonNullableOrEmpty<Value>(value: Value): value is Exclude<Value, undefined | null | ''>;
+/**
+ * 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`
+ */
+declare function isNonNullableOrWhitespace<Value>(value: Value): value is Exclude<Value, undefined | null | ''>;
+/**
+ * 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`
+ */
+declare function isNonNumerical<Value>(value: Value): value is Exclude<Value, number | `${number}`>;
+/**
+ * Is the value not an object _(or function)_?
+ * @param value Value to check
+ * @returns `true` if the value is not an object, otherwise `false`
+ */
+declare function isNonObject<Value>(value: Value): value is Exclude<Value, object>;
 /**
  * Is the value `undefined` or `null`?
  * @param value Value to check
@@ -20,21 +50,21 @@ declare function isNonNullable(value: unknown): value is Exclude<unknown, undefi
  */
 declare function isNullable(value: unknown): value is undefined | 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`
  */
 declare function isNullableOrEmpty(value: unknown): value is undefined | null | '';
 /**
- * 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`
  */
 declare function isNullableOrWhitespace(value: unknown): value is undefined | null | '';
 /**
  * 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`
  */
 declare function isNumerical(value: unknown): value is number | `${number}`;
 /**
@@ -44,4 +74,4 @@ declare function isNumerical(value: unknown): value is number | `${number}`;
  */
 declare function isObject(value: unknown): value is object;
 //#endregion
-export { isArrayOrPlainObject, isConstructor, isEmpty, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isPlainObject, isPrimitive, isTypedArray };
+export { isArrayOrPlainObject, isConstructor, isEmpty, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isPlainObject, isPrimitive, isTypedArray };

package/dist/is.mjs

@@ -1,4 +1,4 @@
-import { isArrayOrPlainObject, isConstructor, isInstanceOf, isKey, isNumber, isPlainObject, isPrimitive, isTypedArray } from "./internal/is.mjs";
+import { isArrayOrPlainObject, isConstructor, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonInstanceOf, isNonKey, isNonNumber, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNumber, isPlainObject, isPrimitive, isTypedArray } from "./internal/is.mjs";
 import { getArray } from "./array/get.mjs";
 import { getString } from "./internal/string.mjs";
 //#region src/is.ts
@@ -16,6 +16,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`
@@ -24,6 +32,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`
@@ -32,17 +72,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));
@@ -50,7 +90,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);
@@ -65,4 +105,4 @@ function isObject(value) {
 }
 const EXPRESSION_WHITESPACE = /^\s*$/;
 //#endregion
-export { isArrayOrPlainObject, isConstructor, isEmpty, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isPlainObject, isPrimitive, isTypedArray };
+export { isArrayOrPlainObject, isConstructor, isEmpty, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isPlainObject, isPrimitive, isTypedArray };