tiny-essentials 1.28.0 → 1.28.1

package/dist/v1/libs/TinyHtml.cjs

@@ -501,7 +501,7 @@ class TinyHtml {
                 const oldStyles = TinyHtml.parseStyle(oldVal);
                 const newStyles = TinyHtml.parseStyle(newVal);
 
-                const changes = text.diffStrings(oldStyles, newStyles);
+                const changes = text.diffObjList(oldStyles, newStyles);
 
                 if (
                   Object.keys(changes.added).length ||

package/dist/v1/libs/TinyHtml.mjs

@@ -1,5 +1,5 @@
 import { diffArrayList } from '../basics/array.mjs';
-import { diffStrings } from '../basics/text.mjs';
+import { diffObjList } from '../basics/text.mjs';
 import * as TinyCollision from '../basics/collision.mjs';
 import TinyElementObserver from './TinyElementObserver.mjs';
 // TITLE: Introduction
@@ -432,7 +432,7 @@ class TinyHtml {
                         const newVal = mutation.target.getAttribute('style') || '';
                         const oldStyles = TinyHtml.parseStyle(oldVal);
                         const newStyles = TinyHtml.parseStyle(newVal);
-                        const changes = diffStrings(oldStyles, newStyles);
+                        const changes = diffObjList(oldStyles, newStyles);
                         if (Object.keys(changes.added).length ||
                             Object.keys(changes.removed).length ||
                             Object.keys(changes.modified).length) {

package/dist/v1/libs/TinyI18.cjs

@@ -3,6 +3,9 @@
 var promises = require('fs/promises');
 var fs = require('fs');
 var path = require('path');
+var utils = require('./utils.cjs');
+
+const checkDestroy = utils.createCheckDestroyed('TinyI18');
 
 /**
  * Supported operating modes for TinyI18.
@@ -168,6 +171,21 @@ class TinyI18 {
     await promises.writeFile(output, JSON.stringify(merged, null, spaces), 'utf-8');
   }
 
+  /**
+   * 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 {ModeTypes} */
   #mode;
   /** @type {LocaleCode} */
@@ -197,6 +215,7 @@ class TinyI18 {
    * @returns {LocaleCode|null}
    */
   get currentLocale() {
+    checkDestroy(this.#destroyed);
     return this.#currentLocale;
   }
 
@@ -206,6 +225,7 @@ class TinyI18 {
    * @type {LocaleCode}
    */
   get defaultLocale() {
+    checkDestroy(this.#destroyed);
     return this.#defaultLocale;
   }
 
@@ -216,6 +236,7 @@ class TinyI18 {
    * @type {ModeTypes}
    */
   get mode() {
+    checkDestroy(this.#destroyed);
     return this.#mode;
   }
 
@@ -226,6 +247,7 @@ class TinyI18 {
    * @type {boolean}
    */
   get strict() {
+    checkDestroy(this.#destroyed);
     return this.#strict;
   }
 
@@ -236,6 +258,7 @@ class TinyI18 {
    * @type {string|null}
    */
   get basePath() {
+    checkDestroy(this.#destroyed);
     return this.#basePath;
   }
 
@@ -244,6 +267,7 @@ class TinyI18 {
    * @returns {StatLocale[]}
    */
   get stats() {
+    checkDestroy(this.#destroyed);
     const locales = [];
     for (const loc of this.#stringTables.keys()) locales.push(this.getStatsForLocale(loc));
     return locales;
@@ -255,6 +279,7 @@ class TinyI18 {
    * @returns {Record<string, Dict>}
    */
   get stringTables() {
+    checkDestroy(this.#destroyed);
     /** @type {Record<string, Dict>} */
     const obj = {};
     for (const [locale, dict] of this.#stringTables.entries()) {
@@ -269,6 +294,7 @@ class TinyI18 {
    * @returns {Record<string, PatternEntry[]>}
    */
   get patternTables() {
+    checkDestroy(this.#destroyed);
     /** @type {Record<string, PatternEntry[]>} */
     const obj = {};
     for (const [locale, arr] of this.#patternTables.entries()) {
@@ -287,6 +313,7 @@ class TinyI18 {
    * @returns {Record<string, HelperCallback>}
    */
   get helpers() {
+    checkDestroy(this.#destroyed);
     /** @type {Record<string, HelperCallback>} */
     const obj = {};
     for (const [name, fn] of this.#helpers.entries()) {
@@ -301,6 +328,7 @@ class TinyI18 {
    * @returns {Record<string, RegExp>}
    */
   get regexCache() {
+    checkDestroy(this.#destroyed);
     /** @type {Record<string, RegExp>} */
     const obj = {};
     for (const [key, re] of this.#regexCache.entries()) {
@@ -765,6 +793,7 @@ class TinyI18 {
    * management is always controlled via the API instead of direct access.
    */
   clearRegexCache() {
+    checkDestroy(this.#destroyed);
     this.#regexCache.clear();
   }
 
@@ -774,6 +803,7 @@ class TinyI18 {
    * @param {HelperCallback} fn
    */
   registerHelper(name, fn) {
+    checkDestroy(this.#destroyed);
     if (typeof name !== 'string' || !name)
       throw new TypeError('registerHelper: "name" must be non-empty string');
     if (typeof fn !== 'function') throw new TypeError('registerHelper: "fn" must be a function');
@@ -789,6 +819,7 @@ class TinyI18 {
    * @returns {boolean} `true` if the helper was removed, `false` if it was not found.
    */
   unregisterHelper(name) {
+    checkDestroy(this.#destroyed);
     if (typeof name !== 'string' || !name)
       throw new TypeError('unregisterHelper: "name" must be non-empty string');
     return this.#helpers.delete(name);
@@ -800,6 +831,7 @@ class TinyI18 {
    * @param {Dict} data
    */
   loadLocaleLocal(locale, data) {
+    checkDestroy(this.#destroyed);
     if (this.#mode !== 'local')
       throw new TypeError('loadLocaleLocal is only available in "local" mode');
     this.#ingestLocale(locale, data);
@@ -811,6 +843,7 @@ class TinyI18 {
    * @param {LocaleCode|null} locale - null -> keep only default
    */
   async setLocale(locale) {
+    checkDestroy(this.#destroyed);
     if (locale !== null && (typeof locale !== 'string' || !locale))
       throw new TypeError('setLocale: "locale" must be string or null');
 
@@ -856,6 +889,7 @@ class TinyI18 {
    * @returns {any}
    */
   get(key, params = undefined, options = undefined) {
+    checkDestroy(this.#destroyed);
     if (typeof key !== 'string' || !key)
       throw new TypeError('get: "key" must be a non-empty string');
 
@@ -891,6 +925,7 @@ class TinyI18 {
    * @returns {any}
    */
   resolveByPattern(key, options) {
+    checkDestroy(this.#destroyed);
     if (typeof key !== 'string' || !key)
       throw new TypeError('get: "key" must be a non-empty string');
     const { locale: forceLocale } = options || {};
@@ -908,6 +943,7 @@ class TinyI18 {
    * Selected locale becomes null.
    */
   resetToDefaultOnly() {
+    checkDestroy(this.#destroyed);
     if (this.#mode === 'file') {
       for (const loc of Array.from(this.#stringTables.keys())) {
         if (loc !== this.#defaultLocale) {
@@ -925,6 +961,7 @@ class TinyI18 {
    * @throws {Error} If the locale is not registered.
    */
   getStatsForLocale(locale) {
+    checkDestroy(this.#destroyed);
     if (typeof locale !== 'string' || !locale)
       throw new TypeError('getStatsForLocale: "locale" must be a non-empty string');
     if (!this.#stringTables.has(locale))
@@ -941,6 +978,30 @@ class TinyI18 {
       isCurrent: locale === this.#currentLocale,
     };
   }
+
+  /**
+   * Destroys the TinyI18 instance, clearing all internal maps and references
+   * to free up memory. Once destroyed, the instance cannot be reused.
+   *
+   * @throws {Error} If the instance has already been destroyed.
+   * @returns {void}
+   */
+  destroy() {
+    if (this.#destroyed) return;
+
+    // Clear all internal maps to release memory
+    this.#stringTables.clear();
+    this.#patternTables.clear();
+    this.#helpers.clear();
+    this.#regexCache.clear();
+
+    // Reset locale and path configurations
+    this.#currentLocale = null;
+    this.#basePath = null;
+
+    // Mark the instance as destroyed
+    this.#destroyed = true;
+  }
 }
 
 module.exports = TinyI18;

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

@@ -267,6 +267,12 @@ declare class TinyI18 {
      * @param {TinyI18Options} options - Configuration options for the instance.
      */
     constructor(options: TinyI18Options);
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed(): boolean;
     /**
      * Gets the currently selected locale, or null if only default is active.
      * @returns {LocaleCode|null}
@@ -413,6 +419,14 @@ declare class TinyI18 {
      * @throws {Error} If the locale is not registered.
      */
     getStatsForLocale(locale: LocaleCode): StatLocale;
+    /**
+     * Destroys the TinyI18 instance, clearing all internal maps and references
+     * to free up memory. Once destroyed, the instance cannot be reused.
+     *
+     * @throws {Error} If the instance has already been destroyed.
+     * @returns {void}
+     */
+    destroy(): void;
     #private;
 }
 //# sourceMappingURL=TinyI18.d.mts.map

package/dist/v1/libs/TinyI18.mjs

@@ -1,6 +1,8 @@
 import { readFile, writeFile } from 'fs/promises';
 import { existsSync } from 'fs';
 import { join as pathJoin } from 'path';
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyI18');
 /**
  * Supported operating modes for TinyI18.
  * - `"local"` → All translations are managed entirely in memory (browser + Node.js).
@@ -148,6 +150,19 @@ class TinyI18 {
         }
         await writeFile(output, JSON.stringify(merged, null, spaces), 'utf-8');
     }
+    /**
+     * 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 {ModeTypes} */
     #mode;
     /** @type {LocaleCode} */
@@ -172,6 +187,7 @@ class TinyI18 {
      * @returns {LocaleCode|null}
      */
     get currentLocale() {
+        checkDestroy(this.#destroyed);
         return this.#currentLocale;
     }
     /**
@@ -180,6 +196,7 @@ class TinyI18 {
      * @type {LocaleCode}
      */
     get defaultLocale() {
+        checkDestroy(this.#destroyed);
         return this.#defaultLocale;
     }
     /**
@@ -189,6 +206,7 @@ class TinyI18 {
      * @type {ModeTypes}
      */
     get mode() {
+        checkDestroy(this.#destroyed);
         return this.#mode;
     }
     /**
@@ -198,6 +216,7 @@ class TinyI18 {
      * @type {boolean}
      */
     get strict() {
+        checkDestroy(this.#destroyed);
         return this.#strict;
     }
     /**
@@ -207,6 +226,7 @@ class TinyI18 {
      * @type {string|null}
      */
     get basePath() {
+        checkDestroy(this.#destroyed);
         return this.#basePath;
     }
     /**
@@ -214,6 +234,7 @@ class TinyI18 {
      * @returns {StatLocale[]}
      */
     get stats() {
+        checkDestroy(this.#destroyed);
         const locales = [];
         for (const loc of this.#stringTables.keys())
             locales.push(this.getStatsForLocale(loc));
@@ -225,6 +246,7 @@ class TinyI18 {
      * @returns {Record<string, Dict>}
      */
     get stringTables() {
+        checkDestroy(this.#destroyed);
         /** @type {Record<string, Dict>} */
         const obj = {};
         for (const [locale, dict] of this.#stringTables.entries()) {
@@ -238,6 +260,7 @@ class TinyI18 {
      * @returns {Record<string, PatternEntry[]>}
      */
     get patternTables() {
+        checkDestroy(this.#destroyed);
         /** @type {Record<string, PatternEntry[]>} */
         const obj = {};
         for (const [locale, arr] of this.#patternTables.entries()) {
@@ -255,6 +278,7 @@ class TinyI18 {
      * @returns {Record<string, HelperCallback>}
      */
     get helpers() {
+        checkDestroy(this.#destroyed);
         /** @type {Record<string, HelperCallback>} */
         const obj = {};
         for (const [name, fn] of this.#helpers.entries()) {
@@ -268,6 +292,7 @@ class TinyI18 {
      * @returns {Record<string, RegExp>}
      */
     get regexCache() {
+        checkDestroy(this.#destroyed);
         /** @type {Record<string, RegExp>} */
         const obj = {};
         for (const [key, re] of this.#regexCache.entries()) {
@@ -707,6 +732,7 @@ class TinyI18 {
      * management is always controlled via the API instead of direct access.
      */
     clearRegexCache() {
+        checkDestroy(this.#destroyed);
         this.#regexCache.clear();
     }
     /**
@@ -715,6 +741,7 @@ class TinyI18 {
      * @param {HelperCallback} fn
      */
     registerHelper(name, fn) {
+        checkDestroy(this.#destroyed);
         if (typeof name !== 'string' || !name)
             throw new TypeError('registerHelper: "name" must be non-empty string');
         if (typeof fn !== 'function')
@@ -730,6 +757,7 @@ class TinyI18 {
      * @returns {boolean} `true` if the helper was removed, `false` if it was not found.
      */
     unregisterHelper(name) {
+        checkDestroy(this.#destroyed);
         if (typeof name !== 'string' || !name)
             throw new TypeError('unregisterHelper: "name" must be non-empty string');
         return this.#helpers.delete(name);
@@ -740,6 +768,7 @@ class TinyI18 {
      * @param {Dict} data
      */
     loadLocaleLocal(locale, data) {
+        checkDestroy(this.#destroyed);
         if (this.#mode !== 'local')
             throw new TypeError('loadLocaleLocal is only available in "local" mode');
         this.#ingestLocale(locale, data);
@@ -750,6 +779,7 @@ class TinyI18 {
      * @param {LocaleCode|null} locale - null -> keep only default
      */
     async setLocale(locale) {
+        checkDestroy(this.#destroyed);
         if (locale !== null && (typeof locale !== 'string' || !locale))
             throw new TypeError('setLocale: "locale" must be string or null');
         const prev = this.#currentLocale;
@@ -791,6 +821,7 @@ class TinyI18 {
      * @returns {any}
      */
     get(key, params = undefined, options = undefined) {
+        checkDestroy(this.#destroyed);
         if (typeof key !== 'string' || !key)
             throw new TypeError('get: "key" must be a non-empty string');
         const { locale: forceLocale } = options || {};
@@ -822,6 +853,7 @@ class TinyI18 {
      * @returns {any}
      */
     resolveByPattern(key, options) {
+        checkDestroy(this.#destroyed);
         if (typeof key !== 'string' || !key)
             throw new TypeError('get: "key" must be a non-empty string');
         const { locale: forceLocale } = options || {};
@@ -839,6 +871,7 @@ class TinyI18 {
      * Selected locale becomes null.
      */
     resetToDefaultOnly() {
+        checkDestroy(this.#destroyed);
         if (this.#mode === 'file') {
             for (const loc of Array.from(this.#stringTables.keys())) {
                 if (loc !== this.#defaultLocale) {
@@ -855,6 +888,7 @@ class TinyI18 {
      * @throws {Error} If the locale is not registered.
      */
     getStatsForLocale(locale) {
+        checkDestroy(this.#destroyed);
         if (typeof locale !== 'string' || !locale)
             throw new TypeError('getStatsForLocale: "locale" must be a non-empty string');
         if (!this.#stringTables.has(locale))
@@ -869,5 +903,26 @@ class TinyI18 {
             isCurrent: locale === this.#currentLocale,
         };
     }
+    /**
+     * Destroys the TinyI18 instance, clearing all internal maps and references
+     * to free up memory. Once destroyed, the instance cannot be reused.
+     *
+     * @throws {Error} If the instance has already been destroyed.
+     * @returns {void}
+     */
+    destroy() {
+        if (this.#destroyed)
+            return;
+        // Clear all internal maps to release memory
+        this.#stringTables.clear();
+        this.#patternTables.clear();
+        this.#helpers.clear();
+        this.#regexCache.clear();
+        // Reset locale and path configurations
+        this.#currentLocale = null;
+        this.#basePath = null;
+        // Mark the instance as destroyed
+        this.#destroyed = true;
+    }
 }
 export default TinyI18;

package/dist/v1/libs/TinyIframeEvents.cjs

@@ -2,6 +2,9 @@
 
 var events = require('events');
 var objChecker = require('../basics/objChecker.cjs');
+var utils = require('./utils.cjs');
+
+const checkDestroy = utils.createCheckDestroyed('TinyIframeEvents');
 
 /** @type {WeakMap<Window, TinyIframeEvents>} */
 const instances = new WeakMap();
@@ -51,6 +54,7 @@ class TinyIframeEvents extends events.EventEmitter {
   #targetWindow;
 
   get targetWindow() {
+    checkDestroy(this.#isDestroyed);
     return this.#targetWindow;
   }
 
@@ -58,6 +62,7 @@ class TinyIframeEvents extends events.EventEmitter {
   #targetIframeElement;
 
   get targetIframeElement() {
+    checkDestroy(this.#isDestroyed);
     return this.#targetIframeElement;
   }
 
@@ -65,6 +70,7 @@ class TinyIframeEvents extends events.EventEmitter {
   #targetOrigin;
 
   get targetOrigin() {
+    checkDestroy(this.#isDestroyed);
     return this.#targetOrigin;
   }
 
@@ -72,6 +78,7 @@ class TinyIframeEvents extends events.EventEmitter {
   #selfType;
 
   get selfType() {
+    checkDestroy(this.#isDestroyed);
     return this.#selfType;
   }
 
@@ -82,6 +89,7 @@ class TinyIframeEvents extends events.EventEmitter {
   #ready = false;
 
   get ready() {
+    checkDestroy(this.#isDestroyed);
     return this.#ready;
   }
 
@@ -92,6 +100,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * @param {function(): void} handler - The callback function to execute.
    */
   onReady(handler) {
+    checkDestroy(this.#isDestroyed);
     if (this.#ready) {
       handler();
     } else {
@@ -168,6 +177,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * @returns {string}
    */
   get secretEventName() {
+    checkDestroy(this.#isDestroyed);
     return this.#secretEventName;
   }
 
@@ -177,6 +187,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * @throws {TypeError} If the value is not a string.
    */
   set secretEventName(name) {
+    checkDestroy(this.#isDestroyed);
     if (typeof name !== 'string')
       throw new TypeError('TinyIframeEvents: secretEventName must be a string.');
     this.#secretEventName = name;
@@ -187,6 +198,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * @returns {string}
    */
   get handshakeEventName() {
+    checkDestroy(this.#isDestroyed);
     return this.#handshakeEventName;
   }
 
@@ -196,6 +208,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * @throws {TypeError} If the value is not a string.
    */
   set handshakeEventName(name) {
+    checkDestroy(this.#isDestroyed);
     if (typeof name !== 'string')
       throw new TypeError('TinyIframeEvents: handshakeEventName must be a string.');
     this.#handshakeEventName = name;
@@ -206,6 +219,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * @returns {string}
    */
   get readyEventName() {
+    checkDestroy(this.#isDestroyed);
     return this.#readyEventName;
   }
 
@@ -215,6 +229,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * @throws {TypeError} If the value is not a string.
    */
   set readyEventName(name) {
+    checkDestroy(this.#isDestroyed);
     if (typeof name !== 'string')
       throw new TypeError('TinyIframeEvents: readyEventName must be a string.');
     this.#readyEventName = name;
@@ -339,6 +354,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * @throws {Error} If instance has been destroyed.
    */
   winEmit(eventName, payload) {
+    checkDestroy(this.#isDestroyed);
     if (typeof eventName !== 'string') throw new TypeError('Event name must be a string.');
     if (this.#isDestroyed) throw new Error('Cannot emit: instance has been destroyed.');
 
@@ -372,7 +388,7 @@ class TinyIframeEvents extends events.EventEmitter {
    * Call this when the instance is no longer needed to prevent memory leaks.
    */
   destroy() {
-    this.#isDestroyed = true;
+    if (this.#isDestroyed) return;
     this.#ready = false;
 
     window.removeEventListener('message', this._boundWindowMessage);
@@ -389,6 +405,7 @@ class TinyIframeEvents extends events.EventEmitter {
     this.removeAllListeners();
     this.#pendingQueue = [];
     instances.delete(this.#targetWindow);
+    this.#isDestroyed = true;
   }
 }