tiny-essentials 1.27.1 → 1.28.1

package/dist/v1/libs/TinyTextDiffer.cjs

@@ -1,5 +1,9 @@
 'use strict';
 
+var utils = require('./utils.cjs');
+
+const checkDestroy = utils.createCheckDestroyed('TinyTextDiffer');
+
 /**
  * Represents the result of a single text segment comparison.
  * @typedef {Object} DiffResult
@@ -18,11 +22,16 @@ class TinyTextDiffer {
   /** @type {boolean} */
   #destroyed = false;
 
+  get destroyed() {
+    return this.#destroyed;
+  }
+
   /**
    * Retrieves a shallow copy of the current history array.
    * @returns {string[]}
    */
   get history() {
+    checkDestroy(this.#destroyed);
     return [...this.#history];
   }
 
@@ -31,6 +40,7 @@ class TinyTextDiffer {
    * @param {string[]} history
    */
   set history(history) {
+    checkDestroy(this.#destroyed);
     if (!Array.isArray(history)) {
       throw new TypeError('History data must be provided as an array.');
     }
@@ -46,6 +56,7 @@ class TinyTextDiffer {
    * @returns {number}
    */
   get size() {
+    checkDestroy(this.#destroyed);
     return this.#history.length;
   }
 
@@ -57,16 +68,6 @@ class TinyTextDiffer {
     this.history = history;
   }
 
-  /**
-   * @throws {Error}
-   * @returns {void}
-   */
-  #checkDestroyed() {
-    if (this.#destroyed) {
-      throw new Error('Cannot perform operations on a destroyed TinyTextDiffer instance.');
-    }
-  }
-
   /**
    * @param {any} index
    * @throws {TypeError}
@@ -95,7 +96,7 @@ class TinyTextDiffer {
    * @returns {string}
    */
   get(index) {
-    this.#checkDestroyed();
+    checkDestroy(this.#destroyed);
     this.#checkIndex(index);
     if (typeof this.#history[index] === 'undefined') {
       throw new Error(`No text version found at index ${index}.`);
@@ -109,7 +110,7 @@ class TinyTextDiffer {
    * @returns {boolean}
    */
   has(index) {
-    this.#checkDestroyed();
+    checkDestroy(this.#destroyed);
     this.#checkIndex(index);
     return typeof this.#history[index] !== 'undefined';
   }
@@ -120,7 +121,7 @@ class TinyTextDiffer {
    * @returns {void}
    */
   add(text) {
-    this.#checkDestroyed();
+    checkDestroy(this.#destroyed);
     this.#checkText(text);
     this.#history.push(text);
   }
@@ -130,7 +131,7 @@ class TinyTextDiffer {
    * @returns {string | undefined}
    */
   remove() {
-    this.#checkDestroyed();
+    checkDestroy(this.#destroyed);
     return this.#history.pop();
   }
 
@@ -141,7 +142,7 @@ class TinyTextDiffer {
    * @returns {void}
    */
   addAt(index, text) {
-    this.#checkDestroyed();
+    checkDestroy(this.#destroyed);
     this.#checkIndex(index);
     this.#checkText(text);
     this.#history.splice(index, 0, text);
@@ -153,7 +154,7 @@ class TinyTextDiffer {
    * @returns {boolean}
    */
   removeAt(index) {
-    this.#checkDestroyed();
+    checkDestroy(this.#destroyed);
     this.#checkIndex(index);
     const oldSize = this.#history.length;
     this.#history.splice(index, 1);
@@ -166,7 +167,7 @@ class TinyTextDiffer {
    * @returns {void}
    */
   clear() {
-    this.#checkDestroyed();
+    checkDestroy(this.#destroyed);
     this.#history = [];
   }
 
@@ -177,7 +178,7 @@ class TinyTextDiffer {
    * @returns {(DiffResult[])[]} An array of DiffResult arrays for each compared pair.
    */
   compare(...indexes) {
-    this.#checkDestroyed();
+    checkDestroy(this.#destroyed);
 
     /** @type {number} */
     const totalIndexes = indexes.length;

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

@@ -28,6 +28,7 @@ declare class TinyTextDiffer {
      * @param {string[]} [history=[]]
      */
     constructor(history?: string[]);
+    get destroyed(): boolean;
     /**
      * Overwrites the current history array, ensuring all elements are valid strings.
      * @param {string[]} history

package/dist/v1/libs/TinyTextDiffer.mjs

@@ -1,3 +1,5 @@
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyTextDiffer');
 /**
  * Represents the result of a single text segment comparison.
  * @typedef {Object} DiffResult
@@ -13,11 +15,15 @@ class TinyTextDiffer {
     #history = [];
     /** @type {boolean} */
     #destroyed = false;
+    get destroyed() {
+        return this.#destroyed;
+    }
     /**
      * Retrieves a shallow copy of the current history array.
      * @returns {string[]}
      */
     get history() {
+        checkDestroy(this.#destroyed);
         return [...this.#history];
     }
     /**
@@ -25,6 +31,7 @@ class TinyTextDiffer {
      * @param {string[]} history
      */
     set history(history) {
+        checkDestroy(this.#destroyed);
         if (!Array.isArray(history)) {
             throw new TypeError('History data must be provided as an array.');
         }
@@ -39,6 +46,7 @@ class TinyTextDiffer {
      * @returns {number}
      */
     get size() {
+        checkDestroy(this.#destroyed);
         return this.#history.length;
     }
     /**
@@ -48,15 +56,6 @@ class TinyTextDiffer {
     constructor(history = []) {
         this.history = history;
     }
-    /**
-     * @throws {Error}
-     * @returns {void}
-     */
-    #checkDestroyed() {
-        if (this.#destroyed) {
-            throw new Error('Cannot perform operations on a destroyed TinyTextDiffer instance.');
-        }
-    }
     /**
      * @param {any} index
      * @throws {TypeError}
@@ -83,7 +82,7 @@ class TinyTextDiffer {
      * @returns {string}
      */
     get(index) {
-        this.#checkDestroyed();
+        checkDestroy(this.#destroyed);
         this.#checkIndex(index);
         if (typeof this.#history[index] === 'undefined') {
             throw new Error(`No text version found at index ${index}.`);
@@ -96,7 +95,7 @@ class TinyTextDiffer {
      * @returns {boolean}
      */
     has(index) {
-        this.#checkDestroyed();
+        checkDestroy(this.#destroyed);
         this.#checkIndex(index);
         return typeof this.#history[index] !== 'undefined';
     }
@@ -106,7 +105,7 @@ class TinyTextDiffer {
      * @returns {void}
      */
     add(text) {
-        this.#checkDestroyed();
+        checkDestroy(this.#destroyed);
         this.#checkText(text);
         this.#history.push(text);
     }
@@ -115,7 +114,7 @@ class TinyTextDiffer {
      * @returns {string | undefined}
      */
     remove() {
-        this.#checkDestroyed();
+        checkDestroy(this.#destroyed);
         return this.#history.pop();
     }
     /**
@@ -125,7 +124,7 @@ class TinyTextDiffer {
      * @returns {void}
      */
     addAt(index, text) {
-        this.#checkDestroyed();
+        checkDestroy(this.#destroyed);
         this.#checkIndex(index);
         this.#checkText(text);
         this.#history.splice(index, 0, text);
@@ -136,7 +135,7 @@ class TinyTextDiffer {
      * @returns {boolean}
      */
     removeAt(index) {
-        this.#checkDestroyed();
+        checkDestroy(this.#destroyed);
         this.#checkIndex(index);
         const oldSize = this.#history.length;
         this.#history.splice(index, 1);
@@ -148,7 +147,7 @@ class TinyTextDiffer {
      * @returns {void}
      */
     clear() {
-        this.#checkDestroyed();
+        checkDestroy(this.#destroyed);
         this.#history = [];
     }
     /**
@@ -158,7 +157,7 @@ class TinyTextDiffer {
      * @returns {(DiffResult[])[]} An array of DiffResult arrays for each compared pair.
      */
     compare(...indexes) {
-        this.#checkDestroyed();
+        checkDestroy(this.#destroyed);
         /** @type {number} */
         const totalIndexes = indexes.length;
         if (totalIndexes === 0 || totalIndexes % 2 !== 0) {

package/dist/v1/libs/TinyTextarea.cjs

@@ -30,6 +30,21 @@
  * @beta
  */
 class TinyTextarea {
+  /**
+   * Tracks whether the instance has been destroyed.
+   * @type {boolean}
+   */
+  #destroyed = false;
+
+  /**
+   * Gets the current destruction status of the instance.
+   *
+   * @returns {boolean} True if the instance is destroyed, false otherwise.
+   */
+  get destroyed() {
+    return this.#destroyed;
+  }
+
   #lineHeight;
   #maxRows;
   #extraHeight;
@@ -223,7 +238,11 @@ class TinyTextarea {
    * Cleans up internal listeners and disables dynamic behavior.
    */
   destroy() {
+    if (this.destroyed) return;
     this.#textarea.removeEventListener('input', this._handleInput);
+
+    // Lock the instance
+    this.#destroyed = true;
   }
 }
 

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

@@ -76,6 +76,12 @@ declare class TinyTextarea {
         onResize?: ((info: OnInputInfo) => void) | undefined;
         onInput?: ((info: OnInputInfo) => void) | undefined;
     });
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed(): boolean;
     /**
      * Returns the computed line height in pixels.
      * @returns {number}

package/dist/v1/libs/TinyTextarea.mjs

@@ -27,6 +27,19 @@
  * @beta
  */
 class TinyTextarea {
+    /**
+     * Tracks whether the instance has been destroyed.
+     * @type {boolean}
+     */
+    #destroyed = false;
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed() {
+        return this.#destroyed;
+    }
     #lineHeight;
     #maxRows;
     #extraHeight;
@@ -192,7 +205,11 @@ class TinyTextarea {
      * Cleans up internal listeners and disables dynamic behavior.
      */
     destroy() {
+        if (this.destroyed)
+            return;
         this.#textarea.removeEventListener('input', this._handleInput);
+        // Lock the instance
+        this.#destroyed = true;
     }
 }
 export default TinyTextarea;

package/dist/v1/libs/TinyTimeout.cjs

@@ -1,5 +1,9 @@
 'use strict';
 
+var utils = require('./utils.cjs');
+
+const checkDestroy = utils.createCheckDestroyed('TinyTimeout');
+
 /**
  * A utility class to manage dynamically adjusted timeouts based on how often
  * each unique ID is triggered. Also provides polling support for asynchronous conditions.
@@ -57,6 +61,7 @@ class TinyTimeout {
    * @returns {boolean}
    */
   getAllowAutoConfigChange() {
+    checkDestroy(this.#isDestroyed);
     return this.#allowAutoConfigChange;
   }
 
@@ -66,6 +71,7 @@ class TinyTimeout {
    * @returns {number}
    */
   getCooldownWatcherTime() {
+    checkDestroy(this.#isDestroyed);
     return this.#cooldownWatcherTime;
   }
 
@@ -75,6 +81,7 @@ class TinyTimeout {
    * @param {boolean} value
    */
   setAllowAutoConfigChange(value) {
+    checkDestroy(this.#isDestroyed);
     if (typeof value !== 'boolean') throw new TypeError(`Expected 'value' to be a boolean.`);
     this.#allowAutoConfigChange = value;
   }
@@ -86,6 +93,7 @@ class TinyTimeout {
    * @param {number} value
    */
   setCooldownWatcherTime(value) {
+    checkDestroy(this.#isDestroyed);
     if (this.#isDestroyed) throw new Error('TinyTimeout has been destroyed.');
     if (!Number.isFinite(value) || value <= 0)
       throw new TypeError(`Expected 'value' to be a positive number.`);
@@ -113,6 +121,7 @@ class TinyTimeout {
    * @throws {Error} Throws if the instance has been destroyed or arguments are invalid.
    */
   set(id, callback, value, limit = null) {
+    checkDestroy(this.#isDestroyed);
     if (this.#isDestroyed) throw new Error('TinyTimeout has been destroyed.');
     if (typeof id !== 'string' || id.trim() === '')
       throw new TypeError(`Expected 'id' to be a non-empty string.`);
@@ -170,6 +179,7 @@ class TinyTimeout {
    * @throws {Error} If the instance is destroyed or arguments are invalid.
    */
   waitForTrue(getValue, checkInterval = 100) {
+    checkDestroy(this.#isDestroyed);
     if (this.#isDestroyed) throw new Error('TinyTimeout has been destroyed.');
     if (typeof getValue !== 'function')
       throw new TypeError(`Expected 'getValue' to be a function.`);
@@ -184,10 +194,10 @@ class TinyTimeout {
    */
   destroy() {
     if (this.#isDestroyed) return;
-    this.#isDestroyed = true;
     if (this.#cooldownWatcher) clearInterval(this.#cooldownWatcher);
     this.#cooldownWatcher = null;
     this.#timeoutFixer.clear();
+    this.#isDestroyed = true;
   }
 }
 

package/dist/v1/libs/TinyTimeout.mjs

@@ -1,3 +1,5 @@
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyTimeout');
 /**
  * A utility class to manage dynamically adjusted timeouts based on how often
  * each unique ID is triggered. Also provides polling support for asynchronous conditions.
@@ -48,6 +50,7 @@ class TinyTimeout {
      * @returns {boolean}
      */
     getAllowAutoConfigChange() {
+        checkDestroy(this.#isDestroyed);
         return this.#allowAutoConfigChange;
     }
     /**
@@ -56,6 +59,7 @@ class TinyTimeout {
      * @returns {number}
      */
     getCooldownWatcherTime() {
+        checkDestroy(this.#isDestroyed);
         return this.#cooldownWatcherTime;
     }
     /**
@@ -64,6 +68,7 @@ class TinyTimeout {
      * @param {boolean} value
      */
     setAllowAutoConfigChange(value) {
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'boolean')
             throw new TypeError(`Expected 'value' to be a boolean.`);
         this.#allowAutoConfigChange = value;
@@ -75,6 +80,7 @@ class TinyTimeout {
      * @param {number} value
      */
     setCooldownWatcherTime(value) {
+        checkDestroy(this.#isDestroyed);
         if (this.#isDestroyed)
             throw new Error('TinyTimeout has been destroyed.');
         if (!Number.isFinite(value) || value <= 0)
@@ -102,6 +108,7 @@ class TinyTimeout {
      * @throws {Error} Throws if the instance has been destroyed or arguments are invalid.
      */
     set(id, callback, value, limit = null) {
+        checkDestroy(this.#isDestroyed);
         if (this.#isDestroyed)
             throw new Error('TinyTimeout has been destroyed.');
         if (typeof id !== 'string' || id.trim() === '')
@@ -154,6 +161,7 @@ class TinyTimeout {
      * @throws {Error} If the instance is destroyed or arguments are invalid.
      */
     waitForTrue(getValue, checkInterval = 100) {
+        checkDestroy(this.#isDestroyed);
         if (this.#isDestroyed)
             throw new Error('TinyTimeout has been destroyed.');
         if (typeof getValue !== 'function')
@@ -169,11 +177,11 @@ class TinyTimeout {
     destroy() {
         if (this.#isDestroyed)
             return;
-        this.#isDestroyed = true;
         if (this.#cooldownWatcher)
             clearInterval(this.#cooldownWatcher);
         this.#cooldownWatcher = null;
         this.#timeoutFixer.clear();
+        this.#isDestroyed = true;
     }
 }
 export default TinyTimeout;

package/dist/v1/libs/TinyToastNotify.cjs

@@ -1,5 +1,9 @@
 'use strict';
 
+var utils = require('./utils.cjs');
+
+const checkDestroy = utils.createCheckDestroyed('TinyToastNotify');
+
 /**
  * A callback function used to manually close a notification.
  * Passed as a second argument to `onClick` handlers, allowing programmatic dismissal of the toast.
@@ -50,6 +54,21 @@ class TinyToastNotify {
   /** @type {HTMLElement|null} */
   #container;
 
+  /**
+   * Tracks whether the instance has been destroyed.
+   * @type {boolean}
+   */
+  #destroyed = false;
+
+  /**
+   * Gets the current destruction status of the instance.
+   *
+   * @returns {boolean} True if the instance is destroyed, false otherwise.
+   */
+  get destroyed() {
+    return this.#destroyed;
+  }
+
   /**
    * @param {'top'|'bottom'} y - 'top' or 'bottom'
    * @param {'right'|'left'|'center'} x - 'right', 'left', or 'center'
@@ -94,6 +113,7 @@ class TinyToastNotify {
    * @throws {Error} If the container is not a valid HTMLElement.
    */
   getContainer() {
+    checkDestroy(this.#destroyed);
     if (!(this.#container instanceof HTMLElement))
       throw new Error('Container is not a valid HTMLElement.');
     return this.#container;
@@ -149,6 +169,7 @@ class TinyToastNotify {
    * @returns {'top'|'bottom'} The vertical direction of the notification container.
    */
   getY() {
+    checkDestroy(this.#destroyed);
     return this.#y;
   }
 
@@ -160,6 +181,7 @@ class TinyToastNotify {
    * @throws {Error} If the value is invalid.
    */
   setY(value) {
+    checkDestroy(this.#destroyed);
     this.#validateY(value);
     const container = this.getContainer();
     container.classList.remove(this.#y);
@@ -174,6 +196,7 @@ class TinyToastNotify {
    * @returns {'left'|'right'|'center'} The horizontal direction of the notification container.
    */
   getX() {
+    checkDestroy(this.#destroyed);
     return this.#x;
   }
 
@@ -185,6 +208,7 @@ class TinyToastNotify {
    * @throws {Error} If the value is invalid.
    */
   setX(value) {
+    checkDestroy(this.#destroyed);
     this.#validateX(value);
     const container = this.getContainer();
     container.classList.remove(this.#x);
@@ -199,6 +223,7 @@ class TinyToastNotify {
    * @returns {number} Base time (in milliseconds) that a notification stays on screen.
    */
   getBaseDuration() {
+    checkDestroy(this.#destroyed);
     return this.#baseDuration;
   }
 
@@ -209,6 +234,7 @@ class TinyToastNotify {
    * @throws {Error} If the value is not a valid non-negative finite number.
    */
   setBaseDuration(value) {
+    checkDestroy(this.#destroyed);
     this.#validateTiming(value, 'baseDuration');
     this.#baseDuration = value;
   }
@@ -219,6 +245,7 @@ class TinyToastNotify {
    * @returns {number} Extra time (in milliseconds) per character in the notification.
    */
   getExtraPerChar() {
+    checkDestroy(this.#destroyed);
     return this.#extraPerChar;
   }
 
@@ -229,6 +256,7 @@ class TinyToastNotify {
    * @throws {Error} If the value is not a valid non-negative finite number.
    */
   setExtraPerChar(value) {
+    checkDestroy(this.#destroyed);
     this.#validateTiming(value, 'extraPerChar');
     this.#extraPerChar = value;
   }
@@ -239,6 +267,7 @@ class TinyToastNotify {
    * @returns {number} Time (in milliseconds) used for fade-out transition.
    */
   getFadeOutDuration() {
+    checkDestroy(this.#destroyed);
     return this.#fadeOutDuration;
   }
 
@@ -249,6 +278,7 @@ class TinyToastNotify {
    * @throws {Error} If the value is not a valid non-negative finite number.
    */
   setFadeOutDuration(value) {
+    checkDestroy(this.#destroyed);
     this.#validateTiming(value, 'fadeOutDuration');
     this.#fadeOutDuration = value;
   }
@@ -267,6 +297,7 @@ class TinyToastNotify {
    * @param {NotifyData} data
    */
   show(data) {
+    checkDestroy(this.#destroyed);
     let message = '';
     let title = '';
     let onClick = null;
@@ -384,6 +415,7 @@ class TinyToastNotify {
    * @returns {void}
    */
   destroy() {
+    if (this.#destroyed) return;
     if (!(this.#container instanceof HTMLElement)) return;
 
     // Remove all child notifications
@@ -396,6 +428,9 @@ class TinyToastNotify {
 
     // Optional: Clean internal references (safe practice)
     this.#container = null;
+
+    // Lock the instance
+    this.#destroyed = true;
   }
 }
 

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

@@ -63,6 +63,12 @@ declare class TinyToastNotify {
      * @param {string} [selector='.notify-container'] - Base selector for container
      */
     constructor(y?: "top" | "bottom", x?: "right" | "left" | "center", baseDuration?: number, extraPerChar?: number, fadeOutDuration?: number, selector?: string);
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed(): boolean;
     /**
      * Returns the notification container element.
      * Ensures that the container is a valid HTMLElement.