tiny-essentials 1.22.10 → 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
 
@@ -2164,7 +2184,7 @@ class TinyHtml {
       if (typeof item === 'undefined' || item === null || item === false) continue;
       if (typeof item !== 'string' && typeof item !== 'number') {
         if (item instanceof Node || item instanceof TinyHtml)
-          results.push(TinyHtml._preNodeElems(item, where)[0]);
+          results.push(...TinyHtml._preNodeElems(item, where));
         else if (Array.isArray(item)) results.push(...TinyHtml._appendChecker(where, ...item));
         else {
           for (const name in item) {

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.
      *

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
     /**
@@ -1889,7 +1907,7 @@ class TinyHtml {
                 continue;
             if (typeof item !== 'string' && typeof item !== 'number') {
                 if (item instanceof Node || item instanceof TinyHtml)
-                    results.push(TinyHtml._preNodeElems(item, where)[0]);
+                    results.push(...TinyHtml._preNodeElems(item, where));
                 else if (Array.isArray(item))
                     results.push(...TinyHtml._appendChecker(where, ...item));
                 else {

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.10",
+  "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"