tiny-essentials 1.26.4 → 1.27.1

package/dist/v1/libs/TinySmartScroller.cjs

@@ -46,6 +46,7 @@ var TinyEvents = require('./TinyEvents.cjs');
  * - Handles media element load events (e.g. `<img>`, `<iframe>`, `<video>`) to prevent sudden scroll jumps
  *
  * This class is **not framework-dependent** and works with vanilla DOM elements and the window object.
+ * @template {Element|Window} HTMLTarget
  */
 class TinySmartScroller {
   static Utils = { ...collision, TinyHtml };
@@ -302,6 +303,9 @@ class TinySmartScroller {
   #attributeFilter;
 
   /** @type {Element} */
+  #targetElement;
+
+  /** @type {HTMLTarget} */
   #target;
 
   /** @type {Set<NodeSizesEvent>} */
@@ -311,7 +315,7 @@ class TinySmartScroller {
    * Creates a new instance of TinySmartScroller, attaching scroll and resize observers to manage
    * automatic scroll behaviors, layout shift correction, and visibility tracking.
    *
-   * @param {Element|Window} target - The scroll container to monitor. Can be an element or `window`.
+   * @param {HTMLTarget} target - The scroll container to monitor. Can be an element or `window`.
    * @param {Object} [options={}] - Optional settings to configure scroll behavior.
    * @param {number} [options.extraScrollBoundary=0] - Extra margin in pixels to extend scroll boundary detection.
    * @param {boolean} [options.autoScrollBottom=true] - Whether to auto-scroll to bottom on layout updates.
@@ -335,7 +339,11 @@ class TinySmartScroller {
     } = {},
   ) {
     // === target ===
-    if (!(target instanceof Element || target === window))
+    if (!(
+      target instanceof Element ||
+      // @ts-ignore
+      target === window
+    ))
       throw new TypeError(
         `TinySmartScroller: 'target' must be a DOM Element or 'window', but got ${typeof target}`,
       );
@@ -378,7 +386,8 @@ class TinySmartScroller {
       );
 
     // Start values
-    this.#target = target instanceof Window ? document.documentElement : target;
+    this.#target = target;
+    this.#targetElement = target instanceof Window ? document.documentElement : target;
     this.#useWindow = target instanceof Window;
     this.#autoScrollBottom = autoScrollBottom;
     this.#observeMutations = observeMutations;
@@ -396,14 +405,14 @@ class TinySmartScroller {
       clearTimeout(timeout);
       timeout = setTimeout(() => this._onScroll(), this.#debounceTime);
     };
-    (this.#useWindow ? window : this.#target).addEventListener('scroll', this.#handler, {
+    (this.#useWindow ? window : this.#targetElement).addEventListener('scroll', this.#handler, {
       passive: true,
     });
 
     // Mutations
     if (this.#observeMutations) {
       this._observeMutations();
-      this._observeResizes(this.#target.children);
+      this._observeResizes(this.#targetElement.children);
     }
 
     this._scrollDataUpdater();
@@ -589,11 +598,11 @@ class TinySmartScroller {
    */
   _scrollDataUpdater() {
     const results = new Map();
-    this.#target.querySelectorAll(this.#querySelector || '*').forEach((target) => {
+    this.#targetElement.querySelectorAll(this.#querySelector || '*').forEach((target) => {
       const oldIsVisible = this.#newVisibles.get(target) ?? false;
       this.#oldVisibles.set(target, oldIsVisible);
 
-      const isVisible = TinyHtml.isInContainer(this.#target, target);
+      const isVisible = TinyHtml.isInContainer(this.#targetElement, target);
       this.#newVisibles.set(target, isVisible);
 
       results.set(target, { oldIsVisible, isVisible });
@@ -608,7 +617,7 @@ class TinySmartScroller {
     if (this.#destroyed) return;
     // Get values
     const scrollCache = this._scrollDataUpdater();
-    const el = this.#target;
+    const el = this.#targetElement;
     const scrollTop = el.scrollTop;
     const scrollHeight = el.scrollHeight;
     const clientHeight = el.clientHeight;
@@ -672,13 +681,15 @@ class TinySmartScroller {
       throw new TypeError('_fixScroll: targets must be an array of Elements');
 
     // Get Scroll data
-    const prevScrollHeight = this.#target.scrollHeight;
-    const prevScrollTop = this.#target.scrollTop;
+    const prevScrollHeight = this.#targetElement.scrollHeight;
+    const prevScrollTop = this.#targetElement.scrollTop;
     const prevBottomOffset =
-      this.#target.scrollHeight - this.#target.scrollTop - this.#target.clientHeight;
+      this.#targetElement.scrollHeight -
+      this.#targetElement.scrollTop -
+      this.#targetElement.clientHeight;
 
     // Get new size
-    const newScrollHeight = this.#target.scrollHeight;
+    const newScrollHeight = this.#targetElement.scrollHeight;
     const heightDelta = newScrollHeight - prevScrollHeight;
 
     /** @type {() => NodeSizes} */
@@ -726,7 +737,7 @@ class TinySmartScroller {
     // Fix scroll size
     if (
       this.#elemOldAmount > 0 &&
-      TinyHtml.hasScroll(this.#target).v &&
+      TinyHtml.hasScroll(this.#targetElement).v &&
       this.#autoScrollBottom &&
       this.#preserveScrollOnLayoutShift &&
       !this.#isAtBottom &&
@@ -734,9 +745,9 @@ class TinySmartScroller {
     ) {
       const scrollSize = calculateScrollSize();
       // Complete
-      this.#target.scrollTop = prevScrollTop + heightDelta + scrollSize.height;
+      this.#targetElement.scrollTop = prevScrollTop + heightDelta + scrollSize.height;
       if (scrollSize.width > 0)
-        this.#target.scrollLeft = this.#target.scrollLeft + scrollSize.width;
+        this.#targetElement.scrollLeft = this.#targetElement.scrollLeft + scrollSize.width;
     }
 
     // Normal stuff
@@ -745,8 +756,8 @@ class TinySmartScroller {
       this.scrollToBottom();
     } else if (!this.#autoScrollBottom && !this.#isAtBottom) {
       calculateScrollSize();
-      this.#target.scrollTop =
-        this.#target.scrollHeight - this.#target.clientHeight - prevBottomOffset;
+      this.#targetElement.scrollTop =
+        this.#targetElement.scrollHeight - this.#targetElement.clientHeight - prevBottomOffset;
     }
   }
   /**
@@ -757,7 +768,7 @@ class TinySmartScroller {
       if (this.#destroyed) return;
       this._scrollDataUpdater();
       this.#elemOldAmount = this.#elemAmount;
-      this.#elemAmount = this.#target.childElementCount;
+      this.#elemAmount = this.#targetElement.childElementCount;
 
       mutations.forEach((mutation) => {
         mutation.addedNodes.forEach((node) => {
@@ -778,7 +789,7 @@ class TinySmartScroller {
     });
 
     // Install observer
-    this.#mutationObserver.observe(this.#target, {
+    this.#mutationObserver.observe(this.#targetElement, {
       childList: true,
       subtree: true,
       attributes: true,
@@ -851,13 +862,15 @@ class TinySmartScroller {
     });
   }
 
+  get target() {
+    return this.#target;
+  }
+
   /**
    * Returns the internal scroll container element being monitored.
-   *
-   * @returns {Element} The DOM element used as the scroll container target.
    */
-  get target() {
-    return this.#target;
+  get targetElement() {
+    return this.#targetElement;
   }
 
   /**
@@ -953,14 +966,14 @@ class TinySmartScroller {
    * Forces the scroll position to move to the very bottom of the target.
    */
   scrollToBottom() {
-    this.#target.scrollTop = this.#target.scrollHeight;
+    this.#targetElement.scrollTop = this.#targetElement.scrollHeight;
   }
 
   /**
    * Forces the scroll position to move to the very top of the target.
    */
   scrollToTop() {
-    this.#target.scrollTop = 0;
+    this.#targetElement.scrollTop = 0;
   }
 
   /**
@@ -1146,7 +1159,7 @@ class TinySmartScroller {
     }
 
     // Removes scroll listener
-    const target = this.#useWindow ? window : this.#target;
+    const target = this.#useWindow ? window : this.#targetElement;
     if (this.#handler) target.removeEventListener('scroll', this.#handler);
 
     // Clean the WeakMaps

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

@@ -65,8 +65,9 @@ export type ScrollListenersFunc = (payload: any) => void;
  * - Handles media element load events (e.g. `<img>`, `<iframe>`, `<video>`) to prevent sudden scroll jumps
  *
  * This class is **not framework-dependent** and works with vanilla DOM elements and the window object.
+ * @template {Element|Window} HTMLTarget
  */
-declare class TinySmartScroller {
+declare class TinySmartScroller<HTMLTarget extends Element | Window> {
     static Utils: {
         TinyHtml: typeof TinyHtml;
         getElsRelativeCenterOffset(rect1: ObjRect, rect2: ObjRect): {
@@ -88,69 +89,19 @@ declare class TinySmartScroller {
         areElsCollTop: (rect1: ObjRect, rect2: ObjRect) => boolean;
         areElsCollBottom: (rect1: ObjRect, rect2: ObjRect) => boolean;
         areElsCollLeft: (rect1: ObjRect, rect2: ObjRect) => boolean;
-        areElsCollRight: (//////////////////////////////////////////////////////////////
-        /**
-         * Adds a event listener.
-         *
-         * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
-         * @param {ScrollListenersFunc} handler - Callback function to be called when event fires.
-         */
-        rect1: ObjRect
-        /**
-         * Adds a event listener.
-         *
-         * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
-         * @param {ScrollListenersFunc} handler - Callback function to be called when event fires.
-         */
-        , ////////////////////////////////////////////////////////
-        /**
-         * Adds a event listener.
-         *
-         * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
-         * @param {ScrollListenersFunc} handler - Callback function to be called when event fires.
-         */
-        rect2: ObjRect
-        /**
-         * Adds a event listener.
-         *
-         * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
-         * @param {ScrollListenersFunc} handler - Callback function to be called when event fires.
-         */
-        ) => boolean;
+        areElsCollRight: (rect1: ObjRect, rect2: ObjRect) => boolean;
         areElsCollPerfTop: (rect1: ObjRect, rect2: ObjRect) => boolean;
         areElsCollPerfBottom: (rect1: ObjRect, rect2: ObjRect) => boolean;
         areElsCollPerfLeft: (rect1: ObjRect, rect2: ObjRect) => boolean;
         areElsCollPerfRight: (rect1: ObjRect, rect2: ObjRect) => boolean;
-        areElsColliding: (////////////////////////////////////////////////////////
-        /**
-         * Removes a previously registered event listener.
-         *
-         * @param {string|string[]} event - The name of the event to remove the handler from.
-         * @param {ScrollListenersFunc} handler - The specific callback function to remove.
-         */
-        rect1: ObjRect
+        areElsColliding: (rect1: ObjRect, rect2: ObjRect) => boolean;
+        areElsPerfColliding: (rect1: ObjRect, rect2: ObjRect
         /**
-         * Removes a previously registered event listener.
+         * Removes all event listeners of a specific type from the element.
          *
-         * @param {string|string[]} event - The name of the event to remove the handler from.
-         * @param {ScrollListenersFunc} handler - The specific callback function to remove.
-         */
-        , //////////////////////////////////////////////////
-        /**
-         * Removes a previously registered event listener.
-         *
-         * @param {string|string[]} event - The name of the event to remove the handler from.
-         * @param {ScrollListenersFunc} handler - The specific callback function to remove.
-         */
-        rect2: ObjRect
-        /**
-         * Removes a previously registered event listener.
-         *
-         * @param {string|string[]} event - The name of the event to remove the handler from.
-         * @param {ScrollListenersFunc} handler - The specific callback function to remove.
+         * @param {string|string[]} event - The event type to remove (e.g. 'onScrollBoundary').
          */
         ) => boolean;
-        areElsPerfColliding: (rect1: ObjRect, rect2: ObjRect) => boolean;
         getElsColliding: (rect1: ObjRect, rect2: ObjRect) => string | null;
         getElsPerfColliding: (rect1: ObjRect, rect2: ObjRect) => "top" | "bottom" | "left" | "right" | null;
         getElsCollOverlap: (rect1: ObjRect, rect2: ObjRect) => {
@@ -168,7 +119,11 @@ declare class TinySmartScroller {
             dirX: Dirs;
             dirY: Dirs;
         };
-        getRectCenter: (rect: ObjRect) => {
+        getRectCenter: (/////////////////////////////
+        /** @type {WeakMap<Element, NodeSizes>} */
+        rect: ObjRect
+        /** @type {WeakMap<Element, NodeSizes>} */
+        ) => {
             x: number;
             y: number;
         };
@@ -177,7 +132,7 @@ declare class TinySmartScroller {
      * Creates a new instance of TinySmartScroller, attaching scroll and resize observers to manage
      * automatic scroll behaviors, layout shift correction, and visibility tracking.
      *
-     * @param {Element|Window} target - The scroll container to monitor. Can be an element or `window`.
+     * @param {HTMLTarget} target - The scroll container to monitor. Can be an element or `window`.
      * @param {Object} [options={}] - Optional settings to configure scroll behavior.
      * @param {number} [options.extraScrollBoundary=0] - Extra margin in pixels to extend scroll boundary detection.
      * @param {boolean} [options.autoScrollBottom=true] - Whether to auto-scroll to bottom on layout updates.
@@ -188,7 +143,7 @@ declare class TinySmartScroller {
      * @param {string[]|Set<string>|null} [options.attributeFilter=['class', 'style', 'src', 'data-*', 'height', 'width']]
      *     - Which attributes to observe for changes.
      */
-    constructor(target: Element | Window, { extraScrollBoundary, autoScrollBottom, observeMutations, preserveScrollOnLayoutShift, debounceTime, querySelector, attributeFilter, }?: {
+    constructor(target: HTMLTarget, { extraScrollBoundary, autoScrollBottom, observeMutations, preserveScrollOnLayoutShift, debounceTime, querySelector, attributeFilter, }?: {
         extraScrollBoundary?: number | undefined;
         autoScrollBottom?: boolean | undefined;
         observeMutations?: boolean | undefined;
@@ -451,12 +406,11 @@ declare class TinySmartScroller {
      * @param {NodeListOf<Element>|Element} elements - Target element(s) to listen on.
      */
     _listenLoadEvents(elements: NodeListOf<Element> | Element): void;
+    get target(): HTMLTarget;
     /**
      * Returns the internal scroll container element being monitored.
-     *
-     * @returns {Element} The DOM element used as the scroll container target.
      */
-    get target(): Element;
+    get targetElement(): Element;
     /**
      * Returns the previous size of a given element, or undefined if not tracked.
      *

package/dist/v1/libs/TinySmartScroller.mjs

@@ -40,6 +40,7 @@ import TinyEvents from './TinyEvents.mjs';
  * - Handles media element load events (e.g. `<img>`, `<iframe>`, `<video>`) to prevent sudden scroll jumps
  *
  * This class is **not framework-dependent** and works with vanilla DOM elements and the window object.
+ * @template {Element|Window} HTMLTarget
  */
 class TinySmartScroller {
     static Utils = { ...TinyCollision, TinyHtml };
@@ -259,6 +260,8 @@ class TinySmartScroller {
     /** @type {Set<string>} */
     #attributeFilter;
     /** @type {Element} */
+    #targetElement;
+    /** @type {HTMLTarget} */
     #target;
     /** @type {Set<NodeSizesEvent>} */
     #sizeFilter = new Set();
@@ -266,7 +269,7 @@ class TinySmartScroller {
      * Creates a new instance of TinySmartScroller, attaching scroll and resize observers to manage
      * automatic scroll behaviors, layout shift correction, and visibility tracking.
      *
-     * @param {Element|Window} target - The scroll container to monitor. Can be an element or `window`.
+     * @param {HTMLTarget} target - The scroll container to monitor. Can be an element or `window`.
      * @param {Object} [options={}] - Optional settings to configure scroll behavior.
      * @param {number} [options.extraScrollBoundary=0] - Extra margin in pixels to extend scroll boundary detection.
      * @param {boolean} [options.autoScrollBottom=true] - Whether to auto-scroll to bottom on layout updates.
@@ -279,7 +282,9 @@ class TinySmartScroller {
      */
     constructor(target, { extraScrollBoundary = 0, autoScrollBottom = true, observeMutations = true, preserveScrollOnLayoutShift = true, debounceTime = 100, querySelector = null, attributeFilter = ['class', 'style', 'src', 'data-*', 'height', 'width'], } = {}) {
         // === target ===
-        if (!(target instanceof Element || target === window))
+        if (!(target instanceof Element ||
+            // @ts-ignore
+            target === window))
             throw new TypeError(`TinySmartScroller: 'target' must be a DOM Element or 'window', but got ${typeof target}`);
         // === extraScrollBoundary ===
         if (typeof extraScrollBoundary !== 'number' || Number.isNaN(extraScrollBoundary))
@@ -304,7 +309,8 @@ class TinySmartScroller {
         if (!isValidAttrList)
             throw new TypeError(`TinySmartScroller: 'attributeFilter' must be an array, Set, or null. Got ${typeof attributeFilter}`);
         // Start values
-        this.#target = target instanceof Window ? document.documentElement : target;
+        this.#target = target;
+        this.#targetElement = target instanceof Window ? document.documentElement : target;
         this.#useWindow = target instanceof Window;
         this.#autoScrollBottom = autoScrollBottom;
         this.#observeMutations = observeMutations;
@@ -321,13 +327,13 @@ class TinySmartScroller {
             clearTimeout(timeout);
             timeout = setTimeout(() => this._onScroll(), this.#debounceTime);
         };
-        (this.#useWindow ? window : this.#target).addEventListener('scroll', this.#handler, {
+        (this.#useWindow ? window : this.#targetElement).addEventListener('scroll', this.#handler, {
             passive: true,
         });
         // Mutations
         if (this.#observeMutations) {
             this._observeMutations();
-            this._observeResizes(this.#target.children);
+            this._observeResizes(this.#targetElement.children);
         }
         this._scrollDataUpdater();
     }
@@ -502,10 +508,10 @@ class TinySmartScroller {
      */
     _scrollDataUpdater() {
         const results = new Map();
-        this.#target.querySelectorAll(this.#querySelector || '*').forEach((target) => {
+        this.#targetElement.querySelectorAll(this.#querySelector || '*').forEach((target) => {
             const oldIsVisible = this.#newVisibles.get(target) ?? false;
             this.#oldVisibles.set(target, oldIsVisible);
-            const isVisible = TinyHtml.isInContainer(this.#target, target);
+            const isVisible = TinyHtml.isInContainer(this.#targetElement, target);
             this.#newVisibles.set(target, isVisible);
             results.set(target, { oldIsVisible, isVisible });
         });
@@ -519,7 +525,7 @@ class TinySmartScroller {
             return;
         // Get values
         const scrollCache = this._scrollDataUpdater();
-        const el = this.#target;
+        const el = this.#targetElement;
         const scrollTop = el.scrollTop;
         const scrollHeight = el.scrollHeight;
         const clientHeight = el.clientHeight;
@@ -576,11 +582,13 @@ class TinySmartScroller {
         if (!Array.isArray(targets))
             throw new TypeError('_fixScroll: targets must be an array of Elements');
         // Get Scroll data
-        const prevScrollHeight = this.#target.scrollHeight;
-        const prevScrollTop = this.#target.scrollTop;
-        const prevBottomOffset = this.#target.scrollHeight - this.#target.scrollTop - this.#target.clientHeight;
+        const prevScrollHeight = this.#targetElement.scrollHeight;
+        const prevScrollTop = this.#targetElement.scrollTop;
+        const prevBottomOffset = this.#targetElement.scrollHeight -
+            this.#targetElement.scrollTop -
+            this.#targetElement.clientHeight;
         // Get new size
-        const newScrollHeight = this.#target.scrollHeight;
+        const newScrollHeight = this.#targetElement.scrollHeight;
         const heightDelta = newScrollHeight - prevScrollHeight;
         /** @type {() => NodeSizes} */
         const calculateScrollSize = () => {
@@ -618,16 +626,16 @@ class TinySmartScroller {
         };
         // Fix scroll size
         if (this.#elemOldAmount > 0 &&
-            TinyHtml.hasScroll(this.#target).v &&
+            TinyHtml.hasScroll(this.#targetElement).v &&
             this.#autoScrollBottom &&
             this.#preserveScrollOnLayoutShift &&
             !this.#isAtBottom &&
             !this.#isAtTop) {
             const scrollSize = calculateScrollSize();
             // Complete
-            this.#target.scrollTop = prevScrollTop + heightDelta + scrollSize.height;
+            this.#targetElement.scrollTop = prevScrollTop + heightDelta + scrollSize.height;
             if (scrollSize.width > 0)
-                this.#target.scrollLeft = this.#target.scrollLeft + scrollSize.width;
+                this.#targetElement.scrollLeft = this.#targetElement.scrollLeft + scrollSize.width;
         }
         // Normal stuff
         else if (!this.#scrollPaused && this.#autoScrollBottom) {
@@ -636,8 +644,8 @@ class TinySmartScroller {
         }
         else if (!this.#autoScrollBottom && !this.#isAtBottom) {
             calculateScrollSize();
-            this.#target.scrollTop =
-                this.#target.scrollHeight - this.#target.clientHeight - prevBottomOffset;
+            this.#targetElement.scrollTop =
+                this.#targetElement.scrollHeight - this.#targetElement.clientHeight - prevBottomOffset;
         }
     }
     /**
@@ -649,7 +657,7 @@ class TinySmartScroller {
                 return;
             this._scrollDataUpdater();
             this.#elemOldAmount = this.#elemAmount;
-            this.#elemAmount = this.#target.childElementCount;
+            this.#elemAmount = this.#targetElement.childElementCount;
             mutations.forEach((mutation) => {
                 mutation.addedNodes.forEach((node) => {
                     if (!(node instanceof Element) || node.nodeType !== 1)
@@ -666,7 +674,7 @@ class TinySmartScroller {
             this._fixScroll();
         });
         // Install observer
-        this.#mutationObserver.observe(this.#target, {
+        this.#mutationObserver.observe(this.#targetElement, {
             childList: true,
             subtree: true,
             attributes: true,
@@ -733,13 +741,14 @@ class TinySmartScroller {
             }
         });
     }
+    get target() {
+        return this.#target;
+    }
     /**
      * Returns the internal scroll container element being monitored.
-     *
-     * @returns {Element} The DOM element used as the scroll container target.
      */
-    get target() {
-        return this.#target;
+    get targetElement() {
+        return this.#targetElement;
     }
     /**
      * Returns the previous size of a given element, or undefined if not tracked.
@@ -825,13 +834,13 @@ class TinySmartScroller {
      * Forces the scroll position to move to the very bottom of the target.
      */
     scrollToBottom() {
-        this.#target.scrollTop = this.#target.scrollHeight;
+        this.#targetElement.scrollTop = this.#targetElement.scrollHeight;
     }
     /**
      * Forces the scroll position to move to the very top of the target.
      */
     scrollToTop() {
-        this.#target.scrollTop = 0;
+        this.#targetElement.scrollTop = 0;
     }
     /**
      * Checks if the user is within the defined extra scroll boundary from the bottom.
@@ -996,7 +1005,7 @@ class TinySmartScroller {
             this.#resizeObserver = null;
         }
         // Removes scroll listener
-        const target = this.#useWindow ? window : this.#target;
+        const target = this.#useWindow ? window : this.#targetElement;
         if (this.#handler)
             target.removeEventListener('scroll', this.#handler);
         // Clean the WeakMaps

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

@@ -160,23 +160,23 @@ export type MsgGenConfig = {
  */
 declare class UltraRandomMsgGen {
     /** @type {string[]} */
-    static "__#private@#defaultWords": string[];
+    static #defaultWords: string[];
     /** @type {string[]} */
-    static "__#private@#defaultEmojis": string[];
+    static #defaultEmojis: string[];
     /** @type {string[]} */
-    static "__#private@#defaultNouns": string[];
+    static #defaultNouns: string[];
     /** @type {string[]} */
-    static "__#private@#defaultVerbs": string[];
+    static #defaultVerbs: string[];
     /** @type {string[]} */
-    static "__#private@#defaultAdjectives": string[];
+    static #defaultAdjectives: string[];
     /** @type {string[]} */
-    static "__#private@#defaultTemplates": string[];
+    static #defaultTemplates: string[];
     /**
      * Utility to validate arrays before setting.
      * @param {any} value
      * @param {string} field
      */
-    static "__#private@#validateArray"(value: any, field: string): void;
+    static #validateArray(value: any, field: string): void;
     /** @param {string[]} value */
     static set defaultWords(value: string[]);
     /** @returns {string[]} */

package/docs/v1/README.md

@@ -20,6 +20,7 @@ Here, you can navigate through different sections of the project. Below are the
 - 🖼️ **[Html](./basics/html.md)** — Utilities for handling DOM element interactions like collision detection and basic element manipulation.
 - 📺 **[FullScreen](./basics/fullScreen.md)** — A complete fullscreen API manager with detection, event handling, and cross-browser compatibility.
 - 🧱 **[Collision](./basics/collision.md)** — Full-featured rectangle collision detection system with directional analysis, depth calculation, and center offset metrics.
+- 🎵 **[MediaContent](./basics/mediaContent.md)** — A comprehensive media processing module for downloading audio, extracting rich ID3 metadata, and managing image blobs for album art.
 
 ### 2. **`libs/`**
 - 🗂️ **[TinyPromiseQueue](./libs/TinyPromiseQueue.md)** — A class that allows sequential execution of asynchronous tasks, supporting task delays, cancellation, and queue management.
@@ -62,7 +63,12 @@ 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.
+* ⏯️ **[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`**
+
 * ⚙️ **[TinyClassManager](./libs/TinyClassManager.md)** — A lightweight, immutable manager designed to linearly compose a base class with multiple modular plugins, featuring automatic dependency verification and duplicate conflict protection.
+* 🛠️ **[TinyPluginInliner](./libs/TinyClassManager/TinyPluginInliner.md)** — A powerful build-time utility that inlines plugin code into a single bundle, automatically rewriting import paths and hoisting dependencies for seamless deployment.
 
 ### 3. **`fileManager/`**
 * 📁 **[Main](./fileManager/main.md)** — A Node.js file/directory utility module with support for JSON, backups, renaming, size analysis, and more.