tiny-essentials 1.28.0 → 1.28.1

package/dist/v1/libs/TinyAnalogClock.mjs

@@ -1,3 +1,5 @@
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyAnalogClock');
 /**
  * Configuration object for the Analog Clock.
  * @typedef {Object} ClockConfig
@@ -32,6 +34,19 @@ class TinyAnalogClock {
     #config;
     /** @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 }}
@@ -297,6 +312,7 @@ class TinyAnalogClock {
      * @returns {HTMLElement} The clock container.
      */
     get element() {
+        checkDestroy(this.#destroyed);
         return this.#element;
     }
     /**
@@ -305,6 +321,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}`);
         }
@@ -316,6 +333,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get size() {
+        checkDestroy(this.#destroyed);
         return this.#config.size;
     }
     /**
@@ -324,6 +342,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}`);
         }
@@ -335,6 +354,7 @@ class TinyAnalogClock {
      * @returns {string|null}
      */
     get skinUrl() {
+        checkDestroy(this.#destroyed);
         return this.#config.skinUrl;
     }
     /**
@@ -343,6 +363,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}`);
         }
@@ -355,6 +376,7 @@ class TinyAnalogClock {
      * @returns {string}
      */
     get borderColor() {
+        checkDestroy(this.#destroyed);
         return this.#config.borderColor;
     }
     /**
@@ -363,6 +385,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}`);
         }
@@ -375,6 +398,7 @@ class TinyAnalogClock {
      * @returns {string}
      */
     get markColor() {
+        checkDestroy(this.#destroyed);
         return this.#config.markColor;
     }
     /**
@@ -383,6 +407,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}`);
         }
@@ -395,6 +420,7 @@ class TinyAnalogClock {
      * @returns {string}
      */
     get textColor() {
+        checkDestroy(this.#destroyed);
         return this.#config.textColor;
     }
     /**
@@ -403,6 +429,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}`);
         }
@@ -414,6 +441,7 @@ class TinyAnalogClock {
      * @returns {boolean}
      */
     get showNumbers() {
+        checkDestroy(this.#destroyed);
         return this.#config.showNumbers;
     }
     /**
@@ -421,6 +449,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;
@@ -431,6 +460,7 @@ class TinyAnalogClock {
      * @returns {string}
      */
     get bgColor() {
+        checkDestroy(this.#destroyed);
         return this.#config.bgColor;
     }
     /**
@@ -438,6 +468,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;
@@ -449,6 +480,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get borderWidth() {
+        checkDestroy(this.#destroyed);
         return this.#config.borderWidth;
     }
     /**
@@ -456,6 +488,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;
@@ -466,6 +499,7 @@ class TinyAnalogClock {
      * @returns {string}
      */
     get hourHandColor() {
+        checkDestroy(this.#destroyed);
         return this.#config.hourHandColor;
     }
     /**
@@ -473,6 +507,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;
@@ -483,6 +518,7 @@ class TinyAnalogClock {
      * @returns {string}
      */
     get minuteHandColor() {
+        checkDestroy(this.#destroyed);
         return this.#config.minuteHandColor;
     }
     /**
@@ -490,6 +526,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;
@@ -500,6 +537,7 @@ class TinyAnalogClock {
      * @returns {string}
      */
     get secondHandColor() {
+        checkDestroy(this.#destroyed);
         return this.#config.secondHandColor;
     }
     /**
@@ -507,6 +545,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;
@@ -517,6 +556,7 @@ class TinyAnalogClock {
      * @returns {boolean}
      */
     get showSeconds() {
+        checkDestroy(this.#destroyed);
         return this.#config.showSeconds;
     }
     /**
@@ -524,6 +564,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;
@@ -534,6 +575,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get sizeAdjust() {
+        checkDestroy(this.#destroyed);
         return this.#config.sizeAdjust;
     }
     /**
@@ -541,6 +583,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;
@@ -551,6 +594,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get padding() {
+        checkDestroy(this.#destroyed);
         return this.#config.padding;
     }
     /**
@@ -558,6 +602,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;
@@ -568,6 +613,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get angleDistance() {
+        checkDestroy(this.#destroyed);
         return this.#config.angleDistance;
     }
     /**
@@ -575,6 +621,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;
@@ -585,6 +632,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get pwH() {
+        checkDestroy(this.#destroyed);
         return this.#config.pwH;
     }
     /**
@@ -592,6 +640,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;
@@ -602,6 +651,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get phH() {
+        checkDestroy(this.#destroyed);
         return this.#config.phH;
     }
     /**
@@ -609,6 +659,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;
@@ -619,6 +670,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get pwM() {
+        checkDestroy(this.#destroyed);
         return this.#config.pwM;
     }
     /**
@@ -626,6 +678,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;
@@ -636,6 +689,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get phM() {
+        checkDestroy(this.#destroyed);
         return this.#config.phM;
     }
     /**
@@ -643,11 +697,14 @@ class TinyAnalogClock {
      * @returns {void}
      */
     destroy() {
+        if (this.#destroyed)
+            return;
         if (this.#animationFrame) {
             cancelAnimationFrame(this.#animationFrame);
             this.#animationFrame = null;
         }
         this.#element.remove();
+        this.#destroyed = true;
     }
 }
 export default TinyAnalogClock;

package/dist/v1/libs/TinyClipboard.cjs

@@ -165,6 +165,7 @@ class TinyClipboard {
    * @param {string|null} [mimeFormat=null] - MIME type or prefix.
    * @param {boolean} [fixValue=false] - If true, exact match on MIME type.
    * @returns {Promise<Blob|string|Array<Blob|string>|null>} A promise resolving with matching data.
+   * @private
    */
   _readData(index = 0, type = null, mimeFormat = null, fixValue = false) {
     return new Promise((resolve, reject) => {
@@ -326,6 +327,7 @@ class TinyClipboard {
    *
    * @param {number|null} index - Index of the item to retrieve or null to get all.
    * @returns {Promise<ClipboardItem|ClipboardItems|null>} A promise resolving with a clipboard item or array of items.
+   * @private
    */
   _read(index) {
     return new Promise((resolve, reject) => {

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

@@ -62,8 +62,9 @@ declare class TinyClipboard {
      * @param {string|null} [mimeFormat=null] - MIME type or prefix.
      * @param {boolean} [fixValue=false] - If true, exact match on MIME type.
      * @returns {Promise<Blob|string|Array<Blob|string>|null>} A promise resolving with matching data.
+     * @private
      */
-    _readData(index?: number | null, type?: "text" | "custom" | null, mimeFormat?: string | null, fixValue?: boolean): Promise<Blob | string | Array<Blob | string> | null>;
+    private _readData;
     /**
      * Read plain text from the clipboard (single item by index).
      *
@@ -107,8 +108,9 @@ declare class TinyClipboard {
      *
      * @param {number|null} index - Index of the item to retrieve or null to get all.
      * @returns {Promise<ClipboardItem|ClipboardItems|null>} A promise resolving with a clipboard item or array of items.
+     * @private
      */
-    _read(index: number | null): Promise<ClipboardItem | ClipboardItems | null>;
+    private _read;
     /**
      * Read clipboard data at a specific index.
      *

package/dist/v1/libs/TinyClipboard.mjs

@@ -152,6 +152,7 @@ class TinyClipboard {
      * @param {string|null} [mimeFormat=null] - MIME type or prefix.
      * @param {boolean} [fixValue=false] - If true, exact match on MIME type.
      * @returns {Promise<Blob|string|Array<Blob|string>|null>} A promise resolving with matching data.
+     * @private
      */
     _readData(index = 0, type = null, mimeFormat = null, fixValue = false) {
         return new Promise((resolve, reject) => {
@@ -307,6 +308,7 @@ class TinyClipboard {
      *
      * @param {number|null} index - Index of the item to retrieve or null to get all.
      * @returns {Promise<ClipboardItem|ClipboardItems|null>} A promise resolving with a clipboard item or array of items.
+     * @private
      */
     _read(index) {
         return new Promise((resolve, reject) => {

package/dist/v1/libs/TinyColorConverter.cjs

@@ -94,6 +94,7 @@ class TinyColorConverter {
    * @param {'rgb'|'hex'|'hsl'} [type='rgb'] - The format of the colors returned: `'rgb'`, `'hex'`, or `'hsl'`.
    * @param {boolean} [pastel=false] - If true, generates pastel tones by adjusting the intensity and offset.
    * @returns {Array<RgbResult|HexResult|HslResult>} An array of color values in the selected format:
+   * @private
    */
   static _rca(len, type, pastel) {
     let eq1 = 127;

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

@@ -164,8 +164,9 @@ declare class TinyColorConverter {
      * @param {'rgb'|'hex'|'hsl'} [type='rgb'] - The format of the colors returned: `'rgb'`, `'hex'`, or `'hsl'`.
      * @param {boolean} [pastel=false] - If true, generates pastel tones by adjusting the intensity and offset.
      * @returns {Array<RgbResult|HexResult|HslResult>} An array of color values in the selected format:
+     * @private
      */
-    static _rca(len?: number, type?: "rgb" | "hex" | "hsl", pastel?: boolean): Array<RgbResult | HexResult | HslResult>;
+    private static _rca;
     /**
      * Generates a smooth gradient of colors based on sine wave patterns.
      *

package/dist/v1/libs/TinyColorConverter.mjs

@@ -82,6 +82,7 @@ class TinyColorConverter {
      * @param {'rgb'|'hex'|'hsl'} [type='rgb'] - The format of the colors returned: `'rgb'`, `'hex'`, or `'hsl'`.
      * @param {boolean} [pastel=false] - If true, generates pastel tones by adjusting the intensity and offset.
      * @returns {Array<RgbResult|HexResult|HslResult>} An array of color values in the selected format:
+     * @private
      */
     static _rca(len, type, pastel) {
         let eq1 = 127;