tiny-essentials 1.23.2 → 1.24.1

package/dist/v1/libs/TinyHtml.mjs

@@ -1013,6 +1013,19 @@ class TinyHtml {
             return checkElement([elems]);
         return checkElement(elems);
     }
+    /**
+     * Prepares and validates multiple elements against allowed types.
+     *
+     * @param {string} where - The method name or context calling this.
+     * @param {any[]} TheTinyElements - The list of allowed constructors (e.g., Element, Document).
+     * @param {string[]} elemName - The list of expected element names for error reporting.
+     * @returns {any[]} - A flat array of validated elements.
+     * @throws {Error} - If any element is not an instance of one of the allowed types.
+     * @readonly
+     */
+    _preElemsTemplate(where, TheTinyElements, elemName) {
+        return TinyHtml._preElemsTemplate(this, where, TheTinyElements, elemName);
+    }
     /**
      * Prepares and validates a single element against allowed types.
      *
@@ -1059,6 +1072,20 @@ class TinyHtml {
         }
         return checkElement(elems);
     }
+    /**
+     * Prepares and validates a single element against allowed types.
+     *
+     * @param {string} where - The method name or context calling this.
+     * @param {any[]} TheTinyElements - The list of allowed constructors (e.g., Element, Document).
+     * @param {string[]} elemName - The list of expected element names for error reporting.
+     * @param {boolean} [canNull=false] - Whether `null` is allowed as a valid value.
+     * @returns {any} - The validated element or `null` if allowed.
+     * @throws {Error} - If the element is not valid or if multiple elements are provided.
+     * @readonly
+     */
+    _preElemTemplate(where, TheTinyElements, elemName, canNull = false) {
+        return TinyHtml._preElemTemplate(this, where, TheTinyElements, elemName, canNull);
+    }
     /**
      * Ensures the input is returned as an array.
      * Useful to normalize operations across multiple or single elements.
@@ -1071,6 +1098,17 @@ class TinyHtml {
     static _preElems(elems, where) {
         return TinyHtml._preElemsTemplate(elems, where, [Element], ['Element']);
     }
+    /**
+     * Ensures the input is returned as an array.
+     * Useful to normalize operations across multiple or single elements.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {Element[]} - Always returns an array of elements.
+     * @readonly
+     */
+    _preElems(where) {
+        return TinyHtml._preElems(this, where);
+    }
     /**
      * Ensures the input is returned as an single element.
      * Useful to normalize operations across multiple or single elements.
@@ -1083,6 +1121,17 @@ class TinyHtml {
     static _preElem(elems, where) {
         return TinyHtml._preElemTemplate(elems, where, [Element], ['Element']);
     }
+    /**
+     * Ensures the input is returned as an single element.
+     * Useful to normalize operations across multiple or single elements.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {Element} - Always returns an single element.
+     * @readonly
+     */
+    _preElem(where) {
+        return TinyHtml._preElem(this, where);
+    }
     /**
      * Ensures the input is returned as an array.
      * Useful to normalize operations across multiple or single nodes.
@@ -1095,6 +1144,17 @@ class TinyHtml {
     static _preNodeElems(elems, where) {
         return TinyHtml._preElemsTemplate(elems, where, [Node], ['Node']);
     }
+    /**
+     * Ensures the input is returned as an array.
+     * Useful to normalize operations across multiple or single nodes.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {Node[]} - Always returns an array of nodes.
+     * @readonly
+     */
+    _preNodeElems(where) {
+        return TinyHtml._preNodeElems(this, where);
+    }
     /**
      * Ensures the input is returned as an single node.
      * Useful to normalize operations across multiple or single nodes.
@@ -1107,6 +1167,17 @@ class TinyHtml {
     static _preNodeElem(elems, where) {
         return TinyHtml._preElemTemplate(elems, where, [Node], ['Node']);
     }
+    /**
+     * Ensures the input is returned as an single node.
+     * Useful to normalize operations across multiple or single nodes.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {Node} - Always returns an single node.
+     * @readonly
+     */
+    _preNodeElem(where) {
+        return TinyHtml._preNodeElem(this, where);
+    }
     /**
      * Ensures the input is returned as an single node.
      * Useful to normalize operations across multiple or single nodes.
@@ -1119,6 +1190,17 @@ class TinyHtml {
     static _preNodeElemWithNull(elems, where) {
         return TinyHtml._preElemTemplate(elems, where, [Node], ['Node'], true);
     }
+    /**
+     * Ensures the input is returned as an single node.
+     * Useful to normalize operations across multiple or single nodes.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {Node|null} - Always returns an single node or null.
+     * @readonly
+     */
+    _preNodeElemWithNull(where) {
+        return TinyHtml._preNodeElemWithNull(this, where);
+    }
     /**
      * Ensures the input is returned as an array.
      * Useful to normalize operations across multiple or single html elements.
@@ -1131,6 +1213,17 @@ class TinyHtml {
     static _preHtmlElems(elems, where) {
         return TinyHtml._preElemsTemplate(elems, where, [HTMLElement], ['HTMLElement']);
     }
+    /**
+     * Ensures the input is returned as an array.
+     * Useful to normalize operations across multiple or single html elements.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {HTMLElement[]} - Always returns an array of html elements.
+     * @readonly
+     */
+    _preHtmlElems(where) {
+        return TinyHtml._preHtmlElems(this, where);
+    }
     /**
      * Ensures the input is returned as an single html element.
      * Useful to normalize operations across multiple or single html elements.
@@ -1143,6 +1236,17 @@ class TinyHtml {
     static _preHtmlElem(elems, where) {
         return TinyHtml._preElemTemplate(elems, where, [HTMLElement], ['HTMLElement']);
     }
+    /**
+     * Ensures the input is returned as an single html element.
+     * Useful to normalize operations across multiple or single html elements.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {HTMLElement} - Always returns an single html element.
+     * @readonly
+     */
+    _preHtmlElem(where) {
+        return TinyHtml._preHtmlElem(this, where);
+    }
     /**
      * Ensures the input is returned as an array.
      * Useful to normalize operations across multiple or single event target elements.
@@ -1155,6 +1259,17 @@ class TinyHtml {
     static _preInputElems(elems, where) {
         return TinyHtml._preElemsTemplate(elems, where, [HTMLInputElement, HTMLSelectElement, HTMLTextAreaElement, HTMLOptionElement], ['HTMLInputElement', 'HTMLSelectElement', 'HTMLTextAreaElement', 'HTMLOptionElement']);
     }
+    /**
+     * Ensures the input is returned as an array.
+     * Useful to normalize operations across multiple or single event target elements.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {InputElement[]} - Always returns an array of event target elements.
+     * @readonly
+     */
+    _preInputElems(where) {
+        return TinyHtml._preInputElems(this, where);
+    }
     /**
      * Ensures the input is returned as an single event target element.
      * Useful to normalize operations across multiple or single event target elements.
@@ -1167,6 +1282,17 @@ class TinyHtml {
     static _preInputElem(elems, where) {
         return TinyHtml._preElemTemplate(elems, where, [HTMLInputElement, HTMLSelectElement, HTMLTextAreaElement, HTMLOptionElement], ['HTMLInputElement', 'HTMLSelectElement', 'HTMLTextAreaElement', 'HTMLOptionElement']);
     }
+    /**
+     * Ensures the input is returned as an single event target element.
+     * Useful to normalize operations across multiple or single event target elements.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {InputElement} - Always returns an single event target element.
+     * @readonly
+     */
+    _preInputElem(where) {
+        return TinyHtml._preInputElem(this, where);
+    }
     /**
      * Ensures the input is returned as an array.
      * Useful to normalize operations across multiple or single event target elements.
@@ -1179,6 +1305,17 @@ class TinyHtml {
     static _preEventTargetElems(elems, where) {
         return TinyHtml._preElemsTemplate(elems, where, [EventTarget], ['EventTarget']);
     }
+    /**
+     * Ensures the input is returned as an array.
+     * Useful to normalize operations across multiple or single event target elements.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {EventTarget[]} - Always returns an array of event target elements.
+     * @readonly
+     */
+    _preEventTargetElems(where) {
+        return TinyHtml._preEventTargetElems(this, where);
+    }
     /**
      * Ensures the input is returned as an single event target element.
      * Useful to normalize operations across multiple or single event target elements.
@@ -1191,6 +1328,17 @@ class TinyHtml {
     static _preEventTargetElem(elems, where) {
         return TinyHtml._preElemTemplate(elems, where, [EventTarget], ['EventTarget']);
     }
+    /**
+     * Ensures the input is returned as an single event target element.
+     * Useful to normalize operations across multiple or single event target elements.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {EventTarget} - Always returns an single event target element.
+     * @readonly
+     */
+    _preEventTargetElem(where) {
+        return TinyHtml._preEventTargetElem(this, where);
+    }
     /**
      * Ensures the input is returned as an array.
      * Useful to normalize operations across multiple or single element/window elements.
@@ -1203,6 +1351,17 @@ class TinyHtml {
     static _preElemsAndWindow(elems, where) {
         return TinyHtml._preElemsTemplate(elems, where, [Element, Window], ['Element', 'Window']);
     }
+    /**
+     * Ensures the input is returned as an array.
+     * Useful to normalize operations across multiple or single element/window elements.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {ElementAndWindow[]} - Always returns an array of element/window elements.
+     * @readonly
+     */
+    _preElemsAndWindow(where) {
+        return TinyHtml._preElemsAndWindow(this, where);
+    }
     /**
      * Ensures the input is returned as an single element/window element.
      * Useful to normalize operations across multiple or single element/window elements.
@@ -1215,6 +1374,17 @@ class TinyHtml {
     static _preElemAndWindow(elems, where) {
         return TinyHtml._preElemTemplate(elems, where, [Element, Window], ['Element', 'Window']);
     }
+    /**
+     * Ensures the input is returned as an single element/window element.
+     * Useful to normalize operations across multiple or single element/window elements.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {ElementAndWindow} - Always returns an single element/window element.
+     * @readonly
+     */
+    _preElemAndWindow(where) {
+        return TinyHtml._preElemAndWindow(this, where);
+    }
     /**
      * Ensures the input is returned as an array.
      * Useful to normalize operations across multiple or single element/window/document elements.
@@ -1228,6 +1398,17 @@ class TinyHtml {
         const result = TinyHtml._preElemsTemplate(elems, where, [Element, Window, Document], ['Element', 'Window', 'Document']);
         return result.map((elem) => (!(elem instanceof Document) ? elem : elem.documentElement));
     }
+    /**
+     * Ensures the input is returned as an array.
+     * Useful to normalize operations across multiple or single element/window/document elements.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {ElementAndWindow[]} - Always returns an array of element/document/window elements.
+     * @readonly
+     */
+    _preElemsAndWinAndDoc(where) {
+        return TinyHtml._preElemsAndWinAndDoc(this, where);
+    }
     /**
      * Ensures the input is returned as an single element/window/document element.
      * Useful to normalize operations across multiple or single element/window/document elements.
@@ -1243,6 +1424,17 @@ class TinyHtml {
             return result.documentElement;
         return result;
     }
+    /**
+     * Ensures the input is returned as an single element/window/document element.
+     * Useful to normalize operations across multiple or single element/window/document elements.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {ElementAndWindow} - Always returns an single element/document/window element.
+     * @readonly
+     */
+    _preElemAndWinAndDoc(where) {
+        return TinyHtml._preElemAndWinAndDoc(this, where);
+    }
     /**
      * Ensures the input is returned as an array.
      * Useful to normalize operations across multiple or single element with document elements.
@@ -1255,6 +1447,17 @@ class TinyHtml {
     static _preElemsWithDoc(elems, where) {
         return TinyHtml._preElemsTemplate(elems, where, [Element, Document], ['Element', 'Document']);
     }
+    /**
+     * Ensures the input is returned as an array.
+     * Useful to normalize operations across multiple or single element with document elements.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {ElementWithDoc[]} - Always returns an array of element with document elements.
+     * @readonly
+     */
+    _preElemsWithDoc(where) {
+        return TinyHtml._preElemsWithDoc(this, where);
+    }
     /**
      * Ensures the input is returned as an single element with document element.
      * Useful to normalize operations across multiple or single element with document elements.
@@ -1267,6 +1470,17 @@ class TinyHtml {
     static _preElemWithDoc(elems, where) {
         return TinyHtml._preElemTemplate(elems, where, [Element, Document], ['Element', 'Document']);
     }
+    /**
+     * Ensures the input is returned as an single element with document element.
+     * Useful to normalize operations across multiple or single element with document elements.
+     *
+     * @param {string} where - The method or context name where validation is being called.
+     * @returns {ElementWithDoc} - Always returns an single element/window element.
+     * @readonly
+     */
+    _preElemWithDoc(where) {
+        return TinyHtml._preElemWithDoc(this, where);
+    }
     //////////////////////////////////////////////////////
     // TITLE: Converter DOM <--> TinyHtml
     /**
@@ -3211,6 +3425,13 @@ class TinyHtml {
     setHeight(value) {
         return TinyHtml.setHeight(this, value);
     }
+    /**
+     * Sets the height of the element.
+     * @param {string|number} value - Height value.
+     */
+    set height(value) {
+        TinyHtml.setHeight(this, value);
+    }
     /**
      * Sets the width of the element.
      * @template {TinyHtmlElement} T
@@ -3234,6 +3455,13 @@ class TinyHtml {
     setWidth(value) {
         return TinyHtml.setWidth(this, value);
     }
+    /**
+     * Sets the width of the element.
+     * @param {string|number} value - Width value.
+     */
+    set width(value) {
+        TinyHtml.setWidth(this, value);
+    }
     /**
      * Returns content box height.
      * @param {TinyElementAndWinAndDoc} el - Target element.
@@ -3247,7 +3475,7 @@ class TinyHtml {
      * Returns content box height.
      * @returns {number}
      */
-    height() {
+    get height() {
         return TinyHtml.height(this);
     }
     /**
@@ -3263,7 +3491,7 @@ class TinyHtml {
      * Returns content box width.
      * @returns {number}
      */
-    width() {
+    get width() {
         return TinyHtml.width(this);
     }
     /**
@@ -4955,9 +5183,16 @@ class TinyHtml {
      * Returns the ID of the element.
      * @returns {string} The element's ID.
      */
-    id() {
+    get id() {
         return TinyHtml.id(this);
     }
+    /**
+     * Set the id on an element.
+     * @param {string} value - Id name.
+     */
+    set id(value) {
+        TinyHtml.setAttr(this, 'id', value);
+    }
     //////////////////////////////////////////////////////////////
     // TITLE: DOM Content Stuff
     /**

package/dist/{legacy/libs/userLevel.d.mts → v1/libs/TinyLevelUp.d.mts}

@@ -139,4 +139,4 @@ declare class TinyLevelUp {
      */
     remove(user: UserEditor, extraExp?: number, type?: "add" | "extra", multi?: number): UserEditor;
 }
-//# sourceMappingURL=userLevel.d.mts.map
+//# sourceMappingURL=TinyLevelUp.d.mts.map

package/dist/v1/libs/TinyUploadClicker.cjs

@@ -7,6 +7,7 @@ require('path');
 require('fs/promises');
 require('./TinyHtml.cjs');
 require('./TinyLocalStorage.cjs');
+require('./TinyColorValidator.cjs');
 
 /**
  * @typedef {Object} UploaderConfig

package/docs/v1/README.md

@@ -59,6 +59,7 @@ This folder contains the core scripts we have worked on so far. Each file is a m
 - 🎲 **[TinySimpleDice](./libs/TinySimpleDice.md)** — A lightweight and flexible dice rolling utility with configurable maximum values, zero allowance, and array/Set index rolling support.
 - 👀 **[TinyElementObserver](./libs/TinyElementObserver.md)** — A DOM mutation tracking utility built on MutationObserver, with customizable detectors for handling changes, event dispatching, and lifecycle management.  
 - ⏳ **[TinyLoadingScreen](./libs/TinyLoadingScreen.md)** — A lightweight, fully-configurable loading overlay with fade-in/out animations, custom messages (string or HTMLElement), HTML rendering option, and status-change callbacks.
+- 🎨 **[TinyColorValidator](./libs/TinyColorValidator.md)** — A comprehensive CSS color validation and parsing utility supporting HEX, HEXA, RGB, RGBA, HSL, HSLA, HWB, Lab, LCH, standard HTML color names, and special keywords, with automatic type detection and parsing.
 
 ### 3. **`fileManager/`**
 * 📁 **[Main](./fileManager/main.md)** — A Node.js file/directory utility module with support for JSON, backups, renaming, size analysis, and more.