tiny-essentials 1.21.9 → 1.21.10

package/dist/v1/libs/TinyHtml.cjs

@@ -5182,28 +5182,46 @@ class TinyHtml {
   }
 
   /**
-   * Set an attribute on an element.
+   * Set one or multiple attributes on an element.
    * @template {TinyElement|TinyElement[]} T
-   * @param {T} el
-   * @param {string} name
-   * @param {string|null} [value=null]
+   * @param {T} el - Target element(s).
+   * @param {string|Record<string, string|null>} name - Attribute name or an object of attributes.
+   * @param {string|null} [value=null] - Attribute value (ignored if "name" is an object).
    * @returns {T}
    */
   static setAttr(el, name, value = null) {
+    const elems = TinyHtml._preElems(el, 'setAttr');
+
+    // Multiple attributes at once
+    if (typeof name === 'object' && name !== null) {
+      Object.entries(name).forEach(([attr, val]) => {
+        if (val !== null && typeof val !== 'string')
+          throw new TypeError(`The value for "${attr}" must be a string or null.`);
+        elems.forEach((elem) => {
+          if (val === null) elem.removeAttribute(TinyHtml.getAttrName(attr));
+          else elem.setAttribute(TinyHtml.getAttrName(attr), val);
+        });
+      });
+      return el;
+    }
+
+    // Single attribute
     if (typeof name !== 'string') throw new TypeError('The "name" must be a string.');
     if (value !== null && typeof value !== 'string')
       throw new TypeError('The "value" must be a string.');
-    TinyHtml._preElems(el, 'setAttr').forEach((elem) => {
+
+    elems.forEach((elem) => {
       if (value === null) elem.removeAttribute(TinyHtml.getAttrName(name));
       else elem.setAttribute(TinyHtml.getAttrName(name), value);
     });
+
     return el;
   }
 
   /**
-   * Set an attribute on an element.
-   * @param {string} name
-   * @param {string|null} [value=null]
+   * Set one or multiple attributes on an element.
+   * @param {string|Record<string, string|null>} name - Attribute name or an object of attributes.
+   * @param {string|null} [value=null] - Attribute value (ignored if "name" is an object).
    * @returns {this}
    */
   setAttr(name, value) {
@@ -5278,81 +5296,92 @@ class TinyHtml {
   }
 
   /**
-   * Set a property on an element.
+   * Set one or multiple properties on an element.
    * @template {TinyElement|TinyElement[]} T
-   * @param {T} el
-   * @param {string} name
+   * @param {T} el - Target element(s).
+   * @param {...string} names - Property name(s).
    * @returns {T}
    */
-  static addProp(el, name) {
-    if (typeof name !== 'string') throw new TypeError('The "name" must be a string.');
+  static addProp(el, ...names) {
     TinyHtml._preElems(el, 'addProp').forEach((elem) => {
-      // @ts-ignore
-      elem[TinyHtml.getPropName(name)] = true;
+      names.forEach((name) => {
+        if (typeof name !== 'string') throw new TypeError('Each "name" must be a string.');
+        // @ts-ignore
+        elem[TinyHtml.getPropName(name)] = true;
+      });
     });
     return el;
   }
 
   /**
    * Set a property on an element.
-   * @param {string} name
+   * @param {...string} names - Property name(s).
    * @returns {this}
    */
-  addProp(name) {
-    return TinyHtml.addProp(this, name);
+  addProp(...names) {
+    return TinyHtml.addProp(this, ...names);
   }
 
   /**
-   * Remove a property from an element.
+   * Remove one or multiple properties from an element.
    * @template {TinyElement|TinyElement[]} T
-   * @param {T} el
-   * @param {string} name
+   * @param {T} el - Target element(s).
+   * @param {...string} names - Property name(s).
    * @returns {T}
    */
-  static removeProp(el, name) {
-    if (typeof name !== 'string') throw new TypeError('The "name" must be a string.');
+  static removeProp(el, ...names) {
     TinyHtml._preElems(el, 'removeProp').forEach((elem) => {
-      // @ts-ignore
-      elem[TinyHtml.getPropName(name)] = false;
+      names.forEach((name) => {
+        if (typeof name !== 'string') throw new TypeError('Each "name" must be a string.');
+        // @ts-ignore
+        elem[TinyHtml.getPropName(name)] = false;
+      });
     });
     return el;
   }
 
   /**
    * Remove a property from an element.
-   * @param {string} name
+   * @param {...string} names - Property name(s).
    * @returns {this}
    */
-  removeProp(name) {
-    return TinyHtml.removeProp(this, name);
+  removeProp(...names) {
+    return TinyHtml.removeProp(this, ...names);
   }
 
   /**
-   * Toggle a boolean property.
+   * Toggle one or multiple boolean properties.
    * @template {TinyElement|TinyElement[]} T
-   * @param {T} el
-   * @param {string} name
-   * @param {boolean} [force]
+   * @param {T} el - Target element(s).
+   * @param {string|string[]} name - Property name or a list of property names.
+   * @param {boolean} [force] - Force true/false instead of toggling.
    * @returns {T}
    */
   static toggleProp(el, name, force) {
-    if (typeof name !== 'string') throw new TypeError('The "name" must be a string.');
+    const elems = TinyHtml._preElems(el, 'toggleProp');
     if (typeof force !== 'undefined' && typeof force !== 'boolean')
       throw new TypeError('The "force" must be a boolean.');
-    TinyHtml._preElems(el, 'toggleProp').forEach((elem) => {
-      // @ts-ignore
-      const shouldEnable = force === undefined ? !elem[TinyHtml.getPropName(name)] : force;
-      // @ts-ignore
-      if (shouldEnable) TinyHtml.addProp(elem, name);
-      else TinyHtml.removeProp(elem, name);
+
+    // Normalize list of properties
+    const props = Array.isArray(name) ? name : [name];
+
+    props.forEach((prop) => {
+      if (typeof prop !== 'string') throw new TypeError('Each property name must be a string.');
+      elems.forEach((elem) => {
+        // @ts-ignore
+        const shouldEnable = force === undefined ? !elem[TinyHtml.getPropName(prop)] : force;
+        if (shouldEnable) TinyHtml.addProp(elem, prop);
+        else TinyHtml.removeProp(elem, prop);
+      });
     });
+
     return el;
   }
 
   /**
-   * Toggle a boolean property.
-   * @param {string} name
-   * @param {boolean} [force]
+   * Toggle one or multiple boolean properties.
+   * @param {string|string[]} name - Property name or a list of property names.
+   * @param {boolean} [force] - Force true/false instead of toggling.
    * @returns {this}
    */
   toggleProp(name, force) {

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

@@ -1911,14 +1911,14 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
      */
     static attr(el: TinyElement, name: string): string | null;
     /**
-     * Set an attribute on an element.
+     * Set one or multiple attributes on an element.
      * @template {TinyElement|TinyElement[]} T
-     * @param {T} el
-     * @param {string} name
-     * @param {string|null} [value=null]
+     * @param {T} el - Target element(s).
+     * @param {string|Record<string, string|null>} name - Attribute name or an object of attributes.
+     * @param {string|null} [value=null] - Attribute value (ignored if "name" is an object).
      * @returns {T}
      */
-    static setAttr<T extends TinyElement | TinyElement[]>(el: T, name: string, value?: string | null): T;
+    static setAttr<T extends TinyElement | TinyElement[]>(el: T, name: string | Record<string, string | null>, value?: string | null): T;
     /**
      * Remove attribute(s) from an element.
      * @template {TinyElement|TinyElement[]} T
@@ -1942,30 +1942,30 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
      */
     static hasProp(el: TinyElement, name: string): boolean;
     /**
-     * Set a property on an element.
+     * Set one or multiple properties on an element.
      * @template {TinyElement|TinyElement[]} T
-     * @param {T} el
-     * @param {string} name
+     * @param {T} el - Target element(s).
+     * @param {...string} names - Property name(s).
      * @returns {T}
      */
-    static addProp<T extends TinyElement | TinyElement[]>(el: T, name: string): T;
+    static addProp<T extends TinyElement | TinyElement[]>(el: T, ...names: string[]): T;
     /**
-     * Remove a property from an element.
+     * Remove one or multiple properties from an element.
      * @template {TinyElement|TinyElement[]} T
-     * @param {T} el
-     * @param {string} name
+     * @param {T} el - Target element(s).
+     * @param {...string} names - Property name(s).
      * @returns {T}
      */
-    static removeProp<T extends TinyElement | TinyElement[]>(el: T, name: string): T;
+    static removeProp<T extends TinyElement | TinyElement[]>(el: T, ...names: string[]): T;
     /**
-     * Toggle a boolean property.
+     * Toggle one or multiple boolean properties.
      * @template {TinyElement|TinyElement[]} T
-     * @param {T} el
-     * @param {string} name
-     * @param {boolean} [force]
+     * @param {T} el - Target element(s).
+     * @param {string|string[]} name - Property name or a list of property names.
+     * @param {boolean} [force] - Force true/false instead of toggling.
      * @returns {T}
      */
-    static toggleProp<T extends TinyElement | TinyElement[]>(el: T, name: string, force?: boolean): T;
+    static toggleProp<T extends TinyElement | TinyElement[]>(el: T, name: string | string[], force?: boolean): T;
     /**
      * Removes an element from the DOM.
      * @template {TinyElement|TinyElement[]} T
@@ -2986,12 +2986,12 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
      */
     attr(name: string): string | null;
     /**
-     * Set an attribute on an element.
-     * @param {string} name
-     * @param {string|null} [value=null]
+     * Set one or multiple attributes on an element.
+     * @param {string|Record<string, string|null>} name - Attribute name or an object of attributes.
+     * @param {string|null} [value=null] - Attribute value (ignored if "name" is an object).
      * @returns {this}
      */
-    setAttr(name: string, value?: string | null): this;
+    setAttr(name: string | Record<string, string | null>, value?: string | null): this;
     /**
      * Remove attribute(s) from an element.
      * @param {string} name Space-separated list of attributes.
@@ -3012,23 +3012,23 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
     hasProp(name: string): boolean;
     /**
      * Set a property on an element.
-     * @param {string} name
+     * @param {...string} names - Property name(s).
      * @returns {this}
      */
-    addProp(name: string): this;
+    addProp(...names: string[]): this;
     /**
      * Remove a property from an element.
-     * @param {string} name
+     * @param {...string} names - Property name(s).
      * @returns {this}
      */
-    removeProp(name: string): this;
+    removeProp(...names: string[]): this;
     /**
-     * Toggle a boolean property.
-     * @param {string} name
-     * @param {boolean} [force]
+     * Toggle one or multiple boolean properties.
+     * @param {string|string[]} name - Property name or a list of property names.
+     * @param {boolean} [force] - Force true/false instead of toggling.
      * @returns {this}
      */
-    toggleProp(name: string, force?: boolean): this;
+    toggleProp(name: string | string[], force?: boolean): this;
     /**
      * Removes the element from the DOM.
      * @returns {this}

package/dist/v1/libs/TinyHtml.mjs

@@ -4688,19 +4688,35 @@ class TinyHtml {
         return TinyHtml.attr(this, name);
     }
     /**
-     * Set an attribute on an element.
+     * Set one or multiple attributes on an element.
      * @template {TinyElement|TinyElement[]} T
-     * @param {T} el
-     * @param {string} name
-     * @param {string|null} [value=null]
+     * @param {T} el - Target element(s).
+     * @param {string|Record<string, string|null>} name - Attribute name or an object of attributes.
+     * @param {string|null} [value=null] - Attribute value (ignored if "name" is an object).
      * @returns {T}
      */
     static setAttr(el, name, value = null) {
+        const elems = TinyHtml._preElems(el, 'setAttr');
+        // Multiple attributes at once
+        if (typeof name === 'object' && name !== null) {
+            Object.entries(name).forEach(([attr, val]) => {
+                if (val !== null && typeof val !== 'string')
+                    throw new TypeError(`The value for "${attr}" must be a string or null.`);
+                elems.forEach((elem) => {
+                    if (val === null)
+                        elem.removeAttribute(TinyHtml.getAttrName(attr));
+                    else
+                        elem.setAttribute(TinyHtml.getAttrName(attr), val);
+                });
+            });
+            return el;
+        }
+        // Single attribute
         if (typeof name !== 'string')
             throw new TypeError('The "name" must be a string.');
         if (value !== null && typeof value !== 'string')
             throw new TypeError('The "value" must be a string.');
-        TinyHtml._preElems(el, 'setAttr').forEach((elem) => {
+        elems.forEach((elem) => {
             if (value === null)
                 elem.removeAttribute(TinyHtml.getAttrName(name));
             else
@@ -4709,9 +4725,9 @@ class TinyHtml {
         return el;
     }
     /**
-     * Set an attribute on an element.
-     * @param {string} name
-     * @param {string|null} [value=null]
+     * Set one or multiple attributes on an element.
+     * @param {string|Record<string, string|null>} name - Attribute name or an object of attributes.
+     * @param {string|null} [value=null] - Attribute value (ignored if "name" is an object).
      * @returns {this}
      */
     setAttr(name, value) {
@@ -4780,81 +4796,89 @@ class TinyHtml {
         return TinyHtml.hasProp(this, name);
     }
     /**
-     * Set a property on an element.
+     * Set one or multiple properties on an element.
      * @template {TinyElement|TinyElement[]} T
-     * @param {T} el
-     * @param {string} name
+     * @param {T} el - Target element(s).
+     * @param {...string} names - Property name(s).
      * @returns {T}
      */
-    static addProp(el, name) {
-        if (typeof name !== 'string')
-            throw new TypeError('The "name" must be a string.');
+    static addProp(el, ...names) {
         TinyHtml._preElems(el, 'addProp').forEach((elem) => {
-            // @ts-ignore
-            elem[TinyHtml.getPropName(name)] = true;
+            names.forEach((name) => {
+                if (typeof name !== 'string')
+                    throw new TypeError('Each "name" must be a string.');
+                // @ts-ignore
+                elem[TinyHtml.getPropName(name)] = true;
+            });
         });
         return el;
     }
     /**
      * Set a property on an element.
-     * @param {string} name
+     * @param {...string} names - Property name(s).
      * @returns {this}
      */
-    addProp(name) {
-        return TinyHtml.addProp(this, name);
+    addProp(...names) {
+        return TinyHtml.addProp(this, ...names);
     }
     /**
-     * Remove a property from an element.
+     * Remove one or multiple properties from an element.
      * @template {TinyElement|TinyElement[]} T
-     * @param {T} el
-     * @param {string} name
+     * @param {T} el - Target element(s).
+     * @param {...string} names - Property name(s).
      * @returns {T}
      */
-    static removeProp(el, name) {
-        if (typeof name !== 'string')
-            throw new TypeError('The "name" must be a string.');
+    static removeProp(el, ...names) {
         TinyHtml._preElems(el, 'removeProp').forEach((elem) => {
-            // @ts-ignore
-            elem[TinyHtml.getPropName(name)] = false;
+            names.forEach((name) => {
+                if (typeof name !== 'string')
+                    throw new TypeError('Each "name" must be a string.');
+                // @ts-ignore
+                elem[TinyHtml.getPropName(name)] = false;
+            });
         });
         return el;
     }
     /**
      * Remove a property from an element.
-     * @param {string} name
+     * @param {...string} names - Property name(s).
      * @returns {this}
      */
-    removeProp(name) {
-        return TinyHtml.removeProp(this, name);
+    removeProp(...names) {
+        return TinyHtml.removeProp(this, ...names);
     }
     /**
-     * Toggle a boolean property.
+     * Toggle one or multiple boolean properties.
      * @template {TinyElement|TinyElement[]} T
-     * @param {T} el
-     * @param {string} name
-     * @param {boolean} [force]
+     * @param {T} el - Target element(s).
+     * @param {string|string[]} name - Property name or a list of property names.
+     * @param {boolean} [force] - Force true/false instead of toggling.
      * @returns {T}
      */
     static toggleProp(el, name, force) {
-        if (typeof name !== 'string')
-            throw new TypeError('The "name" must be a string.');
+        const elems = TinyHtml._preElems(el, 'toggleProp');
         if (typeof force !== 'undefined' && typeof force !== 'boolean')
             throw new TypeError('The "force" must be a boolean.');
-        TinyHtml._preElems(el, 'toggleProp').forEach((elem) => {
-            // @ts-ignore
-            const shouldEnable = force === undefined ? !elem[TinyHtml.getPropName(name)] : force;
-            // @ts-ignore
-            if (shouldEnable)
-                TinyHtml.addProp(elem, name);
-            else
-                TinyHtml.removeProp(elem, name);
+        // Normalize list of properties
+        const props = Array.isArray(name) ? name : [name];
+        props.forEach((prop) => {
+            if (typeof prop !== 'string')
+                throw new TypeError('Each property name must be a string.');
+            elems.forEach((elem) => {
+                // @ts-ignore
+                const shouldEnable = force === undefined ? !elem[TinyHtml.getPropName(prop)] : force;
+                if (shouldEnable)
+                    TinyHtml.addProp(elem, prop);
+                else
+                    TinyHtml.removeProp(elem, prop);
+            });
         });
         return el;
     }
     /**
-     * Toggle a boolean property.
-     * @param {string} name
-     * @param {boolean} [force]
+     * Toggle one or multiple boolean properties.
+     * @param {string|string[]} name - Property name or a list of property names.
+     * @param {boolean} [force] - Force true/false instead of toggling.
      * @returns {this}
      */
     toggleProp(name, force) {

package/docs/v1/README.md

@@ -69,6 +69,14 @@ To get started, navigate to the appropriate directory and explore the files list
 
 ---
 
+## 📖 More Regex Goodies
+
+Looking for practical regex examples and migration helpers?
+
+👉 Check out the **[`Regex-Helpers`](Regex-Helpers.md)** file for a full collection of ready-to-use regex transformations!
+
+---
+
 ## 📑 Contributing
 
 Feel free to suggest changes, improvements, or additional features. You can fork the repository and submit a pull request!

package/docs/v1/Regex-Helpers.md

@@ -0,0 +1,72 @@
+# 🔍 Regex Helpers
+
+Welcome to the **Regex Helpers** guide! ✨
+This document provides a collection of **ready-to-use regex patterns** to help you **transform JavaScript code** more efficiently.
+It’s especially useful when **migrating from jQuery to TinyHtml**, making your workflow faster, cleaner, and less error-prone. 🚀
+
+👉 These helpers were tested only in **Visual Studio Code**, so results may vary in other editors.
+
+---
+
+## ⚡ Basic Function Replacements
+
+Simplify and streamline JavaScript function transformations.
+
+**🔄 Replace `attr`:**
+
+```ruby
+attr\(([^,]+),\s*([^)]+)\)
+```
+
+➡️ with `setAttr`:
+
+```ruby
+setAttr($1, $2)
+```
+
+---
+
+## 🛠️ Migrating from jQuery to TinyHtml
+
+### 📥 Match jQuery with arguments
+
+```ruby
+\$\(\s*['"]<([^'"]+)>['"]\s*,\s*([\s\S]*?)\)
+\$\((?:\s|\n)*['"]<([^'"]+)>['"](?:\s|\n)*,(?:\s|\n)*([\s\S]*?)(?:\s|\n)*\)
+```
+
+➡️ Replace with:
+
+```ruby
+TinyHtml.createFrom('$1', $2)
+```
+
+---
+
+### 📦 Match jQuery without arguments
+
+```ruby
+\$\(\s*['"]<([^'"]+)>['"]\s*\)
+\$\((?:\s|\n)*['"]<([^'"]+)>['"](?:\s|\n)*\)
+```
+
+➡️ Replace with:
+
+```ruby
+TinyHtml.createFrom('$1')
+```
+
+---
+
+### 🔎 Match jQuery queries
+
+```ruby
+\$\(\s*['"]([^'"]+)['"]\s*\)
+\$\((?:\s|\n)*['"]([^'"]+)['"](?:\s|\n)*\)
+```
+
+➡️ Replace with:
+
+```ruby
+TinyHtml.query('$1')
+```

package/docs/v1/libs/TinyHtml.md

@@ -1730,6 +1730,7 @@ Attributes
 ```js
 element.attr("href");                  // Get
 element.setAttr("title", "Cool!");     // Set
+element.setAttr({ "title": "Cool!" }); // Set
 element.removeAttr("data-test");       // Remove
 element.hasAttr("id");                 // Check
 ```
@@ -1744,11 +1745,11 @@ Safe and type-checked — throws if misuse is detected.
 Properties
 
 ```js
-element.hasProp("disabled");         // true/false
-element.addProp("checked");          // set true
-element.removeProp("checked");       // set false
-element.toggleProp("disabled");      // flip
-element.toggleProp("readonly", true); // force enable
+element.hasProp("disabled");            // true/false
+element.addProp("checked");             // set true
+element.removeProp("checked");          // set false
+element.toggleProp("disabled");         // flip
+element.toggleProp(["readonly"], true); // force enable
 ```
 
 These methods interact with real DOM properties (not just attributes).

package/package.json

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