tiny-essentials 1.21.8 → 1.21.9

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

@@ -328,7 +328,7 @@ declare class TinyInventory {
      * Keys are item IDs, values are configuration objects created with {@link TinyInventory.defineItem}.
      * @type {Map<string, ItemDef>}
      */
-    static "__#26@#ItemRegistry": Map<string, ItemDef>;
+    static "__#27@#ItemRegistry": Map<string, ItemDef>;
     /**
      * Returns a deep-cloned snapshot of all registered items.
      * Ensures the caller cannot mutate the internal registry.

package/dist/v1/libs/TinyTextRangeEditor.cjs

@@ -54,7 +54,7 @@ class TinyTextRangeEditor {
 
   /**
    * Ensures the element has focus.
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   ensureFocus() {
     if (document.activeElement !== this.#el) this.#el.focus();
@@ -63,7 +63,7 @@ class TinyTextRangeEditor {
 
   /**
    * Focus the element.
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   focus() {
     this.#el.focus();
@@ -83,7 +83,7 @@ class TinyTextRangeEditor {
    * @param {number} start - Start index.
    * @param {number} end - End index.
    * @param {boolean} [preserveScroll=true] - Whether to preserve scroll position.
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   setSelectionRange(start, end, preserveScroll = true) {
     if (typeof start !== 'number' || typeof end !== 'number')
@@ -108,7 +108,7 @@ class TinyTextRangeEditor {
   /**
    * Sets the full value of the element.
    * @param {string} value - The new value to assign.
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   setValue(value) {
     if (typeof value !== 'string') throw new TypeError('Value must be a string.');
@@ -130,7 +130,7 @@ class TinyTextRangeEditor {
    * @param {boolean} [settings.autoSpacing=false]
    * @param {boolean} [settings.autoSpaceLeft=false]
    * @param {boolean} [settings.autoSpaceRight=false]
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   insertText(
     text,
@@ -173,7 +173,7 @@ class TinyTextRangeEditor {
 
   /**
    * Deletes the currently selected text.
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   deleteSelection() {
     this.insertText('');
@@ -183,7 +183,7 @@ class TinyTextRangeEditor {
   /**
    * Replaces the selection using a transformation function.
    * @param {(selected: string) => string} transformer - Function that modifies the selected text.
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   transformSelection(transformer) {
     if (typeof transformer !== 'function') throw new TypeError('transformer must be a function.');
@@ -199,7 +199,7 @@ class TinyTextRangeEditor {
    * Surrounds current selection with prefix and suffix.
    * @param {string} prefix - Text to insert before.
    * @param {string} suffix - Text to insert after.
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   surroundSelection(prefix, suffix) {
     if (typeof prefix !== 'string' || typeof suffix !== 'string')
@@ -212,7 +212,7 @@ class TinyTextRangeEditor {
   /**
    * Moves the caret by a given offset.
    * @param {number} offset - Characters to move.
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   moveCaret(offset) {
     if (typeof offset !== 'number') throw new TypeError('offset must be a number.');
@@ -224,7 +224,7 @@ class TinyTextRangeEditor {
 
   /**
    * Selects all content in the field.
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   selectAll() {
     this.setSelectionRange(0, this.#el.value.length);
@@ -235,7 +235,7 @@ class TinyTextRangeEditor {
    * Expands the current selection by character amounts.
    * @param {number} before - Characters to expand to the left.
    * @param {number} after - Characters to expand to the right.
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   expandSelection(before, after) {
     if (typeof before !== 'number' || typeof after !== 'number')
@@ -251,7 +251,7 @@ class TinyTextRangeEditor {
    * Replaces all regex matches in the content.
    * @param {RegExp} regex - Regex to match.
    * @param {(match: string) => string} replacer - Replacement function.
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   replaceAll(regex, replacer) {
     if (!(regex instanceof RegExp)) throw new TypeError('regex must be a RegExp.');
@@ -266,7 +266,7 @@ class TinyTextRangeEditor {
    *
    * @param {RegExp} regex - Regular expression to match inside selection.
    * @param {(match: string) => string} replacer - Function to replace each match.
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   replaceInSelection(regex, replacer) {
     if (!(regex instanceof RegExp)) throw new TypeError('regex must be a RegExp.');
@@ -289,7 +289,7 @@ class TinyTextRangeEditor {
    * Toggles a code around the current selection.
    * If it's already wrapped, unwraps it.
    * @param {string} codeName - The code to toggle.
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   toggleCode(codeName) {
     if (typeof codeName !== 'string') throw new TypeError('codeName must be a string.');
@@ -367,7 +367,7 @@ class TinyTextRangeEditor {
    *   - If an object: key-value pairs (e.g., `{ color: "red" }` → `color="red"`).
    *   - If an array: boolean attributes (e.g., `["disabled", "readonly"]`).
    *
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   wrapWithTag(tagName, attributes = {}) {
     if (typeof tagName !== 'string') throw new TypeError('tagName must be a string.');
@@ -385,7 +385,7 @@ class TinyTextRangeEditor {
    * @param {string} tagName - The tag to insert.
    * @param {string} [content=''] - Optional content between tags.
    * @param {Record<string,string> | string[]} [attributes={}] - Optional attributes or list of empty attributes.
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   insertTag(tagName, content = '', attributes = {}) {
     if (typeof tagName !== 'string') throw new TypeError('tagName must be a string.');
@@ -405,7 +405,7 @@ class TinyTextRangeEditor {
    * Inserts a self-closing tag.
    * @param {string} tagName - The tag name.
    * @param {Record<string,string> | string[]} [attributes={}] - Optional attributes or list of empty attributes.
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   insertSelfClosingTag(tagName, attributes = {}) {
     if (typeof tagName !== 'string') throw new TypeError('tagName must be a string.');
@@ -424,7 +424,7 @@ class TinyTextRangeEditor {
    * Supports tags with attributes. If already wrapped, it unwraps.
    * @param {string} tagName - The tag to toggle.
    * @param {Record<string,string> | string[]} [attributes={}] - Optional attributes to apply when wrapping.
-   * @returns {TinyTextRangeEditor}
+   * @returns {this}
    */
   toggleTag(tagName, attributes = {}) {
     if (typeof tagName !== 'string') throw new TypeError('tagName must be a string.');

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

@@ -24,14 +24,14 @@ declare class TinyTextRangeEditor {
     setCloseTag(tag: string): void;
     /**
      * Ensures the element has focus.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    ensureFocus(): TinyTextRangeEditor;
+    ensureFocus(): this;
     /**
      * Focus the element.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    focus(): TinyTextRangeEditor;
+    focus(): this;
     /** @returns {{ start: number, end: number }} The current selection range. */
     getSelectionRange(): {
         start: number;
@@ -42,17 +42,17 @@ declare class TinyTextRangeEditor {
      * @param {number} start - Start index.
      * @param {number} end - End index.
      * @param {boolean} [preserveScroll=true] - Whether to preserve scroll position.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    setSelectionRange(start: number, end: number, preserveScroll?: boolean): TinyTextRangeEditor;
+    setSelectionRange(start: number, end: number, preserveScroll?: boolean): this;
     /** @returns {string} The full current text value. */
     getValue(): string;
     /**
      * Sets the full value of the element.
      * @param {string} value - The new value to assign.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    setValue(value: string): TinyTextRangeEditor;
+    setValue(value: string): this;
     /** @returns {string} The currently selected text. */
     getSelectedText(): string;
     /**
@@ -63,72 +63,72 @@ declare class TinyTextRangeEditor {
      * @param {boolean} [settings.autoSpacing=false]
      * @param {boolean} [settings.autoSpaceLeft=false]
      * @param {boolean} [settings.autoSpaceRight=false]
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     insertText(text: string, { newCursor, autoSpacing, autoSpaceLeft, autoSpaceRight, }?: {
         newCursor?: "end" | "start" | "preserve" | undefined;
         autoSpacing?: boolean | undefined;
         autoSpaceLeft?: boolean | undefined;
         autoSpaceRight?: boolean | undefined;
-    }): TinyTextRangeEditor;
+    }): this;
     /**
      * Deletes the currently selected text.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    deleteSelection(): TinyTextRangeEditor;
+    deleteSelection(): this;
     /**
      * Replaces the selection using a transformation function.
      * @param {(selected: string) => string} transformer - Function that modifies the selected text.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    transformSelection(transformer: (selected: string) => string): TinyTextRangeEditor;
+    transformSelection(transformer: (selected: string) => string): this;
     /**
      * Surrounds current selection with prefix and suffix.
      * @param {string} prefix - Text to insert before.
      * @param {string} suffix - Text to insert after.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    surroundSelection(prefix: string, suffix: string): TinyTextRangeEditor;
+    surroundSelection(prefix: string, suffix: string): this;
     /**
      * Moves the caret by a given offset.
      * @param {number} offset - Characters to move.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    moveCaret(offset: number): TinyTextRangeEditor;
+    moveCaret(offset: number): this;
     /**
      * Selects all content in the field.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    selectAll(): TinyTextRangeEditor;
+    selectAll(): this;
     /**
      * Expands the current selection by character amounts.
      * @param {number} before - Characters to expand to the left.
      * @param {number} after - Characters to expand to the right.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    expandSelection(before: number, after: number): TinyTextRangeEditor;
+    expandSelection(before: number, after: number): this;
     /**
      * Replaces all regex matches in the content.
      * @param {RegExp} regex - Regex to match.
      * @param {(match: string) => string} replacer - Replacement function.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    replaceAll(regex: RegExp, replacer: (match: string) => string): TinyTextRangeEditor;
+    replaceAll(regex: RegExp, replacer: (match: string) => string): this;
     /**
      * Replaces all regex matches within the currently selected text.
      *
      * @param {RegExp} regex - Regular expression to match inside selection.
      * @param {(match: string) => string} replacer - Function to replace each match.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    replaceInSelection(regex: RegExp, replacer: (match: string) => string): TinyTextRangeEditor;
+    replaceInSelection(regex: RegExp, replacer: (match: string) => string): this;
     /**
      * Toggles a code around the current selection.
      * If it's already wrapped, unwraps it.
      * @param {string} codeName - The code to toggle.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    toggleCode(codeName: string): TinyTextRangeEditor;
+    toggleCode(codeName: string): this;
     /**
      * Converts a list of attributes into a string suitable for tag insertion.
      *
@@ -169,32 +169,32 @@ declare class TinyTextRangeEditor {
      *   - If an object: key-value pairs (e.g., `{ color: "red" }` → `color="red"`).
      *   - If an array: boolean attributes (e.g., `["disabled", "readonly"]`).
      *
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    wrapWithTag(tagName: string, attributes?: Record<string, string> | string[]): TinyTextRangeEditor;
+    wrapWithTag(tagName: string, attributes?: Record<string, string> | string[]): this;
     /**
      * Inserts a tag with optional inner content.
      * @param {string} tagName - The tag to insert.
      * @param {string} [content=''] - Optional content between tags.
      * @param {Record<string,string> | string[]} [attributes={}] - Optional attributes or list of empty attributes.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    insertTag(tagName: string, content?: string, attributes?: Record<string, string> | string[]): TinyTextRangeEditor;
+    insertTag(tagName: string, content?: string, attributes?: Record<string, string> | string[]): this;
     /**
      * Inserts a self-closing tag.
      * @param {string} tagName - The tag name.
      * @param {Record<string,string> | string[]} [attributes={}] - Optional attributes or list of empty attributes.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    insertSelfClosingTag(tagName: string, attributes?: Record<string, string> | string[]): TinyTextRangeEditor;
+    insertSelfClosingTag(tagName: string, attributes?: Record<string, string> | string[]): this;
     /**
      * Toggles a tag around the current selection.
      * Supports tags with attributes. If already wrapped, it unwraps.
      * @param {string} tagName - The tag to toggle.
      * @param {Record<string,string> | string[]} [attributes={}] - Optional attributes to apply when wrapping.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
-    toggleTag(tagName: string, attributes?: Record<string, string> | string[]): TinyTextRangeEditor;
+    toggleTag(tagName: string, attributes?: Record<string, string> | string[]): this;
     #private;
 }
 //# sourceMappingURL=TinyTextRangeEditor.d.mts.map

package/dist/v1/libs/TinyTextRangeEditor.mjs

@@ -48,7 +48,7 @@ class TinyTextRangeEditor {
     }
     /**
      * Ensures the element has focus.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     ensureFocus() {
         if (document.activeElement !== this.#el)
@@ -57,7 +57,7 @@ class TinyTextRangeEditor {
     }
     /**
      * Focus the element.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     focus() {
         this.#el.focus();
@@ -75,7 +75,7 @@ class TinyTextRangeEditor {
      * @param {number} start - Start index.
      * @param {number} end - End index.
      * @param {boolean} [preserveScroll=true] - Whether to preserve scroll position.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     setSelectionRange(start, end, preserveScroll = true) {
         if (typeof start !== 'number' || typeof end !== 'number')
@@ -98,7 +98,7 @@ class TinyTextRangeEditor {
     /**
      * Sets the full value of the element.
      * @param {string} value - The new value to assign.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     setValue(value) {
         if (typeof value !== 'string')
@@ -119,7 +119,7 @@ class TinyTextRangeEditor {
      * @param {boolean} [settings.autoSpacing=false]
      * @param {boolean} [settings.autoSpaceLeft=false]
      * @param {boolean} [settings.autoSpaceRight=false]
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     insertText(text, { newCursor = 'end', autoSpacing = false, autoSpaceLeft = autoSpacing, autoSpaceRight = autoSpacing, } = {}) {
         if (typeof text !== 'string')
@@ -151,7 +151,7 @@ class TinyTextRangeEditor {
     }
     /**
      * Deletes the currently selected text.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     deleteSelection() {
         this.insertText('');
@@ -160,7 +160,7 @@ class TinyTextRangeEditor {
     /**
      * Replaces the selection using a transformation function.
      * @param {(selected: string) => string} transformer - Function that modifies the selected text.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     transformSelection(transformer) {
         if (typeof transformer !== 'function')
@@ -176,7 +176,7 @@ class TinyTextRangeEditor {
      * Surrounds current selection with prefix and suffix.
      * @param {string} prefix - Text to insert before.
      * @param {string} suffix - Text to insert after.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     surroundSelection(prefix, suffix) {
         if (typeof prefix !== 'string' || typeof suffix !== 'string')
@@ -188,7 +188,7 @@ class TinyTextRangeEditor {
     /**
      * Moves the caret by a given offset.
      * @param {number} offset - Characters to move.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     moveCaret(offset) {
         if (typeof offset !== 'number')
@@ -200,7 +200,7 @@ class TinyTextRangeEditor {
     }
     /**
      * Selects all content in the field.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     selectAll() {
         this.setSelectionRange(0, this.#el.value.length);
@@ -210,7 +210,7 @@ class TinyTextRangeEditor {
      * Expands the current selection by character amounts.
      * @param {number} before - Characters to expand to the left.
      * @param {number} after - Characters to expand to the right.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     expandSelection(before, after) {
         if (typeof before !== 'number' || typeof after !== 'number')
@@ -225,7 +225,7 @@ class TinyTextRangeEditor {
      * Replaces all regex matches in the content.
      * @param {RegExp} regex - Regex to match.
      * @param {(match: string) => string} replacer - Replacement function.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     replaceAll(regex, replacer) {
         if (!(regex instanceof RegExp))
@@ -241,7 +241,7 @@ class TinyTextRangeEditor {
      *
      * @param {RegExp} regex - Regular expression to match inside selection.
      * @param {(match: string) => string} replacer - Function to replace each match.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     replaceInSelection(regex, replacer) {
         if (!(regex instanceof RegExp))
@@ -261,7 +261,7 @@ class TinyTextRangeEditor {
      * Toggles a code around the current selection.
      * If it's already wrapped, unwraps it.
      * @param {string} codeName - The code to toggle.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     toggleCode(codeName) {
         if (typeof codeName !== 'string')
@@ -339,7 +339,7 @@ class TinyTextRangeEditor {
      *   - If an object: key-value pairs (e.g., `{ color: "red" }` → `color="red"`).
      *   - If an array: boolean attributes (e.g., `["disabled", "readonly"]`).
      *
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     wrapWithTag(tagName, attributes = {}) {
         if (typeof tagName !== 'string')
@@ -357,7 +357,7 @@ class TinyTextRangeEditor {
      * @param {string} tagName - The tag to insert.
      * @param {string} [content=''] - Optional content between tags.
      * @param {Record<string,string> | string[]} [attributes={}] - Optional attributes or list of empty attributes.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     insertTag(tagName, content = '', attributes = {}) {
         if (typeof tagName !== 'string')
@@ -376,7 +376,7 @@ class TinyTextRangeEditor {
      * Inserts a self-closing tag.
      * @param {string} tagName - The tag name.
      * @param {Record<string,string> | string[]} [attributes={}] - Optional attributes or list of empty attributes.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     insertSelfClosingTag(tagName, attributes = {}) {
         if (typeof tagName !== 'string')
@@ -393,7 +393,7 @@ class TinyTextRangeEditor {
      * Supports tags with attributes. If already wrapped, it unwraps.
      * @param {string} tagName - The tag to toggle.
      * @param {Record<string,string> | string[]} [attributes={}] - Optional attributes to apply when wrapping.
-     * @returns {TinyTextRangeEditor}
+     * @returns {this}
      */
     toggleTag(tagName, attributes = {}) {
         if (typeof tagName !== 'string')