tiny-essentials 1.24.0 → 1.24.1

package/dist/v1/libs/TinyHtml.cjs

@@ -1164,6 +1164,20 @@ class TinyHtml {
     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.
    *
@@ -1219,6 +1233,21 @@ 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.
@@ -1232,6 +1261,18 @@ class TinyHtml {
     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.
@@ -1245,6 +1286,18 @@ class TinyHtml {
     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.
@@ -1258,6 +1311,18 @@ class TinyHtml {
     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.
@@ -1271,6 +1336,18 @@ class TinyHtml {
     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.
@@ -1284,6 +1361,18 @@ class TinyHtml {
     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.
@@ -1297,6 +1386,18 @@ class TinyHtml {
     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.
@@ -1310,6 +1411,18 @@ class TinyHtml {
     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.
@@ -1328,6 +1441,18 @@ class TinyHtml {
     );
   }
 
+  /**
+   * 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.
@@ -1346,6 +1471,18 @@ class TinyHtml {
     );
   }
 
+  /**
+   * 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.
@@ -1359,6 +1496,18 @@ class TinyHtml {
     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.
@@ -1372,6 +1521,18 @@ class TinyHtml {
     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.
@@ -1385,6 +1546,18 @@ class TinyHtml {
     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.
@@ -1398,6 +1571,18 @@ class TinyHtml {
     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.
@@ -1417,6 +1602,18 @@ class TinyHtml {
     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.
@@ -1437,6 +1634,18 @@ class TinyHtml {
     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.
@@ -1450,6 +1659,18 @@ class TinyHtml {
     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.
@@ -1463,6 +1684,18 @@ class TinyHtml {
     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
@@ -3590,6 +3823,14 @@ class TinyHtml {
     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
@@ -3615,6 +3856,14 @@ class TinyHtml {
     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.
@@ -3629,7 +3878,7 @@ class TinyHtml {
    * Returns content box height.
    * @returns {number}
    */
-  height() {
+  get height() {
     return TinyHtml.height(this);
   }
 
@@ -3647,7 +3896,7 @@ class TinyHtml {
    * Returns content box width.
    * @returns {number}
    */
-  width() {
+  get width() {
     return TinyHtml.width(this);
   }
 
@@ -5543,10 +5792,18 @@ 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/v1/libs/TinyHtml.d.mts

@@ -2898,6 +2898,182 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      * @readonly
      */
     readonly _getElements(where: string): ConstructorElValues[];
+    /**
+     * 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
+     */
+    readonly _preElemsTemplate(where: string, TheTinyElements: any[], elemName: string[]): any[];
+    /**
+     * 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
+     */
+    readonly _preElemTemplate(where: string, TheTinyElements: any[], elemName: string[], canNull?: boolean): any;
+    /**
+     * 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
+     */
+    readonly _preElems(where: string): 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
+     */
+    readonly _preElem(where: string): Element;
+    /**
+     * 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
+     */
+    readonly _preNodeElems(where: string): 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
+     */
+    readonly _preNodeElem(where: string): 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|null} - Always returns an single node or null.
+     * @readonly
+     */
+    readonly _preNodeElemWithNull(where: string): Node | null;
+    /**
+     * 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
+     */
+    readonly _preHtmlElems(where: string): 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
+     */
+    readonly _preHtmlElem(where: string): HTMLElement;
+    /**
+     * 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
+     */
+    readonly _preInputElems(where: string): InputElement[];
+    /**
+     * 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
+     */
+    readonly _preInputElem(where: string): InputElement;
+    /**
+     * 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
+     */
+    readonly _preEventTargetElems(where: string): 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
+     */
+    readonly _preEventTargetElem(where: string): EventTarget;
+    /**
+     * 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
+     */
+    readonly _preElemsAndWindow(where: string): ElementAndWindow[];
+    /**
+     * 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
+     */
+    readonly _preElemAndWindow(where: string): ElementAndWindow;
+    /**
+     * 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
+     */
+    readonly _preElemsAndWinAndDoc(where: string): ElementAndWindow[];
+    /**
+     * 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
+     */
+    readonly _preElemAndWinAndDoc(where: string): ElementAndWindow;
+    /**
+     * 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
+     */
+    readonly _preElemsWithDoc(where: string): ElementWithDoc[];
+    /**
+     * 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
+     */
+    readonly _preElemWithDoc(where: string): ElementWithDoc;
     /**
      * Returns only the elements **not** matching the given selector or function.
      *
@@ -3268,6 +3444,16 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      * @returns {this}
      */
     setHeight(value: string | number): this;
+    /**
+     * Sets the height of the element.
+     * @param {string|number} value - Height value.
+     */
+    set height(value: string | number);
+    /**
+     * Returns content box height.
+     * @returns {number}
+     */
+    get height(): number;
     /**
      * Sets the width of the element.
      * @param {string|number} value - Width value.
@@ -3275,15 +3461,15 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      */
     setWidth(value: string | number): this;
     /**
-     * Returns content box height.
-     * @returns {number}
+     * Sets the width of the element.
+     * @param {string|number} value - Width value.
      */
-    height(): number;
+    set width(value: string | number);
     /**
      * Returns content box width.
      * @returns {number}
      */
-    width(): number;
+    get width(): number;
     /**
      * Returns padding box height.
      * @returns {number}
@@ -3542,11 +3728,16 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      * @returns {string} The tag name in uppercase.
      */
     tagName(): string;
+    /**
+     * Set the id on an element.
+     * @param {string} value - Id name.
+     */
+    set id(value: string);
     /**
      * Returns the ID of the element.
      * @returns {string} The element's ID.
      */
-    id(): string;
+    get id(): string;
     /**
      * Returns the BigInt content of the element.
      * @returns {bigint|null}