@oscarpalmer/atoms 0.186.2 → 0.187.1

package/dist/internal/string.d.mts

@@ -1,15 +1,29 @@
 //#region src/internal/string.d.ts
 /**
  * Get the string value from any value
+ *
  * @param value Original value
  * @returns String representation of the value
+ *
+ * @example
+ * ```typescript
+ * getString(null)       // => ''
+ * getString('foo')      // => 'foo'
+ * getString(123)        // => '123'
+ * getString(true)       // => 'true'
+ * getString([1, 2, 3])  // => '1,2,3'
+ * getString({a: 1})     // => '{"a":1}'
+ * getString(() => 123)  // => '123'
+ * ```
  */
 declare function getString(value: unknown): string;
 declare function ignoreKey(key: string): boolean;
+declare function interpolate(strings: TemplateStringsArray, values: unknown[]): string;
 /**
  * Join an array of values into a string _(while ignoring empty values)_
  *
  * _(`null`, `undefined`, and any values that become whitespace-only strings are considered empty)_
+ *
  * @param array Array of values
  * @param delimiter Delimiter to use between values
  * @returns Joined string
@@ -19,9 +33,10 @@ declare function tryDecode(value: string): string;
 declare function tryEncode(value: boolean | number | string): unknown;
 /**
  * Split a string into words _(and other readable parts)_
+ *
  * @param value Original string
  * @returns Array of words found in the string
  */
 declare function words(value: string): string[];
 //#endregion
-export { getString, ignoreKey, join, tryDecode, tryEncode, words };
+export { getString, ignoreKey, interpolate, join, tryDecode, tryEncode, words };

package/dist/internal/string.mjs

@@ -1,8 +1,20 @@
 //#region src/internal/string.ts
 /**
 * Get the string value from any value
+*
 * @param value Original value
 * @returns String representation of the value
+*
+* @example
+* ```typescript
+* getString(null)       // => ''
+* getString('foo')      // => 'foo'
+* getString(123)        // => '123'
+* getString(true)       // => 'true'
+* getString([1, 2, 3])  // => '1,2,3'
+* getString({a: 1})     // => '{"a":1}'
+* getString(() => 123)  // => '123'
+* ```
 */
 function getString(value) {
 	if (typeof value === "string") return value;
@@ -15,10 +27,20 @@ function getString(value) {
 function ignoreKey(key) {
 	return EXPRESSION_IGNORED.test(key);
 }
+function interpolate(strings, values) {
+	const { length } = strings;
+	let interpolated = "";
+	for (let index = 0; index < length; index += 1) {
+		const value = values[index];
+		interpolated += `${strings[index]}${Array.isArray(value) ? join(value.map(getString)) : getString(value)}`;
+	}
+	return interpolated;
+}
 /**
 * Join an array of values into a string _(while ignoring empty values)_
 *
 * _(`null`, `undefined`, and any values that become whitespace-only strings are considered empty)_
+*
 * @param array Array of values
 * @param delimiter Delimiter to use between values
 * @returns Joined string
@@ -49,6 +71,7 @@ function tryEncode(value) {
 }
 /**
 * Split a string into words _(and other readable parts)_
+*
 * @param value Original string
 * @returns Array of words found in the string
 */
@@ -58,4 +81,4 @@ function words(value) {
 const EXPRESSION_IGNORED = /(^|\.)(__proto__|constructor|prototype)(\.|$)/i;
 const EXPRESSION_WORDS = /[^\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\x7f]+/g;
 //#endregion
-export { getString, ignoreKey, join, tryDecode, tryEncode, words };
+export { getString, ignoreKey, interpolate, join, tryDecode, tryEncode, words };

package/dist/internal/value/compare.d.mts

@@ -4,6 +4,7 @@ import { Constructor, GenericCallback } from "../../models.mjs";
 type Comparator<Value = any> = (first: Value, second: Value) => number;
 /**
  * Compare two values _(for sorting purposes)_
+ *
  * @param first First value
  * @param second Second value
  * @returns `0` if equal; `-1` first comes before second; `1` first comes after second
@@ -21,14 +22,16 @@ declare namespace compare {
 /**
  * Deregister a custom comparison handler for a class
  *
- * Available as `deregisterComparator` and `compare.deregister`
+ * _Available as `deregisterComparator` and `compare.deregister`_
+ *
  * @param constructor Class constructor
  */
 declare function deregisterComparator<Instance>(constructor: Constructor<Instance>): void;
 /**
  * Register a custom comparison handler for a class
  *
- * Available as `registerComparator` and `compare.register`
+ * _Available as `registerComparator` and `compare.register`_
+ *
  * @param constructor Class constructor
  * @param handler Method name or comparison function _(defaults to `compare`)_
  */

package/dist/internal/value/compare.mjs

@@ -5,6 +5,7 @@ import { getCompareHandlers } from "./handlers.mjs";
 const COMPARE_NAME = "compare";
 /**
 * Compare two values _(for sorting purposes)_
+*
 * @param first First value
 * @param second Second value
 * @returns `0` if equal; `-1` first comes before second; `1` first comes after second
@@ -57,7 +58,8 @@ function compareValue(first, second, compareStrings) {
 /**
 * Deregister a custom comparison handler for a class
 *
-* Available as `deregisterComparator` and `compare.deregister`
+* _Available as `deregisterComparator` and `compare.deregister`_
+*
 * @param constructor Class constructor
 */
 function deregisterComparator(constructor) {
@@ -70,7 +72,8 @@ function getComparisonParts(value) {
 /**
 * Register a custom comparison handler for a class
 *
-* Available as `registerComparator` and `compare.register`
+* _Available as `registerComparator` and `compare.register`_
+*
 * @param constructor Class constructor
 * @param handler Method name or comparison function _(defaults to `compare`)_
 */

package/dist/internal/value/equal.d.mts

@@ -26,6 +26,7 @@ type EqualOptions = {
 type Equalizer = {
   /**
    * Are two strings equal?
+   *
    * @param first First string
    * @param second Second string
    * @param ignoreCase If `true`, comparison will be case-insensitive
@@ -34,6 +35,7 @@ type Equalizer = {
   (first: string, second: string, ignoreCase?: boolean): boolean;
   /**
    * Are two values equal?
+   *
    * @param first First value
    * @param second Second value
    * @returns `true` if the values are equal, otherwise `false`
@@ -41,11 +43,13 @@ type Equalizer = {
   (first: unknown, second: unknown): boolean;
   /**
    * Deregister a equality comparison handler for a specific class
+   *
    * @param constructor Class constructor
    */
   deregister: <Instance>(constructor: Constructor<Instance>) => void;
   /**
    * Register a equality comparison function for a specific class
+   *
    * @param constructor Class constructor
    * @param handler Comparison function
    */
@@ -54,12 +58,14 @@ type Equalizer = {
 /**
  * Deregister a equality comparison handler for a specific class
  *
- * Available as `deregisterEqualizer` and `equal.deregister`
+ * _Available as `deregisterEqualizer` and `equal.deregister`_
+ *
  * @param constructor Class constructor
  */
 declare function deregisterEqualizer<Instance>(constructor: Constructor<Instance>): void;
 /**
  * Are two strings equal?
+ *
  * @param first First string
  * @param second Second string
  * @param ignoreCase If `true`, comparison will be case-insensitive
@@ -68,6 +74,7 @@ declare function deregisterEqualizer<Instance>(constructor: Constructor<Instance
 declare function equal(first: string, second: string, ignoreCase?: boolean): boolean;
 /**
  * Are two values equal?
+ *
  * @param first First value
  * @param second Second value
  * @param options Comparison options
@@ -87,7 +94,8 @@ declare namespace equal {
 /**
  * Create an equalizer with predefined options
  *
- * Available as `initializeEqualizer` and `equal.initialize`
+ * _Available as `initializeEqualizer` and `equal.initialize`_
+ *
  * @param options Comparison options
  * @returns Equalizer function
  */
@@ -95,7 +103,8 @@ declare function initializeEqualizer(options?: EqualOptions): Equalizer;
 /**
  * Register a equality comparison function for a specific class
  *
- * Available as `registerEqualizer` and `equal.register`
+ * _Available as `registerEqualizer` and `equal.register`_
+ *
  * @param constructor Class constructor
  * @param handler Comparison function
  */

package/dist/internal/value/equal.mjs

@@ -4,7 +4,8 @@ import { getCompareHandlers } from "./handlers.mjs";
 /**
 * Deregister a equality comparison handler for a specific class
 *
-* Available as `deregisterEqualizer` and `equal.deregister`
+* _Available as `deregisterEqualizer` and `equal.deregister`_
+*
 * @param constructor Class constructor
 */
 function deregisterEqualizer(constructor) {
@@ -102,7 +103,7 @@ function equalValue(first, second, options) {
 		case typeof first !== typeof second: return false;
 		case typeof first === "string" && options.ignoreCase === true: return Object.is(first.toLocaleLowerCase(), second.toLocaleLowerCase());
 		case first instanceof ArrayBuffer && second instanceof ArrayBuffer: return equalArrayBuffer(first, second, options);
-		case first instanceof Date && second instanceof Date: return Object.is(Number(first), Number(second));
+		case first instanceof Date && second instanceof Date: return Object.is(first.getTime(), second.getTime());
 		case first instanceof DataView && second instanceof DataView: return equalDataView(first, second, options);
 		case first instanceof Error && second instanceof Error: return equalProperties(first, second, ERROR_PROPERTIES, options);
 		case first instanceof Map && second instanceof Map: return equalMap(first, second, options);
@@ -143,7 +144,8 @@ function getEqualOptions(input) {
 /**
 * Create an equalizer with predefined options
 *
-* Available as `initializeEqualizer` and `equal.initialize`
+* _Available as `initializeEqualizer` and `equal.initialize`_
+*
 * @param options Comparison options
 * @returns Equalizer function
 */
@@ -157,7 +159,8 @@ function initializeEqualizer(options) {
 /**
 * Register a equality comparison function for a specific class
 *
-* Available as `registerEqualizer` and `equal.register`
+* _Available as `registerEqualizer` and `equal.register`_
+*
 * @param constructor Class constructor
 * @param handler Comparison function
 */

package/dist/internal/value/get.d.mts

@@ -4,38 +4,38 @@ import { NestedKeys, NestedValue, PlainObject } from "../../models.mjs";
 /**
  * Get the value from an object using a known path
  *
+ * @param data Object to get value from
+ * @param path Path for value
+ * @returns Found value, or `undefined`
+ *
  * @example
  * ```typescript
  * const data = {foo: {bar: {baz: 42}}};
  *
- * getValue(data, 'foo');         // {bar: {baz: 42}}
- * getValue(data, 'foo.bar');     // {baz: 42}
- * getValue(data, 'foo.bar.baz'); // 42
- * getValue(data, 'foo.nope');    // undefined
+ * getValue(data, 'foo');         // => {bar: {baz: 42}}
+ * getValue(data, 'foo.bar');     // => {baz: 42}
+ * getValue(data, 'foo.bar.baz'); // => 42
+ * getValue(data, 'foo.nope');    // => undefined
  * ```
- *
- * @param data Object to get value from
- * @param path Path for value
- * @returns Found value, or `undefined`
  */
 declare function getValue<Data extends PlainObject, Path extends NestedKeys<Data>>(data: Data, path: Path): NestedValue<Data, Path>;
 /**
  * Get the value from an object using an unknown path
  *
+ * @param data Object to get value from
+ * @param path Path for value
+ * @param ignoreCase If `true`, path matching is case-insensitive
+ * @returns Found value, or `undefined`
+ *
  * @example
  * ```typescript
  * const data = {foo: {bar: {baz: 42}}};
  *
- * getValue(data, 'foo');               // {bar: {baz: 42}}
- * getValue(data, 'foo.bar');           // {baz: 42}
- * getValue(data, 'Foo.Bar.Baz', true); // 42
- * getValue(data, 'foo.nope');          // undefined
+ * getValue(data, 'foo');               // => {bar: {baz: 42}}
+ * getValue(data, 'foo.bar');           // => {baz: 42}
+ * getValue(data, 'Foo.Bar.Baz', true); // => 42
+ * getValue(data, 'foo.nope');          // => undefined
  * ```
- *
- * @param data Object to get value from
- * @param path Path for value
- * @param ignoreCase If `true`, path matching is case-insensitive
- * @returns Found value, or `undefined`
  */
 declare function getValue<Data extends PlainObject>(data: Data, path: string, ignoreCase?: boolean): unknown;
 //#endregion

package/dist/internal/value/has.d.mts

@@ -3,41 +3,85 @@ import { Result } from "../../result/models.mjs";
 
 //#region src/internal/value/has.d.ts
 /**
- * Check if a nested property is defined in an object
+ * Check if a property is defined in an object
+ *
  * @param data Object to check in
- * @param path Path for property
+ * @param path Path for property, e.g., `foo.bar.baz`
  * @returns `true` if the property exists, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * const data = {foo: {bar: {baz: 42}}};
+ *
+ * hasValue(data, 'foo');         // => true
+ * hasValue(data, 'foo.bar');     // => true
+ * hasValue(data, 'foo.bar.baz'); // => true
+ * hasValue(data, 'foo.nope');    // => false
+ * ```
  */
 declare function hasValue<Data extends PlainObject, Path extends NestedKeys<Data>>(data: Data, path: Path): boolean;
 /**
- * Check if a nested property is defined in an object
+ * Check if a property is defined in an object
+ *
  * @param data Object to check in
- * @param path Path for property
+ * @param path Path for property, e.g., `foo.bar.baz`
  * @param ignoreCase If `true`, the path matching is case-insensitive
  * @returns `true` if the property exists, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * const data = {foo: {bar: {baz: 42}}};
+ *
+ * hasValue(data, 'foo');               // => true
+ * hasValue(data, 'foo.bar');           // => true
+ * hasValue(data, 'Foo.Bar.Baz', true); // => true
+ * hasValue(data, 'foo.nope');          // => false
+ * ```
  */
 declare function hasValue<Data extends PlainObject>(data: Data, path: string, ignoreCase?: boolean): boolean;
 declare namespace hasValue {
   var get: typeof hasValueResult;
 }
 /**
- * Check if a nested property is defined in an object, and get its value if it is
+ * Check if a property is defined in an object, and get its value if it is
+ *
+ * _Available as `hasValueResult` and `hasValue.get`_
  *
- * Available as `hasValueResult` and `hasValue.get`
  * @param data Object to check in
- * @param path Path for property
+ * @param path Path for property, e.g., `foo.bar.baz`
  * @param ignoreCase If `true`, the path matching is case-insensitive
  * @returns Result object
+ *
+ * @example
+ * ```typescript
+ * const data = {foo: {bar: {baz: 42}}};
+ *
+ * hasValueResult(data, 'foo');         // => {ok: true, value: {bar: {baz: 42}}}
+ * hasValueResult(data, 'foo.bar');     // => {ok: true, value: {baz: 42}}
+ * hasValueResult(data, 'foo.bar.baz'); // => {ok: true, value: 42}
+ * hasValueResult(data, 'foo.nope');    // => {ok: false, error: 'Expected property to exist in object'}
+ * ```
  */
-declare function hasValueResult<Data extends PlainObject, Path extends NestedKeys<Data>>(data: Data, path: Path, ignoreCase?: boolean): Result<NestedValue<Data, ToString<Path>>, string>;
+declare function hasValueResult<Data extends PlainObject, Path extends NestedKeys<Data>>(data: Data, path: Path): Result<NestedValue<Data, ToString<Path>>, string>;
 /**
- * Check if a nested property is defined in an object, and get its value if it is
+ * Check if a property is defined in an object, and get its value if it is
+ *
+ * _Available as `hasValueResult` and `hasValue.get`_
  *
- * Available as `hasValueResult` and `hasValue.get`
  * @param data Object to check in
- * @param path Path for property
+ * @param path Path for property, e.g., `foo.bar.baz`
  * @param ignoreCase If `true`, the path matching is case-insensitive
  * @returns Result object
+ *
+ * @example
+ * ```typescript
+ * const data = {foo: {bar: {baz: 42}}};
+ *
+ * hasValueResult(data, 'foo');               // => {ok: true, value: {bar: {baz: 42}}}
+ * hasValueResult(data, 'foo.bar');           // => {ok: true, value: {baz: 42}}
+ * hasValueResult(data, 'Foo.Bar.Baz', true); // => {ok: true, value: 42}
+ * hasValueResult(data, 'foo.nope');          // => {ok: false, error: 'Expected property to exist in object'}
+ * ```
  */
 declare function hasValueResult<Data extends PlainObject>(data: Data, path: string, ignoreCase?: boolean): Result<unknown, string>;
 //#endregion

package/dist/internal/value/set.d.mts

@@ -3,27 +3,51 @@ import { NestedKeys, NestedValue, PlainObject } from "../../models.mjs";
 //#region src/internal/value/set.d.ts
 /**
  * Update the value in an object using a known path
+ *
  * @param data Object to set value in
  * @param path Path for value, e.g., `foo.bar.baz`
  * @param updater Function to update the current value
  * @returns Updated object
+ *
+ * @example
+ * ```typescript
+ * const data = {foo: {bar: {baz: 42}}};
+ *
+ * setValue(data, 'foo.bar.baz', (current) => current + 1); // => {foo: {bar: {baz: 43}}}
+ * ```
  */
 declare function setValue<Data extends PlainObject, Path extends NestedKeys<Data>>(data: Data, path: Path, updater: (current: NestedValue<Data, Path>) => NestedValue<Data, Path>): Data;
 /**
  * Set the value in an object using a known path
+ *
  * @param data Object to set value in
  * @param path Path for value, e.g., `foo.bar.baz`
  * @param value Value to set
  * @returns Updated object
+ *
+ * @example
+ * ```typescript
+ * const data = {foo: {bar: {baz: 42}}};
+ *
+ * setValue(data, 'foo.bar.baz', 99); // => {foo: {bar: {baz: 99}}}
+ * ```
  */
 declare function setValue<Data extends PlainObject, Path extends NestedKeys<Data>>(data: Data, path: Path, value: NestedValue<Data, Path>): Data;
 /**
  * Set the value in an object using an unknown path
+ *
  * @param data Object to set value in
  * @param path Path for value, e.g., `foo.bar.baz`
  * @param value Value to set
  * @param ignoreCase If `true`, the path matching is case-insensitive
  * @returns Updated object
+ *
+ * @example
+ * ```typescript
+ * const data = {foo: {bar: {baz: 42}}};
+ *
+ * setValue(data, 'Foo.Bar.Baz', 99, true); // => {foo: {bar: {baz: 99}}}
+ * ```
  */
 declare function setValue<Data extends PlainObject>(data: Data, path: string, value: unknown, ignoreCase?: boolean): Data;
 //#endregion

package/dist/internal/value/set.mjs

@@ -20,7 +20,7 @@ function setValue(data, path, value, ignoreCase) {
 		let next = handleValue(target, currentPath, null, true, shouldIgnoreCase).value;
 		if (typeof next !== "object" || next === null) {
 			const nextPath = paths[index + 1];
-			if (EXPRESSION_INDEX.test(nextPath)) next = Array.from({ length: Number.parseInt(nextPath, 10) + 1 }, () => void 0);
+			if (EXPRESSION_INDEX.test(nextPath)) next = Array.from({ length: Number(nextPath) + 1 }, () => void 0);
 			else next = {};
 			target[currentPath] = next;
 		}

package/dist/is.d.mts

@@ -3,72 +3,84 @@ import { isArrayOrPlainObject, isConstructor, isInstanceOf, isKey, isNonArrayOrP
 //#region src/is.d.ts
 /**
  * Is the value empty, or only containing `null` or `undefined` values?
+ *
  * @param value Value to check
  * @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>(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
  * @returns `true` if the value is `undefined` or `null`, otherwise `false`
  */
 declare function isNullable(value: unknown): value is undefined | null;
 /**
  * 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 matches an empty string, otherwise `false`
  */
 declare function isNullableOrEmpty(value: unknown): value is undefined | null | '';
 /**
  * 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 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 number-like string, otherwise `false`
  */
 declare function isNumerical(value: unknown): value is number | `${number}`;
 /**
  * Is the value an object _(or function)_?
+ *
  * @param value Value to check
  * @returns `true` if the value matches, otherwise `false`
  */

package/dist/is.mjs

@@ -4,6 +4,7 @@ import { getString } from "./internal/string.mjs";
 //#region src/is.ts
 /**
 * Is the value empty, or only containing `null` or `undefined` values?
+*
 * @param value Value to check
 * @returns `true` if the value is considered empty, otherwise `false`
 */
@@ -12,11 +13,15 @@ function isEmpty(value) {
 	if (typeof value === "string") return value.length === 0;
 	const values = getArray(value);
 	const { length } = values;
-	for (let index = 0; index < length; index += 1) if (values[index] != null) return false;
+	for (let index = 0; index < length; index += 1) {
+		const item = values[index];
+		if (Array.isArray(item) ? item[1] != null : item != null) return false;
+	}
 	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`
 */
@@ -25,6 +30,7 @@ function isNonEmpty(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`
 */
@@ -33,6 +39,7 @@ function isNonNullable(value) {
 }
 /**
 * 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`
 */
@@ -41,6 +48,7 @@ function isNonNullableOrEmpty(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`
 */
@@ -49,6 +57,7 @@ function isNonNullableOrWhitespace(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`
 */
@@ -57,6 +66,7 @@ function isNonNumerical(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`
 */
@@ -65,6 +75,7 @@ function isNonObject(value) {
 }
 /**
 * Is the value `undefined` or `null`?
+*
 * @param value Value to check
 * @returns `true` if the value is `undefined` or `null`, otherwise `false`
 */
@@ -73,6 +84,7 @@ function isNullable(value) {
 }
 /**
 * 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 matches an empty string, otherwise `false`
 */
@@ -81,6 +93,7 @@ function isNullableOrEmpty(value) {
 }
 /**
 * 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 matches a whitespace-only string, otherwise `false`
 */
@@ -89,6 +102,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 number-like string, otherwise `false`
 */
@@ -97,6 +111,7 @@ function isNumerical(value) {
 }
 /**
 * Is the value an object _(or function)_?
+*
 * @param value Value to check
 * @returns `true` if the value matches, otherwise `false`
 */