tiny-essentials 1.21.8 → 1.21.10

package/dist/v1/libs/UltraRandomMsgGen.cjs

@@ -377,17 +377,89 @@ const defaultTemplates = [
  */
 class UltraRandomMsgGen {
   /** @type {string[]} */
-  static defaultWords = defaultWords;
+  static #defaultWords = defaultWords;
   /** @type {string[]} */
-  static defaultEmojis = defaultEmojis;
+  static #defaultEmojis = defaultEmojis;
   /** @type {string[]} */
-  static defaultNouns = defaultNouns;
+  static #defaultNouns = defaultNouns;
   /** @type {string[]} */
-  static defaultVerbs = defaultVerbs;
+  static #defaultVerbs = defaultVerbs;
   /** @type {string[]} */
-  static defaultAdjectives = defaultAdjectives;
+  static #defaultAdjectives = defaultAdjectives;
   /** @type {string[]} */
-  static defaultTemplates = defaultTemplates;
+  static #defaultTemplates = defaultTemplates;
+
+  /**
+   * Utility to validate arrays before setting.
+   * @param {any} value
+   * @param {string} field
+   */
+  static #validateArray(value, field) {
+    if (!Array.isArray(value)) throw new TypeError(`${field} must be an array of strings`);
+    if (!value.every((v) => typeof v === 'string'))
+      throw new TypeError(`${field} must contain only strings`);
+    if (value.length === 0) throw new Error(`${field} cannot be empty`);
+  }
+
+  /** @returns {string[]} */
+  static get defaultWords() {
+    return [...this.#defaultWords];
+  }
+  /** @param {string[]} value */
+  static set defaultWords(value) {
+    this.#validateArray(value, 'defaultWords');
+    this.#defaultWords = [...value];
+  }
+
+  /** @returns {string[]} */
+  static get defaultEmojis() {
+    return [...this.#defaultEmojis];
+  }
+  /** @param {string[]} value */
+  static set defaultEmojis(value) {
+    this.#validateArray(value, 'defaultEmojis');
+    this.#defaultEmojis = [...value];
+  }
+
+  /** @returns {string[]} */
+  static get defaultNouns() {
+    return [...this.#defaultNouns];
+  }
+  /** @param {string[]} value */
+  static set defaultNouns(value) {
+    this.#validateArray(value, 'defaultNouns');
+    this.#defaultNouns = [...value];
+  }
+
+  /** @returns {string[]} */
+  static get defaultVerbs() {
+    return [...this.#defaultVerbs];
+  }
+  /** @param {string[]} value */
+  static set defaultVerbs(value) {
+    this.#validateArray(value, 'defaultVerbs');
+    this.#defaultVerbs = [...value];
+  }
+
+  /** @returns {string[]} */
+  static get defaultAdjectives() {
+    return [...this.#defaultAdjectives];
+  }
+  /** @param {string[]} value */
+  static set defaultAdjectives(value) {
+    this.#validateArray(value, 'defaultAdjectives');
+    this.#defaultAdjectives = [...value];
+  }
+
+  /** @returns {string[]} */
+  static get defaultTemplates() {
+    return [...this.#defaultTemplates];
+  }
+  /** @param {string[]} value */
+  static set defaultTemplates(value) {
+    this.#validateArray(value, 'defaultTemplates');
+    this.#defaultTemplates = [...value];
+  }
 
   /** @type {MsgGenConfig} */
   config = {
@@ -576,20 +648,20 @@ class UltraRandomMsgGen {
       }
     }
 
-    this.config.emojiSet = [...defaultEmojis];
-    this.config.wordSet = [...defaultWords];
+    this.config.emojiSet = [...UltraRandomMsgGen.#defaultEmojis];
+    this.config.wordSet = [...UltraRandomMsgGen.#defaultWords];
 
-    this.config.grammar.templates = [...defaultTemplates];
-    this.config.grammar.nouns = [...defaultNouns];
-    this.config.grammar.verbs = [...defaultVerbs];
-    this.config.grammar.adjectives = [...defaultAdjectives];
+    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);
   }
 
   /**
    * Merges new configuration values into the current instance.
    * @param {Object} newConfig - Object with one or more configuration overrides.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   configure(newConfig = {}) {
     Object.assign(this.config, newConfig);
@@ -599,7 +671,7 @@ class UltraRandomMsgGen {
   /**
    * Replaces the entire list of grammar templates.
    * @param {...string[]} templates - One or more arrays or strings containing sentence templates.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   setGrammarTemplates(...templates) {
     this.config.grammar.templates = templates.flat();
@@ -609,7 +681,7 @@ class UltraRandomMsgGen {
   /**
    * Adds new grammar templates to the existing list.
    * @param {...string[]} templates - One or more arrays or strings containing sentence templates.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   addGrammarTemplates(...templates) {
     this.config.grammar.templates.push(...templates.flat());
@@ -619,7 +691,7 @@ class UltraRandomMsgGen {
   /**
    * Replaces the list of noun words used in grammar templates.
    * @param {...string[]} nouns - One or more arrays or strings of nouns.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   setGrammarNouns(...nouns) {
     this.config.grammar.nouns = nouns.flat();
@@ -629,7 +701,7 @@ class UltraRandomMsgGen {
   /**
    * Adds noun words to the existing list used in grammar templates.
    * @param {...string[]} nouns - One or more arrays or strings of nouns.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   addGrammarNouns(...nouns) {
     this.config.grammar.nouns.push(...nouns.flat());
@@ -639,7 +711,7 @@ class UltraRandomMsgGen {
   /**
    * Replaces the list of verb words used in grammar templates.
    * @param {...string[]} verbs - One or more arrays or strings of verbs.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   setGrammarVerbs(...verbs) {
     this.config.grammar.verbs = verbs.flat();
@@ -649,7 +721,7 @@ class UltraRandomMsgGen {
   /**
    * Adds verb words to the existing list used in grammar templates.
    * @param {...string[]} verbs - One or more arrays or strings of verbs.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   addGrammarVerbs(...verbs) {
     this.config.grammar.verbs.push(...verbs.flat());
@@ -659,7 +731,7 @@ class UltraRandomMsgGen {
   /**
    * Replaces the list of adjective words used in grammar templates.
    * @param {...string[]} adjectives - One or more arrays or strings of adjectives.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   setGrammarAdjectives(...adjectives) {
     this.config.grammar.adjectives = adjectives.flat();
@@ -669,7 +741,7 @@ class UltraRandomMsgGen {
   /**
    * Adds adjective words to the existing list used in grammar templates.
    * @param {...string[]} adjectives - One or more arrays or strings of adjectives.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   addGrammarAdjectives(...adjectives) {
     this.config.grammar.adjectives.push(...adjectives.flat());
@@ -679,7 +751,7 @@ class UltraRandomMsgGen {
   /**
    * Removes specific grammar templates from the current list.
    * @param {...string[]} templates - One or more arrays or strings of templates to remove.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   removeGrammarTemplates(...templates) {
     const removeSet = new Set(templates.flat());
@@ -690,7 +762,7 @@ class UltraRandomMsgGen {
   /**
    * Removes specific noun words from the grammar noun list.
    * @param {...string[]} nouns - One or more arrays or strings of nouns to remove.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   removeGrammarNouns(...nouns) {
     const removeSet = new Set(nouns.flat());
@@ -701,7 +773,7 @@ class UltraRandomMsgGen {
   /**
    * Removes specific verb words from the grammar verb list.
    * @param {...string[]} verbs - One or more arrays or strings of verbs to remove.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   removeGrammarVerbs(...verbs) {
     const removeSet = new Set(verbs.flat());
@@ -712,7 +784,7 @@ class UltraRandomMsgGen {
   /**
    * Removes specific adjective words from the grammar adjective list.
    * @param {...string[]} adjectives - One or more arrays or strings of adjectives to remove.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   removeGrammarAdjectives(...adjectives) {
     const removeSet = new Set(adjectives.flat());
@@ -725,7 +797,7 @@ class UltraRandomMsgGen {
   /**
    * Replaces the entire word set used in readable/mixed modes.
    * @param {...string[]} words - One or more arrays or strings of words.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   setWords(...words) {
     this.config.wordSet = words.flat();
@@ -735,7 +807,7 @@ class UltraRandomMsgGen {
   /**
    * Adds new words to the word set used in readable/mixed modes.
    * @param {...string[]} words - One or more arrays or strings of words.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   addWords(...words) {
     this.config.wordSet.push(...words.flat());
@@ -745,7 +817,7 @@ class UltraRandomMsgGen {
   /**
    * Removes specific words from the word set.
    * @param {...string[]} words - Words to be removed.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   removeWords(...words) {
     const removeSet = new Set(words.flat());
@@ -756,7 +828,7 @@ class UltraRandomMsgGen {
   /**
    * Replaces the emoji set used in generated output.
    * @param {...string[]} emojis - One or more arrays or strings of emojis.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   setEmojis(...emojis) {
     this.config.emojiSet = emojis.flat();
@@ -766,7 +838,7 @@ class UltraRandomMsgGen {
   /**
    * Adds new emojis to the emoji set.
    * @param {...string[]} emojis - One or more arrays or strings of emojis.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   addEmojis(...emojis) {
     this.config.emojiSet.push(...emojis.flat());
@@ -776,7 +848,7 @@ class UltraRandomMsgGen {
   /**
    * Removes specific emojis from the emoji set.
    * @param {...string[]} emojis - Emojis to be removed.
-   * @returns {UltraRandomMsgGen} - The instance for chaining.
+   * @returns {this} - The instance for chaining.
    */
   removeEmojis(...emojis) {
     const removeSet = new Set(emojis.flat());

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

@@ -160,17 +160,47 @@ export type MsgGenConfig = {
  */
 declare class UltraRandomMsgGen {
     /** @type {string[]} */
-    static defaultWords: string[];
+    static "__#12@#defaultWords": string[];
     /** @type {string[]} */
-    static defaultEmojis: string[];
+    static "__#12@#defaultEmojis": string[];
     /** @type {string[]} */
-    static defaultNouns: string[];
+    static "__#12@#defaultNouns": string[];
     /** @type {string[]} */
-    static defaultVerbs: string[];
+    static "__#12@#defaultVerbs": string[];
     /** @type {string[]} */
-    static defaultAdjectives: string[];
+    static "__#12@#defaultAdjectives": string[];
     /** @type {string[]} */
-    static defaultTemplates: string[];
+    static "__#12@#defaultTemplates": string[];
+    /**
+     * Utility to validate arrays before setting.
+     * @param {any} value
+     * @param {string} field
+     */
+    static "__#12@#validateArray"(value: any, field: string): void;
+    /** @param {string[]} value */
+    static set defaultWords(value: string[]);
+    /** @returns {string[]} */
+    static get defaultWords(): string[];
+    /** @param {string[]} value */
+    static set defaultEmojis(value: string[]);
+    /** @returns {string[]} */
+    static get defaultEmojis(): string[];
+    /** @param {string[]} value */
+    static set defaultNouns(value: string[]);
+    /** @returns {string[]} */
+    static get defaultNouns(): string[];
+    /** @param {string[]} value */
+    static set defaultVerbs(value: string[]);
+    /** @returns {string[]} */
+    static get defaultVerbs(): string[];
+    /** @param {string[]} value */
+    static set defaultAdjectives(value: string[]);
+    /** @returns {string[]} */
+    static get defaultAdjectives(): string[];
+    /** @param {string[]} value */
+    static set defaultTemplates(value: string[]);
+    /** @returns {string[]} */
+    static get defaultTemplates(): string[];
     /**
      * Creates an instance of UltraRandomMsgGen.
      *
@@ -235,117 +265,117 @@ declare class UltraRandomMsgGen {
     /**
      * Merges new configuration values into the current instance.
      * @param {Object} newConfig - Object with one or more configuration overrides.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    configure(newConfig?: Object): UltraRandomMsgGen;
+    configure(newConfig?: Object): this;
     /**
      * Replaces the entire list of grammar templates.
      * @param {...string[]} templates - One or more arrays or strings containing sentence templates.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    setGrammarTemplates(...templates: string[][]): UltraRandomMsgGen;
+    setGrammarTemplates(...templates: string[][]): this;
     /**
      * Adds new grammar templates to the existing list.
      * @param {...string[]} templates - One or more arrays or strings containing sentence templates.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    addGrammarTemplates(...templates: string[][]): UltraRandomMsgGen;
+    addGrammarTemplates(...templates: string[][]): this;
     /**
      * Replaces the list of noun words used in grammar templates.
      * @param {...string[]} nouns - One or more arrays or strings of nouns.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    setGrammarNouns(...nouns: string[][]): UltraRandomMsgGen;
+    setGrammarNouns(...nouns: string[][]): this;
     /**
      * Adds noun words to the existing list used in grammar templates.
      * @param {...string[]} nouns - One or more arrays or strings of nouns.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    addGrammarNouns(...nouns: string[][]): UltraRandomMsgGen;
+    addGrammarNouns(...nouns: string[][]): this;
     /**
      * Replaces the list of verb words used in grammar templates.
      * @param {...string[]} verbs - One or more arrays or strings of verbs.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    setGrammarVerbs(...verbs: string[][]): UltraRandomMsgGen;
+    setGrammarVerbs(...verbs: string[][]): this;
     /**
      * Adds verb words to the existing list used in grammar templates.
      * @param {...string[]} verbs - One or more arrays or strings of verbs.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    addGrammarVerbs(...verbs: string[][]): UltraRandomMsgGen;
+    addGrammarVerbs(...verbs: string[][]): this;
     /**
      * Replaces the list of adjective words used in grammar templates.
      * @param {...string[]} adjectives - One or more arrays or strings of adjectives.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    setGrammarAdjectives(...adjectives: string[][]): UltraRandomMsgGen;
+    setGrammarAdjectives(...adjectives: string[][]): this;
     /**
      * Adds adjective words to the existing list used in grammar templates.
      * @param {...string[]} adjectives - One or more arrays or strings of adjectives.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    addGrammarAdjectives(...adjectives: string[][]): UltraRandomMsgGen;
+    addGrammarAdjectives(...adjectives: string[][]): this;
     /**
      * Removes specific grammar templates from the current list.
      * @param {...string[]} templates - One or more arrays or strings of templates to remove.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    removeGrammarTemplates(...templates: string[][]): UltraRandomMsgGen;
+    removeGrammarTemplates(...templates: string[][]): this;
     /**
      * Removes specific noun words from the grammar noun list.
      * @param {...string[]} nouns - One or more arrays or strings of nouns to remove.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    removeGrammarNouns(...nouns: string[][]): UltraRandomMsgGen;
+    removeGrammarNouns(...nouns: string[][]): this;
     /**
      * Removes specific verb words from the grammar verb list.
      * @param {...string[]} verbs - One or more arrays or strings of verbs to remove.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    removeGrammarVerbs(...verbs: string[][]): UltraRandomMsgGen;
+    removeGrammarVerbs(...verbs: string[][]): this;
     /**
      * Removes specific adjective words from the grammar adjective list.
      * @param {...string[]} adjectives - One or more arrays or strings of adjectives to remove.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    removeGrammarAdjectives(...adjectives: string[][]): UltraRandomMsgGen;
+    removeGrammarAdjectives(...adjectives: string[][]): this;
     /**
      * Replaces the entire word set used in readable/mixed modes.
      * @param {...string[]} words - One or more arrays or strings of words.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    setWords(...words: string[][]): UltraRandomMsgGen;
+    setWords(...words: string[][]): this;
     /**
      * Adds new words to the word set used in readable/mixed modes.
      * @param {...string[]} words - One or more arrays or strings of words.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    addWords(...words: string[][]): UltraRandomMsgGen;
+    addWords(...words: string[][]): this;
     /**
      * Removes specific words from the word set.
      * @param {...string[]} words - Words to be removed.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    removeWords(...words: string[][]): UltraRandomMsgGen;
+    removeWords(...words: string[][]): this;
     /**
      * Replaces the emoji set used in generated output.
      * @param {...string[]} emojis - One or more arrays or strings of emojis.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    setEmojis(...emojis: string[][]): UltraRandomMsgGen;
+    setEmojis(...emojis: string[][]): this;
     /**
      * Adds new emojis to the emoji set.
      * @param {...string[]} emojis - One or more arrays or strings of emojis.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    addEmojis(...emojis: string[][]): UltraRandomMsgGen;
+    addEmojis(...emojis: string[][]): this;
     /**
      * Removes specific emojis from the emoji set.
      * @param {...string[]} emojis - Emojis to be removed.
-     * @returns {UltraRandomMsgGen} - The instance for chaining.
+     * @returns {this} - The instance for chaining.
      */
-    removeEmojis(...emojis: string[][]): UltraRandomMsgGen;
+    removeEmojis(...emojis: string[][]): this;
     /**
      * Returns a random item from an array.
      * @private