tiny-essentials 1.28.15 → 1.28.17

package/docs/v1/Exports.md

@@ -30,11 +30,6 @@ import "tiny-essentials/css/TinyNotify.min.css";
   * `"require"` → `dist/v1/index.cjs`
   * `"import"` → `dist/v1/index.mjs`
 
-* `libs` → all library helpers
-
-  * `"require"` → `dist/v1/libs/index.cjs`
-  * `"import"` → `dist/v1/libs/index.mjs`
-
 * `basics` → general utility functions
 
   * `"require"` → `dist/v1/basics/index.cjs`
@@ -51,15 +46,21 @@ import "tiny-essentials/css/TinyNotify.min.css";
 
 Direct access to smaller utilities:
 
+* `basics/mediaContent`
 * `basics/array`
 * `basics/clock`
 * `basics/collision`
 * `basics/fullScreen`
 * `basics/html`
+* `basics/deprecated/html`
 * `basics/objChecker`
 * `basics/objFilter`
+* `basics/extendObjType/Buffer`
 * `basics/simpleMath`
 * `basics/text`
+* `basics/promiseUtils`
+* `basics/browserDetector`
+* `basics/jsonFilter`
 
 Direct access to file utilities:
 
@@ -72,118 +73,155 @@ Direct access to file utilities:
 
 Each library can be imported separately:
 
-* **General Tools** 🛠
-
-  * `libs/ColorSafeStringify`
-  * `libs/UltraRandomMsgGen`
-  * `libs/TinyUploadClicker`
-  * `libs/TinyToastNotify`
-  * `libs/TinyTimeout`
-  * `libs/TinyTextRangeEditor`
-  * `libs/TinyTextarea`
-  * `libs/TinySmartScroller`
-  * `libs/TinySimpleDice`
-  * `libs/TinyRateLimiter`
-  * `libs/TinyPromiseQueue`
-  * `libs/TinyNotifyCenter`
-  * `libs/TinyNotifications`
-  * `libs/TinyNewWinEvents`
-  * `libs/TinyNeedBar`
-  * `libs/TinyLocalStorage`
-  * `libs/TinyLoadingScreen`
-  * `libs/TinyColorValidator`
-  * `libs/TinyInventoryTrader`
-  * `libs/TinyInventory`
-  * `libs/TinyIframeEvents`
-  * `libs/TinyI18`
-  * `libs/TinyLevelUp`
-  * `libs/TinyGamepad`
-  * `libs/TinyElementObserver`
-  * `libs/TinyDragger`
-  * `libs/TinyDragDropDetector`
-  * `libs/TinyDomReadyManager`
-  * `libs/TinyDayNightCycle`
-  * `libs/TinyCookieConsent`
-  * `libs/TinyColorConverter`
-  * `libs/TinyClipboard`
-  * `libs/TinyArrayPaginator`
-  * `libs/TinyAfterScrollWatcher`
-  * `libs/TinyAdvancedRaffle`
-
-* **HTML Helpers** 🧩
-
-  * `libs/TinyHtml`
-  * `libs/TinyHtmlElems` (BETA)
+* **General Tools 🛠**
+
+  * **Utils & Tools**
+    * `libs/utils/tools`
+    * `libs/utils/UltraRandomMsgGen`
+    * `libs/utils/TinyPromiseQueue`
+    * `libs/tools/TinyDebugger`
+    * `libs/tools/TinyClassManager`
+    * `libs/tools/TinyClassManager/TinyPluginInliner`
+    * `libs/tools/TinyPkgExportValidator`
+
+  * **Color**
+    * `libs/color/ColorSafeStringify`
+    * `libs/color/TinyColorValidator`
+    * `libs/color/TinyColorConverter`
+
+  * **Math**
+    * `libs/math/TinyTimeout`
+    * `libs/math/TinySimpleDice`
+    * `libs/math/TinyRateLimiter`
+    * `libs/math/TinyAdvancedRaffle`
+    * `libs/math/TinyMamdaniInferenceSystem`
+
+  * **Text**
+    * `libs/text/TinyTextRangeEditor`
+    * `libs/text/TinyTextarea`
+    * `libs/text/TinyI18`
+    * `libs/text/TinyClipboard`
+    * `libs/text/TinyTextDiffer`
+
+  * **Array**
+    * `libs/array/TinyArrayPaginator`
+    * `libs/array/TinyArrayComparator`
+
+  * **HTML & UI Helpers**
+    * `libs/html/upload/TinyUploadClicker`
+    * `libs/html/notification/TinyToastNotify`
+    * `libs/html/notification/TinyNotifyCenter`
+    * `libs/html/notification/TinyNotifications`
+    * `libs/html/events/TinyNewWinEvents`
+    * `libs/html/events/TinyIframeEvents`
+    * `libs/html/scroll/TinySmartScroller`
+    * `libs/html/scroll/TinyAfterScrollWatcher`
+    * `libs/html/templates/TinyLoadingScreen`
+    * `libs/html/templates/TinyCookieConsent`
+    * `libs/html/templates/TinyAnalogClock`
+    * `libs/html/drag/TinyDragger`
+    * `libs/html/drag/TinyDragDropDetector`
+    * `libs/html/TinyElementObserver`
+    * `libs/html/TinyDomReadyManager`
+
+  * **Game**
+    * `libs/game/TinyNeedBar`
+    * `libs/game/TinyInventoryTrader`
+    * `libs/game/TinyInventory`
+    * `libs/game/TinyLevelUp`
+    * `libs/game/TinyGamepad`
+    * `libs/game/TinyDayNightCycle`
+
+  * **Storage**
+    * `libs/storage/TinyLocalStorage`
+
+* **Media 🎬**
+
+  * `libs/media/TinyMediaPlayer`
+  * `libs/media/TinyMediaPlayer/Base`
+  * `libs/media/TinyMediaPlayer/Youtube`
+  * `libs/media/TinyMediaPlayer/SoundCloud`
+  * `libs/media/TinyMediaPlayer/HtmlAudio`
+  * `libs/media/TinyMediaPlayer/HtmlVideo`
+  * `libs/media/TinyMediaPlayer/Mock`
+  * `libs/media/TinyMediaPlayer/docs/YouTubePlayer`
+  * `libs/media/TinyMediaPlayer/docs/SoundCloudWidget`
+  * `libs/media/TinyRadioFm`
+
+* **HTML Helpers 🧩**
+
+  * `libs/html/TinyHtml`
+  * `libs/html/TinyHtmlElems` (BETA)
 
   * **General Elements (BETA)**
 
-    * `libs/TinyHtmlElems/Anchor`
-    * `libs/TinyHtmlElems/Button`
-    * `libs/TinyHtmlElems/Canvas`
-    * `libs/TinyHtmlElems/Datalist`
-    * `libs/TinyHtmlElems/Form`
-    * `libs/TinyHtmlElems/Embed`
-    * `libs/TinyHtmlElems/Icon`
-    * `libs/TinyHtmlElems/Iframe`
-    * `libs/TinyHtmlElems/Image`
-    * `libs/TinyHtmlElems/Link`
-    * `libs/TinyHtmlElems/Script`
-    * `libs/TinyHtmlElems/Select`
-    * `libs/TinyHtmlElems/Style`
-    * `libs/TinyHtmlElems/Template`
-    * `libs/TinyHtmlElems/Textarea`
+    * `libs/html/TinyHtmlElems/Anchor`
+    * `libs/html/TinyHtmlElems/Button`
+    * `libs/html/TinyHtmlElems/Canvas`
+    * `libs/html/TinyHtmlElems/Datalist`
+    * `libs/html/TinyHtmlElems/Form`
+    * `libs/html/TinyHtmlElems/Embed`
+    * `libs/html/TinyHtmlElems/Icon`
+    * `libs/html/TinyHtmlElems/Iframe`
+    * `libs/html/TinyHtmlElems/Image`
+    * `libs/html/TinyHtmlElems/Link`
+    * `libs/html/TinyHtmlElems/Script`
+    * `libs/html/TinyHtmlElems/Select`
+    * `libs/html/TinyHtmlElems/Style`
+    * `libs/html/TinyHtmlElems/Template`
+    * `libs/html/TinyHtmlElems/Textarea`
 
   * **Media Elements (BETA)** 🎬
 
-    * `libs/TinyHtmlElems/Media`
-    * `libs/TinyHtmlElems/Media/Audio`
-    * `libs/TinyHtmlElems/Media/Object`
-    * `libs/TinyHtmlElems/Media/Source`
-    * `libs/TinyHtmlElems/Media/Video`
+    * `libs/html/TinyHtmlElems/Media`
+    * `libs/html/TinyHtmlElems/Media/Audio`
+    * `libs/html/TinyHtmlElems/Media/Object`
+    * `libs/html/TinyHtmlElems/Media/Source`
+    * `libs/html/TinyHtmlElems/Media/Video`
 
   * **Input Elements (BETA)** ⌨️
 
-    * `libs/TinyHtmlElems/Input`
+    * `libs/html/TinyHtmlElems/Input`
 
     * **Button Inputs (BETA)**
 
-      * `libs/TinyHtmlElems/Input/Button`
-      * `libs/TinyHtmlElems/Input/Reset`
-      * `libs/TinyHtmlElems/Input/Submit`
+      * `libs/html/TinyHtmlElems/Input/Button`
+      * `libs/html/TinyHtmlElems/Input/Reset`
+      * `libs/html/TinyHtmlElems/Input/Submit`
 
     * **Check Inputs (BETA)**
 
-      * `libs/TinyHtmlElems/Input/Checkbox`
-      * `libs/TinyHtmlElems/Input/Radio`
+      * `libs/html/TinyHtmlElems/Input/Checkbox`
+      * `libs/html/TinyHtmlElems/Input/Radio`
 
     * **Color & File Inputs (BETA)**
 
-      * `libs/TinyHtmlElems/Input/Color`
-      * `libs/TinyHtmlElems/Input/File`
-      * `libs/TinyHtmlElems/Input/Hidden`
-      * `libs/TinyHtmlElems/Input/Image`
+      * `libs/html/TinyHtmlElems/Input/Color`
+      * `libs/html/TinyHtmlElems/Input/File`
+      * `libs/html/TinyHtmlElems/Input/Hidden`
+      * `libs/html/TinyHtmlElems/Input/Image`
 
     * **Date & Time Inputs (BETA)** 🕒
 
-      * `libs/TinyHtmlElems/Input/Date`
-      * `libs/TinyHtmlElems/Input/DateTime`
-      * `libs/TinyHtmlElems/Input/Month`
-      * `libs/TinyHtmlElems/Input/Time`
-      * `libs/TinyHtmlElems/Input/Week`
+      * `libs/html/TinyHtmlElems/Input/Date`
+      * `libs/html/TinyHtmlElems/Input/DateTime`
+      * `libs/html/TinyHtmlElems/Input/Month`
+      * `libs/html/TinyHtmlElems/Input/Time`
+      * `libs/html/TinyHtmlElems/Input/Week`
 
     * **Number Inputs (BETA)** 🔢
 
-      * `libs/TinyHtmlElems/Input/Number`
-      * `libs/TinyHtmlElems/Input/Range`
+      * `libs/html/TinyHtmlElems/Input/Number`
+      * `libs/html/TinyHtmlElems/Input/Range`
 
     * **Text Inputs (BETA)** ✏️
 
-      * `libs/TinyHtmlElems/Input/Email`
-      * `libs/TinyHtmlElems/Input/Password`
-      * `libs/TinyHtmlElems/Input/Search`
-      * `libs/TinyHtmlElems/Input/Tel`
-      * `libs/TinyHtmlElems/Input/Text`
-      * `libs/TinyHtmlElems/Input/Url`
+      * `libs/html/TinyHtmlElems/Input/Email`
+      * `libs/html/TinyHtmlElems/Input/Password`
+      * `libs/html/TinyHtmlElems/Input/Search`
+      * `libs/html/TinyHtmlElems/Input/Tel`
+      * `libs/html/TinyHtmlElems/Input/Text`
+      * `libs/html/TinyHtmlElems/Input/Url`
 
 ---
 
@@ -192,11 +230,11 @@ Each library can be imported separately:
 **ESM (modern projects)**
 
 ```js
-import { TinyTextarea } from "tiny-essentials/libs/TinyTextarea";
+import TinyTextarea from "tiny-essentials/libs/text/TinyTextarea";
 ```
 
 **CommonJS (Node.js)**
 
 ```js
-const { TinyTextarea } = require("tiny-essentials/libs/TinyTextarea");
+const { shuffleArray } = require("tiny-essentials/basics/array");
 ```

package/docs/v1/README.md

@@ -13,6 +13,7 @@ Here, you can navigate through different sections of the project. Below are the
 - 📦 **[Array](./basics/array.md)** — A tiny utility for shuffling arrays using the Fisher–Yates algorithm.
 - ⏰ **[Clock](./basics/clock.md)** — A versatile time utility module for calculating and formatting time durations.
 - 🧠 **[ObjFilter](./basics/objFilter.md)** — Type detection, extension, and analysis made easy with simple and extensible type validation.
+- 🔍 **[jsonFilter](./basics/jsonFilter.md)** — High-precision utilities for filtering objects, arrays, and complex data structures like Maps and Sets.
 * 🧮 **[objChecker](./basics/objChecker.md)** — Utilities for counting keys in objects or arrays and for safely detecting plain JSON-compatible objects.
 - 🔢 **[SimpleMath](./basics/simpleMath.md)** — A collection of simple math utilities for calculations like the Rule of Three and percentages.
 - ✍️ **[Text](./basics/text.md)** — A utility for transforming text into title case formats, with multiple options for capitalization.
@@ -24,62 +25,113 @@ Here, you can navigate through different sections of the project. Below are the
 - 📦 **[BrowserDetector](./basics/browserDetector.md)** — A multi-layered JavaScript utility for identifying the user's web browser and rendering engine.
 
 ### 2. **`libs/`**
-- 🗂️ **[TinyPromiseQueue](./libs/TinyPromiseQueue.md)** — A class that allows sequential execution of asynchronous tasks, supporting task delays, cancellation, and queue management.
-- 🏅 **[TinyLevelUp](./libs/TinyLevelUp.md)** — A class to manage user level-up logic based on experience points, providing methods for experience validation, addition, removal, and calculation.
-- 🎨 **[ColorSafeStringify](./libs/ColorSafeStringify.md)** — A utility for applying customizable ANSI colors to JSON strings in terminal outputs, supporting presets and fine-grained type-based highlighting.
-- 🚦 **[TinyRateLimiter](./libs/TinyRateLimiter.md)** — A flexible per-user rate limiter supporting time windows, hit caps, and automatic cleanup of inactive users.
-- 🔔 **[TinyNotifyCenter](./libs/TinyNotifyCenter.md)** — A dynamic notification center class to display, manage, and interact with notifications, supporting avatars, clickable items, HTML/text modes, and clean UI controls.
-- 🍞 **[TinyToastNotify](./libs/TinyToastNotify.md)** — A lightweight toast notification system supporting positioning, timing customization, avatars, click actions, and fade-out animations.
-- 📥 **[TinyDragDropDetector](./libs/TinyDragDropDetector.md)** — A lightweight drag-and-drop detector for files, handling the full drag lifecycle (`enter`, `over`, `leave`, `drop`) with CSS hover management and safe event handling on any DOM element or the full page.
-- 📂 **[TinyUploadClicker](./libs/TinyUploadClicker.md)** — A minimal utility to bind any clickable element to a hidden file input, offering full control over styling, behavior, and upload event hooks.
-- 🧲 **[TinyDragger](./libs/TinyDragger.md)** — A flexible drag-and-drop manager with collision detection, jail constraints, vibration feedback, visual proxies, revert-on-drop, and full custom event support.
-- 🕒 **[TinyDomReadyManager](./libs/TinyDomReadyManager.md)** — A readiness manager for DOM and async conditions, supporting prioritized callbacks, custom filters, and event-based or promise-based bootstrapping.
-- 📣 **[TinyNotifications](./libs/TinyNotifications.md)** — A browser notification utility with sound support, permission management, truncation logic, default icons, and enforced validation to ensure safe and predictable usage.
-- 🧱 **[TinyHtml](./libs/TinyHtml.md)** — A minimalist DOM utility class that offers jQuery-like methods in pure JavaScript for querying, styling, traversing, event handling, collision detection, and visibility logic — all in a lightweight and chainable interface.
-- 🌀 **[TinySmartScroller](./libs/TinySmartScroller.md)** — A smart scroll monitor that detects user scroll behavior, visibility changes, element sizes, and automatically handles scroll preservation, bottom detection, debounce, and more.
-- 📋 **[TinyClipboard](./libs/TinyClipboard.md)** — A clipboard management utility with support for modern APIs, legacy fallbacks, and custom copy handlers for text and blobs, plus flexible read operations and clipboard item filtering.
-- 🍮 **[UltraRandomMsgGen](./libs/UltraRandomMsgGen.md)** — A whimsical random message generator using grammar templates, word sets, emojis, and chaotic modes to craft playful text outputs.
-- ✍️ **[TinyTextRangeEditor](./libs/TinyTextRangeEditor.md)** — An flexible text range manipulation utility for `input` and `textarea` elements. Supports selection, cursor control, tag insertion, attribute handling, inline editing, formatting, and advanced wrap/toggle logic with optional spacing auto-completion.
-- ⏳ **[TinyTimeout](./libs/TinyTimeout.md)** — A dynamic timeout and delay manager with support for usage-based throttling, delay scaling, configurable decay intervals, and asynchronous polling for conditions.
-- 🌈 **[TinyColorConverter](./libs/TinyColorConverter.md)** — A complete color conversion toolkit supporting hex, RGB(A), HSL(A), and integer formats, with smooth gradient generation, color parsing, and multi-format output conversion.
-- 📦 **[TinyLocalStorage](./libs/TinyLocalStorage.md)** — A tiny wrapper for `localStorage` with full support for objects, arrays, `Map`, `Set`, and typed value helpers like string, number, and boolean.
-- 🖼️ **[TinyIframeEvents](./libs/TinyIframeEvents.md)** — A structured `postMessage`-based event router for secure and reliable communication between a parent window and its embedded iframe. Supports directional filtering, origin enforcement, payload transport, and listener lifecycle.
-- 🪟 **[TinyNewWinEvents](./libs/TinyNewWinEvents.md)** — A smart, route-based `postMessage` system for structured communication between a main window and a popup (`window.open`). Includes queueing, origin enforcement, and lifecycle tracking.
-- 🎮 **[TinyGamepad](./libs/TinyGamepad.md)** — A flexible, professional gamepad and input manager supporting keyboard, mouse, combos, haptics, and custom input mappings.
-- ✨ **[TinyTextarea](./libs/TinyTextarea.md)** — A minimal auto-expanding `<textarea>` manager with configurable row limits, extra height padding, and real-time resize/input event hooks.
-- 🌞 **[TinyDayNightCycle](./libs/TinyDayNightCycle.md)** — A comprehensive day-night cycle system managing seasons, moons, time, and weather with configurable durations, phases, and dynamic weather selection.
-- 🎯 **[TinyAdvancedRaffle](./libs/TinyAdvancedRaffle.md)** — An advanced, seedable raffle system with weighted items, pity systems, exclusions, group management, modifiers, conditional rules, normalization modes, and JSON import/export.
-- 📄 **[TinyArrayPaginator](./libs/TinyArrayPaginator.md)** — A secure and flexible array pagination wrapper that returns paginated results along with metadata, supports filtering via predicates or object-based matching, and prevents direct modification of the source data. 
-- 🍪 **[TinyCookieConsent](./libs/TinyCookieConsent.md)** — A flexible and customizable cookie consent manager that displays a consent bar, supports multiple categories, saves preferences in localStorage, allows custom renderers, and provides smooth animations for showing and hiding elements. 
-- 📦 **[TinyInventory](./libs/TinyInventory.md)** — A robust inventory management system with stack handling, slot management, special equipment slots, serialization, cloning, and item registry support.
-- 🤝 **[TinyInventoryTrader](./libs/TinyInventoryTrader.md)** — A trading helper for safely transferring items between two inventories with support for strict mode, slot targeting, and batch operations.
-- 🌐 **[TinyI18](./libs/TinyI18.md)** — A flexible i18n manager supporting local and file modes, regex-based keys, function-based entries, string interpolation, and safe helper functions for advanced rendering.
-- 🎮 **[TinyNeedBar](./libs/TinyNeedBar.md)** — A versatile "need bar" system for simulating decay over time with multiple configurable factors, serialization, cloning, and full control over clamped and infinite values.
-- 🎲 **[TinySimpleDice](./libs/TinySimpleDice.md)** — A lightweight and flexible dice rolling utility with configurable maximum values, zero allowance, and array/Set index rolling support.
-- 👀 **[TinyElementObserver](./libs/TinyElementObserver.md)** — A DOM mutation tracking utility built on MutationObserver, with customizable detectors for handling changes, event dispatching, and lifecycle management.  
-- ⏳ **[TinyLoadingScreen](./libs/TinyLoadingScreen.md)** — A lightweight, fully-configurable loading overlay with fade-in/out animations, custom messages (string or HTMLElement), HTML rendering option, and status-change callbacks.
-- 🎨 **[TinyColorValidator](./libs/TinyColorValidator.md)** — A comprehensive CSS color validation and parsing utility supporting HEX, HEXA, RGB, RGBA, HSL, HSLA, HWB, Lab, LCH, standard HTML color names, and special keywords, with automatic type detection and parsing.
-* 📝 **[TinyTextDiffer](./libs/TinyTextDiffer.md)** — A granular text comparison utility using the LCS algorithm to detect additions, deletions, and unchanged segments between multiple history versions, returning a clean, parseable diff structure.
-* 🕒 **[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.
-* 🛠️ **[TinyDebugger](./libs/TinyDebugger.md)** — A lightweight, event-driven debugging utility designed to wrap standard `console` methods. It provides enhanced features such as custom prefixes, color support, and the ability to emit events whenever a log occurs, making it perfect for complex applications where you might want to redirect logs to an external service or a UI component.
-
-### 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.
+
+### 2.1. **`libs/storage`**
+
+- 📦 **[TinyLocalStorage](./libs/storage/TinyLocalStorage.md)** — A tiny wrapper for `localStorage` with full support for objects, arrays, `Map`, `Set`, and typed value helpers like string, number, and boolean.
+
+### 2.2. **`libs/utils`**
+
+- 🗂️ **[TinyPromiseQueue](./libs/utils/TinyPromiseQueue.md)** — A class that allows sequential execution of asynchronous tasks, supporting task delays, cancellation, and queue management.
+- 🍮 **[UltraRandomMsgGen](./libs/utils/UltraRandomMsgGen.md)** — A whimsical random message generator using grammar templates, word sets, emojis, and chaotic modes to craft playful text outputs.
+
+### 2.3. **`libs/game`**
+
+- 🏅 **[TinyLevelUp](./libs/game/TinyLevelUp.md)** — A class to manage user level-up logic based on experience points, providing methods for experience validation, addition, removal, and calculation.
+- 🎮 **[TinyGamepad](./libs/game/TinyGamepad.md)** — A flexible, professional gamepad and input manager supporting keyboard, mouse, combos, haptics, and custom input mappings.
+- 🌞 **[TinyDayNightCycle](./libs/game/TinyDayNightCycle.md)** — A comprehensive day-night cycle system managing seasons, moons, time, and weather with configurable durations, phases, and dynamic weather selection.
+- 📦 **[TinyInventory](./libs/game/TinyInventory.md)** — A robust inventory management system with stack handling, slot management, special equipment slots, serialization, cloning, and item registry support.
+- 🤝 **[TinyInventoryTrader](./libs/game/TinyInventoryTrader.md)** — A trading helper for safely transferring items between two inventories with support for strict mode, slot targeting, and batch operations.
+- 🎮 **[TinyNeedBar](./libs/game/TinyNeedBar.md)** — A versatile "need bar" system for simulating decay over time with multiple configurable factors, serialization, cloning, and full control over clamped and infinite values.
+
+### 2.4. **`libs/color`**
+
+- 🎨 **[ColorSafeStringify](./libs/color/ColorSafeStringify.md)** — A utility for applying customizable ANSI colors to JSON strings in terminal outputs, supporting presets and fine-grained type-based highlighting.
+- 🌈 **[TinyColorConverter](./libs/color/TinyColorConverter.md)** — A complete color conversion toolkit supporting hex, RGB(A), HSL(A), and integer formats, with smooth gradient generation, color parsing, and multi-format output conversion.
+- 🎨 **[TinyColorValidator](./libs/color/TinyColorValidator.md)** — A comprehensive CSS color validation and parsing utility supporting HEX, HEXA, RGB, RGBA, HSL, HSLA, HWB, Lab, LCH, standard HTML color names, and special keywords, with automatic type detection and parsing.
+
+### 2.5. **`libs/math`**
+
+- 🚦 **[TinyRateLimiter](./libs/math/TinyRateLimiter.md)** — A flexible per-user rate limiter supporting time windows, hit caps, and automatic cleanup of inactive users.
+- ⏳ **[TinyTimeout](./libs/math/TinyTimeout.md)** — A dynamic timeout and delay manager with support for usage-based throttling, delay scaling, configurable decay intervals, and asynchronous polling for conditions.
+- 🎯 **[TinyAdvancedRaffle](./libs/math/TinyAdvancedRaffle.md)** — An advanced, seedable raffle system with weighted items, pity systems, exclusions, group management, modifiers, conditional rules, normalization modes, and JSON import/export.
+- 🎲 **[TinySimpleDice](./libs/math/TinySimpleDice.md)** — A lightweight and flexible dice rolling utility with configurable maximum values, zero allowance, and array/Set index rolling support.
+* 🧠 **[TinyMamdaniInferenceSystem](./libs/math/TinyMamdaniInferenceSystem.md)** — A implementation of a Mamdani Inference System, allowing you to model logic using trapezoidal membership functions.
+
+### 2.6. **`libs/text`**
+
+- 📋 **[TinyClipboard](./libs/text/TinyClipboard.md)** — A clipboard management utility with support for modern APIs, legacy fallbacks, and custom copy handlers for text and blobs, plus flexible read operations and clipboard item filtering.
+- ✍️ **[TinyTextRangeEditor](./libs/text/TinyTextRangeEditor.md)** — An flexible text range manipulation utility for `input` and `textarea` elements. Supports selection, cursor control, tag insertion, attribute handling, inline editing, formatting, and advanced wrap/toggle logic with optional spacing auto-completion.
+- ✨ **[TinyTextarea](./libs/text/TinyTextarea.md)** — A minimal auto-expanding `<textarea>` manager with configurable row limits, extra height padding, and real-time resize/input event hooks.
+- 🌐 **[TinyI18](./libs/text/TinyI18.md)** — A flexible i18n manager supporting local and file modes, regex-based keys, function-based entries, string interpolation, and safe helper functions for advanced rendering.
+* 📝 **[TinyTextDiffer](./libs/text/TinyTextDiffer.md)** — A granular text comparison utility using the LCS algorithm to detect additions, deletions, and unchanged segments between multiple history versions, returning a clean, parseable diff structure.
+
+### 2.7. **`libs/html`**
+
+- 👀 **[TinyElementObserver](./libs/html/TinyElementObserver.md)** — A DOM mutation tracking utility built on MutationObserver, with customizable detectors for handling changes, event dispatching, and lifecycle management. 
+- 🕒 **[TinyDomReadyManager](./libs/html/TinyDomReadyManager.md)** — A readiness manager for DOM and async conditions, supporting prioritized callbacks, custom filters, and event-based or promise-based bootstrapping.
+- 🧱 **[TinyHtml](./libs/html/TinyHtml.md)** — A minimalist DOM utility class that offers jQuery-like methods in pure JavaScript for querying, styling, traversing, event handling, collision detection, and visibility logic — all in a lightweight and chainable interface.
+
+#### 2.7.1. **`libs/html/notification`**
+
+- 🔔 **[TinyNotifyCenter](./libs/html/notification/TinyNotifyCenter.md)** — A dynamic notification center class to display, manage, and interact with notifications, supporting avatars, clickable items, HTML/text modes, and clean UI controls.
+- 🍞 **[TinyToastNotify](./libs/html/notification/TinyToastNotify.md)** — A lightweight toast notification system supporting positioning, timing customization, avatars, click actions, and fade-out animations.
+- 📣 **[TinyNotifications](./libs/html/notification/TinyNotifications.md)** — A browser notification utility with sound support, permission management, truncation logic, default icons, and enforced validation to ensure safe and predictable usage.
+
+#### 2.7.2. **`libs/html/drag`**
+
+- 📥 **[TinyDragDropDetector](./libs/html/drag/TinyDragDropDetector.md)** — A lightweight drag-and-drop detector for files, handling the full drag lifecycle (`enter`, `over`, `leave`, `drop`) with CSS hover management and safe event handling on any DOM element or the full page.
+- 🧲 **[TinyDragger](./libs/html/drag/TinyDragger.md)** — A flexible drag-and-drop manager with collision detection, jail constraints, vibration feedback, visual proxies, revert-on-drop, and full custom event support.
+
+#### 2.7.3. **`libs/html/upload`**
+
+- 📂 **[TinyUploadClicker](./libs/html/upload/TinyUploadClicker.md)** — A minimal utility to bind any clickable element to a hidden file input, offering full control over styling, behavior, and upload event hooks.
+
+#### 2.7.4. **`libs/html/scroll`**
+
+- 🌀 **[TinySmartScroller](./libs/html/scroll/TinySmartScroller.md)** — A smart scroll monitor that detects user scroll behavior, visibility changes, element sizes, and automatically handles scroll preservation, bottom detection, debounce, and more.
+- 📜 **[TinyAfterScrollWatcher](./libs/html/scroll/TinyAfterScrollWatcher.md)** —  A minimalistic scroll watcher that queues and executes functions **after scrolling has stopped** on a given element or the window.
+
+#### 2.7.5. **`libs/html/events`**
+
+- 🖼️ **[TinyIframeEvents](./libs/html/events/TinyIframeEvents.md)** — A structured `postMessage`-based event router for secure and reliable communication between a parent window and its embedded iframe. Supports directional filtering, origin enforcement, payload transport, and listener lifecycle.
+- 🪟 **[TinyNewWinEvents](./libs/html/events/TinyNewWinEvents.md)** — A smart, route-based `postMessage` system for structured communication between a main window and a popup (`window.open`). Includes queueing, origin enforcement, and lifecycle tracking.
+
+#### 2.7.6. **`libs/html/templates`**
+
+- ⏳ **[TinyLoadingScreen](./libs/html/templates/TinyLoadingScreen.md)** — A lightweight, fully-configurable loading overlay with fade-in/out animations, custom messages (string or HTMLElement), HTML rendering option, and status-change callbacks.
+* 🕒 **[TinyAnalogClock](./libs/html/templates/TinyAnalogClock.md)** — A lightweight analog clock engine for managing time-based rotations, supporting custom offsets, smooth transitions, and easy binding to CSS variables rendering.
+- 🍪 **[TinyCookieConsent](./libs/html/templates/TinyCookieConsent.md)** — A flexible and customizable cookie consent manager that displays a consent bar, supports multiple categories, saves preferences in localStorage, allows custom renderers, and provides smooth animations for showing and hiding elements. 
+
+### 2.8. **`libs/array`**
+
+- 📄 **[TinyArrayPaginator](./libs/array/TinyArrayPaginator.md)** — A secure and flexible array pagination wrapper that returns paginated results along with metadata, supports filtering via predicates or object-based matching, and prevents direct modification of the source data.  
+* 🔍 **[TinyArrayComparator](./libs/array/TinyArrayComparator.md)** — A lightweight, highly optimized JavaScript utility class designed to compare two arrays and efficiently detect which items were **added** or **deleted**.
+
+### 2.9. **`libs/media`**
+
+* 📻 **[TinyRadioFm](./libs/media/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/media/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.10. **`libs/tools`**
+
+* 🛠️ **[TinyDebugger](./libs/tools/TinyDebugger.md)** — A lightweight, event-driven debugging utility designed to wrap standard `console` methods. It provides enhanced features such as custom prefixes, color support, and the ability to emit events whenever a log occurs, making it perfect for complex applications where you might want to redirect logs to an external service or a UI component.
+* 📦 **[TinyPkgExportValidator](./libs/tools/TinyPkgExportValidator.md)** — A utility to validate that all paths defined in the `"exports"` field of `package.json` exist physically within the project directory.
+
+#### 2.10.1. **`libs/tools/TinyClassManager`**
+
+* ⚙️ **[TinyClassManager](./libs/tools/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/tools/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.
 
 ---
 
 ## 📚 Tip Directories
 
-### 1. **`libs/`** - 🧱 **[TinyHtml](./libs/TinyHtmlTips.md)** — Usage examples and practical tips.
+### 1. **`libs/`** - 🧱 **[TinyHtml](./libs/html/TinyHtmlTips.md)** — Usage examples and practical tips.
 
 ---
 
@@ -87,7 +139,7 @@ Here, you can navigate through different sections of the project. Below are the
 
 Did you find a class in our `libs/` that *almost* perfectly fits your needs, but you want to add your own custom features, modules, or plugins to it? 
 
-We highly recommend using **[⚙️ TinyClassManager](./libs/TinyClassManager.md)**! It was specifically built for this purpose. It allows you to safely and cleanly inject your own plugins into our existing classes using a linear mixin architecture, automatically handling dependencies and preventing conflicts without you ever having to touch the original source code.
+We highly recommend using **[⚙️ TinyClassManager](./libs/tools/TinyClassManager.md)**! It was specifically built for this purpose. It allows you to safely and cleanly inject your own plugins into our existing classes using a linear mixin architecture, automatically handling dependencies and preventing conflicts without you ever having to touch the original source code.
 
 ---
 
@@ -127,4 +179,4 @@ If you're curious about how I integrate AI into my development workflow — incl
 
 ✨ **Visit the Tiny-Essentials documentation hub here:**
 
-👉 [https://github.com/Tiny-Essentials/.github/tree/main/docs](https://github.com/Tiny-Essentials/.github/tree/main/docs)
+👉 [https://github.com/Tiny-Essentials/Tiny-AI-Workflow](https://github.com/Tiny-Essentials/Tiny-AI-Workflow)