tiny-essentials 1.22.9 → 1.22.11

package/dist/v1/libs/TinyHtml.cjs

@@ -815,6 +815,8 @@ class TinyHtml {
   }
 
   /**
+   * @deprecated Use the {@link createFromHTML} instead.
+   *
    * Creates an HTMLElement or TextNode from an HTML string.
    * Supports both elements and plain text.
    *
@@ -836,6 +838,24 @@ class TinyHtml {
     return new TinyHtml(template.content.firstChild);
   }
 
+  /**
+   * Creates an HTMLElement or TextNode from an HTML string.
+   * Supports both elements and plain text.
+   *
+   * @param {string} htmlString - The HTML string to convert.
+   * @returns {TinyHtml<Element>} - A single HTMLElement or TextNode.
+   */
+  static createFromHTML(htmlString) {
+    const template = document.createElement('template');
+    htmlString = htmlString.trim();
+
+    template.innerHTML = htmlString;
+    const elems = Array.from(template.content.childNodes);
+    if (!elems.every((item) => item instanceof Element || item instanceof Text))
+      throw new Error('The HTML string must contain a valid HTML element.');
+    return new TinyHtml(elems);
+  }
+
   ///////////////////////////////////////////////////
   // TITLE: Query Script
 
@@ -1627,12 +1647,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 +2174,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 +2182,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));
+        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 +2202,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 +2214,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 +2226,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 +2238,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 +2250,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 +2262,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 +2274,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 +2286,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 +2298,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 +2310,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

@@ -473,6 +473,8 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
      */
     static createTextNode(value: string): TinyHtml<Text>;
     /**
+     * @deprecated Use the {@link createFromHTML} instead.
+     *
      * Creates an HTMLElement or TextNode from an HTML string.
      * Supports both elements and plain text.
      *
@@ -480,6 +482,14 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
      * @returns {TinyHtml<Element>} - A single HTMLElement or TextNode.
      */
     static createElementFromHTML(htmlString: string): TinyHtml<Element>;
+    /**
+     * Creates an HTMLElement or TextNode from an HTML string.
+     * Supports both elements and plain text.
+     *
+     * @param {string} htmlString - The HTML string to convert.
+     * @returns {TinyHtml<Element>} - A single HTMLElement or TextNode.
+     */
+    static createFromHTML(htmlString: string): TinyHtml<Element>;
     /**
      * Queries the document for the first element matching the CSS selector and wraps it in a TinyHtml instance.
      *
@@ -977,52 +987,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 +2831,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 +2962,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

@@ -702,6 +702,8 @@ class TinyHtml {
         return new TinyHtml(document.createTextNode(value));
     }
     /**
+     * @deprecated Use the {@link createFromHTML} instead.
+     *
      * Creates an HTMLElement or TextNode from an HTML string.
      * Supports both elements and plain text.
      *
@@ -720,6 +722,22 @@ class TinyHtml {
             throw new Error('The HTML string must contain a valid HTML element.');
         return new TinyHtml(template.content.firstChild);
     }
+    /**
+     * Creates an HTMLElement or TextNode from an HTML string.
+     * Supports both elements and plain text.
+     *
+     * @param {string} htmlString - The HTML string to convert.
+     * @returns {TinyHtml<Element>} - A single HTMLElement or TextNode.
+     */
+    static createFromHTML(htmlString) {
+        const template = document.createElement('template');
+        htmlString = htmlString.trim();
+        template.innerHTML = htmlString;
+        const elems = Array.from(template.content.childNodes);
+        if (!elems.every((item) => item instanceof Element || item instanceof Text))
+            throw new Error('The HTML string must contain a valid HTML element.');
+        return new TinyHtml(elems);
+    }
     ///////////////////////////////////////////////////
     // TITLE: Query Script
     /**
@@ -1405,12 +1423,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 +1896,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 +1905,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))
-                    results.push(TinyHtml._preNodeElems(item, where)[0]);
-                else
+            if (typeof item !== 'string' && typeof item !== 'number') {
+                if (item instanceof Node || item instanceof TinyHtml)
+                    results.push(...TinyHtml._preNodeElems(item, where));
+                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 +1927,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 +1938,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 +1949,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 +1960,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 +1971,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 +1982,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 +1993,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 +2004,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 +2015,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 +2026,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/docs/v1/libs/TinyHtml.md

@@ -702,16 +702,16 @@ This method is useful when you want to insert raw text content into the DOM with
 
 ---
 
-### `TinyHtml.createElementFromHTML(htmlString)`
+### `TinyHtml.createFromHTML(htmlString)`
 
-Creates an `HTMLElement` or `TextNode` from an HTML string.
+Creates an `HTMLElement` from an HTML string.
 Supports both elements and plain text.
 
 * **Parameters**:
 
   * `htmlString` *(string)* — The HTML string to convert.
 
-* **Returns**: `TinyHtml` — A `TinyHtml` instance wrapping the resulting `HTMLElement` or `TextNode`.
+* **Returns**: `TinyHtml` — A `TinyHtml` instance wrapping the resulting `HTMLElement`.
 
 * **Throws**:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-essentials",
-  "version": "1.22.9",
+  "version": "1.22.11",
   "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",
@@ -38,6 +38,10 @@
   "types": "./dist/v1/index.d.mts",
   "ethereum": "jasmindreasond.x",
   "exports": {
+    "./css/aiMarker.min.css": "./dist/v1/css/aiMarker.min.css",
+    "./css/TinyCookieConsent.min.css": "./dist/v1/css/TinyCookieConsent.min.css",
+    "./css/TinyDraggerExample.min.css": "./dist/v1/css/TinyDraggerExample.min.css",
+    "./css/TinyNotify.min.css": "./dist/v1/css/TinyNotify.min.css",
     ".": {
       "require": "./dist/v1/index.cjs",
       "import": "./dist/v1/index.mjs"