tiny-essentials 1.21.3 → 1.21.5

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

@@ -1171,6 +1171,13 @@ declare class TinyHtml {
      * @returns {TinyHtmlElement}
      */
     static blur(el: TinyHtmlElement): TinyHtmlElement;
+    /**
+     * Select the text content of an input or textarea element.
+     *
+     * @param {TinyHtml|HTMLInputElement|HTMLTextAreaElement} el - The element or a selector string.
+     * @returns {TinyHtml|HTMLInputElement|HTMLTextAreaElement}
+     */
+    static select(el: TinyHtml | HTMLInputElement | HTMLTextAreaElement): TinyHtml | HTMLInputElement | HTMLTextAreaElement;
     /**
      * Interprets a value as a boolean `true` if it matches a common truthy representation.
      *
@@ -1474,6 +1481,59 @@ declare class TinyHtml {
      * @returns {string} The element's ID.
      */
     static id(el: TinyElement): string;
+    /**
+     * Returns the BigInt content of the element.
+     * @param {TinyElement} el - Target element.
+     * @returns {bigint|null} The BigInt content or null if none.
+     */
+    static toBigInt(el: TinyElement): bigint | null;
+    /**
+     * Set BigInt content of elements.
+     * @param {TinyElement|TinyElement[]} el
+     * @param {bigint} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    static setBigInt(el: TinyElement | TinyElement[], value: bigint): TinyElement | TinyElement[];
+    /**
+     * Returns the Date content of the element.
+     * @param {TinyElement} el - Target element.
+     * @returns {Date|null} The Date content or null if invalid.
+     */
+    static toDate(el: TinyElement): Date | null;
+    /**
+     * Set Date content of elements.
+     * @param {TinyElement|TinyElement[]} el
+     * @param {Date} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    static setDate(el: TinyElement | TinyElement[], value: Date): TinyElement | TinyElement[];
+    /**
+     * Returns the JSON content of the element.
+     * @param {TinyElement} el - Target element.
+     * @returns {any|null} The parsed JSON content or null if invalid.
+     */
+    static toJson(el: TinyElement): any | null;
+    /**
+     * Set JSON content of elements.
+     * @param {TinyElement|TinyElement[]} el
+     * @param {any} value
+     * @param {number|string} [space] - Indentation level or string for formatting.
+     * @returns {TinyElement|TinyElement[]}
+     */
+    static setJson(el: TinyElement | TinyElement[], value: any, space?: number | string): TinyElement | TinyElement[];
+    /**
+     * Returns the number content of the element.
+     * @param {TinyElement} el - Target element.
+     * @returns {number|null} The text content or null if none.
+     */
+    static toNumber(el: TinyElement): number | null;
+    /**
+     * Set number content of elements.
+     * @param {TinyElement|TinyElement[]} el
+     * @param {number} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    static setNumber(el: TinyElement | TinyElement[], value: number): TinyElement | TinyElement[];
     /**
      * Returns the text content of the element.
      * @param {TinyElement} el - Target element.
@@ -1710,40 +1770,40 @@ declare class TinyHtml {
      * Registers an event listener on the specified element.
      *
      * @param {TinyEventTarget|TinyEventTarget[]} el - The target to listen on.
-     * @param {string} event - The event type (e.g. 'click', 'keydown').
+     * @param {string|string[]} events - The event type (e.g. 'click', 'keydown').
      * @param {EventListenerOrEventListenerObject|null} handler - The callback function to run on event.
      * @param {EventRegistryOptions} [options] - Optional event listener options.
      * @returns {TinyEventTarget|TinyEventTarget[]}
      */
-    static on(el: TinyEventTarget | TinyEventTarget[], event: string, handler: EventListenerOrEventListenerObject | null, options?: EventRegistryOptions): TinyEventTarget | TinyEventTarget[];
+    static on(el: TinyEventTarget | TinyEventTarget[], events: string | string[], handler: EventListenerOrEventListenerObject | null, options?: EventRegistryOptions): TinyEventTarget | TinyEventTarget[];
     /**
      * Registers an event listener that runs only once, then is removed.
      *
      * @param {TinyEventTarget|TinyEventTarget[]} el - The target to listen on.
-     * @param {string} event - The event type (e.g. 'click', 'keydown').
+     * @param {string|string[]} events - The event type (e.g. 'click', 'keydown').
      * @param {EventListenerOrEventListenerObject} handler - The callback function to run on event.
      * @param {EventRegistryOptions} [options={}] - Optional event listener options.
      * @returns {TinyEventTarget|TinyEventTarget[]}
      */
-    static once(el: TinyEventTarget | TinyEventTarget[], event: string, handler: EventListenerOrEventListenerObject, options?: EventRegistryOptions): TinyEventTarget | TinyEventTarget[];
+    static once(el: TinyEventTarget | TinyEventTarget[], events: string | string[], handler: EventListenerOrEventListenerObject, options?: EventRegistryOptions): TinyEventTarget | TinyEventTarget[];
     /**
      * Removes a specific event listener from an element.
      *
      * @param {TinyEventTarget|TinyEventTarget[]} el - The target element.
-     * @param {string} event - The event type.
+     * @param {string|string[]} events - The event type.
      * @param {EventListenerOrEventListenerObject|null} handler - The function originally bound to the event.
      * @param {boolean|EventListenerOptions} [options] - Optional listener options.
      * @returns {TinyEventTarget|TinyEventTarget[]}
      */
-    static off(el: TinyEventTarget | TinyEventTarget[], event: string, handler: EventListenerOrEventListenerObject | null, options?: boolean | EventListenerOptions): TinyEventTarget | TinyEventTarget[];
+    static off(el: TinyEventTarget | TinyEventTarget[], events: string | string[], handler: EventListenerOrEventListenerObject | null, options?: boolean | EventListenerOptions): TinyEventTarget | TinyEventTarget[];
     /**
      * Removes all event listeners of a specific type from the element.
      *
      * @param {TinyEventTarget|TinyEventTarget[]} el - The target element.
-     * @param {string} event - The event type to remove (e.g. 'click').
+     * @param {string|string[]} events - The event type to remove (e.g. 'click').
      * @returns {TinyEventTarget|TinyEventTarget[]}
      */
-    static offAll(el: TinyEventTarget | TinyEventTarget[], event: string): TinyEventTarget | TinyEventTarget[];
+    static offAll(el: TinyEventTarget | TinyEventTarget[], events: string | string[]): TinyEventTarget | TinyEventTarget[];
     /**
      * Removes all event listeners of all types from the element.
      *
@@ -1757,11 +1817,11 @@ declare class TinyHtml {
      * Triggers all handlers associated with a specific event on the given element.
      *
      * @param {TinyEventTarget|TinyEventTarget[]} el - Target element where the event should be triggered.
-     * @param {string} event - Name of the event to trigger.
+     * @param {string|string[]} events - Name of the event to trigger.
      * @param {Event|CustomEvent|CustomEventInit} [payload] - Optional event object or data to pass.
      * @returns {TinyEventTarget|TinyEventTarget[]}
      */
-    static trigger(el: TinyEventTarget | TinyEventTarget[], event: string, payload?: Event | CustomEvent | CustomEventInit): TinyEventTarget | TinyEventTarget[];
+    static trigger(el: TinyEventTarget | TinyEventTarget[], events: string | string[], payload?: Event | CustomEvent | CustomEventInit): TinyEventTarget | TinyEventTarget[];
     /**
      * Internal property name normalization map (similar to jQuery's `propFix`).
      * Maps attribute-like names to their JavaScript DOM property equivalents.
@@ -2417,6 +2477,11 @@ declare class TinyHtml {
      * @returns {TinyHtmlElement}
      */
     blur(): TinyHtmlElement;
+    /**
+     * Select the text content of an input or textarea element.
+     * @returns {TinyHtml|HTMLInputElement|HTMLTextAreaElement}
+     */
+    select(): TinyHtml | HTMLInputElement | HTMLTextAreaElement;
     /**
      * Gets the width or height of an element based on the box model.
      * @param {"width"|"height"} type - Dimension type.
@@ -2617,6 +2682,51 @@ declare class TinyHtml {
      * @returns {string} The element's ID.
      */
     id(): string;
+    /**
+     * Returns the BigInt content of the element.
+     * @returns {bigint|null}
+     */
+    toBigInt(): bigint | null;
+    /**
+     * Set BigInt content of the element.
+     * @param {bigint} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    setBigInt(value: bigint): TinyElement | TinyElement[];
+    /**
+     * Returns the Date content of the element.
+     * @returns {Date|null}
+     */
+    toDate(): Date | null;
+    /**
+     * Set Date content of the element.
+     * @param {Date} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    setDate(value: Date): TinyElement | TinyElement[];
+    /**
+     * Returns the JSON content of the element.
+     * @returns {any|null}
+     */
+    toJson(): any | null;
+    /**
+     * Set JSON content of the element.
+     * @param {any} value
+     * @param {number|string} [space] - Indentation level or string for formatting.
+     * @returns {TinyElement|TinyElement[]}
+     */
+    setJson(value: any, space?: number | string): TinyElement | TinyElement[];
+    /**
+     * Returns the number content of the element.
+     * @returns {number|null} The text content or null if none.
+     */
+    toNumber(): number | null;
+    /**
+     * Set number content of the element.
+     * @param {number} value
+     * @returns {TinyElement|TinyElement[]}
+     */
+    setNumber(value: number): TinyElement | TinyElement[];
     /**
      * Returns the text content of the element.
      * @returns {string|null} The text content or null if none.
@@ -2748,37 +2858,37 @@ declare class TinyHtml {
     /**
      * Registers an event listener on the specified element.
      *
-     * @param {string} event - The event type (e.g. 'click', 'keydown').
+     * @param {string|string[]} events - The event type (e.g. 'click', 'keydown').
      * @param {EventListenerOrEventListenerObject|null} handler - The callback function to run on event.
      * @param {EventRegistryOptions} [options] - Optional event listener options.
      * @returns {TinyEventTarget|TinyEventTarget[]}
      */
-    on(event: string, handler: EventListenerOrEventListenerObject | null, options?: EventRegistryOptions): TinyEventTarget | TinyEventTarget[];
+    on(events: string | string[], handler: EventListenerOrEventListenerObject | null, options?: EventRegistryOptions): TinyEventTarget | TinyEventTarget[];
     /**
      * Registers an event listener that runs only once, then is removed.
      *
-     * @param {string} event - The event type (e.g. 'click', 'keydown').
+     * @param {string|string[]} events - The event type (e.g. 'click', 'keydown').
      * @param {EventListenerOrEventListenerObject} handler - The callback function to run on event.
      * @param {EventRegistryOptions} [options={}] - Optional event listener options.
      * @returns {TinyEventTarget|TinyEventTarget[]}
      */
-    once(event: string, handler: EventListenerOrEventListenerObject, options?: EventRegistryOptions): TinyEventTarget | TinyEventTarget[];
+    once(events: string | string[], handler: EventListenerOrEventListenerObject, options?: EventRegistryOptions): TinyEventTarget | TinyEventTarget[];
     /**
      * Removes a specific event listener from an element.
      *
-     * @param {string} event - The event type.
+     * @param {string|string[]} events - The event type.
      * @param {EventListenerOrEventListenerObject|null} handler - The function originally bound to the event.
      * @param {boolean|EventListenerOptions} [options] - Optional listener options.
      * @returns {TinyEventTarget|TinyEventTarget[]}
      */
-    off(event: string, handler: EventListenerOrEventListenerObject | null, options?: boolean | EventListenerOptions): TinyEventTarget | TinyEventTarget[];
+    off(events: string | string[], handler: EventListenerOrEventListenerObject | null, options?: boolean | EventListenerOptions): TinyEventTarget | TinyEventTarget[];
     /**
      * Removes all event listeners of a specific type from the element.
      *
-     * @param {string} event - The event type to remove (e.g. 'click').
+     * @param {string|string[]} events - The event type to remove (e.g. 'click').
      * @returns {TinyEventTarget|TinyEventTarget[]}
      */
-    offAll(event: string): TinyEventTarget | TinyEventTarget[];
+    offAll(events: string | string[]): TinyEventTarget | TinyEventTarget[];
     /**
      * Removes all event listeners of all types from the element.
      *
@@ -2790,11 +2900,11 @@ declare class TinyHtml {
     /**
      * Triggers all handlers associated with a specific event on the given element.
      *
-     * @param {string} event - Name of the event to trigger.
+     * @param {string|string[]} events - Name of the event to trigger.
      * @param {Event|CustomEvent|CustomEventInit} [payload] - Optional event object or data to pass.
      * @returns {TinyEventTarget|TinyEventTarget[]}
      */
-    trigger(event: string, payload?: Event | CustomEvent | CustomEventInit): TinyEventTarget | TinyEventTarget[];
+    trigger(events: string | string[], payload?: Event | CustomEvent | CustomEventInit): TinyEventTarget | TinyEventTarget[];
     /**
      * Get an attribute on an element.
      * @param {string} name