tiny-essentials 1.28.0 → 1.28.2

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

@@ -1,22 +1,5 @@
-export default UltraRandomMsgGen;
-/**
- * Defines how the message content is generated:
- * - `mixed`: Combines readable words, gibberish, symbols, emojis, etc.
- * - `readable`: Focuses on human-readable words only.
- * - `chaotic`: Pure chaos, mostly gibberish and symbols.
- * - `natural`: Uses structured grammar templates to form silly but proper sentences.
- */
-export type RandomMsgModes = "mixed" | "readable" | "chaotic" | "natural";
-/**
- * Controls where emojis are placed:
- * - `inline`: Emojis may appear throughout the text.
- * - `end`: Emojis appear at the end of lines.
- * - `none`: No emojis will be used.
- */
-export type EmojiPlacement = "inline" | "end" | "none";
-/**
- * Configuration object for customizing message generation.
- */
+export type RandomMsgModes = 'mixed' | 'readable' | 'chaotic' | 'natural';
+export type EmojiPlacement = 'inline' | 'end' | 'none';
 export type MsgGenConfig = {
     /**
      * - Minimum total length (in characters) of the final generated text.
@@ -79,15 +62,9 @@ export type MsgGenConfig = {
      * - Optional paragraph configuration.
      */
     paragraphs?: {
-        /**
-         * - Minimum number of paragraphs to generate.
-         */
         min: number;
-        /**
-         * - Maximum number of paragraphs to generate.
-         */
         max: number;
-    } | undefined;
+    };
     /**
      * - Configuration for line-based generation.
      */
@@ -159,48 +136,39 @@ export type MsgGenConfig = {
  * @class
  */
 declare class UltraRandomMsgGen {
-    /** @type {string[]} */
-    static #defaultWords: string[];
-    /** @type {string[]} */
-    static #defaultEmojis: string[];
-    /** @type {string[]} */
-    static #defaultNouns: string[];
-    /** @type {string[]} */
-    static #defaultVerbs: string[];
-    /** @type {string[]} */
-    static #defaultAdjectives: string[];
-    /** @type {string[]} */
-    static #defaultTemplates: string[];
-    /**
-     * Utility to validate arrays before setting.
-     * @param {any} value
-     * @param {string} field
-     */
-    static #validateArray(value: any, field: string): void;
-    /** @param {string[]} value */
-    static set defaultWords(value: string[]);
+    #private;
     /** @returns {string[]} */
     static get defaultWords(): string[];
     /** @param {string[]} value */
-    static set defaultEmojis(value: string[]);
+    static set defaultWords(value: string[]);
     /** @returns {string[]} */
     static get defaultEmojis(): string[];
     /** @param {string[]} value */
-    static set defaultNouns(value: string[]);
+    static set defaultEmojis(value: string[]);
     /** @returns {string[]} */
     static get defaultNouns(): string[];
     /** @param {string[]} value */
-    static set defaultVerbs(value: string[]);
+    static set defaultNouns(value: string[]);
     /** @returns {string[]} */
     static get defaultVerbs(): string[];
     /** @param {string[]} value */
-    static set defaultAdjectives(value: string[]);
+    static set defaultVerbs(value: string[]);
     /** @returns {string[]} */
     static get defaultAdjectives(): string[];
     /** @param {string[]} value */
-    static set defaultTemplates(value: string[]);
+    static set defaultAdjectives(value: string[]);
     /** @returns {string[]} */
     static get defaultTemplates(): string[];
+    /** @param {string[]} value */
+    static set defaultTemplates(value: 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[];
     /**
      * Creates an instance of UltraRandomMsgGen.
      *
@@ -231,37 +199,34 @@ declare class UltraRandomMsgGen {
      * @param {number} [config.line.emojiChance=0.3] - Probability (0–1) of placing emoji per line.
      */
     constructor(config?: {
-        minLength?: number | undefined;
-        maxLength?: number | undefined;
-        readable?: boolean | undefined;
-        useEmojis?: boolean | undefined;
-        includeNumbers?: boolean | undefined;
-        includeSymbols?: boolean | undefined;
-        allowWeirdSpacing?: boolean | undefined;
-        emojiSet?: string[] | undefined;
-        wordSet?: string[] | undefined;
-        mode?: RandomMsgModes | undefined;
+        minLength?: number;
+        maxLength?: number;
+        readable?: boolean;
+        useEmojis?: boolean;
+        includeNumbers?: boolean;
+        includeSymbols?: boolean;
+        allowWeirdSpacing?: boolean;
+        emojiSet?: string[];
+        wordSet?: string[];
+        mode?: RandomMsgModes;
         grammar?: {
-            templates?: string[] | undefined;
-            nouns?: string[] | undefined;
-            verbs?: string[] | undefined;
-            adjectives?: string[] | undefined;
-        } | undefined;
-        repeatWords?: boolean | undefined;
-        emojiPlacement?: EmojiPlacement | undefined;
+            templates?: string[];
+            nouns?: string[];
+            verbs?: string[];
+            adjectives?: string[];
+        };
+        repeatWords?: boolean;
+        emojiPlacement?: EmojiPlacement;
         paragraphs?: {
-            min?: number | undefined;
-            max?: number | undefined;
-        } | undefined;
+            min?: number;
+            max?: number;
+        };
         line?: {
-            minLength?: number | undefined;
-            maxLength?: number | undefined;
-            emojiChance?: number | undefined;
-        } | undefined;
+            minLength?: number;
+            maxLength?: number;
+            emojiChance?: number;
+        };
     });
-    /** @type {MsgGenConfig} */
-    config: MsgGenConfig;
-    symbols: string[];
     /**
      * Merges new configuration values into the current instance.
      * @param {Object} newConfig - Object with one or more configuration overrides.
@@ -416,5 +381,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;
 }
+export default UltraRandomMsgGen;
 //# sourceMappingURL=UltraRandomMsgGen.d.mts.map