tiny-essentials 1.28.0 → 1.28.2

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

@@ -1,4 +1,6 @@
-export default TinyDragger;
+import TinyHtml from './TinyHtml.mjs';
+import * as TinyCollision from '../basics/collision.mjs';
+export type TouchDragEvent = (event: TouchEvent) => void;
 export type VibrationPatterns = {
     /**
      * - Pattern to vibrate on start
@@ -31,55 +33,77 @@ export type VibrationPatterns = {
  * @template {HTMLElement} HTMLTarget
  */
 declare class TinyDragger<HTMLTarget extends HTMLElement> {
+    #private;
+    /** @private */
+    _onMouseDown;
+    /** @private */
+    _onMouseMove;
+    /** @private */
+    _onMouseUp;
+    /**
+     * @type {TouchDragEvent}
+     * @private
+     */
+    _onTouchStart;
+    /**
+     * @type {TouchDragEvent}
+     * @private
+     */
+    _onTouchMove;
+    /**
+     * @type {TouchDragEvent}
+     * @private
+     */
+    _onTouchEnd;
     static Utils: {
-        TinyHtml: typeof TinyHtml;
-        getElsRelativeCenterOffset(rect1: ObjRect, rect2: ObjRect): {
-            x: number;
-            y: number;
-        };
-        getElsCollDirDepth(rect1: ObjRect, rect2: ObjRect): {
-            inDir: Dirs | null;
-            dirX: Dirs | null;
-            dirY: Dirs | null;
-            depthX: number;
-            depthY: number;
-        };
-        getElsCollDetails(rect1: ObjRect, rect2: ObjRect): {
-            depth: CollData;
-            dirs: CollDirs;
-            isNeg: NegCollDirs;
-        };
-        areElsCollTop: (rect1: ObjRect, rect2: ObjRect) => boolean;
-        areElsCollBottom: (rect1: ObjRect, rect2: ObjRect) => boolean;
-        areElsCollLeft: (rect1: ObjRect, rect2: ObjRect) => boolean;
-        areElsCollRight: (rect1: ObjRect, rect2: ObjRect) => boolean;
-        areElsCollPerfTop: (rect1: ObjRect, rect2: ObjRect) => boolean;
-        areElsCollPerfBottom: (rect1: ObjRect, rect2: ObjRect) => boolean;
-        areElsCollPerfLeft: (rect1: ObjRect, rect2: ObjRect) => boolean;
-        areElsCollPerfRight: (rect1: ObjRect, rect2: ObjRect) => boolean;
-        areElsColliding: (rect1: ObjRect, rect2: ObjRect) => boolean;
-        areElsPerfColliding: (rect1: ObjRect, rect2: ObjRect) => boolean;
-        getElsColliding: (rect1: ObjRect, rect2: ObjRect) => string | null;
-        getElsPerfColliding: (rect1: ObjRect, rect2: ObjRect) => "top" | "bottom" | "left" | "right" | null;
-        getElsCollOverlap: (rect1: ObjRect, rect2: ObjRect) => {
+        areElsCollTop: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;
+        areElsCollBottom: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;
+        areElsCollLeft: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;
+        areElsCollRight: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;
+        areElsCollPerfTop: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;
+        areElsCollPerfBottom: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;
+        areElsCollPerfLeft: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;
+        areElsCollPerfRight: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;
+        areElsColliding: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;
+        areElsPerfColliding: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;
+        getElsColliding: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => string | null;
+        getElsPerfColliding: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => 'top' | 'bottom' | 'left' | 'right' | null;
+        getElsCollOverlap: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => {
             overlapLeft: number;
             overlapRight: number;
             overlapTop: number;
             overlapBottom: number;
         };
         getElsCollOverlapPos: ({ overlapLeft, overlapRight, overlapTop, overlapBottom, }?: {
-            overlapLeft?: number | undefined;
-            overlapRight?: number | undefined;
-            overlapTop?: number | undefined;
-            overlapBottom?: number | undefined;
+            overlapLeft?: number;
+            overlapRight?: number;
+            overlapTop?: number;
+            overlapBottom?: number;
         }) => {
-            dirX: Dirs;
-            dirY: Dirs;
+            dirX: TinyCollision.Dirs;
+            dirY: TinyCollision.Dirs;
         };
-        getRectCenter: (rect: ObjRect) => {
+        getRectCenter: (rect: TinyCollision.ObjRect) => {
             x: number;
             y: number;
         };
+        getElsRelativeCenterOffset(rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect): {
+            x: number;
+            y: number;
+        };
+        getElsCollDirDepth(rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect): {
+            inDir: TinyCollision.Dirs | null;
+            dirX: TinyCollision.Dirs | null;
+            dirY: TinyCollision.Dirs | null;
+            depthX: number;
+            depthY: number;
+        };
+        getElsCollDetails(rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect): {
+            depth: TinyCollision.CollData;
+            dirs: TinyCollision.CollDirs;
+            isNeg: TinyCollision.NegCollDirs;
+        };
+        TinyHtml: typeof TinyHtml;
     };
     /** @typedef {(event: TouchEvent) => void} TouchDragEvent */
     /**
@@ -103,43 +127,22 @@ declare class TinyDragger<HTMLTarget extends HTMLElement> {
      * @throws {Error} If any option has an invalid type.
      */
     constructor(targetElement: HTMLTarget, options?: {
-        jail?: HTMLElement | undefined;
-        mirrorElem?: boolean | undefined;
-        defaultZIndex?: number | undefined;
-        collisionByMouse?: boolean | undefined;
-        classDragging?: string | undefined;
-        classBodyDragging?: string | undefined;
-        classJailDragging?: string | undefined;
-        classJailDragDisabled?: string | undefined;
-        classDragCollision?: string | undefined;
-        lockInsideJail?: boolean | undefined;
-        dropInJailOnly?: boolean | undefined;
-        multiCollision?: boolean | undefined;
-        vibration?: false | VibrationPatterns | undefined;
-        revertOnDrop?: boolean | undefined;
-        classHidden?: string | undefined;
+        jail?: HTMLElement;
+        mirrorElem?: boolean;
+        defaultZIndex?: number;
+        collisionByMouse?: boolean;
+        classDragging?: string;
+        classBodyDragging?: string;
+        classJailDragging?: string;
+        classJailDragDisabled?: string;
+        classDragCollision?: string;
+        lockInsideJail?: boolean;
+        dropInJailOnly?: boolean;
+        multiCollision?: boolean;
+        vibration?: VibrationPatterns | false;
+        revertOnDrop?: boolean;
+        classHidden?: string;
     });
-    /** @private */
-    private _onMouseDown;
-    /** @private */
-    private _onMouseMove;
-    /** @private */
-    private _onMouseUp;
-    /**
-     * @type {TouchDragEvent}
-     * @private
-     */
-    private _onTouchStart;
-    /**
-     * @type {TouchDragEvent}
-     * @private
-     */
-    private _onTouchMove;
-    /**
-     * @type {TouchDragEvent}
-     * @private
-     */
-    private _onTouchEnd;
     /**
      * Enables the drag functionality.
      */
@@ -170,10 +173,10 @@ declare class TinyDragger<HTMLTarget extends HTMLElement> {
      * @throws {Error} If any pattern is not false or an array of numbers.
      */
     setVibrationPattern({ startPattern, endPattern, collidePattern, movePattern, }?: {
-        startPattern?: false | number[] | undefined;
-        endPattern?: false | number[] | undefined;
-        collidePattern?: false | number[] | undefined;
-        movePattern?: false | number[] | undefined;
+        startPattern?: number[] | false;
+        endPattern?: number[] | false;
+        collidePattern?: number[] | false;
+        movePattern?: number[] | false;
     }): void;
     /**
      * Disables all vibration feedback.
@@ -386,8 +389,6 @@ declare class TinyDragger<HTMLTarget extends HTMLElement> {
      * Does NOT remove the original HTML element.
      */
     destroy(): void;
-    #private;
 }
-import TinyHtml from './TinyHtml.mjs';
-import * as TinyCollision from '../basics/collision.mjs';
+export default TinyDragger;
 //# sourceMappingURL=TinyDragger.d.mts.map

package/dist/v1/libs/TinyDragger.mjs

@@ -1,6 +1,8 @@
 import TinyHtml from './TinyHtml.mjs';
 import * as TinyCollision from '../basics/collision.mjs';
 import { isJsonObject } from '../basics/objChecker.mjs';
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyDragger');
 /**
  * @typedef {Object} VibrationPatterns
  * @property {number[]|false} start - Pattern to vibrate on start
@@ -167,7 +169,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;
@@ -176,6 +178,7 @@ class TinyDragger {
      * Disables the drag functionality.
      */
     disable() {
+        checkDestroy(this.#destroyed);
         if (this.#jail)
             this.#jail.classList.remove(this.#classJailDragDisabled);
         this.#enabled = false;
@@ -186,7 +189,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))
@@ -198,7 +201,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);
@@ -213,7 +216,7 @@ class TinyDragger {
      * @throws {Error} If any pattern is not false or an array of numbers.
      */
     setVibrationPattern({ startPattern = false, endPattern = false, collidePattern = false, movePattern = false, } = {}) {
-        this.#checkDestroy();
+        checkDestroy(this.#destroyed);
         /** @param {any} value */
         const isValidPattern = (value) => value === false || (Array.isArray(value) && value.every((n) => typeof n === 'number'));
         if (!isValidPattern(startPattern))
@@ -235,7 +238,7 @@ class TinyDragger {
      * Disables all vibration feedback.
      */
     disableVibration() {
-        this.#checkDestroy();
+        checkDestroy(this.#destroyed);
         this.#vibration = { start: false, end: false, collide: false, move: false };
     }
     /**
@@ -245,7 +248,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' ||
             typeof event.clientY !== 'number')
@@ -340,6 +343,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;
         // Removes old marking if necessary
@@ -400,6 +404,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 = [];
@@ -515,7 +520,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' ||
             typeof rect.right !== 'number' ||
@@ -531,7 +536,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' ||
             typeof rect.right !== 'number' ||
@@ -558,7 +563,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));
@@ -570,7 +575,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;
@@ -588,6 +593,7 @@ class TinyDragger {
      * @returns {boolean}
      */
     getDragging() {
+        checkDestroy(this.#destroyed);
         return this.#dragging;
     }
     /**
@@ -595,6 +601,7 @@ class TinyDragger {
      * @returns {boolean}
      */
     getLockInsideJail() {
+        checkDestroy(this.#destroyed);
         return this.#lockInsideJail;
     }
     /**
@@ -602,6 +609,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;
@@ -611,6 +619,7 @@ class TinyDragger {
      * @returns {boolean}
      */
     getRevertOnDrop() {
+        checkDestroy(this.#destroyed);
         return this.#revertOnDrop;
     }
     /**
@@ -618,6 +627,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;
@@ -627,6 +637,7 @@ class TinyDragger {
      * @returns {boolean}
      */
     getCollisionByMouse() {
+        checkDestroy(this.#destroyed);
         return this.#collisionByMouse;
     }
     /**
@@ -634,6 +645,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;
@@ -643,6 +655,7 @@ class TinyDragger {
      * @returns {boolean}
      */
     getDropInJailOnly() {
+        checkDestroy(this.#destroyed);
         return this.#dropInJailOnly;
     }
     /**
@@ -650,6 +663,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;
@@ -659,6 +673,7 @@ class TinyDragger {
      * @returns {number}
      */
     getDefaultZIndex() {
+        checkDestroy(this.#destroyed);
         return this.#defaultZIndex;
     }
     /**
@@ -666,6 +681,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;
@@ -675,6 +691,7 @@ class TinyDragger {
      * @returns {boolean}
      */
     isMirrorEnabled() {
+        checkDestroy(this.#destroyed);
         return this.#mirrorElem;
     }
     /**
@@ -682,6 +699,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;
@@ -691,6 +709,7 @@ class TinyDragger {
      * @returns {HTMLElement}
      */
     getTarget() {
+        checkDestroy(this.#destroyed);
         return this.#target;
     }
     /**
@@ -698,6 +717,7 @@ class TinyDragger {
      * @returns {HTMLElement|null}
      */
     getJail() {
+        checkDestroy(this.#destroyed);
         return this.#jail;
     }
     /**
@@ -705,6 +725,7 @@ class TinyDragger {
      * @returns {HTMLElement|null}
      */
     getDragProxy() {
+        checkDestroy(this.#destroyed);
         return this.#dragProxy;
     }
     /**
@@ -712,6 +733,7 @@ class TinyDragger {
      * @returns {HTMLElement|null}
      */
     getLastCollision() {
+        checkDestroy(this.#destroyed);
         return this.#lastCollision;
     }
     /**
@@ -719,6 +741,7 @@ class TinyDragger {
      * @returns {HTMLElement[]}
      */
     getCollidables() {
+        checkDestroy(this.#destroyed);
         return [...this.#collidables];
     }
     /**
@@ -726,6 +749,7 @@ class TinyDragger {
      * @returns {string}
      */
     getDragHiddenClass() {
+        checkDestroy(this.#destroyed);
         return this.#dragHiddenClass;
     }
     /**
@@ -733,6 +757,7 @@ class TinyDragger {
      * @returns {string}
      */
     getClassDragging() {
+        checkDestroy(this.#destroyed);
         return this.#classDragging;
     }
     /**
@@ -740,6 +765,7 @@ class TinyDragger {
      * @returns {string}
      */
     getClassBodyDragging() {
+        checkDestroy(this.#destroyed);
         return this.#classBodyDragging;
     }
     /**
@@ -747,6 +773,7 @@ class TinyDragger {
      * @returns {string}
      */
     getClassJailDragging() {
+        checkDestroy(this.#destroyed);
         return this.#classJailDragging;
     }
     /**
@@ -754,6 +781,7 @@ class TinyDragger {
      * @returns {string}
      */
     getClassJailDragDisabled() {
+        checkDestroy(this.#destroyed);
         return this.#classJailDragDisabled;
     }
     /**
@@ -761,6 +789,7 @@ class TinyDragger {
      * @returns {string}
      */
     getClassDragCollision() {
+        checkDestroy(this.#destroyed);
         return this.#classDragCollision;
     }
     /**
@@ -768,6 +797,7 @@ class TinyDragger {
      * @returns {VibrationPatterns}
      */
     getVibrations() {
+        checkDestroy(this.#destroyed);
         return { ...this.#vibration };
     }
     /**
@@ -775,6 +805,7 @@ class TinyDragger {
      * @returns {number[]|boolean}
      */
     getStartVibration() {
+        checkDestroy(this.#destroyed);
         return this.#vibration.start;
     }
     /**
@@ -782,6 +813,7 @@ class TinyDragger {
      * @returns {number[]|boolean}
      */
     getEndVibration() {
+        checkDestroy(this.#destroyed);
         return this.#vibration.end;
     }
     /**
@@ -789,6 +821,7 @@ class TinyDragger {
      * @returns {number[]|boolean}
      */
     getCollideVibration() {
+        checkDestroy(this.#destroyed);
         return this.#vibration.collide;
     }
     /**
@@ -796,6 +829,7 @@ class TinyDragger {
      * @returns {number[]|boolean}
      */
     getMoveVibration() {
+        checkDestroy(this.#destroyed);
         return this.#vibration.move;
     }
     /**
@@ -803,16 +837,9 @@ 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.