tiny-essentials 1.28.0 → 1.28.2

package/dist/v1/libs/TinyToastNotify.mjs

@@ -1,3 +1,5 @@
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = 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.
@@ -11,7 +13,7 @@
  * @typedef {string | {
  *   message: string, // The main message to display
  *   title?: string,  // Optional title to appear above the message
- *   onClick?: function(MouseEvent, CloseToastFunc): void, // Optional click handler for the notification
+ *   onClick?: (event: MouseEvent, func: CloseToastFunc) => void, // Optional click handler for the notification
  *   html?: boolean,  // Whether the message should be interpreted as raw HTML
  *   avatar?: string  // Optional URL to an avatar image shown on the left
  * }} NotifyData
@@ -44,6 +46,19 @@ class TinyToastNotify {
     #fadeOutDuration;
     /** @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'
@@ -80,6 +95,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;
@@ -127,6 +143,7 @@ class TinyToastNotify {
      * @returns {'top'|'bottom'} The vertical direction of the notification container.
      */
     getY() {
+        checkDestroy(this.#destroyed);
         return this.#y;
     }
     /**
@@ -137,6 +154,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);
@@ -149,6 +167,7 @@ class TinyToastNotify {
      * @returns {'left'|'right'|'center'} The horizontal direction of the notification container.
      */
     getX() {
+        checkDestroy(this.#destroyed);
         return this.#x;
     }
     /**
@@ -159,6 +178,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);
@@ -171,6 +191,7 @@ class TinyToastNotify {
      * @returns {number} Base time (in milliseconds) that a notification stays on screen.
      */
     getBaseDuration() {
+        checkDestroy(this.#destroyed);
         return this.#baseDuration;
     }
     /**
@@ -180,6 +201,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;
     }
@@ -189,6 +211,7 @@ class TinyToastNotify {
      * @returns {number} Extra time (in milliseconds) per character in the notification.
      */
     getExtraPerChar() {
+        checkDestroy(this.#destroyed);
         return this.#extraPerChar;
     }
     /**
@@ -198,6 +221,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;
     }
@@ -207,6 +231,7 @@ class TinyToastNotify {
      * @returns {number} Time (in milliseconds) used for fade-out transition.
      */
     getFadeOutDuration() {
+        checkDestroy(this.#destroyed);
         return this.#fadeOutDuration;
     }
     /**
@@ -216,6 +241,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;
     }
@@ -233,6 +259,7 @@ class TinyToastNotify {
      * @param {NotifyData} data
      */
     show(data) {
+        checkDestroy(this.#destroyed);
         let message = '';
         let title = '';
         let onClick = null;
@@ -337,6 +364,8 @@ class TinyToastNotify {
      * @returns {void}
      */
     destroy() {
+        if (this.#destroyed)
+            return;
         if (!(this.#container instanceof HTMLElement))
             return;
         // Remove all child notifications
@@ -347,6 +376,8 @@ class TinyToastNotify {
         }
         // Optional: Clean internal references (safe practice)
         this.#container = null;
+        // Lock the instance
+        this.#destroyed = true;
     }
 }
 export default TinyToastNotify;

package/dist/v1/libs/TinyUploadClicker.cjs

@@ -64,6 +64,21 @@ require('./TinyColorValidator.cjs');
  * uploader.destroy();
  */
 class TinyUploadClicker {
+  /**
+   * 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 {UploaderConfig} */
   #config;
 
@@ -212,6 +227,7 @@ class TinyUploadClicker {
    * Cleans up all internal elements and event listeners, removing created inputs and breaking references.
    */
   destroy() {
+    if (this.destroyed) return;
     for (const trigger of this.#triggerElements) {
       if (!(trigger instanceof HTMLElement)) return;
       trigger.removeEventListener('click', this.#boundClick);
@@ -223,6 +239,9 @@ class TinyUploadClicker {
     }
 
     this.#triggerElements = [];
+
+    // Lock the instance
+    this.#destroyed = true;
   }
 }
 

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

@@ -1,4 +1,27 @@
-export default TinyUploadClicker;
+/**
+ * @typedef {Object} UploaderConfig
+ *
+ * @property {string | HTMLElement | Array<string | HTMLElement>} triggers -
+ *    Single or multiple elements (or selectors) that will act as upload triggers.
+ *
+ * @property {boolean} [multiple=false] -
+ *    Whether to allow selection of multiple files.
+ *
+ * @property {string|string[]} [accept=""] -
+ *    A comma-separated list of accepted file types (e.g., ".png,.jpg" or "image/*").
+ *
+ * @property {Record<string, string>} [inputAttributes={}] -
+ *    Additional attributes to apply to the created `<input type="file">`.
+ *
+ * @property {Partial<CSSStyleDeclaration>} [inputStyles={ display: 'none' }] -
+ *    Inline CSS styles to apply to the hidden input. Default hides the element.
+ *
+ * @property {((triggerElement: HTMLElement) => void)|null} [onClick=null] -
+ *    Callback executed when a trigger is clicked (before the file dialog opens).
+ *
+ * @property {((files: FileList, triggerElement: HTMLElement) => void)|null} [onFileLoad=null] -
+ *    Callback executed when files are selected through the file input.
+ */
 export type UploaderConfig = {
     /**
      * -
@@ -9,32 +32,32 @@ export type UploaderConfig = {
      * -
      * Whether to allow selection of multiple files.
      */
-    multiple?: boolean | undefined;
+    multiple?: boolean;
     /**
      * -
      * A comma-separated list of accepted file types (e.g., ".png,.jpg" or "image/*").
      */
-    accept?: string | string[] | undefined;
+    accept?: string | string[];
     /**
      * -
      * Additional attributes to apply to the created `<input type="file">`.
      */
-    inputAttributes?: Record<string, string> | undefined;
+    inputAttributes?: Record<string, string>;
     /**
      * -
      * Inline CSS styles to apply to the hidden input. Default hides the element.
      */
-    inputStyles?: Partial<CSSStyleDeclaration> | undefined;
+    inputStyles?: Partial<CSSStyleDeclaration>;
     /**
      * -
      * Callback executed when a trigger is clicked (before the file dialog opens).
      */
-    onClick?: ((triggerElement: HTMLElement) => void) | null | undefined;
+    onClick?: ((triggerElement: HTMLElement) => void) | null;
     /**
      * -
      * Callback executed when files are selected through the file input.
      */
-    onFileLoad?: ((files: FileList, triggerElement: HTMLElement) => void) | null | undefined;
+    onFileLoad?: ((files: FileList, triggerElement: HTMLElement) => void) | null;
 };
 /**
  * TinyUploadClicker is a lightweight utility class for attaching custom clickable elements
@@ -64,6 +87,13 @@ export type UploaderConfig = {
  * uploader.destroy();
  */
 declare class TinyUploadClicker {
+    #private;
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed(): boolean;
     /**
      * Creates a new instance of TinyUploadClicker.
      *
@@ -75,6 +105,6 @@ declare class TinyUploadClicker {
      * Cleans up all internal elements and event listeners, removing created inputs and breaking references.
      */
     destroy(): void;
-    #private;
 }
+export default TinyUploadClicker;
 //# sourceMappingURL=TinyUploadClicker.d.mts.map

package/dist/v1/libs/TinyUploadClicker.mjs

@@ -51,6 +51,19 @@ import { isJsonObject } from '../index.mjs';
  * uploader.destroy();
  */
 class TinyUploadClicker {
+    /**
+     * 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 {UploaderConfig} */
     #config;
     /** @type {Array<HTMLElement|Element|null>} */
@@ -167,6 +180,8 @@ class TinyUploadClicker {
      * Cleans up all internal elements and event listeners, removing created inputs and breaking references.
      */
     destroy() {
+        if (this.destroyed)
+            return;
         for (const trigger of this.#triggerElements) {
             if (!(trigger instanceof HTMLElement))
                 return;
@@ -177,6 +192,8 @@ class TinyUploadClicker {
             this.#inputs.delete(trigger);
         }
         this.#triggerElements = [];
+        // Lock the instance
+        this.#destroyed = true;
     }
 }
 export default TinyUploadClicker;