@vicaniddouglas/js_aide 1.13.1 → 1.13.3

package/README.md

@@ -6,56 +6,46 @@
 
 ## 🕹️ Live Playground
 Explore all library features—including the new Asynchronous Handshaking system—directly in our **[Interactive Sandbox](https://vicaniddouglas.gitlab.io/js_aide)**.
-npm explore @vicaniddouglas/js_aide -- npm run serve:demo
-```
 
 ### `Router`
 
-A modern, feature-rich client-side router for Single-Page Applications (SPAs).
-
-- History API-based navigation.
-- Supports dynamic route segments (e.g., `/users/:id`).
-- Automatic interception of internal `<a>` tags for seamless SPA navigation.
-- Configurable route guards (`beforeNavigate`) with support for redirects.
-- View lifecycle hooks (`beforeEnter`, `beforeLeave`) directly on DOM elements for managing view transitions and data loading.
-- Parses and exposes URL query parameters and hash fragments.
-- Efficient view toggling, only hiding the previously active view.
+A modern, feature-rich client-side router for Single-Page Applications (SPAs). Features include History API navigation, dynamic route segments (`/users/:id`), and view lifecycle hooks (`beforeEnter`, `beforeLeave`).
 
-### `validator`
+### `Validator`
 
-A module offering various input validation utilities (e.g., email, number, custom regex).
+A collection of high-precision validation utilities. Handles complex email logic, phone number formatting, and mandatory field checks out of the box.
 
-### `inputHandlers`
+### `Input Handlers`
 
-Utilities for enhanced DOM element interaction, such as restricting input to numbers, formatting number inputs, or providing custom select options.
+Utilities for enhanced DOM interaction, such as restricting input to specific characters, real-time number formatting, and custom select behaviors.
 
-### `requests`
+### `HTTP Engine`
 
-Helper functions for making HTTP requests (e.g., `fetch` wrappers for common patterns).
+A "Zero-Touch" HTTP client built on `sendRequest`. Features automatic retries with exponential backoff, request queuing, and standardized response objects.
 
-### `dates`
+### `Dates & Timing`
 
-Convenience functions for common date and time manipulation tasks.
+Convenience functions for complex date manipulation, including relative timing (`timeAgo`), `humanizeDate`, and range calculations.
 
-### `fileManager`
+### `File Manager`
 
-Utilities for browser-side file handling (e.g., file uploads, local storage, file type checks).
+Robust utilities for browser-side file handling, including dynamic `DataExporter` for Excel/PDF and secure file upload orchestration.
 
-### `camera`
+### `Camera`
 
-Functions for interacting with device cameras, capturing images or video streams (requires browser API support).
+Advanced module for interacting with device cameras, allowing image capture and video stream management with a single promise-based API.
 
-### `figures`
+### `Figures & Formatting`
 
-Utilities for number formatting, currency (including UGX defaults), and percentages.
+Specialized formatting for financial data. Includes native support for **UGX** (Ugandan Shilling) currency defaults and abbreviated large numbers.
 
-### `dependencyManager`
+### `Dependency Manager`
 
-A robust manager for dynamically loading CDN-based libraries (like SheetJS or jsPDF) with retry logic and dependency tracking.
+A smart loader for external libraries (like SheetJS or jsPDF). Manages CDN fallbacks, retry logic, and ensures libraries are only loaded when needed.
 
-### `WebSocketClient`
+### `WebSocket Client`
 
-A professional-grade WebSocket client featuring automatic reconnection, heartbeat/health monitoring, and a built-in instance registry to prevent duplicate connections. Supports namespaces, rooms, and message acknowledgements.
+A professional-grade WebSocket implementation with automatic reconnection, heartbeat monitoring, and a registry to prevent duplicate connections.
 
 ## Installation
 
@@ -80,11 +70,13 @@ Ensure your project is configured to use ES Modules (e.g., by adding `"type": "m
 You can import specific modules or all of them:
 
 ```javascript
-// Import specific modules
-import { Router, validator } from "@vicaniddouglas/js_aide";
-
-// Or import all, though generally not recommended for tree-shaking
-// import * => JSAide from '@vicaniddouglas/js_aide';
+// Import specific modules for best tree-shaking
+import { 
+    Router, 
+    sendRequest, 
+    validatePhoneNumber, 
+    humanizeDate 
+} from "@vicaniddouglas/js_aide";
 ```
 
 ### Example: Using the Router

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vicaniddouglas/js_aide",
-  "version": "1.13.1",
+  "version": "1.13.3",
   "description": "A versatile collection of modular JavaScript utility helpers designed to streamline single-page application (SPA) development and general web programming tasks.",
   "main": "dist/js_aide.cjs.js",
   "module": "dist/js_aide.esm.js",