@oscarpalmer/atoms 0.176.0 → 0.177.0

package/src/internal/is.ts

@@ -49,6 +49,84 @@ export function isKey(value: unknown): value is Key {
 	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`
+ */
+export function isNonArrayOrPlainObject<Value>(
+	value: Value,
+): value is Exclude<Value, ArrayOrPlainObject> {
+	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`
+ */
+export function isNonConstructor<Value>(value: Value): value is Exclude<Value, Constructor> {
+	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`
+ */
+export function isNonInstanceOf<Instance, Value>(
+	constructor: Constructor<Instance>,
+	value: Value,
+): value is Exclude<Value, Instance> {
+	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`
+ */
+export function isNonKey<Value>(value: Value): value is Exclude<Value, Key> {
+	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`
+ */
+export function isNonNumber<Value>(value: Value): value is Exclude<Value, number> {
+	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`
+ */
+export function isNonPlainObject<Value>(value: Value): value is Exclude<Value, PlainObject> {
+	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`
+ */
+export function isNonPrimitive<Value>(value: Value): value is Exclude<Value, Primitive> {
+	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`
+ */
+export function isNonTypedArray<Value>(value: Value): value is Exclude<Value, TypedArray> {
+	return !isTypedArray(value);
+}
+
 /**
  * Is the value a number?
  * @param value Value to check
@@ -87,7 +165,19 @@ export function isPlainObject(value: unknown): value is PlainObject {
  * @returns `true` if the value matches, otherwise `false`
  */
 export function isPrimitive(value: unknown): value is Primitive {
-	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'
+	);
 }
 
 /**
@@ -96,7 +186,7 @@ export function isPrimitive(value: unknown): value is Primitive {
  * @returns `true` if the value is a typed array, otherwise `false`
  */
 export function isTypedArray(value: unknown): value is TypedArray {
-	TYPED_ARRAYS ??= new Set<unknown>([
+	(isTypedArray as any).types ??= new Set<unknown>([
 		Int8Array,
 		Uint8Array,
 		Uint8ClampedArray,
@@ -110,15 +200,7 @@ export function isTypedArray(value: unknown): value is TypedArray {
 		BigUint64Array,
 	]);
 
-	return TYPED_ARRAYS.has((value as TypedArray)?.constructor);
+	return (isTypedArray as any).types.has((value as TypedArray)?.constructor);
 }
 
 // #endregion
-
-// #region Variables
-
-const EXPRESSION_PRIMITIVE = /^(bigint|boolean|number|string|symbol)$/;
-
-let TYPED_ARRAYS: Set<unknown>;
-
-// #endregion

package/src/is.ts

@@ -30,15 +30,64 @@ export function isEmpty(value: unknown): boolean {
 	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`
+ */
+export function isNonEmpty(value: unknown): boolean {
+	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`
  */
-export function isNonNullable(value: unknown): value is Exclude<unknown, undefined | null> {
+export function isNonNullable<Value>(value: Value): value is Exclude<Value, undefined | null> {
 	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`
+ */
+export function isNonNullableOrEmpty<Value>(
+	value: Value,
+): value is Exclude<Value, undefined | null | ''> {
+	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`
+ */
+export function isNonNullableOrWhitespace<Value>(
+	value: Value,
+): value is Exclude<Value, undefined | null | ''> {
+	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`
+ */
+export function isNonNumerical<Value>(value: Value): value is Exclude<Value, number | `${number}`> {
+	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`
+ */
+export function isNonObject<Value>(value: Value): value is Exclude<Value, object> {
+	return !isObject(value);
+}
+
 /**
  * Is the value `undefined` or `null`?
  * @param value Value to check
@@ -49,18 +98,18 @@ export 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`
  */
 export function isNullableOrEmpty(value: unknown): value is undefined | null | '' {
 	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`
  */
 export function isNullableOrWhitespace(value: unknown): value is undefined | null | '' {
 	return value == null || EXPRESSION_WHITESPACE.test(getString(value));
@@ -69,7 +118,7 @@ export function isNullableOrWhitespace(value: unknown): value is undefined | nul
 /**
  * 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`
  */
 export function isNumerical(value: unknown): value is number | `${number}` {
 	return (
@@ -102,6 +151,14 @@ export {
 	isConstructor,
 	isInstanceOf,
 	isKey,
+	isNonArrayOrPlainObject,
+	isNonConstructor,
+	isNonInstanceOf,
+	isNonKey,
+	isNonNumber,
+	isNonPlainObject,
+	isNonPrimitive,
+	isNonTypedArray,
 	isNumber,
 	isPlainObject,
 	isPrimitive,