dphelper 3.8.5 → 3.9.0

package/llms.txt

@@ -0,0 +1,67 @@
+# dphelper (v3.8.8+)
+
+> [!IMPORTANT]
+> **ARCHITECTURAL CHANGE:** State management has been COMPLETELY REMOVED from the `dphelper` library.
+> Application state is now handled exclusively through dedicated external managers: **Memorio** (for simple global state) or **Argis RGS** (for enterprise-level state).
+
+---
+
+## About dphelper 3.8.8+
+
+`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.
+
+### ⚡ Key Capabilities
+* **AI-First Engineering:** Built-in support for the modern LLM stack, featuring **TOON optimization** (the efficient JSON alternative for prompts), context-aware token counting, smart RAG-ready chunking, and deep reasoning extraction (supporting architectures like DeepSeek and OpenAI o1/o3).
+* **Modern Web Primitives:** Sophisticated wrappers for Web Workers (including worker pool orchestration and multi-tab SharedWorkers), full IndexedDB query builders, and native client-side compression (Gzip/Deflate/LZW).
+* **Cross-Tab Intelligence:** Desktop-grade synchronization without a backend, powered by `dphelper.sync.pulse` cross-tab event buses and active browser tab interlocks.
+* **Biometric Authentication:** Built-in async WebAuthn primitives for effortless fingerprint and facial recognition integrations.
+* **Enterprise Security:** NIST SP 800-53 and NSA CNSA compliant, utilizing AES-256-GCM and strict OWASP-aligned PBKDF2 with 310,000 iterations.
+
+---
+
+## Quick Usage Syntax
+
+`dphelper` maps its modules globally. Import it **exactly once** at your application's absolute entry point (e.g., `index.js`, `main.ts`, or `App.tsx`):
+
+```javascript
+import "dphelper";
+
+### 🧬 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.
+
+// dphelper attaches to the global scope and is ready across your entire project
+console.debug(dphelper.version); // "3.8.8"
+
+// 🤖 AI Stack Snapshot & TOON Optimization
+const appStateToon = dphelper.ai.snapshot();
+const textChunks = dphelper.ai.chunker(longText, { size: 1000, overlap: 200 });
+const { reasoning, content } = dphelper.ai.extractReasoning(rawAiReply);
+
+// ⚙️ Multi-Threaded Worker Pools
+const pool = dphelper.worker.pool('worker.js', 4);
+const results = await dphelper.worker.poolExec(pool, [1, 2, 3, 4]);
+
+// 💓 Real-Time Cross-Tab Sync (No Backend Required)
+const bus = dphelper.sync.pulse('my-app', (msg) => console.log(msg));
+bus.emit({ action: 'theme-change', value: 'dark' });
+
+// 🌍 Full i18n Internationalization Suite
+dphelper.i18n.setLocale('it');
+dphelper.i18n.addTranslations('it', { hello: 'Ciao {name}!' });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dphelper",
-  "code": "dphelper",
-  "version": "3.8.5",
+  "codeName": "dphelper",
+  "version": "3.9.0",
   "description": "dphelper devtools for developers",
   "main": "./index.cjs",
   "browser": "./index.cjs",
@@ -48,6 +48,9 @@
       "url": "https://www.patreon.com/passariello"
     }
   ],
+  "workspaces": [
+    "tests"
+  ],
   "engines": {
     "node": ">=18.0.0"
   },
@@ -67,6 +70,81 @@
       "optional": false
     }
   },
+  "overrides": {
+    "array-buffer-byte-length": "npm:@socketregistry/array-buffer-byte-length@^1",
+    "array-includes": "npm:@socketregistry/array-includes@^1",
+    "array.prototype.findlast": "npm:@socketregistry/array.prototype.findlast@^1",
+    "array.prototype.flat": "npm:@socketregistry/array.prototype.flat@^1",
+    "array.prototype.flatmap": "npm:@socketregistry/array.prototype.flatmap@^1",
+    "array.prototype.tosorted": "npm:@socketregistry/array.prototype.tosorted@^1",
+    "arraybuffer.prototype.slice": "npm:@socketregistry/arraybuffer.prototype.slice@^1",
+    "available-typed-arrays": "npm:@socketregistry/available-typed-arrays@^1",
+    "define-properties": "npm:@socketregistry/define-properties@^1",
+    "es-define-property": "npm:@socketregistry/es-define-property@^1",
+    "es-iterator-helpers": "npm:@socketregistry/es-iterator-helpers@^1",
+    "es-set-tostringtag": "npm:@socketregistry/es-set-tostringtag@^1",
+    "for-each": "npm:@socketregistry/for-each@^1",
+    "function-bind": "npm:@socketregistry/function-bind@^1",
+    "function.prototype.name": "npm:@socketregistry/function.prototype.name@^1",
+    "functions-have-names": "npm:@socketregistry/functions-have-names@^1",
+    "get-symbol-description": "npm:@socketregistry/get-symbol-description@^1",
+    "globalthis": "npm:@socketregistry/globalthis@^1",
+    "gopd": "npm:@socketregistry/gopd@^1",
+    "has-property-descriptors": "npm:@socketregistry/has-property-descriptors@^1",
+    "has-proto": "npm:@socketregistry/has-proto@^1",
+    "has-symbols": "npm:@socketregistry/has-symbols@^1",
+    "has-tostringtag": "npm:@socketregistry/has-tostringtag@^1",
+    "hasown": "npm:@socketregistry/hasown@^1",
+    "indent-string": "npm:@socketregistry/indent-string@^1",
+    "internal-slot": "npm:@socketregistry/internal-slot@^1",
+    "is-array-buffer": "npm:@socketregistry/is-array-buffer@^1",
+    "is-bigint": "npm:@socketregistry/is-bigint@^1",
+    "is-boolean-object": "npm:@socketregistry/is-boolean-object@^1",
+    "is-core-module": "npm:@socketregistry/is-core-module@^1",
+    "is-date-object": "npm:@socketregistry/is-date-object@^1",
+    "is-generator-function": "npm:@socketregistry/is-generator-function@^1",
+    "is-map": "npm:@socketregistry/is-map@^1",
+    "is-negative-zero": "npm:@socketregistry/is-negative-zero@^1",
+    "is-number-object": "npm:@socketregistry/is-number-object@^1",
+    "is-regex": "npm:@socketregistry/is-regex@^1",
+    "is-set": "npm:@socketregistry/is-set@^1",
+    "is-shared-array-buffer": "npm:@socketregistry/is-shared-array-buffer@^1",
+    "is-string": "npm:@socketregistry/is-string@^1",
+    "is-symbol": "npm:@socketregistry/is-symbol@^1",
+    "is-typed-array": "npm:@socketregistry/is-typed-array@^1",
+    "is-weakmap": "npm:@socketregistry/is-weakmap@^1",
+    "is-weakref": "npm:@socketregistry/is-weakref@^1",
+    "is-weakset": "npm:@socketregistry/is-weakset@^1",
+    "isarray": "npm:@socketregistry/isarray@^1",
+    "iterator.prototype": "npm:@socketregistry/iterator.prototype@^1",
+    "object-assign": "npm:@socketregistry/object-assign@^1",
+    "object-keys": "npm:@socketregistry/object-keys@^1",
+    "object.assign": "npm:@socketregistry/object.assign@^1",
+    "object.entries": "npm:@socketregistry/object.entries@^1",
+    "object.fromentries": "npm:@socketregistry/object.fromentries@^1",
+    "object.values": "npm:@socketregistry/object.values@^1",
+    "path-parse": "npm:@socketregistry/path-parse@^1",
+    "reflect.getprototypeof": "npm:@socketregistry/reflect.getprototypeof@^1",
+    "regexp.prototype.flags": "npm:@socketregistry/regexp.prototype.flags@^1",
+    "safe-array-concat": "npm:@socketregistry/safe-array-concat@^1",
+    "safe-regex-test": "npm:@socketregistry/safe-regex-test@^1",
+    "safer-buffer": "npm:@socketregistry/safer-buffer@^1",
+    "set-function-length": "npm:@socketregistry/set-function-length@^1",
+    "side-channel": "npm:@socketregistry/side-channel@^1",
+    "string.prototype.matchall": "npm:@socketregistry/string.prototype.matchall@^1",
+    "string.prototype.repeat": "npm:@socketregistry/string.prototype.repeat@^1",
+    "string.prototype.trim": "npm:@socketregistry/string.prototype.trim@^1",
+    "string.prototype.trimend": "npm:@socketregistry/string.prototype.trimend@^1",
+    "string.prototype.trimstart": "npm:@socketregistry/string.prototype.trimstart@^1",
+    "typed-array-buffer": "npm:@socketregistry/typed-array-buffer@^1",
+    "typed-array-byte-length": "npm:@socketregistry/typed-array-byte-length@^1",
+    "typed-array-byte-offset": "npm:@socketregistry/typed-array-byte-offset@^1",
+    "typed-array-length": "npm:@socketregistry/typed-array-length@^1",
+    "unbox-primitive": "npm:@socketregistry/unbox-primitive@^1",
+    "which-boxed-primitive": "npm:@socketregistry/which-boxed-primitive@^1",
+    "which-collection": "npm:@socketregistry/which-collection@^1",
+    "which-typed-array": "npm:@socketregistry/which-typed-array@^1"
+  },
   "module": "./index.js",
   "exports": {
     ".": {

package/types/dphelper.d.ts

@@ -747,9 +747,6 @@ interface globalThis {
   [key: string]: any
 }
 
-declare var DPH_APP_CODE: string
-declare var DPH_APP_VERSION: string
-
 declare function confirm(message: string, func1: Function, func2?: Function): boolean
 
 declare var dphelper: _dphelper