@ntnyq/utils 0.6.3 → 0.6.4

package/dist/index.cjs

@@ -59,6 +59,7 @@ __export(index_exports, {
   isEmptyStringOrWhitespace: () => isEmptyStringOrWhitespace,
   isError: () => isError,
   isFunction: () => isFunction,
+  isHTMLElement: () => isHTMLElement,
   isInteger: () => isInteger,
   isIterable: () => isIterable,
   isMap: () => isMap,
@@ -131,35 +132,12 @@ function once(func) {
   };
 }
 
-// src/is/isDeepEqual.ts
-function isDeepEqual(value1, value2) {
-  const type1 = getObjectType(value1);
-  const type2 = getObjectType(value2);
-  if (type1 !== type2) {
-    return false;
-  }
-  if (isArray(value1) && isArray(value2)) {
-    if (value1.length !== value2.length) {
-      return false;
-    }
-    return value1.every((item, index) => isDeepEqual(item, value2[index]));
-  }
-  if (isObject(value1) && isObject(value2)) {
-    const keys = Object.keys(value1);
-    if (keys.length !== Object.keys(value2).length) {
-      return false;
-    }
-    return keys.every(
-      (key) => isDeepEqual(
-        value1[key],
-        value2[key]
-      )
-    );
-  }
-  return Object.is(value1, value2);
+// src/is/dom.ts
+function isHTMLElement(value) {
+  return typeof value === "object" && value !== null && "nodeType" in value && value.nodeType === Node.ELEMENT_NODE && value instanceof HTMLElement;
 }
 
-// src/is/index.ts
+// src/is/core.ts
 function getObjectType(value) {
   return Object.prototype.toString.call(value).slice(8, -1);
 }
@@ -264,6 +242,34 @@ function isIterable(value) {
   return isFunction(value?.[Symbol.iterator]);
 }
 
+// src/is/isDeepEqual.ts
+function isDeepEqual(value1, value2) {
+  const type1 = getObjectType(value1);
+  const type2 = getObjectType(value2);
+  if (type1 !== type2) {
+    return false;
+  }
+  if (isArray(value1) && isArray(value2)) {
+    if (value1.length !== value2.length) {
+      return false;
+    }
+    return value1.every((item, index) => isDeepEqual(item, value2[index]));
+  }
+  if (isObject(value1) && isObject(value2)) {
+    const keys = Object.keys(value1);
+    if (keys.length !== Object.keys(value2).length) {
+      return false;
+    }
+    return keys.every(
+      (key) => isDeepEqual(
+        value1[key],
+        value2[key]
+      )
+    );
+  }
+  return Object.is(value1, value2);
+}
+
 // src/dom/scrollIntoView.ts
 function scrollElementIntoView(element, options = {}) {
   const body = document.body;
@@ -867,6 +873,7 @@ var RE_BLOCK_COMMENT = /\/\*[\s\S]*?\*\//g;
   isEmptyStringOrWhitespace,
   isError,
   isFunction,
+  isHTMLElement,
   isInteger,
   isIterable,
   isMap,

package/dist/index.d.cts

@@ -10,9 +10,14 @@ declare const NOOP: typeof noop;
 declare function once<T extends unknown[]>(func: (...args: T) => void): (this: unknown, ...args: T) => boolean;
 
 /**
- * check if two values are deeply equal
+ * @file is/dom.ts
  */
-declare function isDeepEqual(value1: any, value2: any): boolean;
+/**
+ * Check if given value is an HTMLElement
+ * @param value - The value to check
+ * @returns True if the value is an HTMLElement, false otherwise
+ */
+declare function isHTMLElement(value: unknown): value is HTMLElement;
 
 /**
  * @file is utils
@@ -57,6 +62,11 @@ declare function isNativePromise<T = unknown>(value: unknown): value is Promise<
 declare function isPromise<T = unknown>(value: unknown): value is Promise<T>;
 declare function isIterable<T = unknown>(value: unknown): value is Iterable<T>;
 
+/**
+ * check if two values are deeply equal
+ */
+declare function isDeepEqual(value1: any, value2: any): boolean;
+
 interface Options extends ScrollIntoViewOptions {
     /**
      * @default `document.body`
@@ -608,4 +618,4 @@ declare const RE_LINE_COMMENT: RegExp;
  */
 declare const RE_BLOCK_COMMENT: RegExp;
 
-export { type AnyFn, type Arrayable, type Awaitable, type Callable, type CleanObjectOptions, Color, type CreatePadStringOptions, type InteropModuleDefault, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type LiteralUnion, type MayBe, NOOP, type NonEmptyObject, type NonEmptyString, type Nullable, type OpenExternalURLOptions, type Overwrite, type Prettify, type PrettifyV2, type PrimitiveType, RE_BLOCK_COMMENT, RE_COMMENTS, RE_LINE_COMMENT, type RamdomNumberOptions, type ResolvedOptions, SPECIAL_CHAR, type SortObjectOptions, type ThrottleDebounceOptions, type Whitespace, at, cAF, chunk, clamp, cleanObject, createPadString, days, debounce, enhance, ensurePrefix, ensureSuffix, escapeHTML, flattenArrayable, getObjectType, hasOwn, hours, interopDefault, intersect, isArray, isArrayEqual, isBigInt, isBoolean, isBrowser, isDeepEqual, isElementVisibleInViewport, isEmptyArray, isEmptyMap, isEmptyObject, isEmptySet, isEmptyString, isEmptyStringOrWhitespace, isError, isFunction, isInteger, isIterable, isMap, isNaN, isNativePromise, isNil, isNonEmptyArray, isNonEmptyString, isNull, isNullOrUndefined, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isTruthy, isUndefined, isWhitespaceString, isZero, join, last, mergeArrayable, minutes, noop, omit, once, openExternalURL, pick, rAF, randomHexColor, randomNumber, randomRGBAColor, randomRGBColor, randomString, resolveSubOptions, scrollElementIntoView, seconds, slash, slugify, sortObject, throttle, toArray, unescapeHTML, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };
+export { type AnyFn, type Arrayable, type Awaitable, type Callable, type CleanObjectOptions, Color, type CreatePadStringOptions, type InteropModuleDefault, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type LiteralUnion, type MayBe, NOOP, type NonEmptyObject, type NonEmptyString, type Nullable, type OpenExternalURLOptions, type Overwrite, type Prettify, type PrettifyV2, type PrimitiveType, RE_BLOCK_COMMENT, RE_COMMENTS, RE_LINE_COMMENT, type RamdomNumberOptions, type ResolvedOptions, SPECIAL_CHAR, type SortObjectOptions, type ThrottleDebounceOptions, type Whitespace, at, cAF, chunk, clamp, cleanObject, createPadString, days, debounce, enhance, ensurePrefix, ensureSuffix, escapeHTML, flattenArrayable, getObjectType, hasOwn, hours, interopDefault, intersect, isArray, isArrayEqual, isBigInt, isBoolean, isBrowser, isDeepEqual, isElementVisibleInViewport, isEmptyArray, isEmptyMap, isEmptyObject, isEmptySet, isEmptyString, isEmptyStringOrWhitespace, isError, isFunction, isHTMLElement, isInteger, isIterable, isMap, isNaN, isNativePromise, isNil, isNonEmptyArray, isNonEmptyString, isNull, isNullOrUndefined, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isTruthy, isUndefined, isWhitespaceString, isZero, join, last, mergeArrayable, minutes, noop, omit, once, openExternalURL, pick, rAF, randomHexColor, randomNumber, randomRGBAColor, randomRGBColor, randomString, resolveSubOptions, scrollElementIntoView, seconds, slash, slugify, sortObject, throttle, toArray, unescapeHTML, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };

package/dist/index.d.ts

@@ -10,9 +10,14 @@ declare const NOOP: typeof noop;
 declare function once<T extends unknown[]>(func: (...args: T) => void): (this: unknown, ...args: T) => boolean;
 
 /**
- * check if two values are deeply equal
+ * @file is/dom.ts
  */
-declare function isDeepEqual(value1: any, value2: any): boolean;
+/**
+ * Check if given value is an HTMLElement
+ * @param value - The value to check
+ * @returns True if the value is an HTMLElement, false otherwise
+ */
+declare function isHTMLElement(value: unknown): value is HTMLElement;
 
 /**
  * @file is utils
@@ -57,6 +62,11 @@ declare function isNativePromise<T = unknown>(value: unknown): value is Promise<
 declare function isPromise<T = unknown>(value: unknown): value is Promise<T>;
 declare function isIterable<T = unknown>(value: unknown): value is Iterable<T>;
 
+/**
+ * check if two values are deeply equal
+ */
+declare function isDeepEqual(value1: any, value2: any): boolean;
+
 interface Options extends ScrollIntoViewOptions {
     /**
      * @default `document.body`
@@ -608,4 +618,4 @@ declare const RE_LINE_COMMENT: RegExp;
  */
 declare const RE_BLOCK_COMMENT: RegExp;
 
-export { type AnyFn, type Arrayable, type Awaitable, type Callable, type CleanObjectOptions, Color, type CreatePadStringOptions, type InteropModuleDefault, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type LiteralUnion, type MayBe, NOOP, type NonEmptyObject, type NonEmptyString, type Nullable, type OpenExternalURLOptions, type Overwrite, type Prettify, type PrettifyV2, type PrimitiveType, RE_BLOCK_COMMENT, RE_COMMENTS, RE_LINE_COMMENT, type RamdomNumberOptions, type ResolvedOptions, SPECIAL_CHAR, type SortObjectOptions, type ThrottleDebounceOptions, type Whitespace, at, cAF, chunk, clamp, cleanObject, createPadString, days, debounce, enhance, ensurePrefix, ensureSuffix, escapeHTML, flattenArrayable, getObjectType, hasOwn, hours, interopDefault, intersect, isArray, isArrayEqual, isBigInt, isBoolean, isBrowser, isDeepEqual, isElementVisibleInViewport, isEmptyArray, isEmptyMap, isEmptyObject, isEmptySet, isEmptyString, isEmptyStringOrWhitespace, isError, isFunction, isInteger, isIterable, isMap, isNaN, isNativePromise, isNil, isNonEmptyArray, isNonEmptyString, isNull, isNullOrUndefined, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isTruthy, isUndefined, isWhitespaceString, isZero, join, last, mergeArrayable, minutes, noop, omit, once, openExternalURL, pick, rAF, randomHexColor, randomNumber, randomRGBAColor, randomRGBColor, randomString, resolveSubOptions, scrollElementIntoView, seconds, slash, slugify, sortObject, throttle, toArray, unescapeHTML, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };
+export { type AnyFn, type Arrayable, type Awaitable, type Callable, type CleanObjectOptions, Color, type CreatePadStringOptions, type InteropModuleDefault, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type LiteralUnion, type MayBe, NOOP, type NonEmptyObject, type NonEmptyString, type Nullable, type OpenExternalURLOptions, type Overwrite, type Prettify, type PrettifyV2, type PrimitiveType, RE_BLOCK_COMMENT, RE_COMMENTS, RE_LINE_COMMENT, type RamdomNumberOptions, type ResolvedOptions, SPECIAL_CHAR, type SortObjectOptions, type ThrottleDebounceOptions, type Whitespace, at, cAF, chunk, clamp, cleanObject, createPadString, days, debounce, enhance, ensurePrefix, ensureSuffix, escapeHTML, flattenArrayable, getObjectType, hasOwn, hours, interopDefault, intersect, isArray, isArrayEqual, isBigInt, isBoolean, isBrowser, isDeepEqual, isElementVisibleInViewport, isEmptyArray, isEmptyMap, isEmptyObject, isEmptySet, isEmptyString, isEmptyStringOrWhitespace, isError, isFunction, isHTMLElement, isInteger, isIterable, isMap, isNaN, isNativePromise, isNil, isNonEmptyArray, isNonEmptyString, isNull, isNullOrUndefined, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isTruthy, isUndefined, isWhitespaceString, isZero, join, last, mergeArrayable, minutes, noop, omit, once, openExternalURL, pick, rAF, randomHexColor, randomNumber, randomRGBAColor, randomRGBColor, randomString, resolveSubOptions, scrollElementIntoView, seconds, slash, slugify, sortObject, throttle, toArray, unescapeHTML, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };

package/dist/index.js

@@ -16,35 +16,12 @@ function once(func) {
   };
 }
 
-// src/is/isDeepEqual.ts
-function isDeepEqual(value1, value2) {
-  const type1 = getObjectType(value1);
-  const type2 = getObjectType(value2);
-  if (type1 !== type2) {
-    return false;
-  }
-  if (isArray(value1) && isArray(value2)) {
-    if (value1.length !== value2.length) {
-      return false;
-    }
-    return value1.every((item, index) => isDeepEqual(item, value2[index]));
-  }
-  if (isObject(value1) && isObject(value2)) {
-    const keys = Object.keys(value1);
-    if (keys.length !== Object.keys(value2).length) {
-      return false;
-    }
-    return keys.every(
-      (key) => isDeepEqual(
-        value1[key],
-        value2[key]
-      )
-    );
-  }
-  return Object.is(value1, value2);
+// src/is/dom.ts
+function isHTMLElement(value) {
+  return typeof value === "object" && value !== null && "nodeType" in value && value.nodeType === Node.ELEMENT_NODE && value instanceof HTMLElement;
 }
 
-// src/is/index.ts
+// src/is/core.ts
 function getObjectType(value) {
   return Object.prototype.toString.call(value).slice(8, -1);
 }
@@ -149,6 +126,34 @@ function isIterable(value) {
   return isFunction(value?.[Symbol.iterator]);
 }
 
+// src/is/isDeepEqual.ts
+function isDeepEqual(value1, value2) {
+  const type1 = getObjectType(value1);
+  const type2 = getObjectType(value2);
+  if (type1 !== type2) {
+    return false;
+  }
+  if (isArray(value1) && isArray(value2)) {
+    if (value1.length !== value2.length) {
+      return false;
+    }
+    return value1.every((item, index) => isDeepEqual(item, value2[index]));
+  }
+  if (isObject(value1) && isObject(value2)) {
+    const keys = Object.keys(value1);
+    if (keys.length !== Object.keys(value2).length) {
+      return false;
+    }
+    return keys.every(
+      (key) => isDeepEqual(
+        value1[key],
+        value2[key]
+      )
+    );
+  }
+  return Object.is(value1, value2);
+}
+
 // src/dom/scrollIntoView.ts
 function scrollElementIntoView(element, options = {}) {
   const body = document.body;
@@ -751,6 +756,7 @@ export {
   isEmptyStringOrWhitespace,
   isError,
   isFunction,
+  isHTMLElement,
   isInteger,
   isIterable,
   isMap,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ntnyq/utils",
   "type": "module",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "Common used utils.",
   "keywords": [
     "utils"