tiny-essentials 1.28.0 → 1.28.2

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

@@ -1,21 +1,20 @@
-export default TinyDragDropDetector;
 export type DragAndDropOptions = {
     /**
      * - CSS class applied to the target element while files are being dragged over it.
      */
-    hoverClass?: string | undefined;
+    hoverClass?: string;
     /**
      * - Callback function executed when files are dropped onto the target.
      */
-    onDrop?: ((files: FileList, event: DragEvent) => void) | undefined;
+    onDrop?: (files: FileList, event: DragEvent) => void;
     /**
      * - Optional callback triggered when dragging enters the target area.
      */
-    onEnter?: ((event: DragEvent) => void) | undefined;
+    onEnter?: (event: DragEvent) => void;
     /**
      * - Optional callback triggered when dragging leaves the target area.
      */
-    onLeave?: ((event: DragEvent) => void) | undefined;
+    onLeave?: (event: DragEvent) => void;
 };
 /**
  * @typedef {Object} DragAndDropOptions
@@ -34,6 +33,13 @@ export type DragAndDropOptions = {
  * @template {HTMLElement} HTMLTarget
  */
 declare class TinyDragDropDetector<HTMLTarget extends HTMLElement> {
+    #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 TinyDragDropDetector to handle drag-and-drop file detection.
      *
@@ -46,6 +52,26 @@ declare class TinyDragDropDetector<HTMLTarget extends HTMLElement> {
      * @throws {TypeError} If `onLeave` is defined but not a function.
      */
     constructor(target: HTMLTarget, options: DragAndDropOptions);
+    /**
+     * Returns the current target DOM element where the listeners are attached.
+     * @returns {HTMLTarget}
+     */
+    getTarget(): HTMLTarget;
+    /**
+     * Returns the CSS class applied during drag hover.
+     * @returns {string}
+     */
+    getHoverClass(): string;
+    /**
+     * Returns whether a drag operation is currently active over the target.
+     * @returns {boolean}
+     */
+    isDragging(): boolean;
+    /**
+     * Returns whether the event listeners are currently bound to the target.
+     * @returns {boolean}
+     */
+    bound(): boolean;
     /**
      * Handles the `dragenter` event.
      * Adds the hover CSS class and triggers the `onEnter` callback if provided.
@@ -78,32 +104,12 @@ declare class TinyDragDropDetector<HTMLTarget extends HTMLElement> {
      * @returns {void}
      */
     private _handleDrop;
-    /**
-     * Returns the current target DOM element where the listeners are attached.
-     * @returns {HTMLTarget}
-     */
-    getTarget(): HTMLTarget;
-    /**
-     * Returns the CSS class applied during drag hover.
-     * @returns {string}
-     */
-    getHoverClass(): string;
-    /**
-     * Returns whether a drag operation is currently active over the target.
-     * @returns {boolean}
-     */
-    isDragging(): boolean;
-    /**
-     * Returns whether the event listeners are currently bound to the target.
-     * @returns {boolean}
-     */
-    bound(): boolean;
     /**
      * Destroys the detector instance, unbinding all event listeners and cleaning up.
      * Should be called when the detector is no longer needed to avoid memory leaks.
      * @returns {void}
      */
     destroy(): void;
-    #private;
 }
+export default TinyDragDropDetector;
 //# sourceMappingURL=TinyDragDropDetector.d.mts.map

package/dist/v1/libs/TinyDragDropDetector.mjs

@@ -1,3 +1,5 @@
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyDragDropDetector');
 /**
  * @typedef {Object} DragAndDropOptions
  * @property {string} [hoverClass="dnd-hover"] - CSS class applied to the target element while files are being dragged over it.
@@ -29,6 +31,19 @@ class TinyDragDropDetector {
     #isDragging;
     /** @type {boolean} */
     #bound;
+    /**
+     * 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;
+    }
     /**
      * Creates a new instance of TinyDragDropDetector to handle drag-and-drop file detection.
      *
@@ -77,6 +92,7 @@ class TinyDragDropDetector {
      * @returns {HTMLTarget}
      */
     getTarget() {
+        checkDestroy(this.#destroyed);
         return this.#target;
     }
     /**
@@ -84,6 +100,7 @@ class TinyDragDropDetector {
      * @returns {string}
      */
     getHoverClass() {
+        checkDestroy(this.#destroyed);
         return this.#hoverClass;
     }
     /**
@@ -91,6 +108,7 @@ class TinyDragDropDetector {
      * @returns {boolean}
      */
     isDragging() {
+        checkDestroy(this.#destroyed);
         return this.#isDragging;
     }
     /**
@@ -98,6 +116,7 @@ class TinyDragDropDetector {
      * @returns {boolean}
      */
     bound() {
+        checkDestroy(this.#destroyed);
         return this.#bound;
     }
     /**
@@ -205,9 +224,12 @@ class TinyDragDropDetector {
      * @returns {void}
      */
     destroy() {
+        if (this.#destroyed)
+            return;
         this.#unbindEvents();
         const target = this.getTarget();
         target.classList.remove(this.#hoverClass);
+        this.#destroyed = true;
     }
 }
 export default TinyDragDropDetector;

package/dist/v1/libs/TinyDragger.cjs

@@ -3,6 +3,9 @@
 var TinyHtml = require('./TinyHtml.cjs');
 var collision = require('../basics/collision.cjs');
 var objChecker = require('../basics/objChecker.cjs');
+var utils = require('./utils.cjs');
+
+const checkDestroy = utils.createCheckDestroyed('TinyDragger');
 
 /**
  * @typedef {Object} VibrationPatterns
@@ -196,7 +199,7 @@ class TinyDragger {
    * Enables the drag functionality.
    */
   enable() {
-    this.#checkDestroy();
+    checkDestroy(this.#destroyed);
     if (this.#jail) this.#jail.classList.add(this.#classJailDragDisabled);
     this.#enabled = true;
   }
@@ -205,6 +208,7 @@ class TinyDragger {
    * Disables the drag functionality.
    */
   disable() {
+    checkDestroy(this.#destroyed);
     if (this.#jail) this.#jail.classList.remove(this.#classJailDragDisabled);
     this.#enabled = false;
   }
@@ -215,7 +219,7 @@ class TinyDragger {
    * @throws {Error} If the element is not a valid HTMLElement.
    */
   addCollidable(element) {
-    this.#checkDestroy();
+    checkDestroy(this.#destroyed);
     if (!(element instanceof HTMLElement))
       throw new Error('addCollidable expects an HTMLElement as argument.');
     if (!this.#collidables.includes(element)) this.#collidables.push(element);
@@ -227,7 +231,7 @@ class TinyDragger {
    * @throws {Error} If the element is not a valid HTMLElement.
    */
   removeCollidable(element) {
-    this.#checkDestroy();
+    checkDestroy(this.#destroyed);
     if (!(element instanceof HTMLElement))
       throw new Error('removeCollidable expects an HTMLElement as argument.');
     this.#collidables = this.#collidables.filter((el) => el !== element);
@@ -248,7 +252,7 @@ class TinyDragger {
     collidePattern = false,
     movePattern = false,
   } = {}) {
-    this.#checkDestroy();
+    checkDestroy(this.#destroyed);
 
     /** @param {any} value */
     const isValidPattern = (value) =>
@@ -275,7 +279,7 @@ class TinyDragger {
    * Disables all vibration feedback.
    */
   disableVibration() {
-    this.#checkDestroy();
+    checkDestroy(this.#destroyed);
     this.#vibration = { start: false, end: false, collide: false, move: false };
   }
 
@@ -286,7 +290,7 @@ class TinyDragger {
    * @throws {Error} If event is not a MouseEvent or Touch with clientX/clientY.
    */
   getOffset(event) {
-    this.#checkDestroy();
+    checkDestroy(this.#destroyed);
     if (
       (!(event instanceof MouseEvent) && !(event instanceof Touch)) ||
       typeof event.clientX !== 'number' ||
@@ -392,6 +396,7 @@ class TinyDragger {
    * @param {MouseEvent|Touch} event - The drag event.
    */
   checkDragCollision(event) {
+    checkDestroy(this.#destroyed);
     const { collidedElements } = this.execCollision(event);
     const first = collidedElements[0] || null;
 
@@ -468,6 +473,7 @@ class TinyDragger {
    * @returns {{ inJail: boolean; collidedElements: (HTMLElement | null)[] }}
    */
   execCollision(event) {
+    checkDestroy(this.#destroyed);
     if (this.#destroyed || !this.#dragProxy) return { inJail: false, collidedElements: [] };
 
     let collidedElements = [];
@@ -596,7 +602,7 @@ class TinyDragger {
    * @throws {Error} If the input is not a valid DOMRect with numeric bounds.
    */
   getAllCollidedElementsByRect(rect) {
-    this.#checkDestroy();
+    checkDestroy(this.#destroyed);
     if (
       !(rect instanceof DOMRect) ||
       typeof rect.left !== 'number' ||
@@ -615,7 +621,7 @@ class TinyDragger {
    * @throws {Error} If rect is not a DOMRect with valid numeric properties.
    */
   getCollidedElementByRect(rect) {
-    this.#checkDestroy();
+    checkDestroy(this.#destroyed);
     if (
       !(rect instanceof DOMRect) ||
       typeof rect.left !== 'number' ||
@@ -646,7 +652,7 @@ class TinyDragger {
    * @returns {HTMLElement[]} The collided element or null.
    */
   getAllCollidedElements(x, y) {
-    this.#checkDestroy();
+    checkDestroy(this.#destroyed);
     if (typeof x !== 'number' || typeof y !== 'number')
       throw new Error('getCollidedElement expects numeric x and y coordinates.');
     return this.#collidables.filter((el) => this.#getCollidedElement(el, x, y));
@@ -659,7 +665,7 @@ class TinyDragger {
    * @returns {HTMLElement|null} The collided element or null.
    */
   getCollidedElement(x, y) {
-    this.#checkDestroy();
+    checkDestroy(this.#destroyed);
     if (typeof x !== 'number' || typeof y !== 'number')
       throw new Error('getCollidedElement expects numeric x and y coordinates.');
     return this.#collidables.find((el) => this.#getCollidedElement(el, x, y)) || null;
@@ -679,6 +685,7 @@ class TinyDragger {
    * @returns {boolean}
    */
   getDragging() {
+    checkDestroy(this.#destroyed);
     return this.#dragging;
   }
 
@@ -687,6 +694,7 @@ class TinyDragger {
    * @returns {boolean}
    */
   getLockInsideJail() {
+    checkDestroy(this.#destroyed);
     return this.#lockInsideJail;
   }
 
@@ -695,6 +703,7 @@ class TinyDragger {
    * @param {boolean} value
    */
   setLockInsideJail(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'boolean') throw new Error('lockInsideJail must be a boolean.');
     this.#lockInsideJail = value;
   }
@@ -704,6 +713,7 @@ class TinyDragger {
    * @returns {boolean}
    */
   getRevertOnDrop() {
+    checkDestroy(this.#destroyed);
     return this.#revertOnDrop;
   }
 
@@ -712,6 +722,7 @@ class TinyDragger {
    * @param {boolean} value
    */
   setRevertOnDrop(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'boolean') throw new Error('revertOnDrop must be a boolean.');
     this.#revertOnDrop = value;
   }
@@ -721,6 +732,7 @@ class TinyDragger {
    * @returns {boolean}
    */
   getCollisionByMouse() {
+    checkDestroy(this.#destroyed);
     return this.#collisionByMouse;
   }
 
@@ -729,6 +741,7 @@ class TinyDragger {
    * @param {boolean} value
    */
   setCollisionByMouse(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'boolean') throw new Error('collisionByMouse must be a boolean.');
     this.#collisionByMouse = value;
   }
@@ -738,6 +751,7 @@ class TinyDragger {
    * @returns {boolean}
    */
   getDropInJailOnly() {
+    checkDestroy(this.#destroyed);
     return this.#dropInJailOnly;
   }
 
@@ -746,6 +760,7 @@ class TinyDragger {
    * @param {boolean} value
    */
   setDropInJailOnly(value) {
+    checkDestroy(this.#destroyed);
     if (typeof value !== 'boolean') throw new Error('dropInJailOnly must be a boolean.');
     this.#dropInJailOnly = value;
   }
@@ -755,6 +770,7 @@ class TinyDragger {
    * @returns {number}
    */
   getDefaultZIndex() {
+    checkDestroy(this.#destroyed);
     return this.#defaultZIndex;
   }
 
@@ -763,6 +779,7 @@ class TinyDragger {
    * @param {number} newZIndex
    */
   setDefaultZIndex(newZIndex) {
+    checkDestroy(this.#destroyed);
     if (typeof newZIndex !== 'number' || !Number.isFinite(newZIndex))
       throw new TypeError('Z-index must be a finite number.');
     this.#defaultZIndex = newZIndex;
@@ -773,6 +790,7 @@ class TinyDragger {
    * @returns {boolean}
    */
   isMirrorEnabled() {
+    checkDestroy(this.#destroyed);
     return this.#mirrorElem;
   }
 
@@ -781,6 +799,7 @@ class TinyDragger {
    * @param {boolean} useMirror
    */
   setMirrorEnabled(useMirror) {
+    checkDestroy(this.#destroyed);
     if (typeof useMirror !== 'boolean') throw new TypeError('Mirror setting must be a boolean.');
 
     this.#mirrorElem = useMirror;
@@ -791,6 +810,7 @@ class TinyDragger {
    * @returns {HTMLElement}
    */
   getTarget() {
+    checkDestroy(this.#destroyed);
     return this.#target;
   }
 
@@ -799,6 +819,7 @@ class TinyDragger {
    * @returns {HTMLElement|null}
    */
   getJail() {
+    checkDestroy(this.#destroyed);
     return this.#jail;
   }
 
@@ -807,6 +828,7 @@ class TinyDragger {
    * @returns {HTMLElement|null}
    */
   getDragProxy() {
+    checkDestroy(this.#destroyed);
     return this.#dragProxy;
   }
 
@@ -815,6 +837,7 @@ class TinyDragger {
    * @returns {HTMLElement|null}
    */
   getLastCollision() {
+    checkDestroy(this.#destroyed);
     return this.#lastCollision;
   }
 
@@ -823,6 +846,7 @@ class TinyDragger {
    * @returns {HTMLElement[]}
    */
   getCollidables() {
+    checkDestroy(this.#destroyed);
     return [...this.#collidables];
   }
 
@@ -831,6 +855,7 @@ class TinyDragger {
    * @returns {string}
    */
   getDragHiddenClass() {
+    checkDestroy(this.#destroyed);
     return this.#dragHiddenClass;
   }
 
@@ -839,6 +864,7 @@ class TinyDragger {
    * @returns {string}
    */
   getClassDragging() {
+    checkDestroy(this.#destroyed);
     return this.#classDragging;
   }
 
@@ -847,6 +873,7 @@ class TinyDragger {
    * @returns {string}
    */
   getClassBodyDragging() {
+    checkDestroy(this.#destroyed);
     return this.#classBodyDragging;
   }
 
@@ -855,6 +882,7 @@ class TinyDragger {
    * @returns {string}
    */
   getClassJailDragging() {
+    checkDestroy(this.#destroyed);
     return this.#classJailDragging;
   }
 
@@ -863,6 +891,7 @@ class TinyDragger {
    * @returns {string}
    */
   getClassJailDragDisabled() {
+    checkDestroy(this.#destroyed);
     return this.#classJailDragDisabled;
   }
 
@@ -871,6 +900,7 @@ class TinyDragger {
    * @returns {string}
    */
   getClassDragCollision() {
+    checkDestroy(this.#destroyed);
     return this.#classDragCollision;
   }
 
@@ -879,6 +909,7 @@ class TinyDragger {
    * @returns {VibrationPatterns}
    */
   getVibrations() {
+    checkDestroy(this.#destroyed);
     return { ...this.#vibration };
   }
 
@@ -887,6 +918,7 @@ class TinyDragger {
    * @returns {number[]|boolean}
    */
   getStartVibration() {
+    checkDestroy(this.#destroyed);
     return this.#vibration.start;
   }
 
@@ -895,6 +927,7 @@ class TinyDragger {
    * @returns {number[]|boolean}
    */
   getEndVibration() {
+    checkDestroy(this.#destroyed);
     return this.#vibration.end;
   }
 
@@ -903,6 +936,7 @@ class TinyDragger {
    * @returns {number[]|boolean}
    */
   getCollideVibration() {
+    checkDestroy(this.#destroyed);
     return this.#vibration.collide;
   }
 
@@ -911,6 +945,7 @@ class TinyDragger {
    * @returns {number[]|boolean}
    */
   getMoveVibration() {
+    checkDestroy(this.#destroyed);
     return this.#vibration.move;
   }
 
@@ -919,18 +954,10 @@ class TinyDragger {
    * @returns {boolean}
    */
   isEnabled() {
+    checkDestroy(this.#destroyed);
     return this.#enabled;
   }
 
-  /**
-   * Internal method to verify if the instance has been destroyed.
-   * Throws an error if any operation is attempted after destruction.
-   */
-  #checkDestroy() {
-    if (this.#destroyed)
-      throw new Error('This TinyDragger instance has been destroyed and can no longer be used.');
-  }
-
   /**
    * Completely disables drag-and-drop and cleans up all event listeners.
    * Does NOT remove the original HTML element.