# Documentation Menu Welcome to the documentation! This is the central hub for exploring all available resources. Here, you can navigate through different sections of the project. Below are the main directories: --- ## ๐Ÿ“š Main Directories ### 1. **`basics/`** This folder contains the core scripts we have worked on so far. Each file is a module focused on specific functionality. - ๐Ÿ“ฆ **[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. - ๐Ÿ”„ **[AsyncReplace](./basics/asyncReplace.md)** โ€” Asynchronously replaces matches in a string using a regex and an async function. - ๐Ÿ–ผ๏ธ **[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. - ๐Ÿ“ฆ **[BrowserDetector](./basics/browserDetector.md)** โ€” A multi-layered JavaScript utility for identifying the user's web browser and rendering engine. - ๐Ÿ” **[Crypto](./basics/crypto.md)** โ€” A lightweight utility for generating cryptographic hashes (e.g., SHA-256) using the Web Crypto API. - ๐Ÿ” **[PromiseUtils](./basics/promiseUtils.md)** โ€” Promise helpers such as `waitForTrue` and `createSingletonTask` for polling and single-flight async tasks. ### 2. **`libs/`** ### 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. - ๐Ÿ—ƒ๏ธ **[TinyMapCache](./libs/storage/TinyMapCache.md)** โ€” A lightweight, event-driven, in-memory cache manager with TTL expiration, deep cloning, and a familiar `Map`-like iteration API. - ๐Ÿ—„๏ธ **[TinySetMapDatabase](./libs/storage/TinySetMapDatabase.md)** โ€” Persistent `Set` and `Map` collections backed by IndexedDB, with a tiny promise-based API and schema migrations. ### 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. - ๐Ÿงฉ **[TinyCloner](./libs/utils/TinyCloner.md)** โ€” A highly modular, plugin-based deep cloning engine with strict validation, global/instance control, and isolation mode. - ๐Ÿšฆ **[TinyThrottledApi](./libs/utils/TinyThrottledApi.md)** โ€” A professional-grade utility for concurrency control and rate throttling of asynchronous API calls. ### 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 `