yummies 7.10.0 → 7.12.0

package/type-guard.d.ts

@@ -1,87 +1,244 @@
 import { AnyFunction, AnyObject } from 'yummies/types';
 
 /**
- * Check if a value is not null or undefined
- * @param value the value to check
- * @returns boolean
+ * Checks that a value is neither `null` nor `undefined`.
+ *
+ * @template T Value type without nullish branches.
+ * @param value Value to test.
+ * @returns `true` when the value is defined.
+ *
+ * @example
+ * ```ts
+ * isDefined(0); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isDefined(null); // false
+ * ```
  */
 declare const isDefined: <T>(value: T | undefined | null) => value is T;
 /**
- * Check if a value is null
- * @param value the value to check
- * @returns boolean
+ * Checks whether a value is exactly `null`.
+ *
+ * @param value Value to test.
+ * @returns `true` when the value is `null`.
+ *
+ * @example
+ * ```ts
+ * isNull(null); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isNull(undefined); // false
+ * ```
  */
 declare const isNull: (value: unknown) => value is null;
 /**
- * Check if a value is undefined
- * @param value the value to check
- * @returns boolean
+ * Checks whether a value is exactly `undefined`.
+ *
+ * @param value Value to test.
+ * @returns `true` when the value is `undefined`.
+ *
+ * @example
+ * ```ts
+ * isUndefined(undefined); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isUndefined('value'); // false
+ * ```
  */
 declare const isUndefined: (value: unknown) => value is undefined;
 /**
- * Check if a value is an object
- * @param value the value to check
- * @returns boolean
+ * Checks whether a value is a plain object.
+ *
+ * @param value Value to test.
+ * @returns `true` when the value matches `[object Object]`.
+ *
+ * @example
+ * ```ts
+ * isObject({ id: 1 }); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isObject([]); // false
+ * ```
  */
 declare const isObject: (value: unknown) => value is AnyObject;
 /**
- * Check if a value is an array
- * @param value the value to check
- * @returns boolean
+ * Checks whether a value is an array.
+ *
+ * @param value Value to test.
+ * @returns `true` when the value is an array.
+ *
+ * @example
+ * ```ts
+ * isArray([1, 2, 3]); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isArray({ length: 1 }); // false
+ * ```
  */
 declare const isArray: (value: unknown) => value is unknown[];
 /**
- * Check if a value is a string
- * @param value the value to check
- * @returns boolean
+ * Checks whether a value is a string object or primitive string.
+ *
+ * @param value Value to test.
+ * @returns `true` when the value is a string.
+ *
+ * @example
+ * ```ts
+ * isString('hello'); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isString(123); // false
+ * ```
  */
 declare const isString: (value: unknown) => value is string;
 /**
- * Check if a value is a number
- * @param value the value to check
- * @returns boolean
+ * Checks whether a value is a finite number.
+ *
+ * Unlike `isNaN` and `isInfinite`, this guard only matches regular numeric values.
+ *
+ * @param value Value to test.
+ * @returns `true` when the value is a non-NaN finite number.
+ *
+ * @example
+ * ```ts
+ * isNumber(123); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isNumber(Number.NaN); // false
+ * ```
  */
 declare const isNumber: (value: unknown) => value is number;
 /**
- * Check if a value is a boolean
- * @param value the value to check
- * @returns boolean
+ * Checks whether a value is a boolean.
+ *
+ * @param value Value to test.
+ * @returns `true` when the value is a boolean.
+ *
+ * @example
+ * ```ts
+ * isBoolean(true); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isBoolean('true'); // false
+ * ```
  */
 declare const isBoolean: (value: unknown) => value is boolean;
 /**
- * Check if a value is a function
- * @param value the value to check
- * @returns boolean
+ * Checks whether a value is a synchronous or asynchronous function.
+ *
+ * @param value Value to test.
+ * @returns `true` when the value is a function.
+ *
+ * @example
+ * ```ts
+ * isFunction(() => {}); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isFunction(async () => {}); // true
+ * ```
  */
 declare const isFunction: (value: unknown) => value is AnyFunction;
 /**
- * Check if a value is a regular expression
- * @param value the value to check
- * @returns boolean
+ * Checks whether a value is a regular expression.
+ *
+ * @param value Value to test.
+ * @returns `true` when the value is a `RegExp`.
+ *
+ * @example
+ * ```ts
+ * isRegExp(/foo/); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isRegExp('foo'); // false
+ * ```
  */
 declare const isRegExp: (value: unknown) => value is RegExp;
 /**
- * Check if a value is a DOM element
- * @param value the value to check
- * @returns boolean
+ * Checks whether a value looks like a DOM element or document node.
+ *
+ * @param value Value to test.
+ * @returns `true` when the value has an element-like node type.
+ *
+ * @example
+ * ```ts
+ * isElement(document.body); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isElement({ nodeType: 3 }); // false
+ * ```
  */
 declare const isElement: (value: unknown) => value is HTMLElement;
 /**
- * Check if a value is NaN
- * @param value the value to check
- * @returns boolean
+ * Checks whether a value is `NaN`.
+ *
+ * @param value Value to test.
+ * @returns `true` when the value is `NaN`.
+ *
+ * @example
+ * ```ts
+ * isNaN(Number.NaN); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isNaN(5); // false
+ * ```
  */
 declare const isNaN: (value: unknown) => boolean;
 /**
- * Check if a value is infinity
- * @param value the value to check
- * @returns boolean
+ * Checks whether a value is positive or negative infinity.
+ *
+ * @param value Value to test.
+ * @returns `true` when the value is not finite.
+ *
+ * @example
+ * ```ts
+ * isInfinite(Infinity); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isInfinite(10); // false
+ * ```
  */
 declare const isInfinite: (value: unknown) => boolean;
 /**
- * Check if a value is a symbol
- * @param value the value to check
- * @returns boolean
+ * Checks whether a value is a symbol.
+ *
+ * @param value Value to test.
+ * @returns `true` when the value is a symbol.
+ *
+ * @example
+ * ```ts
+ * isSymbol(Symbol('id')); // true
+ * ```
+ *
+ * @example
+ * ```ts
+ * isSymbol('id'); // false
+ * ```
  */
 declare const isSymbol: (value: unknown) => value is symbol;
 

package/type-guard.js

@@ -1,76 +1,291 @@
-const TYPE = {
-  Null: "null",
-  Undefined: "undefined",
-  NaN: "nan",
-  Object: "[object Object]",
-  Array: "[object Array]",
-  String: "[object String]",
-  Number: "[object Number]",
-  Boolean: "[object Boolean]",
-  Function: "[object Function]",
-  AsyncFunction: "[object AsyncFunction]",
-  RegExp: "[object RegExp]",
-  Symbol: "[object Symbol]",
-  Infinite: "infinite",
-  Element: "element"
+import { n as __exportAll } from "./chunk-YKewjYmz.js";
+//#region src/type-guard/_exports.ts
+var _exports_exports = /* @__PURE__ */ __exportAll({
+	isArray: () => isArray,
+	isBoolean: () => isBoolean,
+	isDefined: () => isDefined,
+	isElement: () => isElement,
+	isFunction: () => isFunction,
+	isInfinite: () => isInfinite,
+	isNaN: () => isNaN,
+	isNull: () => isNull,
+	isNumber: () => isNumber,
+	isObject: () => isObject,
+	isRegExp: () => isRegExp,
+	isString: () => isString,
+	isSymbol: () => isSymbol,
+	isUndefined: () => isUndefined
+});
+var TYPE = {
+	Null: "null",
+	Undefined: "undefined",
+	NaN: "nan",
+	Object: "[object Object]",
+	Array: "[object Array]",
+	String: "[object String]",
+	Number: "[object Number]",
+	Boolean: "[object Boolean]",
+	Function: "[object Function]",
+	AsyncFunction: "[object AsyncFunction]",
+	RegExp: "[object RegExp]",
+	Symbol: "[object Symbol]",
+	Infinite: "infinite",
+	Element: "element"
 };
 function getType(value) {
-  if (value === void 0) {
-    return TYPE.Undefined;
-  }
-  if (value === null) {
-    return TYPE.Null;
-  }
-  if (value && (value.nodeType === 1 || value.nodeType === 9)) {
-    return TYPE.Element;
-  }
-  const stringifiedValue = Object.prototype.toString.call(value);
-  if (stringifiedValue === TYPE.Number) {
-    if (Number.isNaN(value)) {
-      return TYPE.NaN;
-    }
-    if (!Number.isFinite(value)) {
-      return TYPE.Infinite;
-    }
-  }
-  return stringifiedValue;
+	if (value === void 0) return TYPE.Undefined;
+	if (value === null) return TYPE.Null;
+	if (value && (value.nodeType === 1 || value.nodeType === 9)) return TYPE.Element;
+	const stringifiedValue = Object.prototype.toString.call(value);
+	if (stringifiedValue === TYPE.Number) {
+		if (Number.isNaN(value)) return TYPE.NaN;
+		if (!Number.isFinite(value)) return TYPE.Infinite;
+	}
+	return stringifiedValue;
 }
-const createTypeGuard = (...types) => (value) => types.includes(getType(value));
-const isDefined = (value) => value != null;
-const isNull = createTypeGuard(TYPE.Null);
-const isUndefined = createTypeGuard(TYPE.Undefined);
-const isObject = createTypeGuard(TYPE.Object);
-const isArray = createTypeGuard(TYPE.Array);
-const isString = createTypeGuard(TYPE.String);
-const isNumber = createTypeGuard(TYPE.Number);
-const isBoolean = createTypeGuard(TYPE.Boolean);
-const isFunction = createTypeGuard(
-  TYPE.Function,
-  TYPE.AsyncFunction
-);
-const isRegExp = createTypeGuard(TYPE.RegExp);
-const isElement = createTypeGuard(TYPE.Element);
-const isNaN = createTypeGuard(TYPE.NaN);
-const isInfinite = createTypeGuard(TYPE.Infinite);
-const isSymbol = createTypeGuard(TYPE.Symbol);
-const _exports = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
-  __proto__: null,
-  isArray,
-  isBoolean,
-  isDefined,
-  isElement,
-  isFunction,
-  isInfinite,
-  isNaN,
-  isNull,
-  isNumber,
-  isObject,
-  isRegExp,
-  isString,
-  isSymbol,
-  isUndefined
-}, Symbol.toStringTag, { value: "Module" }));
-export {
-  _exports as typeGuard
-};
-//# sourceMappingURL=type-guard.js.map
+var createTypeGuard = (...types) => (value) => types.includes(getType(value));
+/**
+* Checks that a value is neither `null` nor `undefined`.
+*
+* @template T Value type without nullish branches.
+* @param value Value to test.
+* @returns `true` when the value is defined.
+*
+* @example
+* ```ts
+* isDefined(0); // true
+* ```
+*
+* @example
+* ```ts
+* isDefined(null); // false
+* ```
+*/
+var isDefined = (value) => value != null;
+/**
+* Checks whether a value is exactly `null`.
+*
+* @param value Value to test.
+* @returns `true` when the value is `null`.
+*
+* @example
+* ```ts
+* isNull(null); // true
+* ```
+*
+* @example
+* ```ts
+* isNull(undefined); // false
+* ```
+*/
+var isNull = createTypeGuard(TYPE.Null);
+/**
+* Checks whether a value is exactly `undefined`.
+*
+* @param value Value to test.
+* @returns `true` when the value is `undefined`.
+*
+* @example
+* ```ts
+* isUndefined(undefined); // true
+* ```
+*
+* @example
+* ```ts
+* isUndefined('value'); // false
+* ```
+*/
+var isUndefined = createTypeGuard(TYPE.Undefined);
+/**
+* Checks whether a value is a plain object.
+*
+* @param value Value to test.
+* @returns `true` when the value matches `[object Object]`.
+*
+* @example
+* ```ts
+* isObject({ id: 1 }); // true
+* ```
+*
+* @example
+* ```ts
+* isObject([]); // false
+* ```
+*/
+var isObject = createTypeGuard(TYPE.Object);
+/**
+* Checks whether a value is an array.
+*
+* @param value Value to test.
+* @returns `true` when the value is an array.
+*
+* @example
+* ```ts
+* isArray([1, 2, 3]); // true
+* ```
+*
+* @example
+* ```ts
+* isArray({ length: 1 }); // false
+* ```
+*/
+var isArray = createTypeGuard(TYPE.Array);
+/**
+* Checks whether a value is a string object or primitive string.
+*
+* @param value Value to test.
+* @returns `true` when the value is a string.
+*
+* @example
+* ```ts
+* isString('hello'); // true
+* ```
+*
+* @example
+* ```ts
+* isString(123); // false
+* ```
+*/
+var isString = createTypeGuard(TYPE.String);
+/**
+* Checks whether a value is a finite number.
+*
+* Unlike `isNaN` and `isInfinite`, this guard only matches regular numeric values.
+*
+* @param value Value to test.
+* @returns `true` when the value is a non-NaN finite number.
+*
+* @example
+* ```ts
+* isNumber(123); // true
+* ```
+*
+* @example
+* ```ts
+* isNumber(Number.NaN); // false
+* ```
+*/
+var isNumber = createTypeGuard(TYPE.Number);
+/**
+* Checks whether a value is a boolean.
+*
+* @param value Value to test.
+* @returns `true` when the value is a boolean.
+*
+* @example
+* ```ts
+* isBoolean(true); // true
+* ```
+*
+* @example
+* ```ts
+* isBoolean('true'); // false
+* ```
+*/
+var isBoolean = createTypeGuard(TYPE.Boolean);
+/**
+* Checks whether a value is a synchronous or asynchronous function.
+*
+* @param value Value to test.
+* @returns `true` when the value is a function.
+*
+* @example
+* ```ts
+* isFunction(() => {}); // true
+* ```
+*
+* @example
+* ```ts
+* isFunction(async () => {}); // true
+* ```
+*/
+var isFunction = createTypeGuard(TYPE.Function, TYPE.AsyncFunction);
+/**
+* Checks whether a value is a regular expression.
+*
+* @param value Value to test.
+* @returns `true` when the value is a `RegExp`.
+*
+* @example
+* ```ts
+* isRegExp(/foo/); // true
+* ```
+*
+* @example
+* ```ts
+* isRegExp('foo'); // false
+* ```
+*/
+var isRegExp = createTypeGuard(TYPE.RegExp);
+/**
+* Checks whether a value looks like a DOM element or document node.
+*
+* @param value Value to test.
+* @returns `true` when the value has an element-like node type.
+*
+* @example
+* ```ts
+* isElement(document.body); // true
+* ```
+*
+* @example
+* ```ts
+* isElement({ nodeType: 3 }); // false
+* ```
+*/
+var isElement = createTypeGuard(TYPE.Element);
+/**
+* Checks whether a value is `NaN`.
+*
+* @param value Value to test.
+* @returns `true` when the value is `NaN`.
+*
+* @example
+* ```ts
+* isNaN(Number.NaN); // true
+* ```
+*
+* @example
+* ```ts
+* isNaN(5); // false
+* ```
+*/
+var isNaN = createTypeGuard(TYPE.NaN);
+/**
+* Checks whether a value is positive or negative infinity.
+*
+* @param value Value to test.
+* @returns `true` when the value is not finite.
+*
+* @example
+* ```ts
+* isInfinite(Infinity); // true
+* ```
+*
+* @example
+* ```ts
+* isInfinite(10); // false
+* ```
+*/
+var isInfinite = createTypeGuard(TYPE.Infinite);
+/**
+* Checks whether a value is a symbol.
+*
+* @param value Value to test.
+* @returns `true` when the value is a symbol.
+*
+* @example
+* ```ts
+* isSymbol(Symbol('id')); // true
+* ```
+*
+* @example
+* ```ts
+* isSymbol('id'); // false
+* ```
+*/
+var isSymbol = createTypeGuard(TYPE.Symbol);
+//#endregion
+export { _exports_exports as typeGuard };
+
+//# sourceMappingURL=type-guard.js.map

package/type-guard.js.map

@@ -1 +1 @@
-{"version":3,"file":"type-guard.js","sources":["../src/type-guard/_exports.ts"],"sourcesContent":["import type { AnyFunction, AnyObject, ValueOf } from 'yummies/types';\n\nconst TYPE = {\n  Null: 'null',\n  Undefined: 'undefined',\n  NaN: 'nan',\n  Object: '[object Object]',\n  Array: '[object Array]',\n  String: '[object String]',\n  Number: '[object Number]',\n  Boolean: '[object Boolean]',\n  Function: '[object Function]',\n  AsyncFunction: '[object AsyncFunction]',\n  RegExp: '[object RegExp]',\n  Symbol: '[object Symbol]',\n  Infinite: 'infinite',\n  Element: 'element',\n};\n\ntype Type = ValueOf<typeof TYPE>;\n\nfunction getType(value: unknown): Type {\n  if (value === undefined) {\n    return TYPE.Undefined;\n  }\n  if (value === null) {\n    return TYPE.Null;\n  }\n\n  // handle DOM elements\n  // @ts-expect-error\n  if (value && (value.nodeType === 1 || value.nodeType === 9)) {\n    return TYPE.Element;\n  }\n\n  const stringifiedValue = Object.prototype.toString.call(value);\n\n  // handle NaN and Infinity\n  if (stringifiedValue === TYPE.Number) {\n    if (Number.isNaN(value as number)) {\n      return TYPE.NaN;\n    }\n    if (!Number.isFinite(value as number)) {\n      return TYPE.Infinite;\n    }\n  }\n\n  return stringifiedValue as Type;\n}\n\nconst createTypeGuard =\n  <T>(...types: Type[]) =>\n  (value: unknown): value is T =>\n    types.includes(getType(value));\n\n/**\n * Check if a value is not null or undefined\n * @param value the value to check\n * @returns boolean\n */\nexport const isDefined = <T>(value: T | undefined | null): value is T =>\n  value != null;\n\n/**\n * Check if a value is null\n * @param value the value to check\n * @returns boolean\n */\nexport const isNull = createTypeGuard<null>(TYPE.Null);\n\n/**\n * Check if a value is undefined\n * @param value the value to check\n * @returns boolean\n */\nexport const isUndefined = createTypeGuard<undefined>(TYPE.Undefined);\n\n/**\n * Check if a value is an object\n * @param value the value to check\n * @returns boolean\n */\nexport const isObject = createTypeGuard<AnyObject>(TYPE.Object);\n\n/**\n * Check if a value is an array\n * @param value the value to check\n * @returns boolean\n */\nexport const isArray = createTypeGuard<unknown[]>(TYPE.Array);\n\n/**\n * Check if a value is a string\n * @param value the value to check\n * @returns boolean\n */\nexport const isString = createTypeGuard<string>(TYPE.String);\n\n/**\n * Check if a value is a number\n * @param value the value to check\n * @returns boolean\n */\nexport const isNumber = createTypeGuard<number>(TYPE.Number);\n\n/**\n * Check if a value is a boolean\n * @param value the value to check\n * @returns boolean\n */\nexport const isBoolean = createTypeGuard<boolean>(TYPE.Boolean);\n\n/**\n * Check if a value is a function\n * @param value the value to check\n * @returns boolean\n */\nexport const isFunction = createTypeGuard<AnyFunction>(\n  TYPE.Function,\n  TYPE.AsyncFunction,\n);\n\n/**\n * Check if a value is a regular expression\n * @param value the value to check\n * @returns boolean\n */\nexport const isRegExp = createTypeGuard<RegExp>(TYPE.RegExp);\n\n/**\n * Check if a value is a DOM element\n * @param value the value to check\n * @returns boolean\n */\nexport const isElement = createTypeGuard<HTMLElement>(TYPE.Element);\n\n/**\n * Check if a value is NaN\n * @param value the value to check\n * @returns boolean\n */\nexport const isNaN = createTypeGuard<number>(TYPE.NaN) as (\n  value: unknown,\n) => boolean;\n\n/**\n * Check if a value is infinity\n * @param value the value to check\n * @returns boolean\n */\nexport const isInfinite = createTypeGuard<number>(TYPE.Infinite) as (\n  value: unknown,\n) => boolean;\n\n/**\n * Check if a value is a symbol\n * @param value the value to check\n * @returns boolean\n */\nexport const isSymbol = createTypeGuard<symbol>(TYPE.Symbol);\n"],"names":[],"mappings":"AAEA,MAAM,OAAO;AAAA,EACX,MAAM;AAAA,EACN,WAAW;AAAA,EACX,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,UAAU;AAAA,EACV,eAAe;AAAA,EACf,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,SAAS;AACX;AAIA,SAAS,QAAQ,OAAsB;AACrC,MAAI,UAAU,QAAW;AACvB,WAAO,KAAK;AAAA,EACd;AACA,MAAI,UAAU,MAAM;AAClB,WAAO,KAAK;AAAA,EACd;AAIA,MAAI,UAAU,MAAM,aAAa,KAAK,MAAM,aAAa,IAAI;AAC3D,WAAO,KAAK;AAAA,EACd;AAEA,QAAM,mBAAmB,OAAO,UAAU,SAAS,KAAK,KAAK;AAG7D,MAAI,qBAAqB,KAAK,QAAQ;AACpC,QAAI,OAAO,MAAM,KAAe,GAAG;AACjC,aAAO,KAAK;AAAA,IACd;AACA,QAAI,CAAC,OAAO,SAAS,KAAe,GAAG;AACrC,aAAO,KAAK;AAAA,IACd;AAAA,EACF;AAEA,SAAO;AACT;AAEA,MAAM,kBACJ,IAAO,UACP,CAAC,UACC,MAAM,SAAS,QAAQ,KAAK,CAAC;AAO1B,MAAM,YAAY,CAAI,UAC3B,SAAS;AAOJ,MAAM,SAAS,gBAAsB,KAAK,IAAI;AAO9C,MAAM,cAAc,gBAA2B,KAAK,SAAS;AAO7D,MAAM,WAAW,gBAA2B,KAAK,MAAM;AAOvD,MAAM,UAAU,gBAA2B,KAAK,KAAK;AAOrD,MAAM,WAAW,gBAAwB,KAAK,MAAM;AAOpD,MAAM,WAAW,gBAAwB,KAAK,MAAM;AAOpD,MAAM,YAAY,gBAAyB,KAAK,OAAO;AAOvD,MAAM,aAAa;AAAA,EACxB,KAAK;AAAA,EACL,KAAK;AACP;AAOO,MAAM,WAAW,gBAAwB,KAAK,MAAM;AAOpD,MAAM,YAAY,gBAA6B,KAAK,OAAO;AAO3D,MAAM,QAAQ,gBAAwB,KAAK,GAAG;AAS9C,MAAM,aAAa,gBAAwB,KAAK,QAAQ;AASxD,MAAM,WAAW,gBAAwB,KAAK,MAAM;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"type-guard.js","names":[],"sources":["../src/type-guard/_exports.ts"],"sourcesContent":["import type { AnyFunction, AnyObject, ValueOf } from 'yummies/types';\n\nconst TYPE = {\n  Null: 'null',\n  Undefined: 'undefined',\n  NaN: 'nan',\n  Object: '[object Object]',\n  Array: '[object Array]',\n  String: '[object String]',\n  Number: '[object Number]',\n  Boolean: '[object Boolean]',\n  Function: '[object Function]',\n  AsyncFunction: '[object AsyncFunction]',\n  RegExp: '[object RegExp]',\n  Symbol: '[object Symbol]',\n  Infinite: 'infinite',\n  Element: 'element',\n};\n\ntype Type = ValueOf<typeof TYPE>;\n\nfunction getType(value: unknown): Type {\n  if (value === undefined) {\n    return TYPE.Undefined;\n  }\n  if (value === null) {\n    return TYPE.Null;\n  }\n\n  // handle DOM elements\n  // @ts-expect-error\n  if (value && (value.nodeType === 1 || value.nodeType === 9)) {\n    return TYPE.Element;\n  }\n\n  const stringifiedValue = Object.prototype.toString.call(value);\n\n  // handle NaN and Infinity\n  if (stringifiedValue === TYPE.Number) {\n    if (Number.isNaN(value as number)) {\n      return TYPE.NaN;\n    }\n    if (!Number.isFinite(value as number)) {\n      return TYPE.Infinite;\n    }\n  }\n\n  return stringifiedValue as Type;\n}\n\nconst createTypeGuard =\n  <T>(...types: Type[]) =>\n  (value: unknown): value is T =>\n    types.includes(getType(value));\n\n/**\n * Checks that a value is neither `null` nor `undefined`.\n *\n * @template T Value type without nullish branches.\n * @param value Value to test.\n * @returns `true` when the value is defined.\n *\n * @example\n * ```ts\n * isDefined(0); // true\n * ```\n *\n * @example\n * ```ts\n * isDefined(null); // false\n * ```\n */\nexport const isDefined = <T>(value: T | undefined | null): value is T =>\n  value != null;\n\n/**\n * Checks whether a value is exactly `null`.\n *\n * @param value Value to test.\n * @returns `true` when the value is `null`.\n *\n * @example\n * ```ts\n * isNull(null); // true\n * ```\n *\n * @example\n * ```ts\n * isNull(undefined); // false\n * ```\n */\nexport const isNull = createTypeGuard<null>(TYPE.Null);\n\n/**\n * Checks whether a value is exactly `undefined`.\n *\n * @param value Value to test.\n * @returns `true` when the value is `undefined`.\n *\n * @example\n * ```ts\n * isUndefined(undefined); // true\n * ```\n *\n * @example\n * ```ts\n * isUndefined('value'); // false\n * ```\n */\nexport const isUndefined = createTypeGuard<undefined>(TYPE.Undefined);\n\n/**\n * Checks whether a value is a plain object.\n *\n * @param value Value to test.\n * @returns `true` when the value matches `[object Object]`.\n *\n * @example\n * ```ts\n * isObject({ id: 1 }); // true\n * ```\n *\n * @example\n * ```ts\n * isObject([]); // false\n * ```\n */\nexport const isObject = createTypeGuard<AnyObject>(TYPE.Object);\n\n/**\n * Checks whether a value is an array.\n *\n * @param value Value to test.\n * @returns `true` when the value is an array.\n *\n * @example\n * ```ts\n * isArray([1, 2, 3]); // true\n * ```\n *\n * @example\n * ```ts\n * isArray({ length: 1 }); // false\n * ```\n */\nexport const isArray = createTypeGuard<unknown[]>(TYPE.Array);\n\n/**\n * Checks whether a value is a string object or primitive string.\n *\n * @param value Value to test.\n * @returns `true` when the value is a string.\n *\n * @example\n * ```ts\n * isString('hello'); // true\n * ```\n *\n * @example\n * ```ts\n * isString(123); // false\n * ```\n */\nexport const isString = createTypeGuard<string>(TYPE.String);\n\n/**\n * Checks whether a value is a finite number.\n *\n * Unlike `isNaN` and `isInfinite`, this guard only matches regular numeric values.\n *\n * @param value Value to test.\n * @returns `true` when the value is a non-NaN finite number.\n *\n * @example\n * ```ts\n * isNumber(123); // true\n * ```\n *\n * @example\n * ```ts\n * isNumber(Number.NaN); // false\n * ```\n */\nexport const isNumber = createTypeGuard<number>(TYPE.Number);\n\n/**\n * Checks whether a value is a boolean.\n *\n * @param value Value to test.\n * @returns `true` when the value is a boolean.\n *\n * @example\n * ```ts\n * isBoolean(true); // true\n * ```\n *\n * @example\n * ```ts\n * isBoolean('true'); // false\n * ```\n */\nexport const isBoolean = createTypeGuard<boolean>(TYPE.Boolean);\n\n/**\n * Checks whether a value is a synchronous or asynchronous function.\n *\n * @param value Value to test.\n * @returns `true` when the value is a function.\n *\n * @example\n * ```ts\n * isFunction(() => {}); // true\n * ```\n *\n * @example\n * ```ts\n * isFunction(async () => {}); // true\n * ```\n */\nexport const isFunction = createTypeGuard<AnyFunction>(\n  TYPE.Function,\n  TYPE.AsyncFunction,\n);\n\n/**\n * Checks whether a value is a regular expression.\n *\n * @param value Value to test.\n * @returns `true` when the value is a `RegExp`.\n *\n * @example\n * ```ts\n * isRegExp(/foo/); // true\n * ```\n *\n * @example\n * ```ts\n * isRegExp('foo'); // false\n * ```\n */\nexport const isRegExp = createTypeGuard<RegExp>(TYPE.RegExp);\n\n/**\n * Checks whether a value looks like a DOM element or document node.\n *\n * @param value Value to test.\n * @returns `true` when the value has an element-like node type.\n *\n * @example\n * ```ts\n * isElement(document.body); // true\n * ```\n *\n * @example\n * ```ts\n * isElement({ nodeType: 3 }); // false\n * ```\n */\nexport const isElement = createTypeGuard<HTMLElement>(TYPE.Element);\n\n/**\n * Checks whether a value is `NaN`.\n *\n * @param value Value to test.\n * @returns `true` when the value is `NaN`.\n *\n * @example\n * ```ts\n * isNaN(Number.NaN); // true\n * ```\n *\n * @example\n * ```ts\n * isNaN(5); // false\n * ```\n */\nexport const isNaN = createTypeGuard<number>(TYPE.NaN) as (\n  value: unknown,\n) => boolean;\n\n/**\n * Checks whether a value is positive or negative infinity.\n *\n * @param value Value to test.\n * @returns `true` when the value is not finite.\n *\n * @example\n * ```ts\n * isInfinite(Infinity); // true\n * ```\n *\n * @example\n * ```ts\n * isInfinite(10); // false\n * ```\n */\nexport const isInfinite = createTypeGuard<number>(TYPE.Infinite) as (\n  value: unknown,\n) => boolean;\n\n/**\n * Checks whether a value is a symbol.\n *\n * @param value Value to test.\n * @returns `true` when the value is a symbol.\n *\n * @example\n * ```ts\n * isSymbol(Symbol('id')); // true\n * ```\n *\n * @example\n * ```ts\n * isSymbol('id'); // false\n * ```\n */\nexport const isSymbol = createTypeGuard<symbol>(TYPE.Symbol);\n"],"mappings":";;;;;;;;;;;;;;;;;;AAEA,IAAM,OAAO;CACX,MAAM;CACN,WAAW;CACX,KAAK;CACL,QAAQ;CACR,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,UAAU;CACV,eAAe;CACf,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,SAAS;CACV;AAID,SAAS,QAAQ,OAAsB;AACrC,KAAI,UAAU,KAAA,EACZ,QAAO,KAAK;AAEd,KAAI,UAAU,KACZ,QAAO,KAAK;AAKd,KAAI,UAAU,MAAM,aAAa,KAAK,MAAM,aAAa,GACvD,QAAO,KAAK;CAGd,MAAM,mBAAmB,OAAO,UAAU,SAAS,KAAK,MAAM;AAG9D,KAAI,qBAAqB,KAAK,QAAQ;AACpC,MAAI,OAAO,MAAM,MAAgB,CAC/B,QAAO,KAAK;AAEd,MAAI,CAAC,OAAO,SAAS,MAAgB,CACnC,QAAO,KAAK;;AAIhB,QAAO;;AAGT,IAAM,mBACA,GAAG,WACN,UACC,MAAM,SAAS,QAAQ,MAAM,CAAC;;;;;;;;;;;;;;;;;;AAmBlC,IAAa,aAAgB,UAC3B,SAAS;;;;;;;;;;;;;;;;;AAkBX,IAAa,SAAS,gBAAsB,KAAK,KAAK;;;;;;;;;;;;;;;;;AAkBtD,IAAa,cAAc,gBAA2B,KAAK,UAAU;;;;;;;;;;;;;;;;;AAkBrE,IAAa,WAAW,gBAA2B,KAAK,OAAO;;;;;;;;;;;;;;;;;AAkB/D,IAAa,UAAU,gBAA2B,KAAK,MAAM;;;;;;;;;;;;;;;;;AAkB7D,IAAa,WAAW,gBAAwB,KAAK,OAAO;;;;;;;;;;;;;;;;;;;AAoB5D,IAAa,WAAW,gBAAwB,KAAK,OAAO;;;;;;;;;;;;;;;;;AAkB5D,IAAa,YAAY,gBAAyB,KAAK,QAAQ;;;;;;;;;;;;;;;;;AAkB/D,IAAa,aAAa,gBACxB,KAAK,UACL,KAAK,cACN;;;;;;;;;;;;;;;;;AAkBD,IAAa,WAAW,gBAAwB,KAAK,OAAO;;;;;;;;;;;;;;;;;AAkB5D,IAAa,YAAY,gBAA6B,KAAK,QAAQ;;;;;;;;;;;;;;;;;AAkBnE,IAAa,QAAQ,gBAAwB,KAAK,IAAI;;;;;;;;;;;;;;;;;AAoBtD,IAAa,aAAa,gBAAwB,KAAK,SAAS;;;;;;;;;;;;;;;;;AAoBhE,IAAa,WAAW,gBAAwB,KAAK,OAAO"}