tiny-essentials 1.21.2 → 1.21.3

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

@@ -2039,6 +2039,12 @@ declare class TinyHtml {
      * @returns {TinyHtml} An array of TinyHtml instances wrapping the found elements.
      */
     getElementsByTagNameNS(localName: string, namespaceURI?: string | null): TinyHtml;
+    /**
+     * Iterates over all elements, executing the provided callback on each.
+     * @param {(element: TinyHtml, index: number, items: TinyHtml[]) => void} callback - Function invoked for each element.
+     * @returns {TinyHtml} The current instance for chaining.
+     */
+    forEach(callback: (element: TinyHtml, index: number, items: TinyHtml[]) => void): TinyHtml;
     /**
      * Returns the current target held by this instance.
      *
@@ -2127,8 +2133,17 @@ declare class TinyHtml {
      * @returns {boolean} `true` if both elements are the same DOM node; otherwise, `false`.
      */
     isSameDom(elem: TinyNode): boolean;
-    /** @type {ElementDataStore} */
-    _data: ElementDataStore;
+    /**
+     * Replaces the internal data with a new object.
+     * @param {ElementDataStore} value - Must be a non-null object.
+     * @throws {Error} If the value is not a valid object.
+     */
+    set _data(value: ElementDataStore);
+    /**
+     * Returns a shallow copy of the internal data.
+     * @type {ElementDataStore}
+     */
+    get _data(): ElementDataStore;
     /**
      * Retrieves data associated with a DOM element.
      *

package/dist/v1/libs/TinyHtml.mjs

@@ -550,6 +550,17 @@ class TinyHtml {
         return TinyHtml.getByTagNameNS(localName, namespaceURI, TinyHtml._preElem(this, 'getByTagNameNS'));
     }
     //////////////////////////////////////////////////////////////////
+    /**
+     * Iterates over all elements, executing the provided callback on each.
+     * @param {(element: TinyHtml, index: number, items: TinyHtml[]) => void} callback - Function invoked for each element.
+     * @returns {TinyHtml} The current instance for chaining.
+     */
+    forEach(callback) {
+        const elems = this.getAll().map((el, index) => this.extract(index));
+        for (const index in elems)
+            callback(elems[index], Number(index), elems);
+        return this;
+    }
     /**
      * Returns the current target held by this instance.
      *
@@ -1153,8 +1164,28 @@ class TinyHtml {
         return TinyHtml.isSameDom(this, elem);
     }
     //////////////////////////////////////////////////////////////////
-    /** @type {ElementDataStore} */
-    _data = {};
+    /**
+     * Internal data storage for element information.
+     * @type {ElementDataStore}
+     */
+    #data = {};
+    /**
+     * Returns a shallow copy of the internal data.
+     * @type {ElementDataStore}
+     */
+    get _data() {
+        return { ...this.#data };
+    }
+    /**
+     * Replaces the internal data with a new object.
+     * @param {ElementDataStore} value - Must be a non-null object.
+     * @throws {Error} If the value is not a valid object.
+     */
+    set _data(value) {
+        if (typeof value !== 'object' || value === null || Array.isArray(value))
+            throw new Error('value must be a non-null object.');
+        this.#data = value;
+    }
     /**
      * Internal data selectors for accessing public or private data stores.
      *
@@ -1174,7 +1205,7 @@ class TinyHtml {
         private: (where, el) => {
             if (!(el instanceof TinyHtml))
                 throw new Error(`Element must be a TinyHtml instance to execute ${where}().`);
-            return el._data;
+            return el.#data;
         },
     };
     /**

package/package.json

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