tiny-essentials 1.22.4 → 1.22.6

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

@@ -300,6 +300,42 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
             y: number;
         };
     };
+    /**
+     * Controls whether TinyHtml emits detailed debug output to the console.
+     * When enabled, helper methods print structured diagnostics for easier troubleshooting.
+     * @type {boolean}
+     */
+    static "__#8@#elemDebug": boolean;
+    /**
+     * Enables or disables debug output.
+     * @param {boolean} value True to enable debug output; false to disable.
+     * @throws {TypeError} Thrown if the provided value is not a boolean.
+     * @returns {void}
+     */
+    static set elemDebug(value: boolean);
+    /**
+     * Gets whether debug output is enabled.
+     * @returns {boolean} True if debug output is enabled; otherwise, false.
+     */
+    static get elemDebug(): boolean;
+    /**
+     * Logs a standardized debug error for element validation, including a console.table
+     * with the involved elements. Use this when an element argument is invalid, unexpected,
+     * or fails a guard/validation.
+     *
+     * The output includes:
+     *  - A concise error header
+     *  - A stack trace (when supported)
+     *  - A table of elements (index, typeof, constructor, summary, value)
+     *  - The specific problematic element, if provided
+     *
+     * @param {(ConstructorElValues | EventTarget | TinyElement | null)[]} elems
+     *        A list of elements participating in the operation (may include nulls).
+     * @param {ConstructorElValues | EventTarget | TinyElement | null} [elem]
+     *        The specific element that triggered the error, if available.
+     * @returns {void}
+     */
+    static _debugElemError(elems: (ConstructorElValues | EventTarget | TinyElement | null)[], elem?: ConstructorElValues | EventTarget | TinyElement | null, ...args: any[]): void;
     /**
      * Parse inline styles into an object.
      * @param {string} styleText
@@ -2346,6 +2382,104 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
      * @returns {string} - The corresponding attribute name.
      */
     static getAttrName(name: string): string;
+    /**
+     * Returns the BigInt value of an attribute.
+     * @param {TinyElement} el
+     * @param {string} name
+     * @returns {bigint|null}
+     */
+    static attrBigInt(el: TinyElement, name: string): bigint | null;
+    /**
+     * Set a BigInt attribute.
+     * @template {TinyElement|TinyElement[]} T
+     * @param {T} el
+     * @param {string} name
+     * @param {bigint} value
+     * @returns {T}
+     */
+    static setAttrBigInt<T extends TinyElement | TinyElement[]>(el: T, name: string, value: bigint): T;
+    /**
+     * Returns the Date value of an attribute.
+     * @param {TinyElement} el
+     * @param {string} name
+     * @returns {Date|null}
+     */
+    static attrDate(el: TinyElement, name: string): Date | null;
+    /**
+     * Set a Date attribute.
+     * @template {TinyElement|TinyElement[]} T
+     * @param {T} el
+     * @param {string} name
+     * @param {Date} value
+     * @returns {T}
+     */
+    static setAttrDate<T extends TinyElement | TinyElement[]>(el: T, name: string, value: Date): T;
+    /**
+     * Returns the JSON value of an attribute.
+     * @param {TinyElement} el
+     * @param {string} name
+     * @returns {any|null}
+     */
+    static attrJson(el: TinyElement, name: string): any | null;
+    /**
+     * Set a JSON attribute.
+     * @template {TinyElement|TinyElement[]} T
+     * @param {T} el
+     * @param {string} name
+     * @param {any} value
+     * @param {(this: any, key: string, value: any) => any} [replacer]
+     * @param {number|string} [space]
+     * @returns {T}
+     */
+    static setAttrJson<T extends TinyElement | TinyElement[]>(el: T, name: string, value: any, replacer?: (this: any, key: string, value: any) => any, space?: number | string): T;
+    /**
+     * Returns the number value of an attribute.
+     * @param {TinyElement} el
+     * @param {string} name
+     * @returns {number|null}
+     */
+    static attrNumber(el: TinyElement, name: string): number | null;
+    /**
+     * Set a number attribute.
+     * @template {TinyElement|TinyElement[]} T
+     * @param {T} el
+     * @param {string} name
+     * @param {number} value
+     * @returns {T}
+     */
+    static setAttrNumber<T extends TinyElement | TinyElement[]>(el: T, name: string, value: number): T;
+    /**
+     * Returns the boolean value of an attribute.
+     * @param {TinyElement} el
+     * @param {string} name
+     * @returns {boolean|null}
+     */
+    static attrBoolean(el: TinyElement, name: string): boolean | null;
+    /**
+     * Set a boolean attribute.
+     * @template {TinyElement|TinyElement[]} T
+     * @param {T} el
+     * @param {string} name
+     * @param {boolean} value
+     * @returns {T}
+     */
+    static setAttrBoolean<T extends TinyElement | TinyElement[]>(el: T, name: string, value: boolean): T;
+    /**
+     * Returns the string value of an attribute.
+     * @param {TinyElement} el
+     * @param {string} name
+     * @returns {string|null}
+     */
+    static attrString(el: TinyElement, name: string): string | null;
+    /**
+     * Set a string attribute.
+     * @template {TinyElement|TinyElement[]} T
+     * @param {T} el
+     * @param {string} name
+     * @param {string} value
+     * @returns {T}
+     */
+    static setAttrString<T extends TinyElement | TinyElement[]>(el: T, name: string, value: string): T;
     /**
      * Get an attribute on an element.
      * @param {TinyElement} el
@@ -2357,11 +2491,11 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
      * Set one or multiple attributes on an element.
      * @template {TinyElement|TinyElement[]} T
      * @param {T} el - Target element(s).
-     * @param {string|Record<string, string|null>} name - Attribute name or an object of attributes.
-     * @param {string|number|null} [value=null] - Attribute value (ignored if "name" is an object).
+     * @param {string|Record<string, any>} name - Attribute name or an object of attributes.
+     * @param {any} [value=null] - Attribute value (ignored if "name" is an object).
      * @returns {T}
      */
-    static setAttr<T extends TinyElement | TinyElement[]>(el: T, name: string | Record<string, string | null>, value?: string | number | null): T;
+    static setAttr<T extends TinyElement | TinyElement[]>(el: T, name: string | Record<string, any>, value?: any): T;
     /**
      * Remove attribute(s) from an element.
      * @template {TinyElement|TinyElement[]} T
@@ -3528,6 +3662,86 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
      * @returns {this}
      */
     trigger(events: string | string[], payload?: Event | CustomEvent | CustomEventInit): this;
+    /**
+     * Returns the BigInt value of an attribute.
+     * @param {string} name
+     * @returns {bigint|null}
+     */
+    attrBigInt(name: string): bigint | null;
+    /**
+     * Set a BigInt attribute.
+     * @param {string} name
+     * @param {bigint} value
+     * @returns {this}
+     */
+    setAttrBigInt(name: string, value: bigint): this;
+    /**
+     * Returns the Date value of an attribute.
+     * @param {string} name
+     * @returns {Date|null}
+     */
+    attrDate(name: string): Date | null;
+    /**
+     * Set a Date attribute.
+     * @param {string} name
+     * @param {Date} value
+     * @returns {this}
+     */
+    setAttrDate(name: string, value: Date): this;
+    /**
+     * Returns the JSON value of an attribute.
+     * @param {string} name
+     * @returns {any|null}
+     */
+    attrJson(name: string): any | null;
+    /**
+     * Set a JSON attribute.
+     * @param {string} name
+     * @param {any} value
+     * @param {(this: any, key: string, value: any) => any} [replacer]
+     * @param {number|string} [space]
+     * @returns {this}
+     */
+    setAttrJson(name: string, value: any, replacer?: (this: any, key: string, value: any) => any, space?: number | string): this;
+    /**
+     * Returns the number value of an attribute.
+     * @param {string} name
+     * @returns {number|null}
+     */
+    attrNumber(name: string): number | null;
+    /**
+     * Set a number attribute.
+     * @param {string} name
+     * @param {number} value
+     * @returns {this}
+     */
+    setAttrNumber(name: string, value: number): this;
+    /**
+     * Returns the boolean value of an attribute.
+     * @param {string} name
+     * @returns {boolean|null}
+     */
+    attrBoolean(name: string): boolean | null;
+    /**
+     * Set a boolean attribute.
+     * @param {string} name
+     * @param {boolean} value
+     * @returns {this}
+     */
+    setAttrBoolean(name: string, value: boolean): this;
+    /**
+     * Returns the string value of an attribute.
+     * @param {string} name
+     * @returns {string|null}
+     */
+    attrString(name: string): string | null;
+    /**
+     * Set a string attribute.
+     * @param {string} name
+     * @param {string} value
+     * @returns {this}
+     */
+    setAttrString(name: string, value: string): this;
     /**
      * Get an attribute on an element.
      * @param {string} name
@@ -3536,11 +3750,11 @@ declare class TinyHtml<TinyHtmlT extends ConstructorElValues | ConstructorElValu
     attr(name: string): string | 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|number|null} [value=null] - Attribute value (ignored if "name" is an object).
+     * @param {string|Record<string, any>} name - Attribute name or an object of attributes.
+     * @param {any} [value=null] - Attribute value (ignored if "name" is an object).
      * @returns {this}
      */
-    setAttr(name: string | Record<string, string | null>, value?: string | number | null): this;
+    setAttr(name: string | Record<string, any>, value?: any): this;
     /**
      * Remove attribute(s) from an element.
      * @param {string} name Space-separated list of attributes.