tiny-essentials 1.27.1 → 1.28.1

package/dist/v1/libs/TinyGamepad.cjs

@@ -1,5 +1,9 @@
 'use strict';
 
+var utils = require('./utils.cjs');
+
+const checkDestroy = utils.createCheckDestroyed('TinyGamepad');
+
 /**
  * @typedef {Object} KeyStatus
  * Describes the status of a key or button.
@@ -1219,6 +1223,7 @@ class TinyGamepad {
    *   - `gp`: the Gamepad object (only if the input source is a gamepad).
    */
   awaitInputMapping({ timeout = 10000, eventName = 'MappingInput', canMove = false } = {}) {
+    checkDestroy(this.#isDestroyed);
     return new Promise((resolve, reject) => {
       // Argument validation
       if (typeof timeout !== 'number' || Number.isNaN(timeout) || timeout < 0)
@@ -1265,6 +1270,7 @@ class TinyGamepad {
    * @param {string|string[]} physicalInput
    */
   mapInput(logicalName, physicalInput) {
+    checkDestroy(this.#isDestroyed);
     if (typeof logicalName !== 'string' || !logicalName.trim())
       throw new TypeError(`Invalid "logicalName": expected a non-empty string, got ${logicalName}`);
     if (!(
@@ -1282,6 +1288,7 @@ class TinyGamepad {
    * @param {string} logicalName
    */
   unmapInput(logicalName) {
+    checkDestroy(this.#isDestroyed);
     if (typeof logicalName !== 'string' || !logicalName.trim())
       throw new TypeError(`Invalid "logicalName": expected a non-empty string, got ${logicalName}`);
     this.#inputMap.delete(logicalName);
@@ -1293,6 +1300,7 @@ class TinyGamepad {
    * @returns {boolean}
    */
   hasMappedInput(logicalName) {
+    checkDestroy(this.#isDestroyed);
     if (typeof logicalName !== 'string' || !logicalName.trim())
       throw new TypeError(`Invalid "logicalName": expected a non-empty string, got ${logicalName}`);
     return this.#inputMap.has(logicalName);
@@ -1304,6 +1312,7 @@ class TinyGamepad {
    * @returns {string | string[]}
    */
   getMappedInput(logicalName) {
+    checkDestroy(this.#isDestroyed);
     if (typeof logicalName !== 'string' || !logicalName.trim())
       throw new TypeError(`Invalid "logicalName": expected a non-empty string, got ${logicalName}`);
     const result = this.#inputMap.get(logicalName);
@@ -1315,6 +1324,7 @@ class TinyGamepad {
    * Clears all mappings for all logical inputs.
    */
   clearMapInputs() {
+    checkDestroy(this.#isDestroyed);
     this.#inputMap.clear();
   }
 
@@ -1326,6 +1336,7 @@ class TinyGamepad {
    * @param {InputSequenceCallback} callback - Function to invoke when the sequence is fully held
    */
   registerInputSequence(sequence, callback) {
+    checkDestroy(this.#isDestroyed);
     if (!Array.isArray(sequence) || !sequence.every((s) => typeof s === 'string'))
       throw new TypeError(
         `'sequence' must be an array of strings, got: ${JSON.stringify(sequence)}`,
@@ -1342,6 +1353,7 @@ class TinyGamepad {
    * @param {string[]} sequence - The sequence to remove from detection
    */
   unregisterInputSequence(sequence) {
+    checkDestroy(this.#isDestroyed);
     if (!Array.isArray(sequence) || !sequence.every((s) => typeof s === 'string'))
       throw new TypeError(
         `'sequence' must be an array of strings, got: ${JSON.stringify(sequence)}`,
@@ -1354,6 +1366,7 @@ class TinyGamepad {
    * Removes all registered input sequences.
    */
   unregisterAllInputSequences() {
+    checkDestroy(this.#isDestroyed);
     this.#inputSequences.clear();
   }
 
@@ -1363,6 +1376,7 @@ class TinyGamepad {
    * @returns {boolean}
    */
   hasInputSequence(sequence) {
+    checkDestroy(this.#isDestroyed);
     if (!Array.isArray(sequence) || !sequence.every((s) => typeof s === 'string'))
       throw new TypeError(
         `'sequence' must be an array of strings, got: ${JSON.stringify(sequence)}`,
@@ -1379,6 +1393,7 @@ class TinyGamepad {
    * @param {InputSequenceCallback} callback - Function to invoke when the sequence is fully held
    */
   registerKeySequence(sequence, callback) {
+    checkDestroy(this.#isDestroyed);
     if (!Array.isArray(sequence) || !sequence.every((s) => typeof s === 'string'))
       throw new TypeError(
         `'sequence' must be an array of strings, got: ${JSON.stringify(sequence)}`,
@@ -1395,6 +1410,7 @@ class TinyGamepad {
    * @param {string[]} sequence - The sequence to remove from detection
    */
   unregisterKeySequence(sequence) {
+    checkDestroy(this.#isDestroyed);
     if (!Array.isArray(sequence) || !sequence.every((s) => typeof s === 'string'))
       throw new TypeError(
         `'sequence' must be an array of strings, got: ${JSON.stringify(sequence)}`,
@@ -1407,6 +1423,7 @@ class TinyGamepad {
    * Removes all registered input sequences.
    */
   unregisterAllKeySequences() {
+    checkDestroy(this.#isDestroyed);
     this.#keySequences.clear();
   }
 
@@ -1416,6 +1433,7 @@ class TinyGamepad {
    * @returns {boolean}
    */
   hasKeySequence(sequence) {
+    checkDestroy(this.#isDestroyed);
     if (!Array.isArray(sequence) || !sequence.every((s) => typeof s === 'string'))
       throw new TypeError(
         `'sequence' must be an array of strings, got: ${JSON.stringify(sequence)}`,
@@ -1430,6 +1448,7 @@ class TinyGamepad {
    * Renew the currently held combo logical keys.
    */
   renewComboMapped() {
+    checkDestroy(this.#isDestroyed);
     if (this.#intervalComboKeys) {
       clearTimeout(this.#intervalComboKeys);
       this.#intervalComboKeys = setTimeout(() => this.resetComboMapped(), this.#timeoutComboKeys);
@@ -1440,6 +1459,7 @@ class TinyGamepad {
    * Resets the currently held key combo logical inputs.
    */
   resetComboMapped() {
+    checkDestroy(this.#isDestroyed);
     if (this.#intervalComboKeys) clearTimeout(this.#intervalComboKeys);
     this.#comboKeys = [];
     this.#intervalComboKeys = null;
@@ -1455,6 +1475,7 @@ class TinyGamepad {
    * @param {MappedInputCallback} callback
    */
   onMappedKeyStart(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onTemplate('', callback, 'mapped-key-start');
   }
 
@@ -1464,6 +1485,7 @@ class TinyGamepad {
    * @param {MappedInputCallback} callback
    */
   onceMappedKeyStart(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onceTemplate('', callback, 'mapped-key-start');
   }
 
@@ -1472,6 +1494,7 @@ class TinyGamepad {
    * @param {MappedInputCallback} callback
    */
   prependMappedKeyStart(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#prependTemplate('', callback, 'mapped-key-start');
   }
 
@@ -1480,6 +1503,7 @@ class TinyGamepad {
    * @param {MappedInputCallback} callback
    */
   offMappedKeyStart(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#offTemplate('', callback, 'mapped-key-start');
   }
 
@@ -1487,6 +1511,7 @@ class TinyGamepad {
    * Removes all callbacks from the "mapped-key-start" event.
    */
   offAllMappedKeyStart() {
+    checkDestroy(this.#isDestroyed);
     this.#callbacks.delete('mapped-key-start');
   }
 
@@ -1497,6 +1522,7 @@ class TinyGamepad {
    * @param {MappedInputCallback} callback
    */
   onMappedKeyEnd(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onTemplate('', callback, 'mapped-key-end');
   }
 
@@ -1506,6 +1532,7 @@ class TinyGamepad {
    * @param {MappedInputCallback} callback
    */
   onceMappedKeyEnd(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onceTemplate('', callback, 'mapped-key-end');
   }
 
@@ -1514,6 +1541,7 @@ class TinyGamepad {
    * @param {MappedInputCallback} callback
    */
   prependMappedKeyEnd(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#prependTemplate('', callback, 'mapped-key-end');
   }
 
@@ -1522,6 +1550,7 @@ class TinyGamepad {
    * @param {MappedInputCallback} callback
    */
   offMappedKeyEnd(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#offTemplate('', callback, 'mapped-key-end');
   }
 
@@ -1529,6 +1558,7 @@ class TinyGamepad {
    * Removes all callbacks from the "mapped-key-end" event.
    */
   offAllMappedKeyEnd() {
+    checkDestroy(this.#isDestroyed);
     this.#callbacks.delete('mapped-key-end');
   }
 
@@ -1539,6 +1569,7 @@ class TinyGamepad {
    * @param {MappedInputCallback} callback
    */
   onMappedInputStart(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onTemplate('', callback, 'mapped-input-start');
   }
 
@@ -1548,6 +1579,7 @@ class TinyGamepad {
    * @param {MappedInputCallback} callback
    */
   onceMappedInputStart(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onceTemplate('', callback, 'mapped-input-start');
   }
 
@@ -1556,6 +1588,7 @@ class TinyGamepad {
    * @param {MappedInputCallback} callback
    */
   prependMappedInputStart(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#prependTemplate('', callback, 'mapped-input-start');
   }
 
@@ -1564,6 +1597,7 @@ class TinyGamepad {
    * @param {MappedInputCallback} callback
    */
   offMappedInputStart(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#offTemplate('', callback, 'mapped-input-start');
   }
 
@@ -1571,6 +1605,7 @@ class TinyGamepad {
    * Removes all callbacks from the "mapped-input-start" event.
    */
   offAllMappedInputStart() {
+    checkDestroy(this.#isDestroyed);
     this.#callbacks.delete('mapped-input-start');
   }
 
@@ -1581,6 +1616,7 @@ class TinyGamepad {
    * @param {MappedInputCallback} callback
    */
   onMappedInputEnd(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onTemplate('', callback, 'mapped-input-end');
   }
 
@@ -1590,6 +1626,7 @@ class TinyGamepad {
    * @param {MappedInputCallback} callback
    */
   onceMappedInputEnd(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onceTemplate('', callback, 'mapped-input-end');
   }
 
@@ -1598,6 +1635,7 @@ class TinyGamepad {
    * @param {MappedInputCallback} callback
    */
   prependMappedInputEnd(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#prependTemplate('', callback, 'mapped-input-end');
   }
 
@@ -1606,6 +1644,7 @@ class TinyGamepad {
    * @param {MappedInputCallback} callback
    */
   offMappedInputEnd(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#offTemplate('', callback, 'mapped-input-end');
   }
 
@@ -1613,6 +1652,7 @@ class TinyGamepad {
    * Removes all callbacks from the "mapped-input-end" event.
    */
   offAllMappedInputEnd() {
+    checkDestroy(this.#isDestroyed);
     this.#callbacks.delete('mapped-input-end');
   }
 
@@ -1624,6 +1664,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   onInput(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onTemplate(logicalName, callback, 'input-{logicalName}');
   }
 
@@ -1634,6 +1675,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   onceInput(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onceTemplate(logicalName, callback, 'input-{logicalName}');
   }
 
@@ -1643,6 +1685,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   prependInput(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#prependTemplate(logicalName, callback, 'input-{logicalName}');
   }
 
@@ -1652,6 +1695,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   offInput(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#offTemplate(logicalName, callback, 'input-{logicalName}');
   }
 
@@ -1663,6 +1707,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   onInputStart(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onTemplate(logicalName, callback, 'input-down-{logicalName}');
   }
 
@@ -1672,6 +1717,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   onceInputStart(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onceTemplate(logicalName, callback, 'input-down-{logicalName}');
   }
 
@@ -1681,6 +1727,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   prependInputStart(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#prependTemplate(logicalName, callback, 'input-down-{logicalName}');
   }
 
@@ -1690,6 +1737,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   offInputStart(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#offTemplate(logicalName, callback, 'input-down-{logicalName}');
   }
 
@@ -1701,6 +1749,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   onInputEnd(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onTemplate(logicalName, callback, 'input-up-{logicalName}');
   }
 
@@ -1710,6 +1759,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   onceInputEnd(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onceTemplate(logicalName, callback, 'input-up-{logicalName}');
   }
 
@@ -1719,6 +1769,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   prependInputEnd(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#prependTemplate(logicalName, callback, 'input-up-{logicalName}');
   }
 
@@ -1728,6 +1779,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   offInputEnd(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#offTemplate(logicalName, callback, 'input-up-{logicalName}');
   }
 
@@ -1739,6 +1791,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   onInputHold(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onTemplate(logicalName, callback, 'input-hold-{logicalName}');
   }
 
@@ -1748,6 +1801,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   onceInputHold(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onceTemplate(logicalName, callback, 'input-hold-{logicalName}');
   }
 
@@ -1757,6 +1811,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   prependInputHold(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#prependTemplate(logicalName, callback, 'input-hold-{logicalName}');
   }
 
@@ -1766,6 +1821,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   offInputHold(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#offTemplate(logicalName, callback, 'input-hold-{logicalName}');
   }
 
@@ -1777,6 +1833,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   onInputChange(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onTemplate(logicalName, callback, 'input-change-{logicalName}');
   }
 
@@ -1786,6 +1843,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   onceInputChange(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onceTemplate(logicalName, callback, 'input-change-{logicalName}');
   }
 
@@ -1795,6 +1853,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   prependInputChange(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#prependTemplate(logicalName, callback, 'input-change-{logicalName}');
   }
 
@@ -1804,6 +1863,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   offInputChange(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#offTemplate(logicalName, callback, 'input-change-{logicalName}');
   }
 
@@ -1815,6 +1875,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   onInputMove(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onTemplate(logicalName, callback, 'input-move-{logicalName}');
   }
 
@@ -1824,6 +1885,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   onceInputMove(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onceTemplate(logicalName, callback, 'input-move-{logicalName}');
   }
 
@@ -1833,6 +1895,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   prependInputMove(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#prependTemplate(logicalName, callback, 'input-move-{logicalName}');
   }
 
@@ -1842,6 +1905,7 @@ class TinyGamepad {
    * @param {PayloadCallback} callback
    */
   offInputMove(logicalName, callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#offTemplate(logicalName, callback, 'input-move-{logicalName}');
   }
 
@@ -1854,6 +1918,7 @@ class TinyGamepad {
    * @returns {Function[]}
    */
   getCalls(logicalName, type = 'all') {
+    checkDestroy(this.#isDestroyed);
     if (typeof logicalName !== 'string' || logicalName.trim() === '')
       throw new TypeError(`"logicalName" must be a non-empty string, received ${logicalName}`);
     const validTypes = ['all', 'start', 'end', 'hold', 'change', 'move'];
@@ -1878,6 +1943,7 @@ class TinyGamepad {
    * @param {'all'| 'start' | 'end' | 'hold' | 'change' | 'move'} [type='all']
    */
   offAllInputs(logicalName, type = 'all') {
+    checkDestroy(this.#isDestroyed);
     if (typeof logicalName !== 'string' || logicalName.trim() === '')
       throw new TypeError(`"logicalName" must be a non-empty string, received ${logicalName}`);
     const validTypes = ['all', 'start', 'end', 'hold', 'change', 'move'];
@@ -1901,6 +1967,7 @@ class TinyGamepad {
    * @returns {number}
    */
   getCallSize(logicalName, type = 'all') {
+    checkDestroy(this.#isDestroyed);
     if (typeof logicalName !== 'string' || logicalName.trim() === '')
       throw new TypeError(`"logicalName" must be a non-empty string, received ${logicalName}`);
     const validTypes = ['all', 'start', 'end', 'hold', 'change', 'move'];
@@ -1946,6 +2013,7 @@ class TinyGamepad {
    * @returns {{ type: GamepadHapticEffectType; params: GamepadEffectParameters; }} The default haptic effect settings.
    */
   get defaultHapticEffect() {
+    checkDestroy(this.#isDestroyed);
     return {
       type: this.#defaultHapticEffect.type,
       params: { ...this.#defaultHapticEffect.params },
@@ -1958,6 +2026,7 @@ class TinyGamepad {
    * @param {GamepadEffectParameters} params - Effect parameters.
    */
   setDefaultHapticEffect(type, params) {
+    checkDestroy(this.#isDestroyed);
     if (typeof type !== 'string')
       throw new TypeError(
         `"type" must be a valid GamepadHapticEffectType string, received ${type}`,
@@ -1973,6 +2042,7 @@ class TinyGamepad {
    * @returns {boolean}
    */
   hasHapticEffect() {
+    checkDestroy(this.#isDestroyed);
     const gp = this.#connectedGamepad;
     if (!gp) return false;
     const vibrationActuator = gp.vibrationActuator;
@@ -1987,6 +2057,7 @@ class TinyGamepad {
    * @returns {Promise<GamepadHapticsResult>}
    */
   vibrate(params, type) {
+    checkDestroy(this.#isDestroyed);
     if (params !== undefined && (typeof params !== 'object' || params === null))
       throw new TypeError(`"params" must be an object if provided, received ${params}`);
     if (type !== undefined && typeof type !== 'string')
@@ -2011,6 +2082,7 @@ class TinyGamepad {
    * @param {string} id
    */
   ignoreId(id) {
+    checkDestroy(this.#isDestroyed);
     if (typeof id !== 'string' || id.trim() === '')
       throw new TypeError(`"id" must be a non-empty string, received ${id}`);
     this.#ignoreIds.add(id);
@@ -2021,6 +2093,7 @@ class TinyGamepad {
    * @param {string} id
    */
   unignoreId(id) {
+    checkDestroy(this.#isDestroyed);
     if (typeof id !== 'string' || id.trim() === '')
       throw new TypeError(`"id" must be a non-empty string, received ${id}`);
     this.#ignoreIds.delete(id);
@@ -2031,6 +2104,7 @@ class TinyGamepad {
    * @param {ConnectionCallback} callback
    */
   onConnected(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onTemplate('', callback, 'connected');
   }
 
@@ -2040,6 +2114,7 @@ class TinyGamepad {
    * @param {ConnectionCallback} callback
    */
   onceConnected(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onceTemplate('', callback, 'connected');
   }
 
@@ -2048,6 +2123,7 @@ class TinyGamepad {
    * @param {ConnectionCallback} callback
    */
   prependConnected(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#prependTemplate('', callback, 'connected');
   }
 
@@ -2056,6 +2132,7 @@ class TinyGamepad {
    * @param {ConnectionCallback} callback
    */
   offConnected(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#offTemplate('', callback, 'connected');
   }
 
@@ -2063,6 +2140,7 @@ class TinyGamepad {
    * Removes all callbacks from the "connected" event.
    */
   offAllConnected() {
+    checkDestroy(this.#isDestroyed);
     this.#callbacks.delete('connected');
   }
 
@@ -2071,6 +2149,7 @@ class TinyGamepad {
    * @param {ConnectionCallback} callback
    */
   onDisconnected(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onTemplate('', callback, 'disconnected');
   }
 
@@ -2080,6 +2159,7 @@ class TinyGamepad {
    * @param {ConnectionCallback} callback
    */
   onceDisconnected(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#onceTemplate('', callback, 'disconnected');
   }
 
@@ -2088,6 +2168,7 @@ class TinyGamepad {
    * @param {ConnectionCallback} callback
    */
   prependDisconnected(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#prependTemplate('', callback, 'disconnected');
   }
 
@@ -2096,6 +2177,7 @@ class TinyGamepad {
    * @param {ConnectionCallback} callback
    */
   offDisconnected(callback) {
+    checkDestroy(this.#isDestroyed);
     return this.#offTemplate('', callback, 'disconnected');
   }
 
@@ -2103,6 +2185,7 @@ class TinyGamepad {
    * Removes all callbacks from the "disconnected" event.
    */
   offAllDisconnected() {
+    checkDestroy(this.#isDestroyed);
     this.#callbacks.delete('disconnected');
   }
 
@@ -2113,6 +2196,7 @@ class TinyGamepad {
    * @returns {boolean}
    */
   hasGamepad() {
+    checkDestroy(this.#isDestroyed);
     return this.#connectedGamepad instanceof Gamepad;
   }
 
@@ -2122,6 +2206,7 @@ class TinyGamepad {
    * @returns {Gamepad}
    */
   getGamepad() {
+    checkDestroy(this.#isDestroyed);
     if (!this.#connectedGamepad) throw new Error('No gamepad is currently connected.');
     return this.#connectedGamepad;
   }
@@ -2132,6 +2217,7 @@ class TinyGamepad {
    * @returns {boolean} True if a last state exists for the specified button index; otherwise, false.
    */
   hasLastButtonState(index) {
+    checkDestroy(this.#isDestroyed);
     if (!this.#lastButtonStates[index]) return false;
     return true;
   }
@@ -2144,6 +2230,7 @@ class TinyGamepad {
    * @throws {Error} If no last state exists for the specified button index.
    */
   getLastButtonState(index) {
+    checkDestroy(this.#isDestroyed);
     if (!this.#lastButtonStates[index])
       throw new Error(`No last button state found for index ${index}`);
     return { ...this.#lastButtonStates[index] };
@@ -2157,6 +2244,7 @@ class TinyGamepad {
    * @returns {ExportedConfig} The current configuration snapshot.
    */
   exportConfig() {
+    checkDestroy(this.#isDestroyed);
     return {
       expectedId: this.#expectedId,
       ignoreIds: Array.from(this.#ignoreIds),
@@ -2175,6 +2263,7 @@ class TinyGamepad {
    * or if any property has an incorrect type.
    */
   importConfig(json) {
+    checkDestroy(this.#isDestroyed);
     if (typeof json !== 'string' && (typeof json !== 'object' || json === null))
       throw new TypeError(`"json" must be a string or a non-null object, received: ${json}`);
 
@@ -2222,6 +2311,7 @@ class TinyGamepad {
    * @returns {MappedInputCallback[]}
    */
   get mappedKeyStartCalls() {
+    checkDestroy(this.#isDestroyed);
     /** @type {MappedInputCallback[]} */
     // @ts-ignore
     const list = this.#callbacks.get('mapped-key-start');
@@ -2233,6 +2323,7 @@ class TinyGamepad {
    * @returns {MappedInputCallback[]}
    */
   get mappedKeyEndCalls() {
+    checkDestroy(this.#isDestroyed);
     /** @type {MappedInputCallback[]} */
     // @ts-ignore
     const list = this.#callbacks.get('mapped-key-end');
@@ -2246,6 +2337,7 @@ class TinyGamepad {
    * @returns {string[]}
    */
   get comboMappedKeys() {
+    checkDestroy(this.#isDestroyed);
     return [...this.#comboKeys];
   }
 
@@ -2254,6 +2346,7 @@ class TinyGamepad {
    * @returns {string[]}
    */
   get comboMappedInputs() {
+    checkDestroy(this.#isDestroyed);
     return [...this.#comboInputs];
   }
 
@@ -2264,6 +2357,7 @@ class TinyGamepad {
    * @returns {number}
    */
   get keySequenceSize() {
+    checkDestroy(this.#isDestroyed);
     return this.#keySequences.size;
   }
 
@@ -2272,6 +2366,7 @@ class TinyGamepad {
    * @returns {InputSequenceCallback[]}
    */
   get keySequences() {
+    checkDestroy(this.#isDestroyed);
     const result = [];
     for (const [, data] of this.#keySequences.entries()) result.push(data.callback);
     return result;
@@ -2282,6 +2377,7 @@ class TinyGamepad {
    * @returns {string[]}
    */
   get activeMappedKeys() {
+    checkDestroy(this.#isDestroyed);
     return [...this.#activeMappedKeys];
   }
 
@@ -2292,6 +2388,7 @@ class TinyGamepad {
    * @returns {MappedInputCallback[]}
    */
   get mappedInputStartCalls() {
+    checkDestroy(this.#isDestroyed);
     /** @type {MappedInputCallback[]} */
     // @ts-ignore
     const list = this.#callbacks.get('mapped-input-start');
@@ -2303,6 +2400,7 @@ class TinyGamepad {
    * @returns {MappedInputCallback[]}
    */
   get mappedInputEndCalls() {
+    checkDestroy(this.#isDestroyed);
     /** @type {MappedInputCallback[]} */
     // @ts-ignore
     const list = this.#callbacks.get('mapped-input-end');
@@ -2316,6 +2414,7 @@ class TinyGamepad {
    * @returns {number}
    */
   get inputSequenceSize() {
+    checkDestroy(this.#isDestroyed);
     return this.#inputSequences.size;
   }
 
@@ -2324,6 +2423,7 @@ class TinyGamepad {
    * @returns {InputSequenceCallback[]}
    */
   get inputSequences() {
+    checkDestroy(this.#isDestroyed);
     const result = [];
     for (const [, data] of this.#inputSequences.entries()) result.push(data.callback);
     return result;
@@ -2334,6 +2434,7 @@ class TinyGamepad {
    * @returns {string[]}
    */
   get activeMappedInputs() {
+    checkDestroy(this.#isDestroyed);
     return [...this.#activeMappedInputs];
   }
 
@@ -2344,6 +2445,7 @@ class TinyGamepad {
    * @returns {{ [logicalName: string]: string | string[] }}
    */
   get mappedInputs() {
+    checkDestroy(this.#isDestroyed);
     /** @type {{ [logicalName: string]: string | string[] }} */
     const result = {};
     for (const [logicalName, physicalInput] of this.#inputMap.entries()) {
@@ -2357,6 +2459,7 @@ class TinyGamepad {
    * @returns {number}
    */
   get mappedInputSize() {
+    checkDestroy(this.#isDestroyed);
     return this.#inputMap.size;
   }
 
@@ -2367,6 +2470,7 @@ class TinyGamepad {
    * @returns {ConnectionCallback[]}
    */
   get connectedCalls() {
+    checkDestroy(this.#isDestroyed);
     /** @type {ConnectionCallback[]} */
     // @ts-ignore
     const list = this.#callbacks.get('connected');
@@ -2378,6 +2482,7 @@ class TinyGamepad {
    * @returns {ConnectionCallback[]}
    */
   get disconnectedCalls() {
+    checkDestroy(this.#isDestroyed);
     /** @type {ConnectionCallback[]} */
     // @ts-ignore
     const list = this.#callbacks.get('disconnected');
@@ -2391,6 +2496,7 @@ class TinyGamepad {
    * @returns {string[]}
    */
   get ignoredDeviceIds() {
+    checkDestroy(this.#isDestroyed);
     return [...this.#ignoreIds];
   }
 
@@ -2399,6 +2505,7 @@ class TinyGamepad {
    * @returns {string[]}
    */
   get heldKeys() {
+    checkDestroy(this.#isDestroyed);
     return [...this.#heldKeys];
   }
 
@@ -2409,6 +2516,7 @@ class TinyGamepad {
    * @returns {number}
    */
   get eventsSize() {
+    checkDestroy(this.#isDestroyed);
     let total = 0;
     this.#callbacks.forEach((values) => {
       total += values.length;
@@ -2421,6 +2529,7 @@ class TinyGamepad {
    * @returns {number}
    */
   get callSize() {
+    checkDestroy(this.#isDestroyed);
     return this.#callbacks.size;
   }
 
@@ -2429,6 +2538,7 @@ class TinyGamepad {
    * @returns {number}
    */
   get connectedCallSize() {
+    checkDestroy(this.#isDestroyed);
     const list = this.#callbacks.get('connected');
     return Array.isArray(list) ? list.length : 0;
   }
@@ -2438,6 +2548,7 @@ class TinyGamepad {
    * @returns {number}
    */
   get disconnectedCallSize() {
+    checkDestroy(this.#isDestroyed);
     const list = this.#callbacks.get('disconnected');
     return Array.isArray(list) ? list.length : 0;
   }
@@ -2447,6 +2558,7 @@ class TinyGamepad {
    * @returns {number}
    */
   get mappedKeyStartCallSize() {
+    checkDestroy(this.#isDestroyed);
     const list = this.#callbacks.get('mapped-key-start');
     return Array.isArray(list) ? list.length : 0;
   }
@@ -2456,6 +2568,7 @@ class TinyGamepad {
    * @returns {number}
    */
   get mappedKeyEndCallSize() {
+    checkDestroy(this.#isDestroyed);
     const list = this.#callbacks.get('mapped-key-end');
     return Array.isArray(list) ? list.length : 0;
   }
@@ -2465,6 +2578,7 @@ class TinyGamepad {
    * @returns {number}
    */
   get mappedInputStartCallSize() {
+    checkDestroy(this.#isDestroyed);
     const list = this.#callbacks.get('mapped-input-start');
     return Array.isArray(list) ? list.length : 0;
   }
@@ -2474,6 +2588,7 @@ class TinyGamepad {
    * @returns {number}
    */
   get mappedInputEndCallSize() {
+    checkDestroy(this.#isDestroyed);
     const list = this.#callbacks.get('mapped-input-end');
     return Array.isArray(list) ? list.length : 0;
   }
@@ -2486,6 +2601,7 @@ class TinyGamepad {
    * @returns {KeyStatus[]} An array of button states from the last poll.
    */
   get lastButtonStates() {
+    checkDestroy(this.#isDestroyed);
     /** @type {KeyStatus[]} */
     const results = [];
     this.#lastButtonStates.forEach((value) => {
@@ -2500,6 +2616,7 @@ class TinyGamepad {
    * @returns {number[]} An array of axis values from the last poll.
    */
   get lastAxes() {
+    checkDestroy(this.#isDestroyed);
     return [...this.#lastAxes];
   }
 
@@ -2510,6 +2627,7 @@ class TinyGamepad {
    * @returns {InputMode}
    */
   get inputMode() {
+    checkDestroy(this.#isDestroyed);
     return this.#inputMode;
   }
 
@@ -2518,6 +2636,7 @@ class TinyGamepad {
    * @returns {Window|Element}
    */
   get elementBase() {
+    checkDestroy(this.#isDestroyed);
     return this.#elementBase;
   }
 
@@ -2526,6 +2645,7 @@ class TinyGamepad {
    * @returns {number}
    */
   get timeComboInputs() {
+    checkDestroy(this.#isDestroyed);
     return this.#timeComboInputs;
   }
 
@@ -2534,6 +2654,7 @@ class TinyGamepad {
    * @returns {number}
    */
   get timeComboKeys() {
+    checkDestroy(this.#isDestroyed);
     return this.#timeComboKeys;
   }
 
@@ -2542,6 +2663,7 @@ class TinyGamepad {
    * @returns {number}
    */
   get timeMappedInputs() {
+    checkDestroy(this.#isDestroyed);
     return this.#timeMappedInputs;
   }
 
@@ -2550,6 +2672,7 @@ class TinyGamepad {
    * @returns {number}
    */
   get timeoutComboKeys() {
+    checkDestroy(this.#isDestroyed);
     return this.#timeoutComboKeys;
   }
 
@@ -2559,6 +2682,7 @@ class TinyGamepad {
    * @param {number} value
    */
   set timeoutComboKeys(value) {
+    checkDestroy(this.#isDestroyed);
     if (typeof value !== 'number' || value < 0 || !Number.isFinite(value))
       throw new TypeError('Timeout combo keys must be a non-negative finite number.');
     this.#timeoutComboKeys = value;
@@ -2573,6 +2697,7 @@ class TinyGamepad {
    * @returns {number} The current axis activity sensitivity (between 0 and 1).
    */
   get axisActiveSensitivity() {
+    checkDestroy(this.#isDestroyed);
     return this.#axisActiveSensitivity;
   }
 
@@ -2586,6 +2711,7 @@ class TinyGamepad {
    * @param {number} value - The new sensitivity value between 0 and 1.
    */
   set axisActiveSensitivity(value) {
+    checkDestroy(this.#isDestroyed);
     if (typeof value !== 'number' || value < 0 || value > 1)
       throw new RangeError('Axis sensitivity must be a number between 0 and 1.');
     this.#axisActiveSensitivity = value;
@@ -2596,6 +2722,7 @@ class TinyGamepad {
    * @returns {number}
    */
   get deadZone() {
+    checkDestroy(this.#isDestroyed);
     return this.#deadZone;
   }
 
@@ -2605,6 +2732,7 @@ class TinyGamepad {
    * @param {number} value
    */
   set deadZone(value) {
+    checkDestroy(this.#isDestroyed);
     if (typeof value !== 'number' || value < 0 || value > 1)
       throw new RangeError('Dead zone must be a number between 0 and 1.');
     this.#deadZone = value;
@@ -2615,6 +2743,7 @@ class TinyGamepad {
    * @returns {string|null}
    */
   get expectedId() {
+    checkDestroy(this.#isDestroyed);
     return this.#expectedId;
   }
 
@@ -2623,6 +2752,7 @@ class TinyGamepad {
    * @returns {string}
    */
   set expectedId(value) {
+    checkDestroy(this.#isDestroyed);
     if (typeof value !== 'string') throw new TypeError('Expected device id be a string.');
     this.#expectedId = value;
   }
@@ -2643,7 +2773,6 @@ class TinyGamepad {
    */
   destroy() {
     if (this.#isDestroyed) return;
-    this.#isDestroyed = true;
 
     if (this.#animationFrame) cancelAnimationFrame(this.#animationFrame);
     if (this.#mouseKeyboardHoldLoop) cancelAnimationFrame(this.#mouseKeyboardHoldLoop);
@@ -2682,6 +2811,7 @@ class TinyGamepad {
     this.#expectedId = null;
     this.#allowMouse = false;
     this.#timeMappedInputs = 0;
+    this.#isDestroyed = true;
   }
 }