tiny-essentials 1.28.0 → 1.28.1

package/dist/v1/libs/TinyElementObserver.cjs

@@ -1,5 +1,9 @@
 'use strict';
 
+var utils = require('./utils.cjs');
+
+const checkDestroy = utils.createCheckDestroyed('TinyElementObserver');
+
 /**
  * Callback type used for element mutation detectors.
  *
@@ -19,6 +23,21 @@
  * @template {Element} HTMLElement
  */
 class TinyElementObserver {
+  /**
+   * 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;
+  }
+
   /** @type {HTMLElement} */
   #el;
 
@@ -27,6 +46,7 @@ class TinyElementObserver {
    * @returns {HTMLElement} The DOM element being tracked, or `undefined` if none is set.
    */
   get el() {
+    checkDestroy(this.#destroyed);
     return this.#el;
   }
 
@@ -42,6 +62,7 @@ class TinyElementObserver {
    * @returns {MutationObserverInit}
    */
   get settings() {
+    checkDestroy(this.#destroyed);
     return this.#settings;
   }
 
@@ -50,6 +71,7 @@ class TinyElementObserver {
    * @param {MutationObserverInit} settings
    */
   set settings(settings) {
+    checkDestroy(this.#destroyed);
     if (typeof settings !== 'object' || settings === null)
       throw new TypeError('settings must be a non-null object.');
     this.#settings = settings;
@@ -66,6 +88,7 @@ class TinyElementObserver {
    * @returns {MutationObserver|null}
    */
   get observer() {
+    checkDestroy(this.#destroyed);
     return this.#observer;
   }
 
@@ -84,6 +107,7 @@ class TinyElementObserver {
    * @returns {Array<[string, ElementDetectorsFn]>}
    */
   get detectors() {
+    checkDestroy(this.#destroyed);
     return this.#detectors.map((item) => [item[0], item[1]]);
   }
 
@@ -92,6 +116,7 @@ class TinyElementObserver {
    * @param {Array<[string, ElementDetectorsFn]>} detectors
    */
   set detectors(detectors) {
+    checkDestroy(this.#destroyed);
     if (!Array.isArray(detectors)) throw new TypeError('detectors must be an array.');
 
     /** @type {Array<[string, ElementDetectorsFn]>} */
@@ -110,6 +135,7 @@ class TinyElementObserver {
    * @returns {boolean}
    */
   get isActive() {
+    checkDestroy(this.#destroyed);
     return !!this.#observer;
   }
 
@@ -119,6 +145,7 @@ class TinyElementObserver {
    * @returns {number} Total count of detectors.
    */
   get size() {
+    checkDestroy(this.#destroyed);
     return this.#detectors.length;
   }
 
@@ -142,6 +169,7 @@ class TinyElementObserver {
    * until new detectors are added again.
    */
   clear() {
+    checkDestroy(this.#destroyed);
     this.#detectors = [];
   }
 
@@ -151,6 +179,7 @@ class TinyElementObserver {
    * @throws {Error} If no element has been set to observe.
    */
   start() {
+    checkDestroy(this.#destroyed);
     if (!this.#el) throw new Error('Cannot start observation: no target element has been set.');
     if (this.#observer) return;
     this.#observer = new MutationObserver((mutations) => {
@@ -166,6 +195,7 @@ class TinyElementObserver {
    * Stop tracking changes.
    */
   stop() {
+    checkDestroy(this.#destroyed);
     if (!this.#observer) return;
     this.#observer.disconnect();
     this.#observer = null;
@@ -179,6 +209,7 @@ class TinyElementObserver {
    * @param {ElementDetectorsFn} handler
    */
   add(name, handler) {
+    checkDestroy(this.#destroyed);
     this.#validateDetector(name, handler);
     this.#detectors.push([name, handler]);
   }
@@ -189,6 +220,7 @@ class TinyElementObserver {
    * @param {ElementDetectorsFn} handler
    */
   insertAtStart(name, handler) {
+    checkDestroy(this.#destroyed);
     this.#validateDetector(name, handler);
     this.#detectors.unshift([name, handler]);
   }
@@ -201,6 +233,7 @@ class TinyElementObserver {
    * @param {'before'|'after'} position - Position relative to the index
    */
   insertAt(index, name, handler, position = 'after') {
+    checkDestroy(this.#destroyed);
     this.#validateDetector(name, handler);
     if (typeof index !== 'number' || index < 0 || index >= this.#detectors.length)
       throw new RangeError('Invalid index for insertDetectorAt.');
@@ -213,6 +246,7 @@ class TinyElementObserver {
    * @param {number} index
    */
   removeAt(index) {
+    checkDestroy(this.#destroyed);
     if (typeof index !== 'number' || index < 0 || index >= this.#detectors.length)
       throw new RangeError('Invalid index for removeDetectorAt.');
     this.#detectors.splice(index, 1);
@@ -225,6 +259,7 @@ class TinyElementObserver {
    * @param {number} after - Number of items after the index to remove
    */
   removeAround(index, before = 0, after = 0) {
+    checkDestroy(this.#destroyed);
     if (typeof index !== 'number' || index < 0 || index >= this.#detectors.length)
       throw new RangeError('Invalid index for removeDetectorsAround.');
     const start = Math.max(0, index - before);
@@ -238,6 +273,7 @@ class TinyElementObserver {
    * @returns {boolean}
    */
   isIndexUsed(index) {
+    checkDestroy(this.#destroyed);
     return index >= 0 && index < this.#detectors.length;
   }
 
@@ -247,6 +283,7 @@ class TinyElementObserver {
    * @returns {boolean}
    */
   hasHandler(handler) {
+    checkDestroy(this.#destroyed);
     if (typeof handler !== 'function') throw new TypeError('Handler must be a function.');
     return this.#detectors.some(([_, fn]) => fn === handler);
   }
@@ -269,8 +306,10 @@ class TinyElementObserver {
    * leaving the instance unusable until reconfigured.
    */
   destroy() {
+    if (this.#destroyed) return;
     this.stop();
     this.clear();
+    this.#destroyed = true;
   }
 }
 

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

@@ -33,6 +33,12 @@ declare class TinyElementObserver<HTMLElement extends Element> {
         initDetectors?: [string, ElementDetectorsFn][] | undefined;
         initCfg?: MutationObserverInit | undefined;
     });
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed(): boolean;
     /**
      * Get the current element being observed.
      * @returns {HTMLElement} The DOM element being tracked, or `undefined` if none is set.

package/dist/v1/libs/TinyElementObserver.mjs

@@ -1,3 +1,5 @@
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyElementObserver');
 /**
  * Callback type used for element mutation detectors.
  *
@@ -16,6 +18,19 @@
  * @template {Element} HTMLElement
  */
 class TinyElementObserver {
+    /**
+     * 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;
+    }
     /** @type {HTMLElement} */
     #el;
     /**
@@ -23,6 +38,7 @@ class TinyElementObserver {
      * @returns {HTMLElement} The DOM element being tracked, or `undefined` if none is set.
      */
     get el() {
+        checkDestroy(this.#destroyed);
         return this.#el;
     }
     /**
@@ -36,6 +52,7 @@ class TinyElementObserver {
      * @returns {MutationObserverInit}
      */
     get settings() {
+        checkDestroy(this.#destroyed);
         return this.#settings;
     }
     /**
@@ -43,6 +60,7 @@ class TinyElementObserver {
      * @param {MutationObserverInit} settings
      */
     set settings(settings) {
+        checkDestroy(this.#destroyed);
         if (typeof settings !== 'object' || settings === null)
             throw new TypeError('settings must be a non-null object.');
         this.#settings = settings;
@@ -57,6 +75,7 @@ class TinyElementObserver {
      * @returns {MutationObserver|null}
      */
     get observer() {
+        checkDestroy(this.#destroyed);
         return this.#observer;
     }
     /**
@@ -73,6 +92,7 @@ class TinyElementObserver {
      * @returns {Array<[string, ElementDetectorsFn]>}
      */
     get detectors() {
+        checkDestroy(this.#destroyed);
         return this.#detectors.map((item) => [item[0], item[1]]);
     }
     /**
@@ -80,6 +100,7 @@ class TinyElementObserver {
      * @param {Array<[string, ElementDetectorsFn]>} detectors
      */
     set detectors(detectors) {
+        checkDestroy(this.#destroyed);
         if (!Array.isArray(detectors))
             throw new TypeError('detectors must be an array.');
         /** @type {Array<[string, ElementDetectorsFn]>} */
@@ -98,6 +119,7 @@ class TinyElementObserver {
      * @returns {boolean}
      */
     get isActive() {
+        checkDestroy(this.#destroyed);
         return !!this.#observer;
     }
     /**
@@ -106,6 +128,7 @@ class TinyElementObserver {
      * @returns {number} Total count of detectors.
      */
     get size() {
+        checkDestroy(this.#destroyed);
         return this.#detectors.length;
     }
     /**
@@ -129,6 +152,7 @@ class TinyElementObserver {
      * until new detectors are added again.
      */
     clear() {
+        checkDestroy(this.#destroyed);
         this.#detectors = [];
     }
     /**
@@ -137,6 +161,7 @@ class TinyElementObserver {
      * @throws {Error} If no element has been set to observe.
      */
     start() {
+        checkDestroy(this.#destroyed);
         if (!this.#el)
             throw new Error('Cannot start observation: no target element has been set.');
         if (this.#observer)
@@ -150,6 +175,7 @@ class TinyElementObserver {
      * Stop tracking changes.
      */
     stop() {
+        checkDestroy(this.#destroyed);
         if (!this.#observer)
             return;
         this.#observer.disconnect();
@@ -162,6 +188,7 @@ class TinyElementObserver {
      * @param {ElementDetectorsFn} handler
      */
     add(name, handler) {
+        checkDestroy(this.#destroyed);
         this.#validateDetector(name, handler);
         this.#detectors.push([name, handler]);
     }
@@ -171,6 +198,7 @@ class TinyElementObserver {
      * @param {ElementDetectorsFn} handler
      */
     insertAtStart(name, handler) {
+        checkDestroy(this.#destroyed);
         this.#validateDetector(name, handler);
         this.#detectors.unshift([name, handler]);
     }
@@ -182,6 +210,7 @@ class TinyElementObserver {
      * @param {'before'|'after'} position - Position relative to the index
      */
     insertAt(index, name, handler, position = 'after') {
+        checkDestroy(this.#destroyed);
         this.#validateDetector(name, handler);
         if (typeof index !== 'number' || index < 0 || index >= this.#detectors.length)
             throw new RangeError('Invalid index for insertDetectorAt.');
@@ -193,6 +222,7 @@ class TinyElementObserver {
      * @param {number} index
      */
     removeAt(index) {
+        checkDestroy(this.#destroyed);
         if (typeof index !== 'number' || index < 0 || index >= this.#detectors.length)
             throw new RangeError('Invalid index for removeDetectorAt.');
         this.#detectors.splice(index, 1);
@@ -204,6 +234,7 @@ class TinyElementObserver {
      * @param {number} after - Number of items after the index to remove
      */
     removeAround(index, before = 0, after = 0) {
+        checkDestroy(this.#destroyed);
         if (typeof index !== 'number' || index < 0 || index >= this.#detectors.length)
             throw new RangeError('Invalid index for removeDetectorsAround.');
         const start = Math.max(0, index - before);
@@ -216,6 +247,7 @@ class TinyElementObserver {
      * @returns {boolean}
      */
     isIndexUsed(index) {
+        checkDestroy(this.#destroyed);
         return index >= 0 && index < this.#detectors.length;
     }
     /**
@@ -224,6 +256,7 @@ class TinyElementObserver {
      * @returns {boolean}
      */
     hasHandler(handler) {
+        checkDestroy(this.#destroyed);
         if (typeof handler !== 'function')
             throw new TypeError('Handler must be a function.');
         return this.#detectors.some(([_, fn]) => fn === handler);
@@ -245,8 +278,11 @@ class TinyElementObserver {
      * leaving the instance unusable until reconfigured.
      */
     destroy() {
+        if (this.#destroyed)
+            return;
         this.stop();
         this.clear();
+        this.#destroyed = true;
     }
 }
 export default TinyElementObserver;