tiny-essentials 1.22.9 → 1.22.10

package/dist/v1/libs/TinyHtml.cjs

@@ -1627,12 +1627,12 @@ class TinyHtml {
   }
 
   /**
-   * Return if the element has the target(s).
+   * Returns elements from the current list that contain the given target(s).
    * @param {string|TinyElement|TinyElement[]} target - Selector or DOM element(s).
-   * @returns {boolean} Elements that contain the target.
+   * @returns {Element[]} Elements that contain the target.
    */
   has(target) {
-    return TinyHtml.has(this, target).length > 0;
+    return TinyHtml.has(this, target);
   }
 
   /**
@@ -2154,7 +2154,7 @@ class TinyHtml {
   /**
    * Normalize and validate nodes before DOM insertion.
    * Converts TinyNode-like structures or strings into DOM-compatible nodes.
-   * @type {(where: string, ...nodes: AppendCheckerValues[]) => (Node | string)[]}
+   * @type {(where: string, ...nodes: (AppendCheckerValues|Record<string, AppendCheckerValues>)[]) => (Node | string)[]}
    * @readonly
    */
   static _appendChecker(where, ...nodes) {
@@ -2162,9 +2162,16 @@ class TinyHtml {
     const results = [];
     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));
+      if (typeof item !== 'string' && typeof item !== 'number') {
+        if (item instanceof Node || item instanceof TinyHtml)
+          results.push(TinyHtml._preNodeElems(item, where)[0]);
+        else if (Array.isArray(item)) results.push(...TinyHtml._appendChecker(where, ...item));
+        else {
+          for (const name in item) {
+            const elems = item[name];
+            results.push(...TinyHtml._appendChecker(where, elems));
+          }
+        }
       } else results.push(item);
     }
     return results;
@@ -2175,7 +2182,7 @@ class TinyHtml {
    *
    * @template {TinyElement} T
    * @param {T} el - The target element(s) to receive children.
-   * @param {...AppendCheckerValues} children - The child elements or text to append.
+   * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - The child elements or text to append.
    * @returns {T}
    */
   static append(el, ...children) {
@@ -2187,7 +2194,7 @@ class TinyHtml {
   /**
    * Appends child elements or strings to the end of the target element(s).
    *
-   * @param {...AppendCheckerValues} children - The child elements or text to append.
+   * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - The child elements or text to append.
    * @returns {this}
    */
   append(...children) {
@@ -2199,7 +2206,7 @@ class TinyHtml {
    *
    * @template {TinyElement} T
    * @param {T} el - The target element(s) to receive children.
-   * @param {...AppendCheckerValues} children - The child elements or text to prepend.
+   * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - The child elements or text to prepend.
    * @returns {T}
    */
   static prepend(el, ...children) {
@@ -2211,7 +2218,7 @@ class TinyHtml {
   /**
    * Prepends child elements or strings to the beginning of the target element(s).
    *
-   * @param {...AppendCheckerValues} children - The child elements or text to prepend.
+   * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - The child elements or text to prepend.
    * @returns {this}
    */
   prepend(...children) {
@@ -2223,7 +2230,7 @@ class TinyHtml {
    *
    * @template {TinyElement} T
    * @param {T} el - The target element(s) before which new content is inserted.
-   * @param {...AppendCheckerValues} children - Elements or text to insert before the target.
+   * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - Elements or text to insert before the target.
    * @returns {T}
    */
   static before(el, ...children) {
@@ -2235,7 +2242,7 @@ class TinyHtml {
   /**
    * Inserts elements or strings immediately before the target element(s) in the DOM.
    *
-   * @param {...AppendCheckerValues} children - Elements or text to insert before the target.
+   * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - Elements or text to insert before the target.
    * @returns {this}
    */
   before(...children) {
@@ -2247,7 +2254,7 @@ class TinyHtml {
    *
    * @template {TinyElement} T
    * @param {T} el - The target element(s) after which new content is inserted.
-   * @param {...AppendCheckerValues} children - Elements or text to insert after the target.
+   * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - Elements or text to insert after the target.
    * @returns {T}
    */
   static after(el, ...children) {
@@ -2259,7 +2266,7 @@ class TinyHtml {
   /**
    * Inserts elements or strings immediately after the target element(s) in the DOM.
    *
-   * @param {...AppendCheckerValues} children - Elements or text to insert after the target.
+   * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - Elements or text to insert after the target.
    * @returns {this}
    */
   after(...children) {
@@ -2271,7 +2278,7 @@ class TinyHtml {
    *
    * @template {TinyElement} T
    * @param {T} el - The element(s) to be replaced.
-   * @param {...AppendCheckerValues} newNodes - New elements or text to replace the target.
+   * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} newNodes - New elements or text to replace the target.
    * @returns {T}
    */
   static replaceWith(el, ...newNodes) {
@@ -2283,7 +2290,7 @@ class TinyHtml {
   /**
    * Replaces the target element(s) in the DOM with new elements or text.
    *
-   * @param {...AppendCheckerValues} newNodes - New elements or text to replace the target.
+   * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} newNodes - New elements or text to replace the target.
    * @returns {this}
    */
   replaceWith(...newNodes) {

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

@@ -977,52 +977,52 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
      * @returns {Node[]}
      */
     static clone(el: TinyNode | TinyNode[], deep?: boolean): Node[];
-    static readonly _appendChecker(where: string, ...nodes: AppendCheckerValues[]): (Node | string)[];
+    static readonly _appendChecker(where: string, ...nodes: (AppendCheckerValues | Record<string, AppendCheckerValues>)[]): (Node | string)[];
     /**
      * Appends child elements or strings to the end of the target element(s).
      *
      * @template {TinyElement} T
      * @param {T} el - The target element(s) to receive children.
-     * @param {...AppendCheckerValues} children - The child elements or text to append.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - The child elements or text to append.
      * @returns {T}
      */
-    static append<T extends TinyElement>(el: T, ...children: AppendCheckerValues[]): T;
+    static append<T extends TinyElement>(el: T, ...children: (AppendCheckerValues | Record<string, AppendCheckerValues>)[]): T;
     /**
      * Prepends child elements or strings to the beginning of the target element(s).
      *
      * @template {TinyElement} T
      * @param {T} el - The target element(s) to receive children.
-     * @param {...AppendCheckerValues} children - The child elements or text to prepend.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - The child elements or text to prepend.
      * @returns {T}
      */
-    static prepend<T extends TinyElement>(el: T, ...children: AppendCheckerValues[]): T;
+    static prepend<T extends TinyElement>(el: T, ...children: (AppendCheckerValues | Record<string, AppendCheckerValues>)[]): T;
     /**
      * Inserts elements or strings immediately before the target element(s) in the DOM.
      *
      * @template {TinyElement} T
      * @param {T} el - The target element(s) before which new content is inserted.
-     * @param {...AppendCheckerValues} children - Elements or text to insert before the target.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - Elements or text to insert before the target.
      * @returns {T}
      */
-    static before<T extends TinyElement>(el: T, ...children: AppendCheckerValues[]): T;
+    static before<T extends TinyElement>(el: T, ...children: (AppendCheckerValues | Record<string, AppendCheckerValues>)[]): T;
     /**
      * Inserts elements or strings immediately after the target element(s) in the DOM.
      *
      * @template {TinyElement} T
      * @param {T} el - The target element(s) after which new content is inserted.
-     * @param {...AppendCheckerValues} children - Elements or text to insert after the target.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - Elements or text to insert after the target.
      * @returns {T}
      */
-    static after<T extends TinyElement>(el: T, ...children: AppendCheckerValues[]): T;
+    static after<T extends TinyElement>(el: T, ...children: (AppendCheckerValues | Record<string, AppendCheckerValues>)[]): T;
     /**
      * Replaces the target element(s) in the DOM with new elements or text.
      *
      * @template {TinyElement} T
      * @param {T} el - The element(s) to be replaced.
-     * @param {...AppendCheckerValues} newNodes - New elements or text to replace the target.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} newNodes - New elements or text to replace the target.
      * @returns {T}
      */
-    static replaceWith<T extends TinyElement>(el: T, ...newNodes: AppendCheckerValues[]): T;
+    static replaceWith<T extends TinyElement>(el: T, ...newNodes: (AppendCheckerValues | Record<string, AppendCheckerValues>)[]): T;
     /**
      * Appends the given element(s) to each target element in sequence.
      *
@@ -2821,11 +2821,11 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
      */
     is(selector: WinnowRequest): boolean;
     /**
-     * Return if the element has the target(s).
+     * Returns elements from the current list that contain the given target(s).
      * @param {string|TinyElement|TinyElement[]} target - Selector or DOM element(s).
-     * @returns {boolean} Elements that contain the target.
+     * @returns {Element[]} Elements that contain the target.
      */
-    has(target: string | TinyElement | TinyElement[]): boolean;
+    has(target: string | TinyElement | TinyElement[]): Element[];
     /**
      * Finds the closest ancestor (including self) that matches the selector.
      *
@@ -2952,38 +2952,38 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
     /**
      * Appends child elements or strings to the end of the target element(s).
      *
-     * @param {...AppendCheckerValues} children - The child elements or text to append.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - The child elements or text to append.
      * @returns {this}
      */
-    append(...children: AppendCheckerValues[]): this;
+    append(...children: (AppendCheckerValues | Record<string, AppendCheckerValues>)[]): this;
     /**
      * Prepends child elements or strings to the beginning of the target element(s).
      *
-     * @param {...AppendCheckerValues} children - The child elements or text to prepend.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - The child elements or text to prepend.
      * @returns {this}
      */
-    prepend(...children: AppendCheckerValues[]): this;
+    prepend(...children: (AppendCheckerValues | Record<string, AppendCheckerValues>)[]): this;
     /**
      * Inserts elements or strings immediately before the target element(s) in the DOM.
      *
-     * @param {...AppendCheckerValues} children - Elements or text to insert before the target.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - Elements or text to insert before the target.
      * @returns {this}
      */
-    before(...children: AppendCheckerValues[]): this;
+    before(...children: (AppendCheckerValues | Record<string, AppendCheckerValues>)[]): this;
     /**
      * Inserts elements or strings immediately after the target element(s) in the DOM.
      *
-     * @param {...AppendCheckerValues} children - Elements or text to insert after the target.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - Elements or text to insert after the target.
      * @returns {this}
      */
-    after(...children: AppendCheckerValues[]): this;
+    after(...children: (AppendCheckerValues | Record<string, AppendCheckerValues>)[]): this;
     /**
      * Replaces the target element(s) in the DOM with new elements or text.
      *
-     * @param {...AppendCheckerValues} newNodes - New elements or text to replace the target.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} newNodes - New elements or text to replace the target.
      * @returns {this}
      */
-    replaceWith(...newNodes: AppendCheckerValues[]): this;
+    replaceWith(...newNodes: (AppendCheckerValues | Record<string, AppendCheckerValues>)[]): this;
     /**
      * Appends the given element(s) to each target element in sequence.
      *

package/dist/v1/libs/TinyHtml.mjs

@@ -1405,12 +1405,12 @@ class TinyHtml {
         return TinyHtml._preElems(roots, 'has').filter((root) => targets.some((t) => root && root.contains(t)));
     }
     /**
-     * Return if the element has the target(s).
+     * Returns elements from the current list that contain the given target(s).
      * @param {string|TinyElement|TinyElement[]} target - Selector or DOM element(s).
-     * @returns {boolean} Elements that contain the target.
+     * @returns {Element[]} Elements that contain the target.
      */
     has(target) {
-        return TinyHtml.has(this, target).length > 0;
+        return TinyHtml.has(this, target);
     }
     /**
      * Finds the closest ancestor (including self) that matches the selector.
@@ -1878,7 +1878,7 @@ class TinyHtml {
     /**
      * Normalize and validate nodes before DOM insertion.
      * Converts TinyNode-like structures or strings into DOM-compatible nodes.
-     * @type {(where: string, ...nodes: AppendCheckerValues[]) => (Node | string)[]}
+     * @type {(where: string, ...nodes: (AppendCheckerValues|Record<string, AppendCheckerValues>)[]) => (Node | string)[]}
      * @readonly
      */
     static _appendChecker(where, ...nodes) {
@@ -1887,11 +1887,17 @@ class TinyHtml {
         for (const item of nodes) {
             if (typeof item === 'undefined' || item === null || item === false)
                 continue;
-            if (typeof item !== 'string') {
-                if (!Array.isArray(item))
+            if (typeof item !== 'string' && typeof item !== 'number') {
+                if (item instanceof Node || item instanceof TinyHtml)
                     results.push(TinyHtml._preNodeElems(item, where)[0]);
-                else
+                else if (Array.isArray(item))
                     results.push(...TinyHtml._appendChecker(where, ...item));
+                else {
+                    for (const name in item) {
+                        const elems = item[name];
+                        results.push(...TinyHtml._appendChecker(where, elems));
+                    }
+                }
             }
             else
                 results.push(item);
@@ -1903,7 +1909,7 @@ class TinyHtml {
      *
      * @template {TinyElement} T
      * @param {T} el - The target element(s) to receive children.
-     * @param {...AppendCheckerValues} children - The child elements or text to append.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - The child elements or text to append.
      * @returns {T}
      */
     static append(el, ...children) {
@@ -1914,7 +1920,7 @@ class TinyHtml {
     /**
      * Appends child elements or strings to the end of the target element(s).
      *
-     * @param {...AppendCheckerValues} children - The child elements or text to append.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - The child elements or text to append.
      * @returns {this}
      */
     append(...children) {
@@ -1925,7 +1931,7 @@ class TinyHtml {
      *
      * @template {TinyElement} T
      * @param {T} el - The target element(s) to receive children.
-     * @param {...AppendCheckerValues} children - The child elements or text to prepend.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - The child elements or text to prepend.
      * @returns {T}
      */
     static prepend(el, ...children) {
@@ -1936,7 +1942,7 @@ class TinyHtml {
     /**
      * Prepends child elements or strings to the beginning of the target element(s).
      *
-     * @param {...AppendCheckerValues} children - The child elements or text to prepend.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - The child elements or text to prepend.
      * @returns {this}
      */
     prepend(...children) {
@@ -1947,7 +1953,7 @@ class TinyHtml {
      *
      * @template {TinyElement} T
      * @param {T} el - The target element(s) before which new content is inserted.
-     * @param {...AppendCheckerValues} children - Elements or text to insert before the target.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - Elements or text to insert before the target.
      * @returns {T}
      */
     static before(el, ...children) {
@@ -1958,7 +1964,7 @@ class TinyHtml {
     /**
      * Inserts elements or strings immediately before the target element(s) in the DOM.
      *
-     * @param {...AppendCheckerValues} children - Elements or text to insert before the target.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - Elements or text to insert before the target.
      * @returns {this}
      */
     before(...children) {
@@ -1969,7 +1975,7 @@ class TinyHtml {
      *
      * @template {TinyElement} T
      * @param {T} el - The target element(s) after which new content is inserted.
-     * @param {...AppendCheckerValues} children - Elements or text to insert after the target.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - Elements or text to insert after the target.
      * @returns {T}
      */
     static after(el, ...children) {
@@ -1980,7 +1986,7 @@ class TinyHtml {
     /**
      * Inserts elements or strings immediately after the target element(s) in the DOM.
      *
-     * @param {...AppendCheckerValues} children - Elements or text to insert after the target.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} children - Elements or text to insert after the target.
      * @returns {this}
      */
     after(...children) {
@@ -1991,7 +1997,7 @@ class TinyHtml {
      *
      * @template {TinyElement} T
      * @param {T} el - The element(s) to be replaced.
-     * @param {...AppendCheckerValues} newNodes - New elements or text to replace the target.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} newNodes - New elements or text to replace the target.
      * @returns {T}
      */
     static replaceWith(el, ...newNodes) {
@@ -2002,7 +2008,7 @@ class TinyHtml {
     /**
      * Replaces the target element(s) in the DOM with new elements or text.
      *
-     * @param {...AppendCheckerValues} newNodes - New elements or text to replace the target.
+     * @param {...(AppendCheckerValues|Record<string, AppendCheckerValues>)} newNodes - New elements or text to replace the target.
      * @returns {this}
      */
     replaceWith(...newNodes) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-essentials",
-  "version": "1.22.9",
+  "version": "1.22.10",
   "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",