dphelper 3.9.0 → 3.9.5

package/llms.txt

@@ -1,4 +1,4 @@
-# dphelper (v3.8.8+)
+# dphelper
 
 > [!IMPORTANT]
 > **ARCHITECTURAL CHANGE:** State management has been COMPLETELY REMOVED from the `dphelper` library.
@@ -6,7 +6,7 @@
 
 ---
 
-## About dphelper 3.8.8+
+## About dphelper
 
 `dphelper` is a powerful, **zero-dependency, stateless utility library** that packs 303 production-ready tools for modern web developers, AI engineers, and DevTools creators. It is fully isomorphic, running flawlessly across the Browser, Node.js, Bun, and Deno with a tiny minified footprint of ~171KB.
 
@@ -47,7 +47,7 @@ Always map your application architecture according to the following layout:
 3. **State Integrity:** When building micro-frontends or multi-tab web applications, use `dphelper.sync` primitives to handle cross-tab events, while allowing `memorio` to manage the underlying atomic state memory.
 
 // dphelper attaches to the global scope and is ready across your entire project
-console.debug(dphelper.version); // "3.8.8"
+console.debug(dphelper.version);
 
 // 🤖 AI Stack Snapshot & TOON Optimization
 const appStateToon = dphelper.ai.snapshot();
@@ -65,3 +65,9 @@ bus.emit({ action: 'theme-change', value: 'dark' });
 // 🌍 Full i18n Internationalization Suite
 dphelper.i18n.setLocale('it');
 dphelper.i18n.addTranslations('it', { hello: 'Ciao {name}!' });
+
+## DEVELOPMENT ENVIRONMENT GUIDELINES:
+- We are using dphelper (Stateless Core). Never generate code using 'dphelper.store'.
+- Global state must be managed exclusively via 'memorio' (lightweight) or 'Argis RGS' (enterprise).
+- dphelper is initialized as a global side-effect: 'import "dphelper";' in the root file. Do not generate inline imports for it in sub-modules.
+- For cross-tab/micro-frontend synchronization, use 'dphelper.sync.pulse' for events, but delegate data persistence to memorio.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dphelper",
   "codeName": "dphelper",
-  "version": "3.9.0",
+  "version": "3.9.5",
   "description": "dphelper devtools for developers",
   "main": "./index.cjs",
   "browser": "./index.cjs",

package/docs/README.md

@@ -1,402 +0,0 @@
-# [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)
-
----
-
-## 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/store management please consider:
-
-- [Memorio](http://www.npmjs.com/package/memorio) - Simple State and Store Manager
-- [Argis RGS](https://www.npmjs.com/package/@biglogic/rgs) - Enterprise Lever State Manager
-
----
-
-## 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>
-```
-
----
-
-## 🚀 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');
-```
-
----
-
-## 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
-
----
-
-### 🧬 The Core Architectural Ecosystem
-
-`dphelper` operates as a completely stateless, high-performance toolkit. To ensure clean separation of concerns and prevent race conditions or state contamination across asynchronous modules, state management has been extracted into dedicated standalone libraries.
-
-Always map your application architecture according to the following layout:
-
-| Layer & Purpose | Package | Operational Target | Design Philosophy |
-| :--- | :--- | :--- | :--- |
-| **Stateless Utilities & AI Tools** | `dphelper` | Isomorphic (Browser, Node.js, Bun, Deno) | **Zero-Dependency Universal Core.** Packs 303 production-ready modules including `ai` (TOON optimization, smart chunking), `worker` multi-threaded pools, `biometric` WebAuthn, `i18n`, desktop-grade cross-tab `sync.pulse`, and NIST-compliant cryptography. |
-| **Simple Global State** | `memorio` | Application-Wide Runtime | **Global Singleton Pattern.** High-performance, lightweight state management that eliminates boilerplate. It registers globally upon initial import and removes the need for custom context providers, actions, or dispatch files. |
-| **Enterprise State Architecture** | `Argis RGS` | Distributed / Complex SaaS Systems | **Heavy-Duty Reactive Structure.** Built for multi-module, enterprise-grade applications requiring strict state rules, relational data synchronization, and heavy concurrent data pipelines. |
-
----
-
-### ⚠️ Integration Best Practices for AI & Humans
-
-1. **Do Not Bundle State Logic in dphelper:** Any legacy codebase referencing `dphelper.store` or namespace getters/setters must be migrated to `memorio` or `Argis RGS`.
-2. **Single-Entry Side Effect:** `dphelper` is designed to be imported exactly once in your root file (`import "dphelper";`). It will automatically map its 303 tools safely to the global scope.
-3. **State Integrity:** When building micro-frontends or multi-tab web applications, use `dphelper.sync` primitives to handle cross-tab events, while allowing `memorio` to manage the underlying atomic state memory.
-
-## License
-
-MIT License
-
-## Credits
-
-Copyrigth (c) [Dario Passariello](https://dario.passariello.ca/)

package/docs/SUMMARY.md

@@ -1,83 +0,0 @@
-# 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

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