dphelper 3.5.5 → 3.7.2

package/README.md

@@ -76,27 +76,6 @@ If you need to use state management please consider:
 
 ---
 
-## 💾 IndexedDB Module
-
-```javascript
-// Open/create database
-const db = await dphelper.idb.open('mydb', 1, { users: 'id++,name,email' });
-
-// Add record
-await dphelper.idb.put('mydb', 'users', { name: 'John', email: 'john@example.com' });
-
-// Query records
-const users = await dphelper.idb.getAll('mydb', 'users');
-
-// Query by index
-const johns = await dphelper.idb.query('mydb', 'users', 'name', 'John');
-
-// Bulk operations
-await dphelper.idb.bulkPut('mydb', 'users', [{name: 'A'}, {name: 'B'}]);
-```
-
----
-
 ## ⚙️ Web Worker Module
 
 ```javascript

package/docs/README.md

@@ -0,0 +1,385 @@
+# [dphelper](https://npmjs.com/package/dphelper)
+
+![dpHelper](https://raw.githubusercontent.com/passariello/container/refs/heads/main/dphelper/assets/images/banner.svg)
+
+> **The supercharged toolkit for modern web development, AI engineering & DevTools.**
+
+[![version](https://img.shields.io/npm/v/dphelper.svg)](https://npmjs.org/package/dphelper)
+[![install size](https://img.shields.io/badge/dynamic/json?url=https://packagephobia.com/v2/api.json?p=dphelper&query=$.install.pretty&label=install%20size&style=flat-square)](https://packagephobia.now.sh/result?p=dphelper)
+[![downloads](https://img.shields.io/npm/dm/dphelper.svg)](https://npmjs.org/package/dphelper)
+
+![Node.js](https://img.shields.io/badge/Node.js-gray?logo=node.js)
+![React](https://img.shields.io/badge/React-gray?logo=React)
+![Javascript](https://img.shields.io/badge/Javascript-gray?logo=Javascript)
+![TypeScript](https://img.shields.io/badge/TypeScript-gray?logo=typescript)
+![esbuild](https://img.shields.io/badge/esbuild-gray?logo=esbuild)
+
+![Jest](https://img.shields.io/badge/Jest-gray?logo=jest)
+![ESLint](https://img.shields.io/badge/Eslint-gray?logo=eslint)
+![Playwright](https://img.shields.io/badge/Playwright-gray?logo=playwright)
+![AI Ready](https://img.shields.io/badge/AI-Ready-brightgreen?logo=openai)
+![TOON](https://img.shields.io/badge/TOON-Format-blue)
+
+[![GitBook](https://img.shields.io/static/v1?message=Documented%20on%20GitBook&logo=gitbook&logoColor=ffffff&label=%20&labelColor=5c5c5c&color=3F89A1)](https://a51.gitbook.io/dphelper)
+
+
+---
+
+## About
+
+**dphelper** is a powerful, zero-dependency utility library that brings together **303 production-ready tools** for web developers, AI engineers, and DevTools creators.
+
+Think of it as your **universal toolbox** - from DOM manipulation to cryptographic operations, from real-time WebSocket handling to AI-powered token optimization. No more juggling multiple packages. One import, infinite possibilities.
+
+### Why dphelper?
+
+- **⚡ Zero Dependencies** - Pure vanilla JavaScript/TypeScript. No bloat, no surprises.
+- **🤖 AI-First Design** - Built for LLM apps with TOON optimization, token counting, and RAG support.
+- **🌐 Universal** - Works in browser, Node.js, Bun, and Deno.
+- **🔒 Type-Safe** - Full TypeScript definitions auto-generated for every tool.
+- **📦 Tiny Bundle** - Only ~171KB minified, tree-shakeable.
+- **🔐 Security First** - NIST/NSA compliant, CNSA algorithms, PBKDF2 310k iterations
+
+> [!NOTE]
+> **Network Access:** This library includes networking primitives (`fetch`, `sse`, `socket`) by design for modern web development. Callers are responsible for validating and sanitizing URLs before use. See the [Security](#security) section for best practices.
+
+> *"dphelper is what you'd build if you combined lodash, socket.io, and an AI SDK - but lighter."*
+
+---
+
+## State and Store removed from dpHelper
+
+> [!IMPORTANT]
+> dpHelper do not integrate state management directly anymore
+>
+> Application state is currently handled through **Memorio** or **RGS**.
+
+If you need to use state management please consider:
+
+- Simple State and Store Manager [Memorio](http://www.npmjs.com/package/memorio)
+- Enterprise Lever State Manager [Argis RGS](https://www.npmjs.com/package/@biglogic/rgs)
+
+---
+
+## 🚀 New Powerful Modules
+
+`dphelper` has expanded with powerful new modules for modern web development:
+
+### ✨ Highlights
+
+- **💾 IndexedDB Module**: Full-featured wrapper for IndexedDB with query builder, transactions, and bulk operations.
+- **⚙️ Web Worker Module**: Create and manage workers, worker pools for parallel processing, and SharedWorkers for cross-tab communication.
+- **🌍 i18n Module**: Complete internationalization with translations, pluralization, date/number formatting, and relative time.
+- **🖼️ Image Module**: Image processing including resize, crop, filters, rotation, flip, and compositing.
+- **🗜️ Compression Module**: Gzip, deflate, LZW compression, plus base64, URL, and HTML encoding/decoding.
+- **🔐 Biometric Module**: WebAuthn support for fingerprint, face recognition, and secure credential management.
+
+---
+
+## ⚙️ Web Worker Module
+
+```javascript
+// Create worker from file
+const worker = dphelper.worker.create('worker.js', {
+  onmessage: (e) => console.log(e.data)
+});
+
+// Create inline worker
+const inlineWorker = dphelper.worker.createInline(`
+  self.onmessage = e => postMessage(e.data * 2);
+`);
+
+// Worker pool for parallel processing
+const pool = dphelper.worker.pool('worker.js', 4);
+const results = await dphelper.worker.poolExec(pool, [1, 2, 3, 4]);
+
+// SharedWorker for cross-tab communication
+const shared = dphelper.worker.shared('worker.js', { name: 'my-shared' });
+```
+
+---
+
+## 🌍 i18n Module
+
+```javascript
+// Set locale
+dphelper.i18n.setLocale('it');
+
+// Add translations
+dphelper.i18n.addTranslations('it', {
+  hello: 'Ciao {name}!',
+  items: '{count, plural, one{# item} other{# items}}'
+});
+
+// Translate with interpolation
+dphelper.i18n.t('hello', { name: 'World' }); // "Ciao World!"
+
+// Pluralize
+dphelper.i18n.pluralize(5, { one: 'item', other: 'items' }); // "items"
+
+// Format number/currency
+dphelper.i18n.number(1234.56, 'de-DE', { style: 'currency', currency: 'EUR' });
+
+// Relative time
+dphelper.i18n.relativeTime(Date.now() - 3600000); // "1 hour ago"
+```
+
+---
+
+## 🖼️ Image Module
+
+```javascript
+// Load image
+const img = await dphelper.image.load('photo.jpg');
+
+// Resize
+const resized = dphelper.image.resize(img, 100, 100);
+
+// Crop
+const cropped = dphelper.image.crop(img, { x: 0, y: 0, width: 50, height: 50 });
+
+// Apply filters
+const filtered = dphelper.image.filter(img, { brightness: 1.2, sepia: 0.5 });
+
+// Rotate/Flip
+const rotated = dphelper.image.rotate(img, 90);
+const flipped = dphelper.image.flip(img, 'horizontal');
+
+// Grayscale/Blur
+const gray = dphelper.image.grayscale(img);
+const blurred = dphelper.image.blur(img, 5);
+```
+
+---
+
+## 🗜️ Compression Module
+
+```javascript
+// Gzip compression
+const compressed = await dphelper.compress.gzip('Hello World');
+const decompressed = await dphelper.compress.gunzip(compressed);
+
+// Base64 encoding
+const encoded = dphelper.compress.base64Encode('Hello');
+const decoded = dphelper.compress.base64Decode(encoded);
+
+// URL encoding
+const urlEncoded = dphelper.compress.urlEncode('Hello World!');
+const urlDecoded = dphelper.compress.urlDecode(urlEncoded);
+
+// HTML encoding
+const htmlEncoded = dphelper.compress.htmlEncode('<script>');
+const htmlDecoded = dphelper.compress.htmlDecode('&lt;script&gt;');
+```
+
+---
+
+## 🔐 Biometric Module (WebAuthn)
+
+```javascript
+// Check availability
+const available = dphelper.biometric.isAvailable();
+
+// Get support details
+const support = dphelper.biometric.getWebAuthnSupport();
+
+// Register credential
+const { success, credentialId } = await dphelper.biometric.register('user123');
+
+// Authenticate
+const { success } = await dphelper.biometric.authenticate('user123');
+
+// Check specific sensor
+const hasFingerprint = await dphelper.biometric.isSensorAvailable('fingerprint');
+```
+
+---
+
+## Table of Contents
+
+1. [About](#about)
+2. [Installation](#installation)
+3. [AI Power User Guide](#ai-power-user-guide)
+4. [Modular Architecture](#modular-architecture)
+5. [Browser Extension (Chrome/Edge)](#browser-extension-chromeedge)
+6. [Environment Compatibility](#environment-compatibility)
+7. [Security](#security)
+
+---
+
+## Installation
+
+```shell
+npm i dphelper --save-dev
+```
+
+### Usage
+
+Import it precisely **once** in your entry point (e.g., `index.js`, `main.ts`, or `App.tsx`):
+
+```js
+import "dphelper";
+// dphelper is now available globally across your entire project!
+```
+
+For plain HTML/CDN:
+
+```html
+<script src="https://unpkg.com/dphelper/dphelper.js"></script>
+
+<!-- Optional check -->
+<script>
+  console.debug(dphelper.version);  // latest version
+  console.debud(dphelper.isBrowser); // true
+</script>
+```
+
+---
+
+## AI Power User Guide
+
+The new `dphelper.ai` module is designed for the modern AI stack (LLMs, RAG, Vector Search).
+
+```javascript
+// ⚡ TOON: The ultimate JSON alternative for prompts
+const toonData = dphelper.ai.toon(myJsonObject);
+// Efficient, compact, and deterministic.
+
+// 📏 Context-Aware Token Counting
+const tokens = dphelper.ai.tokenCount(myJsonObject);
+// Automatically calculates tokens based on the optimal TOON representation.
+
+// 🧩 Smart Chunker (RAG Ready)
+const chunks = dphelper.ai.chunker(longText, { size: 1000, overlap: 200 });
+
+// 🔍 Semantic Similarity
+const score = dphelper.ai.similarity(embeddingA, embeddingB);
+
+// 🧠 Reasoning Extractor (DeepSeek/O1 support)
+const { reasoning, content } = dphelper.ai.extractReasoning(rawAiReply);
+
+// 📸 The AI Black Box (Snapshot)
+const appStateToon = dphelper.ai.snapshot();
+// Generates a complete app "mental dump" (URL, gState, Logs) optimized for LLMs.
+```
+
+---
+
+## Modular Architecture
+
+Every tool in `dphelper` is now a self-contained module. Our new build system automatically:
+
+1. Scans the `tools/` directory.
+2. Generates dynamic imports for the core.
+3. Synchronizes TypeScript interfaces in `dphelper.d.ts`.
+
+This ensures that adding new tools is instantaneous and always documented with full Intellisense support.
+
+---
+
+## 🔄 UI Mirror & Auto-Recovery
+
+`dphelper` makes your web app feel like a native desktop application with cross-tab intelligence.
+
+```javascript
+// ⚓ Auto-Recovery: Save scroll and input values across reloads/crashes
+dphelper.UI.anchorContext();
+
+// 💓 Pulse: Real-time event bus between all open tabs (No Backend needed!)
+const bus = dphelper.sync.pulse('my-app', (msg) => {
+  console.debug('Received from another tab:', msg);
+});
+bus.emit({ action: 'theme-change', value: 'dark' });
+
+// 🔒 Interlock: Monitor how many tabs of your app are active
+dphelper.browser.interlock((count) => {
+  console.debug(`Active tabs: ${count}`);
+});
+
+// 🌊 SSE: Modern streaming (Support for POST & Headers)
+const stream = dphelper.sse.open('/api/ai', {
+  method: 'POST',
+  headers: { 'Authorization': 'Bearer ...' },
+  body: JSON.stringify({ prompt: 'Hello AI' })
+});
+
+stream.on('message', (data) => console.debug('Chunk:', data));
+stream.on('error', (err) => console.error('Stream failure:', err));
+```
+
+---
+
+## Browser Extension (Chrome/Edge)
+
+![dphelper Banner](https://raw.githubusercontent.com/passariello/container/refs/heads/main/dphelper/assets/images/screenshot.png)
+
+Manage your `dphelper` environment, monitor memory usage, and access documentation directly from your browser.
+
+- [Download for Chrome](https://chrome.google.com/webstore/detail/dphelper-manager-dev-tool/oppppldaoknfddeikfloonnialijngbk)
+- [Download for Edge](https://microsoftedge.microsoft.com/addons/detail/dphelper-manager-dev-to/kphabkbdpaljlfagldhojilhfammepnk)
+
+---
+
+---
+
+## Environment Compatibility
+
+`dphelper` tools are classified by their execution target to ensure stability across the stack.
+
+| Icon | Type | Description |
+| :--- | :--- | :--- |
+| 🌐 | **Client** | Browser only (requires DOM, window, or navigator). |
+| 🖥️ | **Server** | Node.js / Bun / Deno only (access to process, fs, etc). |
+| 🧬 | **Isomorphic** | Universal. Works in both Browser and Server (AI, Logic, Math). |
+
+### Core Module Status
+
+- `dphelper.ai`: 🧬 Isomorphic
+- `dphelper.fetch`: 🧬 Isomorphic (Supports Node 18+)
+- `dphelper.sse`: 🌐 Client (Streaming fetch)
+- `dphelper.socket`: 🌐 Client (WebSocket)
+- `dphelper.sync`: 🌐 Client (BroadcastChannel)
+- `dphelper.UI`: 🌐 Client (DOM based)
+
+---
+
+## Security
+
+dphelper follows **NIST SP 800-53** and **NSA** security standards:
+
+### Cryptography (CNSA Compliant)
+- **AES-256-GCM** encryption
+- **SHA-256** only (SHA-1 deprecated)
+- **PBKDF2** with 310,000 iterations (OWASP 2023)
+
+### Network Security
+- HTTPS required for `fetch` and `SSE`
+- TLS enforced for `socket` (wss:// only)
+- URL validation built-in
+
+> [!IMPORTANT]
+> **For Library Users:** Network functions require **input validation** by the caller. Always sanitize URLs before passing to dphelper networking tools.
+
+```javascript
+// Correct
+const safeUrl = dphelper.sanitize.url(userInput);
+await dphelper.fetch.get(safeUrl);
+
+// Never do this
+await dphelper.fetch.get(userInput); // ❌ Unvalidated
+```
+
+### Compliance
+- 100% NIST/NSA compliant
+- No known vulnerabilities
+- Automated security scanning in CI
+
+---
+
+## License
+
+MIT License
+
+## Credits
+
+Copyrigth (c) [Dario Passariello](https://dario.passariello.ca/)

package/docs/SUMMARY.md

@@ -0,0 +1,83 @@
+# Table of Contents
+
+- [dpHelper](../README.md)
+
+---
+
+## Core Tools
+
+- [ai](markdown/ai.md)
+- [array](markdown/array.md)
+- [browser](markdown/browser.md)
+- [check](markdown/check.md)
+- [date](markdown/date.md)
+- [form](markdown/form.md)
+- [json](markdown/json.md)
+- [load](markdown/load.md)
+- [navigation](markdown/navigation.md)
+- [security](markdown/security.md)
+- [socket](markdown/socket.md)
+- [svg](markdown/svg.md)
+- [markdown](markdown/markdown.md)
+- [window](markdown/window.md)
+
+---
+
+## UI & DOM
+
+- [anchor](markdown/anchor.md)
+- [audio](markdown/audio.md)
+- [color](markdown/color.md)
+- [coords](markdown/coords.md)
+- [disable](markdown/disable.md)
+- [dispatch](markdown/dispatch.md)
+- [element](markdown/element.md)
+- [event](markdown/event.md)
+- [scrollbar](markdown/scrollbar.md)
+- [screen](markdown/screen.md)
+- [trigger](markdown/trigger.md)
+- [type](markdown/type.md)
+- [types](markdown/types.md)
+- [ui](markdown/ui.md)
+
+---
+
+## Data & Text
+
+- [format](markdown/format.md)
+- [math](markdown/math.md)
+- [objects](markdown/objects.md)
+- [path](markdown/path.md)
+- [sanitize](markdown/sanitize.md)
+- [text](markdown/text.md)
+- [translators](markdown/translators.md)
+
+---
+
+## Network & Storage
+
+- [cookie](markdown/cookie.md)
+- [compress](markdown/compress.md)
+- [fetch](markdown/fetch.md)
+- [net](markdown/net.md)
+- [sse](markdown/sse.md)
+- [sync](markdown/sync.md)
+
+---
+
+## Advanced
+
+- [avoid](markdown/avoid.md)
+- [biometric](markdown/biometric.md)
+- [credits](markdown/credits.md)
+- [i18n](markdown/i18n.md)
+- [image](markdown/image.md)
+- [logging](markdown/logging.md)
+- [memory](markdown/memory.md)
+- [promise](markdown/promise.md)
+- [shortcut](markdown/shortcut.md)
+- [system](markdown/system.md)
+- [terminal](markdown/terminal.md)
+- [timer](markdown/timer.md)
+- [triggers](markdown/triggers.md)
+- [worker](markdown/worker.md)

package/docs/_config.yml

@@ -0,0 +1 @@
+theme: jekyll-theme-modernist