tiny-essentials 1.28.0 → 1.28.2

package/dist/v1/libs/UltraRandomMsgGen.mjs

@@ -1,3 +1,5 @@
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('UltraRandomMsgGen');
 const defaultWords = [
     'lorem',
     'ipsum',
@@ -51,6 +53,33 @@ const defaultEmojis = [
     '🎮',
     '🥓',
     '🍮',
+    '🍬',
+    '🍓',
+    '🍒',
+    '🥝',
+    '🥑',
+    '🍄',
+    '🌊',
+    '☁️',
+    '🌟',
+    '🌙',
+    '🧚',
+    '🐾',
+    '🐥',
+    '🐼',
+    '🐨',
+    '🐳',
+    '✨',
+    '🧁',
+    '🌸',
+    '🍃',
+    '💎',
+    '🎐',
+    '🎀',
+    '🫧',
+    '☄️',
+    '🛸',
+    '🔮',
 ];
 const defaultNouns = [
     'pudding',
@@ -234,6 +263,14 @@ const defaultTemplates = [
     'Do {noun}s have feelings? Asking for a {adj} friend.',
     '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.',
@@ -429,8 +466,21 @@ class UltraRandomMsgGen {
         this.#validateArray(value, 'defaultTemplates');
         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,
@@ -455,6 +505,15 @@ class UltraRandomMsgGen {
             emojiChance: 0.3, // 30% chance per line
         },
     };
+    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.
      *
@@ -485,7 +544,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, readable, useEmojis, includeNumbers, includeSymbols, allowWeirdSpacing, emojiSet, wordSet, mode, grammar, repeatWords, emojiPlacement, paragraphs, line, } = config;
         // Validations
         if (minLength !== undefined && (!Number.isInteger(minLength) || minLength < 1)) {
@@ -579,13 +637,13 @@ class UltraRandomMsgGen {
                 throw new RangeError('config.line.emojiChance must be a number between 0 and 1');
             }
         }
-        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.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);
     }
     /**
      * Merges new configuration values into the current instance.
@@ -593,7 +651,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;
     }
     /**
@@ -602,7 +661,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;
     }
     /**
@@ -611,7 +671,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;
     }
     /**
@@ -620,7 +681,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;
     }
     /**
@@ -629,7 +691,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;
     }
     /**
@@ -638,7 +701,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;
     }
     /**
@@ -647,7 +711,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;
     }
     /**
@@ -656,7 +721,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;
     }
     /**
@@ -665,7 +731,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;
     }
     /**
@@ -674,8 +741,9 @@ 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;
     }
     /**
@@ -684,8 +752,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;
     }
     /**
@@ -694,8 +763,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;
     }
     /**
@@ -704,8 +774,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((a) => !removeSet.has(a));
+        this.#config.grammar.adjectives = this.#config.grammar.adjectives.filter((a) => !removeSet.has(a));
         return this;
     }
     /**
@@ -714,7 +785,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;
     }
     /**
@@ -723,7 +795,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;
     }
     /**
@@ -732,8 +805,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;
     }
     /**
@@ -742,7 +816,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;
     }
     /**
@@ -751,7 +826,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;
     }
     /**
@@ -760,8 +836,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;
     }
     /**
@@ -779,7 +856,7 @@ class UltraRandomMsgGen {
      * @returns {string} - A chunk (word, emoji, symbol, number, etc.).
      */
     _generateChunk() {
-        const { wordSet, emojiSet, includeNumbers, includeSymbols, useEmojis, readable, mode, emojiPlacement, } = this.config;
+        const { wordSet, emojiSet, includeNumbers, includeSymbols, useEmojis, readable, mode, emojiPlacement, } = this.#config;
         if (mode === 'natural') {
             return this._generateNaturalSentence();
         }
@@ -794,7 +871,7 @@ class UltraRandomMsgGen {
             pools.push(Math.floor(Math.random() * 99999).toString());
         }
         if (includeSymbols) {
-            pools.push(this._getRandomItem(this.symbols));
+            pools.push(this._getRandomItem(this.#symbols));
         }
         if (emojiPlacement === 'inline' && useEmojis && emojiSet.length) {
             pools.push(this._getRandomItem(emojiSet));
@@ -807,7 +884,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);
         return template
             .replace(/{noun}/g, () => this._getRandomItem(nouns))
@@ -822,7 +899,7 @@ class UltraRandomMsgGen {
      * @returns {string} - A generated line.
      */
     _generateLine(targetLength, seenWords) {
-        const { allowWeirdSpacing, repeatWords, readable, emojiSet, useEmojis, emojiPlacement, line } = this.config;
+        const { allowWeirdSpacing, repeatWords, readable, emojiSet, useEmojis, emojiPlacement, line } = this.#config;
         const parts = [];
         seenWords ??= new Set();
         while (parts.join(' ').length < targetLength) {
@@ -856,7 +933,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;
@@ -874,7 +951,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;
         if (paragraphs && typeof paragraphs === 'object') {
             const paraCount = Math.floor(Math.random() * (paragraphs.max - paragraphs.min + 1)) + paragraphs.min;
@@ -888,5 +966,26 @@ 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;
+    }
 }
 export default UltraRandomMsgGen;

package/dist/v1/libs/utils.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+/**
+ * Creates a internal method to verify if the instance was been destroyed.
+ * @param {string} name
+ */
+const createCheckDestroyed =
+  (name) =>
+  /**
+   * Internal method to verify if the instance has been destroyed.
+   * Throws an error if any operation is attempted after destruction.
+   * @param {boolean} isDestroyed
+   * @throws {Error}
+   * @returns {void}
+   */
+  (isDestroyed) => {
+    if (isDestroyed)
+      throw new Error(`This ${name} instance has been destroyed and can no longer be used.`);
+  };
+
+exports.createCheckDestroyed = createCheckDestroyed;

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

@@ -0,0 +1,6 @@
+/**
+ * Creates a internal method to verify if the instance was been destroyed.
+ * @param {string} name
+ */
+export declare const createCheckDestroyed: (name: string) => (isDestroyed: boolean) => void;
+//# sourceMappingURL=utils.d.mts.map

package/dist/v1/libs/utils.mjs

@@ -0,0 +1,16 @@
+/**
+ * Creates a internal method to verify if the instance was been destroyed.
+ * @param {string} name
+ */
+export const createCheckDestroyed = (name) => 
+/**
+ * Internal method to verify if the instance has been destroyed.
+ * Throws an error if any operation is attempted after destruction.
+ * @param {boolean} isDestroyed
+ * @throws {Error}
+ * @returns {void}
+ */
+(isDestroyed) => {
+    if (isDestroyed)
+        throw new Error(`This ${name} instance has been destroyed and can no longer be used.`);
+};

package/docs/v1/README.md

@@ -62,6 +62,7 @@ Here, you can navigate through different sections of the project. Below are the
 * 🕒 **[TinyAnalogClock](./libs/TinyAnalogClock.md)** — A lightweight analog clock engine for managing time-based rotations, supporting custom offsets, smooth transitions, and easy binding to CSS variables rendering.
 * 🔍 **[TinyArrayComparator](./libs/TinyArrayComparator.md)** — A lightweight, highly optimized JavaScript utility class designed to compare two arrays and efficiently detect which items were **added** or **deleted**.
 * 🧠 **[TinyMamdaniInferenceSystem](./libs/TinyMamdaniInferenceSystem.md)** — A implementation of a Mamdani Inference System, allowing you to model logic using trapezoidal membership functions.
+* 📻 **[TinyRadioFm](./libs/TinyRadioFm.md)** — It is designed to handle complex playback sequences, including music and voice playlists, scheduled timeline mutations, and custom content injections, all while maintaining absolute reproducibility through a mathematical seed.
 * ⏯️ **[TinyMediaPlayer](./libs/TinyMediaPlayer.md)** — A universal media player architecture utilizing an adapter pattern to orchestrate multiple platform APIs, featuring robust playlist management, playback controls, and weighted random selection.
 
 ### 2.1. **`libs/TinyClassManager`**

package/docs/v1/basics/array.md

@@ -15,7 +15,7 @@ A minimal and handy module offering a couple of focused utilities for working wi
 ### 🚀 Usage
 
 ```js
-import { shuffleArray } from './array.mjs';
+import { shuffleArray } from 'tiny-essentials/basics/array';
 
 const fruits = ['apple', 'banana', 'cherry', 'date'];
 shuffleArray(fruits);
@@ -37,7 +37,7 @@ You can find the original discussion here:
 ### 📌 Function Signature
 
 ```js
-arraySortPositions(item: string, isReverse?: boolean): (a: Object<string|number, *>, b: Object<string|number, *>) => number
+arraySortPositions(item?: string, isReverse?: boolean): (a: Object<string|number, *>, b: Object<string|number, *>) => number
 ```
 
 ### 🧠 Parameters

package/docs/v1/basics/deprecated/html.md

@@ -0,0 +1,17 @@
+### 🌐 `fetchTemplate(...)`
+
+Loads data from a remote URL using the Fetch API, with support for custom HTTP methods, retries, timeouts, headers, and even external abort controllers.
+
+#### 📥 Parameters
+
+* `url` *(string)*: The full URL to fetch from (must start with `http://`, `https://`, `/`, `./`, or `../`).
+* `options` *(object)* *(optional)*:
+
+  * `signal` *(`AbortSignal` | `null`)*: Custom abort signal.
+  * `method` *(string)*: The HTTP method to use (e.g., `GET`, `POST`, `PUT`, `DELETE`, etc.).
+  * `timeout` *(number)*: Request timeout in milliseconds. Default is `0` (no timeout).
+  * `retries` *(number)*: Number of retry attempts if the request fails. Default is `0`.
+  * `headers` *(object)*: Additional headers to include in the request.
+  * `body` *(object)*: Request body. If the value is a plain object, it will be automatically stringified as JSON.
+  * `onProgress` *((loaded: number, total: number) => void)*: Track the load progress.
+  * `returnResponse` *((res: Response) => ResponseInit)* *(optional)*: The callback function to return the ResponseInit to ReadableStream.

package/docs/v1/basics/fullScreen.md

@@ -167,7 +167,7 @@ import {
   isFullScreenMode,
   onFullScreenChange,
   offFullScreenChange,
-} from './fullScreen';
+} from 'tiny-essentials/basics/fullScreen';
 
 async function toggleFullscreen() {
   if (isFullScreenMode()) {

package/docs/v1/basics/html.md

@@ -140,24 +140,7 @@ const data = { name: 'Yasmin', type: 'dev' };
 saveJsonFile('yasmin.json', data);
 ```
 
-### 🌐 `fetchTemplate(...)`
-
-Loads data from a remote URL using the Fetch API, with support for custom HTTP methods, retries, timeouts, headers, and even external abort controllers.
-
-#### 📥 Parameters
-
-* `url` *(string)*: The full URL to fetch from (must start with `http://`, `https://`, `/`, `./`, or `../`).
-* `options` *(object)* *(optional)*:
-
-  * `signal` *(`AbortSignal` | `null`)*: Custom abort signal.
-  * `method` *(string)*: The HTTP method to use (e.g., `GET`, `POST`, `PUT`, `DELETE`, etc.).
-  * `timeout` *(number)*: Request timeout in milliseconds. Default is `0` (no timeout).
-  * `retries` *(number)*: Number of retry attempts if the request fails. Default is `0`.
-  * `headers` *(object)*: Additional headers to include in the request.
-  * `body` *(object)*: Request body. If the value is a plain object, it will be automatically stringified as JSON.
-  * `onProgress` *((loaded: number, total: number) => void)*: Track the load progress.
-
-#### `trackFetchProgress(response, onProgress)`
+#### `trackFetchProgress(response, onProgress, returnResponse?)`
 
 Intercepts a standard Fetch API Response to track the download progress of its body stream.
 
@@ -171,14 +154,15 @@ Intercepts a standard Fetch API Response to track the download progress of its b
 
 ---
 
-#### `fetchJson(url, options?)`
+#### `fetchJson(url, options?, onProgress?)`
 
 Loads and parses a remote JSON file.
 
 * **Parameters**:
 
   * `url` *(string)*: URL to fetch the JSON from.
-  * `options` *(object)* *(optional)*: Same structure as `fetchTemplate`.
+  * `options` *(object)* *(optional)*: Same structure as `fetch`.
+  * `onProgress` *(callback)* *(optional)*: Same structure as `FetchOnProgressResult`.
 
 * **Returns**:
   `Promise<any[] | Record<string | number | symbol, unknown>>` — The parsed JSON data.
@@ -190,7 +174,7 @@ Loads and parses a remote JSON file.
 
 ---
 
-#### `fetchBlob(url, allowedMimeTypes?, options?)`
+#### `fetchBlob(url, allowedMimeTypes?, options?, onProgress?)`
 
 Loads a remote file as a Blob object.
 
@@ -198,7 +182,8 @@ Loads a remote file as a Blob object.
 
   * `url` *(string)*: URL of the remote file.
   * `allowedMimeTypes` *(string\[])* *(optional)*: List of accepted MIME types.
-  * `options` *(object)* *(optional)*: Same structure as `fetchTemplate`.
+  * `options` *(object)* *(optional)*: Same structure as `fetch`.
+  * `onProgress` *(callback)* *(optional)*: Same structure as `FetchOnProgressResult`.
 
 * **Returns**:
   `Promise<Blob>`
@@ -210,7 +195,7 @@ Loads a remote file as a Blob object.
 
 ---
 
-#### `fetchText(url, allowedMimeTypes?, options?)`
+#### `fetchText(url, allowedMimeTypes?, options?, onProgress?)`
 
 Loads a remote file as **plain text** using the Fetch API.
 
@@ -218,7 +203,8 @@ Loads a remote file as **plain text** using the Fetch API.
 
   * `url` *(string)*: Full URL of the file to fetch.
   * `allowedMimeTypes` *(string\[])* *(optional)*: List of accepted MIME types (e.g., `['text/plain']`).
-  * `options` *(object)* *(optional)*: Same structure as `fetchTemplate`.
+  * `options` *(object)* *(optional)*: Same structure as `fetch`.
+  * `onProgress` *(callback)* *(optional)*: Same structure as `FetchOnProgressResult`.
 
 * **Returns**:
   `Promise<string>` — The content of the file as a text string.
@@ -317,7 +303,7 @@ Perfect for UI states like dimming, pausing animations, or showing "away" status
 #### 🧪 Usage
 
 ```js
-import { installWindowHiddenScript } from 'tiny-essentials';
+import { installWindowHiddenScript } from 'tiny-essentials/basics/html';
 
 const uninstall = installWindowHiddenScript({
   element: document.getElementById('app'),
@@ -425,7 +411,7 @@ The promise resolves to an object containing:
 #### 🧪 Example
 
 ```javascript
-import { loadImage } from './html.mjs';
+import { loadImage } from 'tiny-essentials/basics/html';
 
 const handleLoading = (event, startTime) => {
   console.log('Started loading at:', startTime);

package/docs/v1/basics/mediaContent.md

@@ -100,7 +100,7 @@ Downloads an audio file and uses a provided parser to extract its internal metad
 
 **1. Using a simple URL with manual overrides:**
 ```javascript
-import { parseMediaMetadata } from './mediaContent.mjs';
+import { parseMediaMetadata } from 'tiny-essentials/basics/mediaContent';
 import { parseBlob } from 'music-metadata';
 
 // Note: We pass empty objects for default/manual if we want to jump straight to the parser

package/docs/v1/basics/objChecker.md

@@ -15,7 +15,7 @@ Returns the number of elements in an array or the number of keys in an object.
 ```js
 countObj([1, 2, 3]);       // 3
 countObj({ a: 1, b: 2 });  // 2
-countObj('hi');            // 0
+countObj('hi');            // Throws TypeError
 ```
 
 ---

package/docs/v1/basics/text.md

@@ -162,7 +162,7 @@ console.log(safeTextTrim(longText, 30));
 
 ---
 
-## 🔎 `diffStrings(oldStrings, newStrings)`
+## 🔎 `diffObjList(oldStrings, newStrings)`
 
 Compares two **style objects** and identifies which properties were **added**, **removed**, or **modified**.
 
@@ -177,7 +177,7 @@ Compares two **style objects** and identifies which properties were **added**, *
 **Example:**
 
 ```js
-diffStrings(
+diffObjList(
   { color: 'red', display: 'block' },
   { color: 'blue', visibility: 'hidden' }
 );

package/docs/v1/fileManager/main.md

@@ -221,7 +221,7 @@ renameFilePadNumbers('./screenshots', 4, ['.jpg']);
 ## 📦 More Example Use
 
 ```js
-import { readJsonFile, writeJsonFile, listFiles, backupFile } from './utils/files.js';
+import { readJsonFile, writeJsonFile, listFiles, backupFile } from 'tiny-essentials/fileManager';
 
 const data = readJsonFile('./config/settings.json');
 data.debug = false;

package/docs/v1/libs/ColorSafeStringify.md

@@ -26,7 +26,7 @@ Then import both the stable stringifier and `ColorSafeStringify`:
 
 ```js
 import stringify from 'safe-stable-stringify';
-import { ColorSafeStringify } from 'tiny-essentials';
+import ColorSafeStringify from 'tiny-essentials/libs/ColorSafeStringify';
 ```
 
 ---

package/docs/v1/libs/TinyAfterScrollWatcher.md

@@ -19,7 +19,7 @@ Perfect for optimizing logic that should only run **after** the user has finishe
 ## 📦 Import
 
 ```js
-import TinyAfterScrollWatcher from './TinyAfterScrollWatcher.mjs';
+import TinyAfterScrollWatcher from 'tiny-essentials/libs/TinyAfterScrollWatcher';
 ```
 
 ---

package/docs/v1/libs/TinyAnalogClock.md

@@ -19,7 +19,7 @@
 Import the class into your JavaScript module.
 
 ```javascript
-import TinyAnalogClock from './TinyAnalogClock.js';
+import TinyAnalogClock from 'tiny-essentials/libs/TinyAnalogClock';
 ```
 
 ### 2. Basic Usage