tiny-essentials 1.22.7 → 1.22.9

package/dist/v1/libs/TinyHtml.cjs

@@ -23,7 +23,13 @@ const {
 /**
  * Represents the valid values that can be appended to a TinyNode.
  *
- * @typedef {TinyNode | TinyNode[] | string | false | null | undefined} AppendCheckerValues
+ * @typedef {TinyNode | TinyNode[] | string | false | null | undefined} AppendCheckerTemplate
+ */
+
+/**
+ * Represents the the collection of values that can be appended to a TinyNode.
+ *
+ * @typedef {AppendCheckerTemplate|AppendCheckerTemplate[]} AppendCheckerValues
  */
 
 /**
@@ -2152,18 +2158,14 @@ class TinyHtml {
    * @readonly
    */
   static _appendChecker(where, ...nodes) {
+    /** @type {(string | Node)[]} */
     const results = [];
-    const nds = [...nodes];
-    for (const index in nds) {
-      if (
-        typeof nds[index] === 'undefined' ||
-        nds[index] === null ||
-        nds[index] === false
-      )
-        continue;
-      if (typeof nds[index] !== 'string') {
-        results.push(TinyHtml._preNodeElem(nds[index], where));
-      } else results.push(nds[index]);
+    for (const item of nodes) {
+      if (typeof item === 'undefined' || item === null || item === false) continue;
+      if (typeof item !== 'string') {
+        if (!Array.isArray(item)) results.push(TinyHtml._preNodeElems(item, where)[0]);
+        else results.push(...TinyHtml._appendChecker(where, ...item));
+      } else results.push(item);
     }
     return results;
   }

package/dist/v1/libs/TinyHtml.d.mts

@@ -6,7 +6,11 @@ export type TinyHtmlAny = TinyHtml<ConstructorElValues>;
 /**
  * Represents the valid values that can be appended to a TinyNode.
  */
-export type AppendCheckerValues = TinyNode | TinyNode[] | string | false | null | undefined;
+export type AppendCheckerTemplate = TinyNode | TinyNode[] | string | false | null | undefined;
+/**
+ * Represents the the collection of values that can be appended to a TinyNode.
+ */
+export type AppendCheckerValues = AppendCheckerTemplate | AppendCheckerTemplate[];
 /**
  * Callback function used for hover events.
  */
@@ -279,55 +283,7 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
         areElsCollPerfTop: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;
         areElsCollPerfBottom: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;
         areElsCollPerfLeft: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;
-        areElsCollPerfRight: (rect1: TinyCollision.ObjRect, 
-        /**
-         * Represents a value that can be either a DOM Element, or the document object.
-         * Useful for functions that operate generically on measurable targets.
-         *
-         * @typedef {Element|Document} ElementWithDoc
-         */
-        /**
-         * A parameter type used for filtering or matching elements.
-         * It can be:
-         * - A string (CSS selector),
-         * - A raw DOM element,
-         * - An array of raw DOM elements,
-         * - A filtering function that receives an index and element,
-         *   and returns true if it matches.
-         *
-         * @typedef {string|Element|Element[]|((index: number, el: Element) => boolean)} WinnowRequest
-         */
-        /**
-         * Elements accepted as constructor values for TinyHtml.
-         * These include common DOM elements and root containers.
-         *
-         * @typedef {Window|Element|Document|Text} ConstructorElValues
-         */
-        /**
-         * Options passed to `addEventListener` or `removeEventListener`.
-         * Can be a boolean or an object of type `AddEventListenerOptions`.
-         *
-         * @typedef {boolean|AddEventListenerOptions} EventRegistryOptions
-         */
-        /**
-         * Structure describing a registered event callback and its options.
-         *
-         * @typedef {Object} EventRegistryItem
-         * @property {EventListenerOrEventListenerObject|null} handler - The function to be executed when the event is triggered.
-         * @property {EventRegistryOptions} [options] - Optional configuration passed to the listener.
-         */
-        /**
-         * Maps event names (e.g., `"click"`, `"keydown"`) to a list of registered handlers and options.
-         *
-         * @typedef {Record<string, EventRegistryItem[]>} EventRegistryList
-         */
-        /**
-         * WeakMap storing all event listeners per element.
-         * Each element has a registry mapping event names to their handler lists.
-         *
-         * @type {WeakMap<ConstructorElValues|EventTarget, EventRegistryList>}
-         */
-        rect2: TinyCollision.ObjRect) => boolean;
+        areElsCollPerfRight: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;
         areElsColliding: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;
         areElsPerfColliding: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;
         getElsColliding: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => string | null;

package/dist/v1/libs/TinyHtml.mjs

@@ -11,7 +11,12 @@ const { areElsColliding, areElsPerfColliding, areElsCollTop, areElsCollBottom, a
 /**
  * Represents the valid values that can be appended to a TinyNode.
  *
- * @typedef {TinyNode | TinyNode[] | string | false | null | undefined} AppendCheckerValues
+ * @typedef {TinyNode | TinyNode[] | string | false | null | undefined} AppendCheckerTemplate
+ */
+/**
+ * Represents the the collection of values that can be appended to a TinyNode.
+ *
+ * @typedef {AppendCheckerTemplate|AppendCheckerTemplate[]} AppendCheckerValues
  */
 /**
  * Callback function used for hover events.
@@ -1877,18 +1882,19 @@ class TinyHtml {
      * @readonly
      */
     static _appendChecker(where, ...nodes) {
+        /** @type {(string | Node)[]} */
         const results = [];
-        const nds = [...nodes];
-        for (const index in nds) {
-            if (typeof nds[index] === 'undefined' ||
-                nds[index] === null ||
-                nds[index] === false)
+        for (const item of nodes) {
+            if (typeof item === 'undefined' || item === null || item === false)
                 continue;
-            if (typeof nds[index] !== 'string') {
-                results.push(TinyHtml._preNodeElem(nds[index], where));
+            if (typeof item !== 'string') {
+                if (!Array.isArray(item))
+                    results.push(TinyHtml._preNodeElems(item, where)[0]);
+                else
+                    results.push(...TinyHtml._appendChecker(where, ...item));
             }
             else
-                results.push(nds[index]);
+                results.push(item);
         }
         return results;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-essentials",
-  "version": "1.22.7",
+  "version": "1.22.9",
   "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.",
   "scripts": {
     "test": "npm run test:mjs && npm run test:cjs && npm run test:js",