tiny-essentials 1.28.2 → 1.28.4

package/dist/v1/basics/index.cjs

@@ -31,7 +31,9 @@ exports.readJsonBlob = html.readJsonBlob;
 exports.saveJsonFile = html.saveJsonFile;
 exports.cloneObjTypeOrder = objFilter.cloneObjTypeOrder;
 exports.extendObjType = objFilter.extendObjType;
+exports.isObjType = objFilter.isObjType;
 exports.objType = objFilter.objType;
+exports.objTypeName = objFilter.objTypeName;
 exports.reorderObjTypeOrder = objFilter.reorderObjTypeOrder;
 exports.countObj = objChecker.countObj;
 exports.isJsonObject = objChecker.isJsonObject;

package/dist/v1/basics/index.d.mts

@@ -1,12 +1,12 @@
 import { diffArrayList, shuffleArray, arraySortPositions, multiplyArrayBlocks } from './array.mjs';
 import { breakdownDuration, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration } from './clock.mjs';
 import { readJsonBlob, saveJsonFile, fetchJson, installWindowHiddenScript, readFileBlob, readBase64Blob, fetchText } from './html.mjs';
-import { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType } from './objFilter.mjs';
+import { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, isObjType, objTypeName } from './objFilter.mjs';
 import { countObj, isJsonObject } from './objChecker.mjs';
 import { documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange } from './fullScreen.mjs';
 import { calculateMarketcap, compareMarketcap, formatBytes, genFibonacciSeq, getAge, getPercentage, getSimplePerc, ruleOfThree } from './simpleMath.mjs';
 import { addAiMarkerShortcut, diffStrings, diffObjList, safeTextTrim, toTitleCase, toTitleCaseLowerFirst, asyncReplace } from './text.mjs';
 import { areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails } from './collision.mjs';
 import { extractMediaId3Tags, parseMediaMetadata, valMediaContentMetadata, valMediaContentMetadataPartial } from './mediaContent.mjs';
-export { multiplyArrayBlocks, valMediaContentMetadata, valMediaContentMetadataPartial, parseMediaMetadata, extractMediaId3Tags, diffStrings, diffObjList, diffArrayList, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+export { multiplyArrayBlocks, valMediaContentMetadata, valMediaContentMetadataPartial, parseMediaMetadata, extractMediaId3Tags, diffStrings, diffObjList, diffArrayList, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, isObjType, objTypeName, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
 //# sourceMappingURL=index.d.mts.map

package/dist/v1/basics/index.mjs

@@ -1,11 +1,11 @@
 import { diffArrayList, shuffleArray, arraySortPositions, multiplyArrayBlocks } from './array.mjs';
 import { breakdownDuration, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, } from './clock.mjs';
 import { readJsonBlob, saveJsonFile, fetchJson, installWindowHiddenScript, readFileBlob, readBase64Blob, fetchText, } from './html.mjs';
-import { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType } from './objFilter.mjs';
+import { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, isObjType, objTypeName, } from './objFilter.mjs';
 import { countObj, isJsonObject } from './objChecker.mjs';
 import { documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, } from './fullScreen.mjs';
 import { calculateMarketcap, compareMarketcap, formatBytes, genFibonacciSeq, getAge, getPercentage, getSimplePerc, ruleOfThree, } from './simpleMath.mjs';
 import { addAiMarkerShortcut, diffStrings, diffObjList, safeTextTrim, toTitleCase, toTitleCaseLowerFirst, asyncReplace, } from './text.mjs';
 import { areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, } from './collision.mjs';
 import { extractMediaId3Tags, parseMediaMetadata, valMediaContentMetadata, valMediaContentMetadataPartial, } from './mediaContent.mjs';
-export { multiplyArrayBlocks, valMediaContentMetadata, valMediaContentMetadataPartial, parseMediaMetadata, extractMediaId3Tags, diffStrings, diffObjList, diffArrayList, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+export { multiplyArrayBlocks, valMediaContentMetadata, valMediaContentMetadataPartial, parseMediaMetadata, extractMediaId3Tags, diffStrings, diffObjList, diffArrayList, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, isObjType, objTypeName, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/dist/v1/basics/objFilter.cjs

@@ -2,6 +2,8 @@
 
 var objChecker = require('./objChecker.cjs');
 
+// @ts-nocheck
+
 const isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';
 
 /**
@@ -144,9 +146,6 @@ function cloneObjTypeOrder() {
 /**
  * Returns the detected type name of a given value based on predefined type validators.
  *
- * This function uses `getType` with a predefined `typeValidator` to determine or compare types safely.
- * in the specified `typeValidator.order`. The first matching type is returned.
- *
  * If `val` is `null`, it immediately returns `'null'`.
  * If no match is found, it returns `'unknown'`.
  *
@@ -154,12 +153,11 @@ function cloneObjTypeOrder() {
  * @returns {string} - The type name of the value (e.g., "array", "date", "map"), or "unknown" if no match is found.
  *
  * @example
- * getType([]); // "array"
- * getType(null); // "null"
- * getType(new Set()); // "set"
- * getType(() => {}); // "unknown"
+ * objTypeName([]); // "array"
+ * objTypeName(null); // "null"
+ * objTypeName(new Set()); // "set"
  */
-const getType = (val) => {
+const objTypeName = (val) => {
   if (val === null) return 'null';
   // @ts-ignore
   for (const name of typeValidator.order) {
@@ -170,9 +168,22 @@ const getType = (val) => {
   return 'unknown';
 };
 
+/**
+ * Checks the type of a given object.
+ *
+ * @param {*} obj - The object to check.
+ * @param {string} [type] - Checks whether the object matches this type (e.g., "object", "array", "string").
+ * @returns {boolean} - Returns `true` if the type matches.
+ */
+function isObjType(obj, type) {
+  if (typeof type !== 'string') throw new TypeError("Argument 'type' must be a string.");
+  return objTypeName(obj) === type.toLowerCase();
+}
+
 /**
  * Checks the type of a given object or returns its type as a string.
  *
+ * @deprecated Use {@link isObjType} or {@link objTypeName} instead.
  * @param {*} obj - The object to check or identify.
  * @param {string} [type] - Optional. If provided, checks whether the object matches this type (e.g., "object", "array", "string").
  * @returns {boolean|string|null} - Returns `true` if the type matches, `false` if not,
@@ -190,7 +201,7 @@ function objType(obj, type) {
     throw new TypeError("Argument 'type' must be a string.");
   }
 
-  const result = getType(obj);
+  const result = objTypeName(obj);
   if (typeof type === 'string') return result === type.toLowerCase();
   return result;
 }
@@ -232,49 +243,48 @@ function getCheckObj() {
 extendObjType([
   [
     'undefined',
-    /** @param {*} val @returns {val is undefined} */
+    /** @param {unknown} val @returns {val is undefined} */
     (val) => typeof val === 'undefined',
   ],
   [
     'null',
-    /** @param {*} val @returns {val is null} */
+    /** @param {unknown} val @returns {val is null} */
     (val) => val === null,
   ],
   [
     'boolean',
-    /** @param {*} val @returns {val is boolean} */
+    /** @param {unknown} val @returns {val is boolean} */
     (val) => typeof val === 'boolean',
   ],
   [
     'number',
-    /** @param {*} val @returns {val is number} */
+    /** @param {unknown} val @returns {val is number} */
     (val) => typeof val === 'number' && !Number.isNaN(val),
   ],
   [
     'bigint',
-    /** @param {*} val @returns {val is bigint} */
+    /** @param {unknown} val @returns {val is bigint} */
     (val) => typeof val === 'bigint',
   ],
   [
     'string',
-    /** @param {*} val @returns {val is string} */
+    /** @param {unknown} val @returns {val is string} */
     (val) => typeof val === 'string',
   ],
   [
     'symbol',
-    /** @param {*} val @returns {val is symbol} */
+    /** @param {unknown} val @returns {val is symbol} */
     (val) => typeof val === 'symbol',
   ],
   [
     'function',
-    /** @param {*} val @returns {val is Function} */
+    /** @param {unknown} val @returns {val is Function} */
     (val) => typeof val === 'function',
   ],
   [
     'array',
     /**
-     * @template {any} Value
-     * @param {*} val @returns {val is Value[]}
+     * @param {unknown} val @returns {val is unknown[]}
      */
     (val) => Array.isArray(val),
   ],
@@ -284,7 +294,7 @@ if (isBrowser) {
   extendObjType([
     [
       'file',
-      /** @param {*} val @returns {val is File} */
+      /** @param {unknown} val @returns {val is File} */
       (val) => typeof File !== 'undefined' && val instanceof File,
     ],
   ]);
@@ -293,53 +303,46 @@ if (isBrowser) {
 extendObjType([
   [
     'date',
-    /** @param {*} val @returns {val is Date} */
+    /** @param {unknown} val @returns {val is Date} */
     (val) => val instanceof Date,
   ],
   [
     'regexp',
-    /** @param {*} val @returns {val is RegExp} */
+    /** @param {unknown} val @returns {val is RegExp} */
     (val) => val instanceof RegExp,
   ],
   [
     'map',
     /**
-     * @template {any} Key
-     * @template {any} Value
-     * @param {*} val @returns {val is Map<Key, Value>}
+     * @param {unknown} val @returns {val is Map<unknown, unknown>}
      */
     (val) => val instanceof Map,
   ],
   [
     'set',
     /**
-     * @template {any} Value
-     * @param {*} val @returns {val is Set<Value>}
+     * @param {unknown} val @returns {val is Set<unknown>}
      */
     (val) => val instanceof Set,
   ],
   [
     'weakmap',
     /**
-     * @template {WeakKey} Key
-     * @template {any} Value
-     * @param {*} val @returns {val is WeakMap<Key, Value>}
+     * @param {unknown} val @returns {val is WeakMap<unknown, unknown>}
      */
     (val) => val instanceof WeakMap,
   ],
   [
     'weakset',
     /**
-     * @template {WeakKey} Value
-     * @param {*} val @returns {val is WeakSet<Value>}
+     * @param {unknown} val @returns {val is WeakSet<unknown>}
      */
     (val) => val instanceof WeakSet,
   ],
   [
     'promise',
     /**
-     * @template {any} Value
-     * @param {*} val @returns {val is Promise<Value>}
+     * @param {unknown} val @returns {val is Promise<unknown>}
      */
     (val) => val instanceof Promise,
   ],
@@ -349,7 +352,7 @@ if (isBrowser) {
   extendObjType([
     [
       'htmlelement',
-      /** @param {*} val @returns {val is HTMLElement} */
+      /** @param {unknown} val @returns {val is HTMLElement} */
       (val) => typeof HTMLElement !== 'undefined' && val instanceof HTMLElement,
     ],
   ]);
@@ -359,9 +362,7 @@ extendObjType([
   [
     'object',
     /**
-     * @template {string | number | symbol} Key
-     * @template {any} Value
-     * @param {*} val @returns {val is Record<Key, Value>}
+     * @param {unknown} val @returns {val is Record<string | number | symbol, unknown>}
      */
     (val) => objChecker.isJsonObject(val),
   ],
@@ -373,5 +374,7 @@ exports.checkObj = checkObj;
 exports.cloneObjTypeOrder = cloneObjTypeOrder;
 exports.extendObjType = extendObjType;
 exports.getCheckObj = getCheckObj;
+exports.isObjType = isObjType;
 exports.objType = objType;
+exports.objTypeName = objTypeName;
 exports.reorderObjTypeOrder = reorderObjTypeOrder;

package/dist/v1/basics/objFilter.d.mts

@@ -48,9 +48,33 @@ export declare function reorderObjTypeOrder(newOrder: string[]): boolean;
  * @returns {string[]} - A new array with the same values as `typeValidator.order`.
  */
 export declare function cloneObjTypeOrder(): string[];
+/**
+ * Returns the detected type name of a given value based on predefined type validators.
+ *
+ * If `val` is `null`, it immediately returns `'null'`.
+ * If no match is found, it returns `'unknown'`.
+ *
+ * @param {any} val - The value whose type should be determined.
+ * @returns {string} - The type name of the value (e.g., "array", "date", "map"), or "unknown" if no match is found.
+ *
+ * @example
+ * objTypeName([]); // "array"
+ * objTypeName(null); // "null"
+ * objTypeName(new Set()); // "set"
+ */
+export declare const objTypeName: (val: any) => string;
+/**
+ * Checks the type of a given object.
+ *
+ * @param {*} obj - The object to check.
+ * @param {string} [type] - Checks whether the object matches this type (e.g., "object", "array", "string").
+ * @returns {boolean} - Returns `true` if the type matches.
+ */
+export declare function isObjType(obj: any, type?: string): boolean;
 /**
  * Checks the type of a given object or returns its type as a string.
  *
+ * @deprecated Use {@link isObjType} or {@link objTypeName} instead.
  * @param {*} obj - The object to check or identify.
  * @param {string} [type] - Optional. If provided, checks whether the object matches this type (e.g., "object", "array", "string").
  * @returns {boolean|string|null} - Returns `true` if the type matches, `false` if not,

package/dist/v1/basics/objFilter.mjs

@@ -1,3 +1,4 @@
+// @ts-nocheck
 import { countObj, isJsonObject } from './objChecker.mjs';
 export { countObj, isJsonObject };
 const isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';
@@ -121,9 +122,6 @@ export function cloneObjTypeOrder() {
 /**
  * Returns the detected type name of a given value based on predefined type validators.
  *
- * This function uses `getType` with a predefined `typeValidator` to determine or compare types safely.
- * in the specified `typeValidator.order`. The first matching type is returned.
- *
  * If `val` is `null`, it immediately returns `'null'`.
  * If no match is found, it returns `'unknown'`.
  *
@@ -131,12 +129,11 @@ export function cloneObjTypeOrder() {
  * @returns {string} - The type name of the value (e.g., "array", "date", "map"), or "unknown" if no match is found.
  *
  * @example
- * getType([]); // "array"
- * getType(null); // "null"
- * getType(new Set()); // "set"
- * getType(() => {}); // "unknown"
+ * objTypeName([]); // "array"
+ * objTypeName(null); // "null"
+ * objTypeName(new Set()); // "set"
  */
-const getType = (val) => {
+export const objTypeName = (val) => {
     if (val === null)
         return 'null';
     // @ts-ignore
@@ -147,9 +144,22 @@ const getType = (val) => {
     }
     return 'unknown';
 };
+/**
+ * Checks the type of a given object.
+ *
+ * @param {*} obj - The object to check.
+ * @param {string} [type] - Checks whether the object matches this type (e.g., "object", "array", "string").
+ * @returns {boolean} - Returns `true` if the type matches.
+ */
+export function isObjType(obj, type) {
+    if (typeof type !== 'string')
+        throw new TypeError("Argument 'type' must be a string.");
+    return objTypeName(obj) === type.toLowerCase();
+}
 /**
  * Checks the type of a given object or returns its type as a string.
  *
+ * @deprecated Use {@link isObjType} or {@link objTypeName} instead.
  * @param {*} obj - The object to check or identify.
  * @param {string} [type] - Optional. If provided, checks whether the object matches this type (e.g., "object", "array", "string").
  * @returns {boolean|string|null} - Returns `true` if the type matches, `false` if not,
@@ -167,7 +177,7 @@ export function objType(obj, type) {
     if (typeof type !== 'undefined' && typeof type !== 'string') {
         throw new TypeError("Argument 'type' must be a string.");
     }
-    const result = getType(obj);
+    const result = objTypeName(obj);
     if (typeof type === 'string')
         return result === type.toLowerCase();
     return result;
@@ -206,49 +216,48 @@ export function getCheckObj() {
 extendObjType([
     [
         'undefined',
-        /** @param {*} val @returns {val is undefined} */
+        /** @param {unknown} val @returns {val is undefined} */
         (val) => typeof val === 'undefined',
     ],
     [
         'null',
-        /** @param {*} val @returns {val is null} */
+        /** @param {unknown} val @returns {val is null} */
         (val) => val === null,
     ],
     [
         'boolean',
-        /** @param {*} val @returns {val is boolean} */
+        /** @param {unknown} val @returns {val is boolean} */
         (val) => typeof val === 'boolean',
     ],
     [
         'number',
-        /** @param {*} val @returns {val is number} */
+        /** @param {unknown} val @returns {val is number} */
         (val) => typeof val === 'number' && !Number.isNaN(val),
     ],
     [
         'bigint',
-        /** @param {*} val @returns {val is bigint} */
+        /** @param {unknown} val @returns {val is bigint} */
         (val) => typeof val === 'bigint',
     ],
     [
         'string',
-        /** @param {*} val @returns {val is string} */
+        /** @param {unknown} val @returns {val is string} */
         (val) => typeof val === 'string',
     ],
     [
         'symbol',
-        /** @param {*} val @returns {val is symbol} */
+        /** @param {unknown} val @returns {val is symbol} */
         (val) => typeof val === 'symbol',
     ],
     [
         'function',
-        /** @param {*} val @returns {val is Function} */
+        /** @param {unknown} val @returns {val is Function} */
         (val) => typeof val === 'function',
     ],
     [
         'array',
         /**
-         * @template {any} Value
-         * @param {*} val @returns {val is Value[]}
+         * @param {unknown} val @returns {val is unknown[]}
          */
         (val) => Array.isArray(val),
     ],
@@ -257,7 +266,7 @@ if (isBrowser) {
     extendObjType([
         [
             'file',
-            /** @param {*} val @returns {val is File} */
+            /** @param {unknown} val @returns {val is File} */
             (val) => typeof File !== 'undefined' && val instanceof File,
         ],
     ]);
@@ -265,53 +274,46 @@ if (isBrowser) {
 extendObjType([
     [
         'date',
-        /** @param {*} val @returns {val is Date} */
+        /** @param {unknown} val @returns {val is Date} */
         (val) => val instanceof Date,
     ],
     [
         'regexp',
-        /** @param {*} val @returns {val is RegExp} */
+        /** @param {unknown} val @returns {val is RegExp} */
         (val) => val instanceof RegExp,
     ],
     [
         'map',
         /**
-         * @template {any} Key
-         * @template {any} Value
-         * @param {*} val @returns {val is Map<Key, Value>}
+         * @param {unknown} val @returns {val is Map<unknown, unknown>}
          */
         (val) => val instanceof Map,
     ],
     [
         'set',
         /**
-         * @template {any} Value
-         * @param {*} val @returns {val is Set<Value>}
+         * @param {unknown} val @returns {val is Set<unknown>}
          */
         (val) => val instanceof Set,
     ],
     [
         'weakmap',
         /**
-         * @template {WeakKey} Key
-         * @template {any} Value
-         * @param {*} val @returns {val is WeakMap<Key, Value>}
+         * @param {unknown} val @returns {val is WeakMap<unknown, unknown>}
          */
         (val) => val instanceof WeakMap,
     ],
     [
         'weakset',
         /**
-         * @template {WeakKey} Value
-         * @param {*} val @returns {val is WeakSet<Value>}
+         * @param {unknown} val @returns {val is WeakSet<unknown>}
          */
         (val) => val instanceof WeakSet,
     ],
     [
         'promise',
         /**
-         * @template {any} Value
-         * @param {*} val @returns {val is Promise<Value>}
+         * @param {unknown} val @returns {val is Promise<unknown>}
          */
         (val) => val instanceof Promise,
     ],
@@ -320,7 +322,7 @@ if (isBrowser) {
     extendObjType([
         [
             'htmlelement',
-            /** @param {*} val @returns {val is HTMLElement} */
+            /** @param {unknown} val @returns {val is HTMLElement} */
             (val) => typeof HTMLElement !== 'undefined' && val instanceof HTMLElement,
         ],
     ]);
@@ -329,9 +331,7 @@ extendObjType([
     [
         'object',
         /**
-         * @template {string | number | symbol} Key
-         * @template {any} Value
-         * @param {*} val @returns {val is Record<Key, Value>}
+         * @param {unknown} val @returns {val is Record<string | number | symbol, unknown>}
          */
         (val) => isJsonObject(val),
     ],

package/dist/v1/index.cjs

@@ -71,7 +71,9 @@ exports.getTimeDuration = clock.getTimeDuration;
 exports.checkObj = objFilter.checkObj;
 exports.cloneObjTypeOrder = objFilter.cloneObjTypeOrder;
 exports.extendObjType = objFilter.extendObjType;
+exports.isObjType = objFilter.isObjType;
 exports.objType = objFilter.objType;
+exports.objTypeName = objFilter.objTypeName;
 exports.reorderObjTypeOrder = objFilter.reorderObjTypeOrder;
 exports.countObj = objChecker.countObj;
 exports.isJsonObject = objChecker.isJsonObject;

package/dist/v1/index.d.mts

@@ -1,7 +1,7 @@
 import TinyLevelUp from './libs/TinyLevelUp.mjs';
 import { diffArrayList, shuffleArray, arraySortPositions, multiplyArrayBlocks } from './basics/array.mjs';
 import { breakdownDuration, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration } from './basics/clock.mjs';
-import { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, checkObj } from './basics/objFilter.mjs';
+import { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, checkObj, objTypeName, isObjType } from './basics/objFilter.mjs';
 import { countObj, isJsonObject } from './basics/objChecker.mjs';
 import { documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange } from './basics/fullScreen.mjs';
 import { calculateMarketcap, compareMarketcap, formatBytes, genFibonacciSeq, getAge, getPercentage, getSimplePerc, ruleOfThree } from './basics/simpleMath.mjs';
@@ -53,5 +53,5 @@ import TinyClassManager from './libs/TinyClassManager.mjs';
 import TinyRadioFm from './libs/TinyRadioFm.mjs';
 import TinyMediaPlayer from './libs/TinyMediaPlayer.mjs';
 import { createCheckDestroyed } from './libs/utils.mjs';
-export { TinyMediaPlayer, TinyRadioFm, TinyClassManager, FuzzySet, MamdaniInferenceSystem, TinyArrayComparator, TinyTextDiffer, TinyAnalogClock, TinyColorValidator, TinyLoadingScreen, TinyElementObserver, TinySimpleDice, TinyNeedBar, TinyI18, TinyCookieConsent, TinyInventory, TinyInventoryTrader, TinyArrayPaginator, TinyAdvancedRaffle, TinyDayNightCycle, TinyGamepad, TinyTextarea, TinyNewWinEvents, TinyIframeEvents, TinyLocalStorage, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, multiplyArrayBlocks, createCheckDestroyed, valMediaContentMetadata, valMediaContentMetadataPartial, parseMediaMetadata, extractMediaId3Tags, defuzzifyCentroid, trapezoid, diffArrayList, diffStrings, diffObjList, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getLatestBackupPath, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+export { TinyMediaPlayer, TinyRadioFm, TinyClassManager, FuzzySet, MamdaniInferenceSystem, TinyArrayComparator, TinyTextDiffer, TinyAnalogClock, TinyColorValidator, TinyLoadingScreen, TinyElementObserver, TinySimpleDice, TinyNeedBar, TinyI18, TinyCookieConsent, TinyInventory, TinyInventoryTrader, TinyArrayPaginator, TinyAdvancedRaffle, TinyDayNightCycle, TinyGamepad, TinyTextarea, TinyNewWinEvents, TinyIframeEvents, TinyLocalStorage, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, multiplyArrayBlocks, createCheckDestroyed, valMediaContentMetadata, valMediaContentMetadataPartial, parseMediaMetadata, extractMediaId3Tags, defuzzifyCentroid, trapezoid, diffArrayList, diffStrings, diffObjList, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getLatestBackupPath, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objTypeName, isObjType, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
 //# sourceMappingURL=index.d.mts.map

package/dist/v1/index.mjs

@@ -1,7 +1,7 @@
 import TinyLevelUp from './libs/TinyLevelUp.mjs';
 import { diffArrayList, shuffleArray, arraySortPositions, multiplyArrayBlocks, } from './basics/array.mjs';
 import { breakdownDuration, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, } from './basics/clock.mjs';
-import { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, checkObj, } from './basics/objFilter.mjs';
+import { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, checkObj, objTypeName, isObjType, } from './basics/objFilter.mjs';
 import { countObj, isJsonObject } from './basics/objChecker.mjs';
 import { documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, } from './basics/fullScreen.mjs';
 import { calculateMarketcap, compareMarketcap, formatBytes, genFibonacciSeq, getAge, getPercentage, getSimplePerc, ruleOfThree, } from './basics/simpleMath.mjs';
@@ -56,4 +56,4 @@ import { createCheckDestroyed } from './libs/utils.mjs';
 // import TinyHtmlElems from './libs/TinyHtml/index.mjs';
 export { TinyMediaPlayer, TinyRadioFm, TinyClassManager, FuzzySet, MamdaniInferenceSystem, TinyArrayComparator, TinyTextDiffer, TinyAnalogClock, 
 // TinyHtmlElems,
-TinyColorValidator, TinyLoadingScreen, TinyElementObserver, TinySimpleDice, TinyNeedBar, TinyI18, TinyCookieConsent, TinyInventory, TinyInventoryTrader, TinyArrayPaginator, TinyAdvancedRaffle, TinyDayNightCycle, TinyGamepad, TinyTextarea, TinyNewWinEvents, TinyIframeEvents, TinyLocalStorage, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, multiplyArrayBlocks, createCheckDestroyed, valMediaContentMetadata, valMediaContentMetadataPartial, parseMediaMetadata, extractMediaId3Tags, defuzzifyCentroid, trapezoid, diffArrayList, diffStrings, diffObjList, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getLatestBackupPath, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+TinyColorValidator, TinyLoadingScreen, TinyElementObserver, TinySimpleDice, TinyNeedBar, TinyI18, TinyCookieConsent, TinyInventory, TinyInventoryTrader, TinyArrayPaginator, TinyAdvancedRaffle, TinyDayNightCycle, TinyGamepad, TinyTextarea, TinyNewWinEvents, TinyIframeEvents, TinyLocalStorage, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, multiplyArrayBlocks, createCheckDestroyed, valMediaContentMetadata, valMediaContentMetadataPartial, parseMediaMetadata, extractMediaId3Tags, defuzzifyCentroid, trapezoid, diffArrayList, diffStrings, diffObjList, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getLatestBackupPath, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objTypeName, isObjType, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/docs/v1/basics/deprecated/objFilter.md

@@ -0,0 +1,14 @@
+### 🔍 `objType(obj, [type])`
+
+Get the type of any value, or check it against a known type.
+
+```js
+objType([], 'array'); // true
+objType('hello');     // "string"
+objType(undefined);   // null
+```
+
+Returns:
+- `true` / `false` if a type is provided
+- The detected type name as a string if no type is provided
+- `null` if `undefined` is passed

package/docs/v1/basics/objFilter.md

@@ -23,23 +23,6 @@ Whether you’re validating inputs, writing schema validators, or building tools
 
 ## Usage
 
-### 🔍 `objType(obj, [type])`
-
-Get the type of any value, or check it against a known type.
-
-```js
-objType([], 'array'); // true
-objType('hello');     // "string"
-objType(undefined);   // null
-```
-
-Returns:
-- `true` / `false` if a type is provided
-- The detected type name as a string if no type is provided
-- `null` if `undefined` is passed
-
----
-
 ### 🔍 `checkObj(obj)`
 
 Checks the type of a given object and returns the validation result if a known type is detected.
@@ -73,6 +56,37 @@ Returns:
 
 ---
 
+### 🏷️ `objTypeName(val)`
+
+Returns the detected type name of a given value as a string.
+
+```js
+objTypeName([]); // "array"
+objTypeName(null); // "null"
+objTypeName(new Set()); // "set"
+```
+
+Returns:
+- A string representing the type name (e.g., `"array"`, `"date"`, `"map"`).
+- `"unknown"` if no matching type is found.
+
+---
+
+### ✅ `isObjType(obj, type)`
+
+Checks whether a given object matches a specific type. This check is case-insensitive.
+
+```js
+isObjType([], 'array'); // true
+isObjType({}, 'object'); // true
+isObjType('hello', 'string'); // true
+isObjType(123, 'boolean'); // false
+```
+
+*Note: Throws a `TypeError` if the `type` argument is not a string.*
+
+---
+
 ### ➕ `extendObjType(newTypes, [index])`
 
 Add your own custom types. You can optionally define where in the check order they go.