tiny-essentials 1.28.3 → 1.28.4

package/changelog/1/28/4.md

@@ -0,0 +1,4 @@
+## 🛠️ Maintenance & Fixes
+
+- 📝 **Documentation**: Performed a comprehensive cleanup and correction of `jsDoc` annotations throughout `objFilter.mjs`.
+- ⚙️ **Type Compatibility**: Added `// @ts-nocheck` to resolve type-checking conflicts with `WeakMap` and `WeakSet` validators, ensuring they can correctly process `unknown` values without compiler interference.

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';
 
 /**
@@ -241,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),
   ],
@@ -293,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,
     ],
   ]);
@@ -302,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,
   ],
@@ -358,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,
     ],
   ]);
@@ -368,8 +362,7 @@ extendObjType([
   [
     'object',
     /**
-     * @template {Record<string | number | symbol, any>} Value
-     * @param {*} val @returns {val is Value}
+     * @param {unknown} val @returns {val is Record<string | number | symbol, unknown>}
      */
     (val) => objChecker.isJsonObject(val),
   ],

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';
@@ -215,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),
     ],
@@ -266,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,
         ],
     ]);
@@ -274,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,
     ],
@@ -329,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,
         ],
     ]);
@@ -338,8 +331,7 @@ extendObjType([
     [
         'object',
         /**
-         * @template {Record<string | number | symbol, any>} Value
-         * @param {*} val @returns {val is Value}
+         * @param {unknown} val @returns {val is Record<string | number | symbol, unknown>}
          */
         (val) => isJsonObject(val),
     ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-essentials",
-  "version": "1.28.3",
+  "version": "1.28.4",
   "description": "Collection of small, essential scripts designed to be used across various projects. These simple utilities are crafted for speed, ease of use, and versatility.",
   "bin": {
     "tiny-essentials-fork": "./TinyFork.mjs"