tiny-essentials 1.28.0 → 1.28.1

package/dist/v1/libs/TinyAfterScrollWatcher.mjs

@@ -1,3 +1,5 @@
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyAfterScrollWatcher');
 /**
  * @typedef {(() => void)} FnData - Function with no arguments and no return value
  */
@@ -16,6 +18,7 @@ class TinyAfterScrollWatcher {
     /** @type {ScrollElement} */
     #scrollTarget;
     get scrollTarget() {
+        checkDestroy(this.#destroyed);
         return this.#scrollTarget;
     }
     /** @type {null|NodeJS.Timeout} */
@@ -23,6 +26,7 @@ class TinyAfterScrollWatcher {
     /** @type {FnData[]} */
     #afterScrollQueue = [];
     get afterScrollQueueSize() {
+        checkDestroy(this.#destroyed);
         return this.#afterScrollQueue.length;
     }
     /** @type {number} */
@@ -50,6 +54,9 @@ class TinyAfterScrollWatcher {
         this.#scrollTarget.addEventListener('scroll', this._checkTimer);
         this.#inactivityTime = inactivityTime;
     }
+    /**
+     * @private
+     */
     _checkTimer = () => {
         if (this.#lastScrollTime)
             clearTimeout(this.#lastScrollTime);
@@ -63,6 +70,7 @@ class TinyAfterScrollWatcher {
      * @returns {number}
      */
     get inactivityTime() {
+        checkDestroy(this.#destroyed);
         return this.#inactivityTime;
     }
     /**
@@ -72,6 +80,7 @@ class TinyAfterScrollWatcher {
      * @throws {Error} If value is not a positive number
      */
     set inactivityTime(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'number' || value <= 0 || !Number.isFinite(value))
             throw new Error('inactivityTime must be a positive number in milliseconds.');
         this.#inactivityTime = value;
@@ -103,6 +112,7 @@ class TinyAfterScrollWatcher {
      * @throws {TypeError} If the argument is not a function.
      */
     doAfterScroll(fn) {
+        checkDestroy(this.#destroyed);
         if (typeof fn !== 'function')
             throw new TypeError('Argument must be a function.');
         this.lastScrollTime = Date.now();
@@ -116,6 +126,7 @@ class TinyAfterScrollWatcher {
      * @throws {TypeError} If the argument is not a function.
      */
     onStop(fn) {
+        checkDestroy(this.#destroyed);
         if (typeof fn !== 'function')
             throw new TypeError('Argument must be a function.');
         this.#onStopListeners.add(fn);
@@ -127,6 +138,7 @@ class TinyAfterScrollWatcher {
      * @throws {TypeError} If the argument is not a function.
      */
     offStop(fn) {
+        checkDestroy(this.#destroyed);
         if (typeof fn !== 'function')
             throw new TypeError('Argument must be a function.');
         this.#onStopListeners.delete(fn);
@@ -138,6 +150,7 @@ class TinyAfterScrollWatcher {
      * @throws {TypeError} If the argument is not a function.
      */
     onScroll(fn) {
+        checkDestroy(this.#destroyed);
         if (typeof fn !== 'function')
             throw new TypeError('Argument must be a function.');
         this.#scrollTarget.addEventListener('scroll', fn);
@@ -150,6 +163,7 @@ class TinyAfterScrollWatcher {
      * @throws {TypeError} If the argument is not a function.
      */
     offScroll(fn) {
+        checkDestroy(this.#destroyed);
         if (typeof fn !== 'function')
             throw new TypeError('Argument must be a function.');
         if (this.#externalScrollListeners.has(fn)) {
@@ -163,12 +177,12 @@ class TinyAfterScrollWatcher {
     destroy() {
         if (this.#destroyed)
             return;
-        this.#destroyed = true;
         this.#scrollTarget.removeEventListener('scroll', this._checkTimer);
         for (const fn of this.#externalScrollListeners)
             this.#scrollTarget.removeEventListener('scroll', fn);
         this.#externalScrollListeners.clear();
         this.#onStopListeners.clear();
+        this.#destroyed = true;
     }
 }
 export default TinyAfterScrollWatcher;

package/dist/v1/libs/TinyAnalogClock.cjs

@@ -1,5 +1,9 @@
 'use strict';
 
+var utils = require('./utils.cjs');
+
+const checkDestroy = utils.createCheckDestroyed('TinyAnalogClock');
+
 /**
  * Configuration object for the Analog Clock.
  * @typedef {Object} ClockConfig
@@ -36,6 +40,21 @@ class TinyAnalogClock {
   /** @type {number|null} */
   #animationFrame = null;
 
+  /**
+   * 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;
+  }
+
   /**
    * Retrieves the current date and extracts the specific hour, minute, and second components.
    * @returns {{ now: Date, s: number, m: number, h: number }}
@@ -332,6 +351,7 @@ class TinyAnalogClock {
    * @returns {HTMLElement} The clock container.
    */
   get element() {
+    checkDestroy(this.#destroyed);
     return this.#element;
   }
 
@@ -341,6 +361,7 @@ class TinyAnalogClock {
    * @throws {Error} If value is not a positive number.
    */
   set size(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'number' || value <= 0 || isNaN(value)) {
       throw new Error(`TinyAnalogClock: 'size' must be a positive number. Received: ${value}`);
     }
@@ -353,6 +374,7 @@ class TinyAnalogClock {
    * @returns {number}
    */
   get size() {
+    checkDestroy(this.#destroyed);
     return this.#config.size;
   }
 
@@ -362,6 +384,7 @@ class TinyAnalogClock {
    * @throws {Error} If value is not a string or null.
    */
   set skinUrl(url) {
+    checkDestroy(this.#destroyed);
     if (url !== null && typeof url !== 'string') {
       throw new Error(
         `TinyAnalogClock: 'skin' must be a URL string or null. Received type: ${typeof url}`,
@@ -376,6 +399,7 @@ class TinyAnalogClock {
    * @returns {string|null}
    */
   get skinUrl() {
+    checkDestroy(this.#destroyed);
     return this.#config.skinUrl;
   }
 
@@ -385,6 +409,7 @@ class TinyAnalogClock {
    * @throws {Error} If value is not a non-empty string.
    */
   set borderColor(color) {
+    checkDestroy(this.#destroyed);
     if (typeof color !== 'string' || color.trim() === '') {
       throw new Error(
         `TinyAnalogClock: 'borderColor' must be a non-empty string. Received: ${color}`,
@@ -400,6 +425,7 @@ class TinyAnalogClock {
    * @returns {string}
    */
   get borderColor() {
+    checkDestroy(this.#destroyed);
     return this.#config.borderColor;
   }
 
@@ -409,6 +435,7 @@ class TinyAnalogClock {
    * @throws {Error} If value is not a non-empty string.
    */
   set markColor(color) {
+    checkDestroy(this.#destroyed);
     if (typeof color !== 'string' || color.trim() === '') {
       throw new Error(
         `TinyAnalogClock: 'markColor' must be a non-empty string. Received: ${color}`,
@@ -424,6 +451,7 @@ class TinyAnalogClock {
    * @returns {string}
    */
   get markColor() {
+    checkDestroy(this.#destroyed);
     return this.#config.markColor;
   }
 
@@ -433,6 +461,7 @@ class TinyAnalogClock {
    * @throws {Error} If value is not a non-empty string.
    */
   set textColor(color) {
+    checkDestroy(this.#destroyed);
     if (typeof color !== 'string' || color.trim() === '') {
       throw new Error(
         `TinyAnalogClock: 'textColor' must be a non-empty string. Received: ${color}`,
@@ -448,6 +477,7 @@ class TinyAnalogClock {
    * @returns {string}
    */
   get textColor() {
+    checkDestroy(this.#destroyed);
     return this.#config.textColor;
   }
 
@@ -457,6 +487,7 @@ class TinyAnalogClock {
    * @throws {Error} If value is not a boolean.
    */
   set showNumbers(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'boolean') {
       throw new Error(
         `TinyAnalogClock: 'showNumbers' must be a boolean. Received type: ${typeof value}`,
@@ -471,6 +502,7 @@ class TinyAnalogClock {
    * @returns {boolean}
    */
   get showNumbers() {
+    checkDestroy(this.#destroyed);
     return this.#config.showNumbers;
   }
 
@@ -479,6 +511,7 @@ class TinyAnalogClock {
    * @param {string} value
    */
   set bgColor(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'string' || !value)
       throw new Error("TinyAnalogClock: 'bgColor' must be a non-empty string.");
     this.#config.bgColor = value;
@@ -490,6 +523,7 @@ class TinyAnalogClock {
    * @returns {string}
    */
   get bgColor() {
+    checkDestroy(this.#destroyed);
     return this.#config.bgColor;
   }
 
@@ -498,6 +532,7 @@ class TinyAnalogClock {
    * @param {number} value
    */
   set borderWidth(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'number' || value < 0)
       throw new Error("TinyAnalogClock: 'borderWidth' must be a non-negative number.");
     this.#config.borderWidth = value;
@@ -510,6 +545,7 @@ class TinyAnalogClock {
    * @returns {number}
    */
   get borderWidth() {
+    checkDestroy(this.#destroyed);
     return this.#config.borderWidth;
   }
 
@@ -518,6 +554,7 @@ class TinyAnalogClock {
    * @param {string} value
    */
   set hourHandColor(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'string' || !value)
       throw new Error("TinyAnalogClock: 'hourHandColor' must be a non-empty string.");
     this.#config.hourHandColor = value;
@@ -529,6 +566,7 @@ class TinyAnalogClock {
    * @returns {string}
    */
   get hourHandColor() {
+    checkDestroy(this.#destroyed);
     return this.#config.hourHandColor;
   }
 
@@ -537,6 +575,7 @@ class TinyAnalogClock {
    * @param {string} value
    */
   set minuteHandColor(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'string' || !value)
       throw new Error("TinyAnalogClock: 'minuteHandColor' must be a non-empty string.");
     this.#config.minuteHandColor = value;
@@ -548,6 +587,7 @@ class TinyAnalogClock {
    * @returns {string}
    */
   get minuteHandColor() {
+    checkDestroy(this.#destroyed);
     return this.#config.minuteHandColor;
   }
 
@@ -556,6 +596,7 @@ class TinyAnalogClock {
    * @param {string} value
    */
   set secondHandColor(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'string' || !value)
       throw new Error("TinyAnalogClock: 'secondHandColor' must be a non-empty string.");
     this.#config.secondHandColor = value;
@@ -567,6 +608,7 @@ class TinyAnalogClock {
    * @returns {string}
    */
   get secondHandColor() {
+    checkDestroy(this.#destroyed);
     return this.#config.secondHandColor;
   }
 
@@ -575,6 +617,7 @@ class TinyAnalogClock {
    * @param {boolean} value
    */
   set showSeconds(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'boolean')
       throw new Error("TinyAnalogClock: 'showSeconds' must be a boolean.");
     this.#config.showSeconds = value;
@@ -586,6 +629,7 @@ class TinyAnalogClock {
    * @returns {boolean}
    */
   get showSeconds() {
+    checkDestroy(this.#destroyed);
     return this.#config.showSeconds;
   }
 
@@ -594,6 +638,7 @@ class TinyAnalogClock {
    * @param {number} value - Positive number.
    */
   set sizeAdjust(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'number' || value <= 0)
       throw new Error("TinyAnalogClock: 'sizeAdjust' must be a positive number.");
     this.#config.sizeAdjust = value;
@@ -605,6 +650,7 @@ class TinyAnalogClock {
    * @returns {number}
    */
   get sizeAdjust() {
+    checkDestroy(this.#destroyed);
     return this.#config.sizeAdjust;
   }
 
@@ -613,6 +659,7 @@ class TinyAnalogClock {
    * @param {number} value - Non-negative number in pixels.
    */
   set padding(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'number' || value < 0)
       throw new Error("TinyAnalogClock: 'padding' must be a non-negative number.");
     this.#config.padding = value;
@@ -624,6 +671,7 @@ class TinyAnalogClock {
    * @returns {number}
    */
   get padding() {
+    checkDestroy(this.#destroyed);
     return this.#config.padding;
   }
 
@@ -632,6 +680,7 @@ class TinyAnalogClock {
    * @param {number} value - Positive number.
    */
   set angleDistance(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'number' || value <= 0)
       throw new Error("TinyAnalogClock: 'angleDistance' must be a positive number.");
     this.#config.angleDistance = value;
@@ -643,6 +692,7 @@ class TinyAnalogClock {
    * @returns {number}
    */
   get angleDistance() {
+    checkDestroy(this.#destroyed);
     return this.#config.angleDistance;
   }
 
@@ -651,6 +701,7 @@ class TinyAnalogClock {
    * @param {number} value - Positive number.
    */
   set pwH(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'number' || value <= 0)
       throw new Error("TinyAnalogClock: 'pwH' must be a positive number.");
     this.#config.pwH = value;
@@ -662,6 +713,7 @@ class TinyAnalogClock {
    * @returns {number}
    */
   get pwH() {
+    checkDestroy(this.#destroyed);
     return this.#config.pwH;
   }
 
@@ -670,6 +722,7 @@ class TinyAnalogClock {
    * @param {number} value - Positive number.
    */
   set phH(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'number' || value <= 0)
       throw new Error("TinyAnalogClock: 'phH' must be a positive number.");
     this.#config.phH = value;
@@ -681,6 +734,7 @@ class TinyAnalogClock {
    * @returns {number}
    */
   get phH() {
+    checkDestroy(this.#destroyed);
     return this.#config.phH;
   }
 
@@ -689,6 +743,7 @@ class TinyAnalogClock {
    * @param {number} value - Positive number.
    */
   set pwM(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'number' || value <= 0)
       throw new Error("TinyAnalogClock: 'pwM' must be a positive number.");
     this.#config.pwM = value;
@@ -700,6 +755,7 @@ class TinyAnalogClock {
    * @returns {number}
    */
   get pwM() {
+    checkDestroy(this.#destroyed);
     return this.#config.pwM;
   }
 
@@ -708,6 +764,7 @@ class TinyAnalogClock {
    * @param {number} value - Positive number.
    */
   set phM(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'number' || value <= 0)
       throw new Error("TinyAnalogClock: 'phM' must be a positive number.");
     this.#config.phM = value;
@@ -719,6 +776,7 @@ class TinyAnalogClock {
    * @returns {number}
    */
   get phM() {
+    checkDestroy(this.#destroyed);
     return this.#config.phM;
   }
 
@@ -727,11 +785,13 @@ class TinyAnalogClock {
    * @returns {void}
    */
   destroy() {
+    if (this.#destroyed) return;
     if (this.#animationFrame) {
       cancelAnimationFrame(this.#animationFrame);
       this.#animationFrame = null;
     }
     this.#element.remove();
+    this.#destroyed = true;
   }
 }
 

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

@@ -110,6 +110,12 @@ declare class TinyAnalogClock {
      * @param {Partial<ClockConfig>} [options] - Optional configuration overrides.
      */
     constructor(options?: Partial<ClockConfig>);
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed(): boolean;
     /**
      * Retrieves the current date and extracts the specific hour, minute, and second components.
      * @returns {{ now: Date, s: number, m: number, h: number }}