tiny-essentials 1.27.1 → 1.28.1

package/dist/v1/libs/TinyDayNightCycle.mjs

@@ -1,3 +1,5 @@
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyDayNightCycle');
 /**
  * Represents a mapping of weather type names to their selected values.
  * Each key is the name of a weather type, and the value is either:
@@ -215,6 +217,7 @@ class TinyDayNightCycle {
      * @returns {number}
      */
     get daySize() {
+        checkDestroy(this.#isDestroyed);
         return this.#daySize;
     }
     /**
@@ -222,6 +225,7 @@ class TinyDayNightCycle {
      * @returns {boolean}
      */
     get autoSizeAdjuste() {
+        checkDestroy(this.#isDestroyed);
         return this.#autoSizeAdjuste;
     }
     /**
@@ -230,6 +234,7 @@ class TinyDayNightCycle {
      * @throws {TypeError} If `value` is not a boolean.
      */
     set autoSizeAdjuste(value) {
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'boolean')
             throw new TypeError('autoSizeAdjuste must be a boolean.');
         this.#autoSizeAdjuste = value;
@@ -241,6 +246,7 @@ class TinyDayNightCycle {
      * @throws {Error} If `value` is not a positive finite number.
      */
     set daySize(value) {
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0)
             throw new Error('daySize must be a positive finite number.');
         const hourRatio = this.#hourSize / this.#daySize;
@@ -256,6 +262,7 @@ class TinyDayNightCycle {
      * @returns {number}
      */
     get hourSize() {
+        checkDestroy(this.#isDestroyed);
         return this.#hourSize;
     }
     /**
@@ -265,6 +272,7 @@ class TinyDayNightCycle {
      * @throws {Error} If `value` is not a positive finite number.
      */
     set hourSize(value) {
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0)
             throw new Error('hourSize must be a positive finite number.');
         const dayRatio = this.#daySize / this.#hourSize;
@@ -280,6 +288,7 @@ class TinyDayNightCycle {
      * @returns {number}
      */
     get minuteSize() {
+        checkDestroy(this.#isDestroyed);
         return this.#minuteSize;
     }
     /**
@@ -289,6 +298,7 @@ class TinyDayNightCycle {
      * @throws {Error} If `value` is not a positive finite number.
      */
     set minuteSize(value) {
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0)
             throw new Error('minuteSize must be a positive finite number.');
         const hourRatio = this.#hourSize / this.#minuteSize;
@@ -311,6 +321,7 @@ class TinyDayNightCycle {
      * @returns {number} Current seconds (0 to 86399).
      */
     get currentSeconds() {
+        checkDestroy(this.#isDestroyed);
         return this.#currentSeconds;
     }
     /**
@@ -321,7 +332,7 @@ class TinyDayNightCycle {
      * @throws {RangeError} If the value is outside the valid range.
      */
     set currentSeconds(value) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'number' || !Number.isFinite(value))
             throw new TypeError(`currentSeconds must be a finite number, received ${typeof value}`);
         if (value < 0 || value >= this.#daySize)
@@ -335,6 +346,7 @@ class TinyDayNightCycle {
      * @returns {number} Current minutes (0 to 1439).
      */
     get currentMinutes() {
+        checkDestroy(this.#isDestroyed);
         return this.#currentMinutes;
     }
     /**
@@ -345,7 +357,7 @@ class TinyDayNightCycle {
      * @throws {RangeError} If the value is outside the valid range.
      */
     set currentMinutes(value) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'number' || !Number.isFinite(value))
             throw new TypeError(`currentMinutes must be a finite number, received ${typeof value}`);
         if (value < 0 || value >= 1440)
@@ -360,6 +372,7 @@ class TinyDayNightCycle {
      * @returns {number} Current hours (0 to less than 24).
      */
     get currentHours() {
+        checkDestroy(this.#isDestroyed);
         return this.#currentHours;
     }
     /**
@@ -371,7 +384,7 @@ class TinyDayNightCycle {
      * @throws {RangeError} If the value is outside the valid range.
      */
     set currentHours(value) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'number' || !Number.isFinite(value))
             throw new TypeError(`currentHours must be a finite number, received ${typeof value}`);
         if (value < 0 || value >= 24)
@@ -385,6 +398,7 @@ class TinyDayNightCycle {
      * @returns {MoonData[]} Array of moons including their name, current phase index, phase name, and cycle length.
      */
     get moons() {
+        checkDestroy(this.#isDestroyed);
         return this.#moons.map((moon) => this.getMoon(moon));
     }
     /**
@@ -392,34 +406,42 @@ class TinyDayNightCycle {
      * @returns {string[]} Array of season names.
      */
     get seasons() {
+        checkDestroy(this.#isDestroyed);
         return Array.from(this.#seasons.keys());
     }
     /** @returns {number} Hour at which day starts (0-23). */
     get dayStart() {
+        checkDestroy(this.#isDestroyed);
         return this.#dayStart;
     }
     /** @returns {number} Hour at which night starts (0-23). */
     get nightStart() {
+        checkDestroy(this.#isDestroyed);
         return this.#nightStart;
     }
     /** @returns {SelectedWeather} Currently active weather types or nulls if none. */
     get weather() {
+        checkDestroy(this.#isDestroyed);
         return { ...this.#weather };
     }
     /** @returns {string} Currently active season name. */
     get currentSeason() {
+        checkDestroy(this.#isDestroyed);
         return this.#currentSeason;
     }
     /** @returns {number} Current day of the month. */
     get currentDay() {
+        checkDestroy(this.#isDestroyed);
         return this.#currentDay;
     }
     /** @returns {number} Current month number. */
     get currentMonth() {
+        checkDestroy(this.#isDestroyed);
         return this.#currentMonth;
     }
     /** @returns {number} Current year count. */
     get currentYear() {
+        checkDestroy(this.#isDestroyed);
         return this.#currentYear;
     }
     /**
@@ -428,6 +450,7 @@ class TinyDayNightCycle {
      * @returns {number[]} Object mapping month number to days.
      */
     get monthDays() {
+        checkDestroy(this.#isDestroyed);
         return [...this.#monthDays];
     }
     /**
@@ -435,10 +458,12 @@ class TinyDayNightCycle {
      * @returns {{min: number, max: number}} Object with min and max weather duration.
      */
     get weatherDuration() {
+        checkDestroy(this.#isDestroyed);
         return { ...this.#weatherDuration };
     }
     /** @returns {number} Minutes left until current weather expires. */
     get weatherTimeLeft() {
+        checkDestroy(this.#isDestroyed);
         return this.#weatherTimeLeft;
     }
     /**
@@ -447,7 +472,7 @@ class TinyDayNightCycle {
      * @throws {TypeError} If value is not a number.
      */
     set dayStart(value) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'number' || value < 1)
             throw new TypeError(`dayStart must be a positive non-zero number, received ${typeof value}`);
         this.#dayStart = value;
@@ -458,7 +483,7 @@ class TinyDayNightCycle {
      * @throws {TypeError} If value is not a number.
      */
     set nightStart(value) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'number' || value < 1)
             throw new TypeError(`nightStart must be a positive non-zero number, received ${typeof value}`);
         this.#nightStart = value;
@@ -469,7 +494,7 @@ class TinyDayNightCycle {
      * @throws {TypeError} If value is not a string or null.
      */
     set weather(value) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'object' ||
             value === null ||
             Array.isArray(value) ||
@@ -484,7 +509,7 @@ class TinyDayNightCycle {
      * @throws {TypeError} If value is not a string or not a configured season.
      */
     set currentSeason(value) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'string' || !this.#seasons.has(value)) {
             throw new TypeError(`currentSeason must be one of ${Array.from(this.#seasons)
                 .map((v) => v[0])
@@ -498,7 +523,7 @@ class TinyDayNightCycle {
      * @throws {TypeError} If value is not a number.
      */
     set currentDay(value) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'number' || value < 1 || value > this.#monthDays[this.#currentMonth - 1])
             throw new TypeError(`currentDay must be a valid day number, received ${typeof value}`);
         this.#currentDay = value;
@@ -509,7 +534,7 @@ class TinyDayNightCycle {
      * @throws {TypeError} If value is not a number.
      */
     set currentMonth(value) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'number' || typeof this.#monthDays[value - 1] !== 'number')
             throw new TypeError(`currentMonth must be a valid month number, received ${typeof value}`);
         this.#currentMonth = value;
@@ -520,7 +545,7 @@ class TinyDayNightCycle {
      * @throws {TypeError} If value is not a number.
      */
     set currentYear(value) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'number' || value < 1)
             throw new TypeError(`currentYear must be a positive number non-zero, received ${typeof value}`);
         this.#currentYear = value;
@@ -531,7 +556,7 @@ class TinyDayNightCycle {
      * @param {number[]} value - An object where keys are month numbers and values are the number of days.
      */
     set monthDays(value) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (!Array.isArray(value))
             throw new TypeError(`monthDays must be a array`);
         if (!value.every((n) => typeof n === 'number'))
@@ -544,7 +569,7 @@ class TinyDayNightCycle {
      * @throws {TypeError} If value or its min/max are invalid.
      */
     set weatherDuration(value) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'object' || value === null)
             throw new TypeError(`weatherDuration must be a non-null object`);
         if (typeof value.min !== 'number' || typeof value.max !== 'number')
@@ -557,7 +582,7 @@ class TinyDayNightCycle {
      * @throws {TypeError} If value is not a number.
      */
     set weatherTimeLeft(value) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (typeof value !== 'number')
             throw new TypeError(`weatherTimeLeft must be a number, received ${typeof value}`);
         this.#weatherTimeLeft = value;
@@ -568,6 +593,7 @@ class TinyDayNightCycle {
      * @returns {WeatherCfgs} Deep copy of the weather configuration.
      */
     get weatherConfig() {
+        checkDestroy(this.#isDestroyed);
         /** @type {Record<string, WeatherCfg>} */
         const hours = {};
         /** @type {Record<string, WeatherCfg>} */
@@ -591,7 +617,7 @@ class TinyDayNightCycle {
      * @throws {TypeError} If the provided value is not a valid object or contains invalid data types.
      */
     set weatherConfig(config) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (typeof config !== 'object' || config === null)
             throw new TypeError(`weatherConfig must be a non-null object, received ${config}`);
         const requiredKeys = ['default', 'day', 'night', 'hours', 'seasons'];
@@ -658,7 +684,7 @@ class TinyDayNightCycle {
      * @throws {TypeError} If `name` is not a string or `values` is not an array of numbers.
      */
     addSeason(name, values) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (typeof name !== 'string')
             throw new TypeError(`Season name must be a string, received ${typeof name}`);
         if (!Array.isArray(values) || !values.every((v) => typeof v === 'number'))
@@ -672,7 +698,7 @@ class TinyDayNightCycle {
      * @throws {TypeError} If `name` is not a string.
      */
     removeSeason(name) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (typeof name !== 'string')
             throw new TypeError(`Season name must be a string, received ${typeof name}`);
         this.#seasons.delete(name);
@@ -687,6 +713,7 @@ class TinyDayNightCycle {
      * @throws {TypeError} If `name` is not a string.
      */
     hasSeason(name) {
+        checkDestroy(this.#isDestroyed);
         if (typeof name !== 'string')
             throw new TypeError(`Season name must be a string, received ${typeof name}`);
         return this.#seasons.has(name);
@@ -700,6 +727,7 @@ class TinyDayNightCycle {
      * @throws {Error} If the season does not exist.
      */
     getSeason(name) {
+        checkDestroy(this.#isDestroyed);
         if (typeof name !== 'string')
             throw new TypeError(`Season name must be a string, received ${typeof name}`);
         const result = this.#seasons.get(name);
@@ -716,7 +744,7 @@ class TinyDayNightCycle {
      * @param {number} [settings.second=0] - 0 to 59
      */
     setTime({ hour = 0, minute = 0, second = 0 }) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         this.currentSeconds =
             (hour * this.#hourSize + minute * this.#minuteSize + second) % this.#daySize;
     }
@@ -728,7 +756,7 @@ class TinyDayNightCycle {
      * @param {number} [settings.seconds=0]
      */
     addTime({ hours = 0, minutes = 0, seconds = 0 }) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         let total = this.currentSeconds + hours * this.#hourSize + minutes * this.#minuteSize + seconds;
         while (total >= this.#daySize) {
             total -= this.#daySize;
@@ -757,6 +785,7 @@ class TinyDayNightCycle {
      * }} An object containing the hour, minute, second, and the formatted time string.
      */
     getTime({ withSeconds = false, hourSize = this.#hourSize, minuteSize = this.#minuteSize } = {}) {
+        checkDestroy(this.#isDestroyed);
         const hour = Math.floor(this.currentSeconds / hourSize);
         const minute = Math.floor((this.currentSeconds % hourSize) / minuteSize);
         const second = this.currentSeconds % minuteSize;
@@ -775,6 +804,7 @@ class TinyDayNightCycle {
      * @returns {boolean} True if current time is day, false otherwise.
      */
     isDay() {
+        checkDestroy(this.#isDestroyed);
         if (this.#dayStart < this.#nightStart) {
             return (this.#currentMinutes >= this.#dayStart * this.#minuteSize &&
                 this.#currentMinutes < this.#nightStart * this.#minuteSize);
@@ -837,7 +867,7 @@ class TinyDayNightCycle {
      * @returns {number} Time until target hour, in the specified unit.
      */
     timeUntil(targetHour, unit) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         const targetSeconds = targetHour * this.#hourSize; // 1 hour = 3600 seconds
         let diffSeconds = targetSeconds - this.#currentSeconds;
         if (diffSeconds <= 0)
@@ -857,7 +887,7 @@ class TinyDayNightCycle {
      * @param {"day"|"night"} phase - The phase to set the time to.
      */
     setTo(phase) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         if (phase === 'day')
             this.setTime({ hour: this.#dayStart });
         else if (phase === 'night')
@@ -871,7 +901,7 @@ class TinyDayNightCycle {
      * @param {number} [amount=1] - Number of days to move forward.
      */
     nextDay(amount = 1) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         for (let i = 0; i < amount; i++) {
             this.#currentDay++;
             const monthDays = this.#monthDays[this.#currentMonth - 1];
@@ -896,7 +926,7 @@ class TinyDayNightCycle {
      * @param {number} [amount=1] - Number of days to move backward.
      */
     prevDay(amount = 1) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         for (let i = 0; i < amount; i++) {
             this.#currentDay--;
             if (this.#currentDay < 1) {
@@ -915,7 +945,7 @@ class TinyDayNightCycle {
      * Updates the current season based on the month.
      */
     updateSeason() {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         this.#seasons.forEach((seasonMonths, name) => {
             if (seasonMonths.includes(this.#currentMonth))
                 this.#currentSeason = name;
@@ -928,7 +958,7 @@ class TinyDayNightCycle {
      * An object defining default probabilities, time-based probabilities, day/night differences, and seasonal probabilities.
      */
     setWeatherConfig(config) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         this.#weatherConfig = { ...this.#weatherConfig, ...config };
     }
     /**
@@ -937,7 +967,7 @@ class TinyDayNightCycle {
      * @param {number} maxMinutes - Maximum duration in minutes.
      */
     setWeatherDuration(minMinutes, maxMinutes) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         this.#weatherDuration.min = minMinutes;
         this.#weatherDuration.max = maxMinutes;
     }
@@ -947,7 +977,7 @@ class TinyDayNightCycle {
      * @param {number} minutesPassed - Number of in-game minutes passed since last update.
      */
     updateWeatherTimer(minutesPassed) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         this.#weatherTimeLeft -= minutesPassed;
         if (this.#weatherTimeLeft <= 0) {
             this.chooseNewWeather();
@@ -961,7 +991,7 @@ class TinyDayNightCycle {
      * @param {number|null} [settings.duration=null] - Duration in minutes. If null, a random duration is used.
      */
     forceWeather({ where = 'main', type, duration = null }) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         const weather = this.#weather;
         weather[where] = type;
         this.weather = weather;
@@ -983,7 +1013,7 @@ class TinyDayNightCycle {
      * @returns {string|null} - The selected weather type, or null if none selected.
      */
     chooseNewWeather({ customWeather, where = 'main' } = {}) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         /** @type {WeatherData} */
         let probabilities = {};
         /**
@@ -1063,6 +1093,7 @@ class TinyDayNightCycle {
      * @param {number} min - Minimum value.
      * @param {number} max - Maximum value.
      * @returns {number} - A random integer between min and max.
+     * @private
      */
     _randomInRange(min, max) {
         return Math.floor(Math.random() * (max - min + 1)) + min;
@@ -1077,7 +1108,7 @@ class TinyDayNightCycle {
      * @returns {number} - The moon index.
      */
     addMoon(name, cycleLength, phaseNames, startingPhase = 0) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         const length = Math.max(1, cycleLength);
         this.#moons.push({
             name,
@@ -1092,7 +1123,7 @@ class TinyDayNightCycle {
      * @param {string} name
      */
     removeMoon(name) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         this.#moons = this.#moons.filter((m) => m.name !== name);
     }
     /**
@@ -1118,7 +1149,7 @@ class TinyDayNightCycle {
      * @throws {RangeError} If the moonIndex is invalid.
      */
     advanceMoon(moonIndex, days = 1) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         const moon = this.#moons[moonIndex];
         if (!moon)
             throw new RangeError(`No moon found at index ${moonIndex}`);
@@ -1131,7 +1162,7 @@ class TinyDayNightCycle {
      * @throws {RangeError} If the moonIndex is invalid.
      */
     rewindMoon(moonIndex, days = 1) {
-        this._checkDestroyed();
+        checkDestroy(this.#isDestroyed);
         const moon = this.#moons[moonIndex];
         if (!moon)
             throw new RangeError(`No moon found at index ${moonIndex}`);
@@ -1144,6 +1175,7 @@ class TinyDayNightCycle {
      * @returns {boolean} `true` if a moon exists at the given index, otherwise `false`.
      */
     moonExists(index) {
+        checkDestroy(this.#isDestroyed);
         if (!this.#moons[index])
             return false;
         return true;
@@ -1158,6 +1190,7 @@ class TinyDayNightCycle {
      * @throws {Error} If `index` is a `MoonRaw` object but required properties are missing or invalid.
      */
     getMoon(index) {
+        checkDestroy(this.#isDestroyed);
         let moon;
         if (typeof index === 'number') {
             moon = this.#moons[index];
@@ -1181,15 +1214,6 @@ class TinyDayNightCycle {
             cycleLength: moon.cycleLength,
         };
     }
-    /**
-     * Checks if the instance has been destroyed and throws an error if so.
-     * @private
-     * @throws {Error} If the instance has already been destroyed.
-     */
-    _checkDestroyed() {
-        if (this.#isDestroyed)
-            throw new Error('This instance has been destroyed and can no longer be used.');
-    }
     /**
      * Destroys all stored data and marks the instance as unusable.
      * Clears all internal maps, arrays, and resets primitive values to defaults.

package/dist/v1/libs/TinyDragDropDetector.cjs

@@ -1,5 +1,9 @@
 'use strict';
 
+var utils = require('./utils.cjs');
+
+const checkDestroy = utils.createCheckDestroyed('TinyDragDropDetector');
+
 /**
  * @typedef {Object} DragAndDropOptions
  * @property {string} [hoverClass="dnd-hover"] - CSS class applied to the target element while files are being dragged over it.
@@ -39,6 +43,21 @@ class TinyDragDropDetector {
   /** @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.
    *
@@ -98,6 +117,7 @@ class TinyDragDropDetector {
    * @returns {HTMLTarget}
    */
   getTarget() {
+    checkDestroy(this.#destroyed);
     return this.#target;
   }
 
@@ -106,6 +126,7 @@ class TinyDragDropDetector {
    * @returns {string}
    */
   getHoverClass() {
+    checkDestroy(this.#destroyed);
     return this.#hoverClass;
   }
 
@@ -114,6 +135,7 @@ class TinyDragDropDetector {
    * @returns {boolean}
    */
   isDragging() {
+    checkDestroy(this.#destroyed);
     return this.#isDragging;
   }
 
@@ -122,6 +144,7 @@ class TinyDragDropDetector {
    * @returns {boolean}
    */
   bound() {
+    checkDestroy(this.#destroyed);
     return this.#bound;
   }
 
@@ -234,9 +257,11 @@ class TinyDragDropDetector {
    * @returns {void}
    */
   destroy() {
+    if (this.#destroyed) return;
     this.#unbindEvents();
     const target = this.getTarget();
     target.classList.remove(this.#hoverClass);
+    this.#destroyed = true;
   }
 }
 

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

@@ -46,6 +46,12 @@ declare class TinyDragDropDetector<HTMLTarget extends HTMLElement> {
      * @throws {TypeError} If `onLeave` is defined but not a function.
      */
     constructor(target: HTMLTarget, options: DragAndDropOptions);
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed(): boolean;
     /**
      * Handles the `dragenter` event.
      * Adds the hover CSS class and triggers the `onEnter` callback if provided.

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;