tiny-essentials 1.27.1 → 1.28.1

package/dist/v1/libs/TinyToastNotify.mjs

@@ -1,3 +1,5 @@
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyToastNotify');
 /**
  * A callback function used to manually close a notification.
  * Passed as a second argument to `onClick` handlers, allowing programmatic dismissal of the toast.
@@ -44,6 +46,19 @@ class TinyToastNotify {
     #fadeOutDuration;
     /** @type {HTMLElement|null} */
     #container;
+    /**
+     * Tracks whether the instance has been destroyed.
+     * @type {boolean}
+     */
+    #destroyed = false;
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed() {
+        return this.#destroyed;
+    }
     /**
      * @param {'top'|'bottom'} y - 'top' or 'bottom'
      * @param {'right'|'left'|'center'} x - 'right', 'left', or 'center'
@@ -80,6 +95,7 @@ class TinyToastNotify {
      * @throws {Error} If the container is not a valid HTMLElement.
      */
     getContainer() {
+        checkDestroy(this.#destroyed);
         if (!(this.#container instanceof HTMLElement))
             throw new Error('Container is not a valid HTMLElement.');
         return this.#container;
@@ -127,6 +143,7 @@ class TinyToastNotify {
      * @returns {'top'|'bottom'} The vertical direction of the notification container.
      */
     getY() {
+        checkDestroy(this.#destroyed);
         return this.#y;
     }
     /**
@@ -137,6 +154,7 @@ class TinyToastNotify {
      * @throws {Error} If the value is invalid.
      */
     setY(value) {
+        checkDestroy(this.#destroyed);
         this.#validateY(value);
         const container = this.getContainer();
         container.classList.remove(this.#y);
@@ -149,6 +167,7 @@ class TinyToastNotify {
      * @returns {'left'|'right'|'center'} The horizontal direction of the notification container.
      */
     getX() {
+        checkDestroy(this.#destroyed);
         return this.#x;
     }
     /**
@@ -159,6 +178,7 @@ class TinyToastNotify {
      * @throws {Error} If the value is invalid.
      */
     setX(value) {
+        checkDestroy(this.#destroyed);
         this.#validateX(value);
         const container = this.getContainer();
         container.classList.remove(this.#x);
@@ -171,6 +191,7 @@ class TinyToastNotify {
      * @returns {number} Base time (in milliseconds) that a notification stays on screen.
      */
     getBaseDuration() {
+        checkDestroy(this.#destroyed);
         return this.#baseDuration;
     }
     /**
@@ -180,6 +201,7 @@ class TinyToastNotify {
      * @throws {Error} If the value is not a valid non-negative finite number.
      */
     setBaseDuration(value) {
+        checkDestroy(this.#destroyed);
         this.#validateTiming(value, 'baseDuration');
         this.#baseDuration = value;
     }
@@ -189,6 +211,7 @@ class TinyToastNotify {
      * @returns {number} Extra time (in milliseconds) per character in the notification.
      */
     getExtraPerChar() {
+        checkDestroy(this.#destroyed);
         return this.#extraPerChar;
     }
     /**
@@ -198,6 +221,7 @@ class TinyToastNotify {
      * @throws {Error} If the value is not a valid non-negative finite number.
      */
     setExtraPerChar(value) {
+        checkDestroy(this.#destroyed);
         this.#validateTiming(value, 'extraPerChar');
         this.#extraPerChar = value;
     }
@@ -207,6 +231,7 @@ class TinyToastNotify {
      * @returns {number} Time (in milliseconds) used for fade-out transition.
      */
     getFadeOutDuration() {
+        checkDestroy(this.#destroyed);
         return this.#fadeOutDuration;
     }
     /**
@@ -216,6 +241,7 @@ class TinyToastNotify {
      * @throws {Error} If the value is not a valid non-negative finite number.
      */
     setFadeOutDuration(value) {
+        checkDestroy(this.#destroyed);
         this.#validateTiming(value, 'fadeOutDuration');
         this.#fadeOutDuration = value;
     }
@@ -233,6 +259,7 @@ class TinyToastNotify {
      * @param {NotifyData} data
      */
     show(data) {
+        checkDestroy(this.#destroyed);
         let message = '';
         let title = '';
         let onClick = null;
@@ -337,6 +364,8 @@ class TinyToastNotify {
      * @returns {void}
      */
     destroy() {
+        if (this.#destroyed)
+            return;
         if (!(this.#container instanceof HTMLElement))
             return;
         // Remove all child notifications
@@ -347,6 +376,8 @@ class TinyToastNotify {
         }
         // Optional: Clean internal references (safe practice)
         this.#container = null;
+        // Lock the instance
+        this.#destroyed = true;
     }
 }
 export default TinyToastNotify;

package/dist/v1/libs/TinyUploadClicker.cjs

@@ -6,6 +6,7 @@ require('fs');
 require('path');
 require('fs/promises');
 require('./TinyHtml.cjs');
+require('events');
 require('./TinyLocalStorage.cjs');
 require('./TinyColorValidator.cjs');
 
@@ -63,6 +64,21 @@ require('./TinyColorValidator.cjs');
  * uploader.destroy();
  */
 class TinyUploadClicker {
+  /**
+   * Tracks whether the instance has been destroyed.
+   * @type {boolean}
+   */
+  #destroyed = false;
+
+  /**
+   * Gets the current destruction status of the instance.
+   *
+   * @returns {boolean} True if the instance is destroyed, false otherwise.
+   */
+  get destroyed() {
+    return this.#destroyed;
+  }
+
   /** @type {UploaderConfig} */
   #config;
 
@@ -211,6 +227,7 @@ class TinyUploadClicker {
    * Cleans up all internal elements and event listeners, removing created inputs and breaking references.
    */
   destroy() {
+    if (this.destroyed) return;
     for (const trigger of this.#triggerElements) {
       if (!(trigger instanceof HTMLElement)) return;
       trigger.removeEventListener('click', this.#boundClick);
@@ -222,6 +239,9 @@ class TinyUploadClicker {
     }
 
     this.#triggerElements = [];
+
+    // Lock the instance
+    this.#destroyed = true;
   }
 }
 

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

@@ -71,6 +71,12 @@ declare class TinyUploadClicker {
      * @throws {TypeError} If the config is invalid or required options are missing.
      */
     constructor(options: UploaderConfig);
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed(): boolean;
     /**
      * Cleans up all internal elements and event listeners, removing created inputs and breaking references.
      */

package/dist/v1/libs/TinyUploadClicker.mjs

@@ -51,6 +51,19 @@ import { isJsonObject } from '../index.mjs';
  * uploader.destroy();
  */
 class TinyUploadClicker {
+    /**
+     * Tracks whether the instance has been destroyed.
+     * @type {boolean}
+     */
+    #destroyed = false;
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed() {
+        return this.#destroyed;
+    }
     /** @type {UploaderConfig} */
     #config;
     /** @type {Array<HTMLElement|Element|null>} */
@@ -167,6 +180,8 @@ class TinyUploadClicker {
      * Cleans up all internal elements and event listeners, removing created inputs and breaking references.
      */
     destroy() {
+        if (this.destroyed)
+            return;
         for (const trigger of this.#triggerElements) {
             if (!(trigger instanceof HTMLElement))
                 return;
@@ -177,6 +192,8 @@ class TinyUploadClicker {
             this.#inputs.delete(trigger);
         }
         this.#triggerElements = [];
+        // Lock the instance
+        this.#destroyed = true;
     }
 }
 export default TinyUploadClicker;

package/dist/v1/libs/UltraRandomMsgGen.cjs

@@ -1,5 +1,9 @@
 'use strict';
 
+var utils = require('./utils.cjs');
+
+const checkDestroy = utils.createCheckDestroyed('UltraRandomMsgGen');
+
 const defaultWords = [
   'lorem',
   'ipsum',
@@ -53,6 +57,33 @@ const defaultEmojis = [
   '🎮',
   '🥓',
   '🍮',
+  '🍬',
+  '🍓',
+  '🍒',
+  '🥝',
+  '🥑',
+  '🍄',
+  '🌊',
+  '☁️',
+  '🌟',
+  '🌙',
+  '🧚',
+  '🐾',
+  '🐥',
+  '🐼',
+  '🐨',
+  '🐳',
+  '✨',
+  '🧁',
+  '🌸',
+  '🍃',
+  '💎',
+  '🎐',
+  '🎀',
+  '🫧',
+  '☄️',
+  '🛸',
+  '🔮',
 ];
 
 const defaultNouns = [
@@ -248,6 +279,16 @@ const defaultTemplates = [
   'I trusted the {noun} and all I got was a glitter-covered sock.',
   'Plot twist: the {adj} {noun} was inside us all along.',
 
+  // ✨ Magical/Dreamy (New Category)
+  'In the glow of the {adj} moon, the {noun} began to {verb}.',
+  'A sprinkle of {adj} dust made the {noun} {verb} through the air.',
+  'The {noun} whispered a {adj} secret that made everyone {verb}.',
+  'Everything felt {adj} and {adj}, especially when the {noun} {verb}ed.',
+
+  // 🌀 Chaos/Glitch (New Category)
+  'The {noun} is {verb}ing! The {noun} is {verb}ing! AAAAA!',
+  'Glitch in the {noun}: the {adj} {noun} just {verb}ed out of existence.',
+
   // Mini cute explosions and chaos
   'The {adj} {noun} {verb} and {verb} all over the {adj} {noun}!',
   'Oops! {noun}s {verb}ed into the {adj} {noun} while {verb}ing crazily.',
@@ -461,8 +502,23 @@ class UltraRandomMsgGen {
     this.#defaultTemplates = [...value];
   }
 
+  /**
+   * Tracks whether the instance has been destroyed.
+   * @type {boolean}
+   */
+  #destroyed = false;
+
+  /**
+   * Gets the current destruction status of the instance.
+   *
+   * @returns {boolean} True if the instance is destroyed, false otherwise.
+   */
+  get destroyed() {
+    return this.#destroyed;
+  }
+
   /** @type {MsgGenConfig} */
-  config = {
+  #config = {
     minLength: 10,
     maxLength: 300,
     readable: true,
@@ -488,6 +544,18 @@ class UltraRandomMsgGen {
     },
   };
 
+  get config() {
+    checkDestroy(this.#destroyed);
+    return structuredClone(this.#config);
+  }
+
+  #symbols = '!@#$%^&*()-_=+[]{}|;:,.<>?/\\~'.split('');
+
+  get symbols() {
+    checkDestroy(this.#destroyed);
+    return structuredClone(this.#symbols);
+  }
+
   /**
    * Creates an instance of UltraRandomMsgGen.
    *
@@ -518,8 +586,6 @@ class UltraRandomMsgGen {
    * @param {number} [config.line.emojiChance=0.3] - Probability (0–1) of placing emoji per line.
    */
   constructor(config = {}) {
-    this.symbols = '!@#$%^&*()-_=+[]{}|;:,.<>?/\\~'.split('');
-
     const {
       minLength,
       maxLength,
@@ -648,14 +714,14 @@ class UltraRandomMsgGen {
       }
     }
 
-    this.config.emojiSet = [...UltraRandomMsgGen.#defaultEmojis];
-    this.config.wordSet = [...UltraRandomMsgGen.#defaultWords];
+    this.#config.emojiSet = [...UltraRandomMsgGen.#defaultEmojis];
+    this.#config.wordSet = [...UltraRandomMsgGen.#defaultWords];
 
-    this.config.grammar.templates = [...UltraRandomMsgGen.#defaultTemplates];
-    this.config.grammar.nouns = [...UltraRandomMsgGen.#defaultNouns];
-    this.config.grammar.verbs = [...UltraRandomMsgGen.#defaultVerbs];
-    this.config.grammar.adjectives = [...UltraRandomMsgGen.#defaultAdjectives];
-    Object.assign(this.config, config);
+    this.#config.grammar.templates = [...UltraRandomMsgGen.#defaultTemplates];
+    this.#config.grammar.nouns = [...UltraRandomMsgGen.#defaultNouns];
+    this.#config.grammar.verbs = [...UltraRandomMsgGen.#defaultVerbs];
+    this.#config.grammar.adjectives = [...UltraRandomMsgGen.#defaultAdjectives];
+    Object.assign(this.#config, config);
   }
 
   /**
@@ -664,7 +730,8 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   configure(newConfig = {}) {
-    Object.assign(this.config, newConfig);
+    checkDestroy(this.#destroyed);
+    Object.assign(this.#config, newConfig);
     return this;
   }
 
@@ -674,7 +741,8 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   setGrammarTemplates(...templates) {
-    this.config.grammar.templates = templates.flat();
+    checkDestroy(this.#destroyed);
+    this.#config.grammar.templates = templates.flat();
     return this;
   }
 
@@ -684,7 +752,8 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   addGrammarTemplates(...templates) {
-    this.config.grammar.templates.push(...templates.flat());
+    checkDestroy(this.#destroyed);
+    this.#config.grammar.templates.push(...templates.flat());
     return this;
   }
 
@@ -694,7 +763,8 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   setGrammarNouns(...nouns) {
-    this.config.grammar.nouns = nouns.flat();
+    checkDestroy(this.#destroyed);
+    this.#config.grammar.nouns = nouns.flat();
     return this;
   }
 
@@ -704,7 +774,8 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   addGrammarNouns(...nouns) {
-    this.config.grammar.nouns.push(...nouns.flat());
+    checkDestroy(this.#destroyed);
+    this.#config.grammar.nouns.push(...nouns.flat());
     return this;
   }
 
@@ -714,7 +785,8 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   setGrammarVerbs(...verbs) {
-    this.config.grammar.verbs = verbs.flat();
+    checkDestroy(this.#destroyed);
+    this.#config.grammar.verbs = verbs.flat();
     return this;
   }
 
@@ -724,7 +796,8 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   addGrammarVerbs(...verbs) {
-    this.config.grammar.verbs.push(...verbs.flat());
+    checkDestroy(this.#destroyed);
+    this.#config.grammar.verbs.push(...verbs.flat());
     return this;
   }
 
@@ -734,7 +807,8 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   setGrammarAdjectives(...adjectives) {
-    this.config.grammar.adjectives = adjectives.flat();
+    checkDestroy(this.#destroyed);
+    this.#config.grammar.adjectives = adjectives.flat();
     return this;
   }
 
@@ -744,7 +818,8 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   addGrammarAdjectives(...adjectives) {
-    this.config.grammar.adjectives.push(...adjectives.flat());
+    checkDestroy(this.#destroyed);
+    this.#config.grammar.adjectives.push(...adjectives.flat());
     return this;
   }
 
@@ -754,8 +829,11 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   removeGrammarTemplates(...templates) {
+    checkDestroy(this.#destroyed);
     const removeSet = new Set(templates.flat());
-    this.config.grammar.templates = this.config.grammar.templates.filter((t) => !removeSet.has(t));
+    this.#config.grammar.templates = this.#config.grammar.templates.filter(
+      (t) => !removeSet.has(t),
+    );
     return this;
   }
 
@@ -765,8 +843,9 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   removeGrammarNouns(...nouns) {
+    checkDestroy(this.#destroyed);
     const removeSet = new Set(nouns.flat());
-    this.config.grammar.nouns = this.config.grammar.nouns.filter((n) => !removeSet.has(n));
+    this.#config.grammar.nouns = this.#config.grammar.nouns.filter((n) => !removeSet.has(n));
     return this;
   }
 
@@ -776,8 +855,9 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   removeGrammarVerbs(...verbs) {
+    checkDestroy(this.#destroyed);
     const removeSet = new Set(verbs.flat());
-    this.config.grammar.verbs = this.config.grammar.verbs.filter((v) => !removeSet.has(v));
+    this.#config.grammar.verbs = this.#config.grammar.verbs.filter((v) => !removeSet.has(v));
     return this;
   }
 
@@ -787,8 +867,9 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   removeGrammarAdjectives(...adjectives) {
+    checkDestroy(this.#destroyed);
     const removeSet = new Set(adjectives.flat());
-    this.config.grammar.adjectives = this.config.grammar.adjectives.filter(
+    this.#config.grammar.adjectives = this.#config.grammar.adjectives.filter(
       (a) => !removeSet.has(a),
     );
     return this;
@@ -800,7 +881,8 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   setWords(...words) {
-    this.config.wordSet = words.flat();
+    checkDestroy(this.#destroyed);
+    this.#config.wordSet = words.flat();
     return this;
   }
 
@@ -810,7 +892,8 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   addWords(...words) {
-    this.config.wordSet.push(...words.flat());
+    checkDestroy(this.#destroyed);
+    this.#config.wordSet.push(...words.flat());
     return this;
   }
 
@@ -820,8 +903,9 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   removeWords(...words) {
+    checkDestroy(this.#destroyed);
     const removeSet = new Set(words.flat());
-    this.config.wordSet = this.config.wordSet.filter((word) => !removeSet.has(word));
+    this.#config.wordSet = this.#config.wordSet.filter((word) => !removeSet.has(word));
     return this;
   }
 
@@ -831,7 +915,8 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   setEmojis(...emojis) {
-    this.config.emojiSet = emojis.flat();
+    checkDestroy(this.#destroyed);
+    this.#config.emojiSet = emojis.flat();
     return this;
   }
 
@@ -841,7 +926,8 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   addEmojis(...emojis) {
-    this.config.emojiSet.push(...emojis.flat());
+    checkDestroy(this.#destroyed);
+    this.#config.emojiSet.push(...emojis.flat());
     return this;
   }
 
@@ -851,8 +937,9 @@ class UltraRandomMsgGen {
    * @returns {this} - The instance for chaining.
    */
   removeEmojis(...emojis) {
+    checkDestroy(this.#destroyed);
     const removeSet = new Set(emojis.flat());
-    this.config.emojiSet = this.config.emojiSet.filter((emoji) => !removeSet.has(emoji));
+    this.#config.emojiSet = this.#config.emojiSet.filter((emoji) => !removeSet.has(emoji));
     return this;
   }
 
@@ -881,7 +968,7 @@ class UltraRandomMsgGen {
       readable,
       mode,
       emojiPlacement,
-    } = this.config;
+    } = this.#config;
 
     if (mode === 'natural') {
       return this._generateNaturalSentence();
@@ -902,7 +989,7 @@ class UltraRandomMsgGen {
     }
 
     if (includeSymbols) {
-      pools.push(this._getRandomItem(this.symbols));
+      pools.push(this._getRandomItem(this.#symbols));
     }
 
     if (emojiPlacement === 'inline' && useEmojis && emojiSet.length) {
@@ -918,7 +1005,7 @@ class UltraRandomMsgGen {
    * @returns {string} - A generated sentence.
    */
   _generateNaturalSentence() {
-    const { templates, nouns, verbs, adjectives } = this.config.grammar;
+    const { templates, nouns, verbs, adjectives } = this.#config.grammar;
 
     let template = this._getRandomItem(templates);
 
@@ -937,7 +1024,7 @@ class UltraRandomMsgGen {
    */
   _generateLine(targetLength, seenWords) {
     const { allowWeirdSpacing, repeatWords, readable, emojiSet, useEmojis, emojiPlacement, line } =
-      this.config;
+      this.#config;
 
     const parts = [];
     seenWords ??= new Set();
@@ -978,7 +1065,7 @@ class UltraRandomMsgGen {
    * @returns {string[]} - Array of lines that form the paragraph.
    */
   _generateParagraphLines(totalLength) {
-    const { line } = this.config;
+    const { line } = this.#config;
     const lines = [];
     const seenWords = new Set();
     let currentTotal = 0;
@@ -1003,7 +1090,8 @@ class UltraRandomMsgGen {
    * @returns {string} - A full generated message.
    */
   generate() {
-    const { minLength, maxLength, paragraphs } = this.config;
+    checkDestroy(this.#destroyed);
+    const { minLength, maxLength, paragraphs } = this.#config;
 
     const totalLength = Math.floor(Math.random() * (maxLength - minLength + 1)) + minLength;
 
@@ -1023,6 +1111,31 @@ class UltraRandomMsgGen {
 
     return this._generateParagraphLines(totalLength).join('\n');
   }
+
+  /**
+   * Safely destroys the instance by clearing references to aid garbage collection.
+   * Once destroyed, the instance cannot be used to generate new messages.
+   *
+   * @throws {Error} If the instance has already been destroyed.
+   * @returns {void}
+   */
+  destroy() {
+    if (this.destroyed) return;
+
+    // Clear primary memory references
+    this.#symbols = [];
+
+    this.#config.emojiSet = [];
+    this.#config.wordSet = [];
+
+    this.#config.grammar.templates = [];
+    this.#config.grammar.nouns = [];
+    this.#config.grammar.verbs = [];
+    this.#config.grammar.adjectives = [];
+
+    // Lock the instance
+    this.#destroyed = true;
+  }
 }
 
 module.exports = UltraRandomMsgGen;

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

@@ -259,9 +259,14 @@ declare class UltraRandomMsgGen {
             emojiChance?: number | undefined;
         } | undefined;
     });
-    /** @type {MsgGenConfig} */
-    config: MsgGenConfig;
-    symbols: string[];
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed(): boolean;
+    get config(): MsgGenConfig;
+    get symbols(): string[];
     /**
      * Merges new configuration values into the current instance.
      * @param {Object} newConfig - Object with one or more configuration overrides.
@@ -416,5 +421,14 @@ declare class UltraRandomMsgGen {
      * @returns {string} - A full generated message.
      */
     generate(): string;
+    /**
+     * Safely destroys the instance by clearing references to aid garbage collection.
+     * Once destroyed, the instance cannot be used to generate new messages.
+     *
+     * @throws {Error} If the instance has already been destroyed.
+     * @returns {void}
+     */
+    destroy(): void;
+    #private;
 }
 //# sourceMappingURL=UltraRandomMsgGen.d.mts.map