dphelper 4.6.0 → 4.6.2

package/llms.txt

@@ -1,73 +1,515 @@
-# dphelper
-
-> [!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
-
-`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);
-
-// 🤖 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}!' });
-
-## 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.
+# dphelper
+
+> **Stateless, zero-dependency capability toolkit for Web, Node.js, Bun, Deno and AI systems.**
+
+`dphelper` provides a consistent namespace of modular capabilities for modern JavaScript and TypeScript applications.
+
+**Core principles:**
+
+* Stateless
+* Zero runtime dependencies
+* Modular
+* Isomorphic where supported
+* Consistent namespace
+* TypeScript-friendly
+* AI-ready
+
+---
+
+## IMPORTANT: Architecture
+
+**Application state management has been removed from `dphelper`.**
+
+Do **not** use legacy state APIs such as:
+
+```javascript
+dphelper.store
+```
+
+Application state must be handled by a dedicated state manager:
+
+* **Memorio** — lightweight application-wide/global state.
+* **Argis RGS** — enterprise and complex reactive state architectures.
+
+`dphelper` provides capabilities and operations. It does not own application state.
+
+---
+
+## Core Mental Model
+
+Think of `dphelper` as a **capability layer**, not as an application framework.
+
+```text
+Application
+    │
+    ├── State
+    │     ├── Memorio
+    │     └── Argis RGS
+    │
+    └── Capabilities
+          │
+          └── dphelper
+                ├── ai
+                ├── worker
+                ├── fetch
+                ├── security
+                ├── sanitize
+                ├── i18n
+                ├── sync
+                ├── compress
+                └── ...
+```
+
+Keep these responsibilities separate.
+
+---
+
+## Initialization
+
+`dphelper` uses a global namespace.
+
+Initialize it **once**, at the application's root entry point:
+
+```javascript
+import "dphelper";
+```
+
+After initialization:
+
+```javascript
+console.debug(dphelper.version);
+```
+
+### Important
+
+Do not repeatedly initialize `dphelper` from individual submodules.
+
+Preferred architecture:
+
+```text
+Application Root
+      │
+      └── import "dphelper"
+              │
+              ▼
+        global dphelper
+              │
+       ┌──────┼──────┐
+       ▼      ▼      ▼
+      ai    worker  security
+```
+
+---
+
+## Modular Imports
+
+Individual capabilities can also be imported explicitly:
+
+```typescript
+import { sanitize } from "dphelper/sanitize";
+import { format } from "dphelper/format";
+import { fetch } from "dphelper/fetch";
+import { security } from "dphelper/security";
+```
+
+Use modular imports when explicit imports and tree-shaking are preferred.
+
+The corresponding global namespace remains available after initialization.
+
+---
+
+## Capability Namespace
+
+Capabilities follow the general pattern:
+
+```text
+dphelper.<domain>.<operation>
+```
+
+Examples:
+
+```javascript
+dphelper.ai.toon(data);
+dphelper.ai.tokenCount(data);
+
+dphelper.security.ulid();
+
+dphelper.i18n.t("hello");
+
+dphelper.worker.create("worker.js");
+
+dphelper.sync.pulse("my-app", callback);
+
+dphelper.format.currency(1234.56, "en-US", "USD");
+```
+
+When generating code, prefer the existing `dphelper` namespace rather than introducing an additional utility dependency for functionality already provided by the library.
+
+---
+
+# AI Capabilities
+
+`dphelper.ai` provides capabilities intended for LLM, RAG and AI-assisted application workflows.
+
+## TOON
+
+Use:
+
+```javascript
+const toonData = dphelper.ai.toon(data);
+```
+
+TOON provides a compact structured representation intended for AI/LLM-oriented data exchange.
+
+## Token Counting
+
+Use:
+
+```javascript
+const tokens = dphelper.ai.tokenCount(data);
+```
+
+Use this when estimating the token representation of structured data for AI workflows.
+
+## RAG Chunking
+
+Use:
+
+```javascript
+const chunks = dphelper.ai.chunker(text, {
+  size: 1000,
+  overlap: 200
+});
+```
+
+## Semantic Similarity
+
+Use:
+
+```javascript
+const score = dphelper.ai.similarity(
+  embeddingA,
+  embeddingB
+);
+```
+
+## Reasoning Extraction
+
+Use:
+
+```javascript
+const {
+  reasoning,
+  content
+} = dphelper.ai.extractReasoning(rawAiReply);
+```
+
+This capability can process responses containing separate reasoning and content representations.
+
+## Runtime Snapshot
+
+Use:
+
+```javascript
+const snapshot = dphelper.ai.snapshot();
+```
+
+The snapshot capability creates a compact representation of relevant application/runtime context for AI-assisted inspection, debugging and recovery.
+
+---
+
+# Worker Capabilities
+
+`dphelper.worker` provides browser Worker primitives.
+
+## Worker
+
+```javascript
+const worker = dphelper.worker.create("worker.js", {
+  onmessage: (event) => {
+    console.log(event.data);
+  }
+});
+```
+
+## Inline Worker
+
+```javascript
+const worker = dphelper.worker.createInline(`
+  self.onmessage = e => {
+    postMessage(e.data * 2);
+  };
+`);
+```
+
+## Worker Pool
+
+```javascript
+const pool = dphelper.worker.pool("worker.js", 4);
+
+const results =
+  await dphelper.worker.poolExec(
+    pool,
+    [1, 2, 3, 4]
+  );
+```
+
+## SharedWorker
+
+```javascript
+const shared =
+  dphelper.worker.shared("worker.js", {
+    name: "my-shared"
+  });
+```
+
+### Worker Security Rule
+
+Worker code and worker script URLs must be treated as **trusted input**.
+
+Never pass arbitrary user-controlled code directly to:
+
+```javascript
+dphelper.worker.createInline(userInput);
+dphelper.worker.create(userInput);
+dphelper.worker.pool(userInput);
+```
+
+Do not load worker scripts from URLs controlled by untrusted users.
+
+---
+
+# Cross-Tab Synchronization
+
+Use `dphelper.sync.pulse` for event-based communication between browser contexts:
+
+```javascript
+const bus = dphelper.sync.pulse(
+  "my-app",
+  (message) => {
+    console.log(message);
+  }
+);
+
+bus.emit({
+  action: "theme-change",
+  value: "dark"
+});
+```
+
+`sync.pulse` provides communication.
+
+It is **not** the application state store.
+
+For persistent/application state:
+
+```text
+Cross-tab events  → dphelper.sync.pulse
+Application state → Memorio / Argis RGS
+```
+
+---
+
+# Internationalization
+
+Use:
+
+```javascript
+dphelper.i18n.setLocale("it");
+
+dphelper.i18n.addTranslations("it", {
+  hello: "Ciao {name}!"
+});
+
+dphelper.i18n.t("hello", {
+  name: "World"
+});
+```
+
+Other internationalization capabilities include pluralization, number formatting and relative time.
+
+---
+
+# Security Guidance
+
+`dphelper` provides security-oriented capabilities but does not automatically make an application secure.
+
+Always consider the application's threat model and validate external input at the application boundary.
+
+## Cryptography
+
+Available cryptographic primitives include:
+
+* AES-256-GCM
+* SHA-256
+* PBKDF2
+* PBKDF2 configurations using 310,000 iterations where applicable
+
+Do not describe `dphelper` as universally "NIST compliant" or "NSA compliant" unless a specific component, configuration and compliance scope has been formally established.
+
+Prefer precise descriptions of the cryptographic primitive being used.
+
+## Network Input
+
+Networking capabilities include:
+
+```text
+dphelper.fetch
+dphelper.sse
+dphelper.socket
+```
+
+Treat externally supplied URLs as untrusted.
+
+Example:
+
+```javascript
+const safeUrl =
+  dphelper.sanitize.url(userInput);
+
+await dphelper.fetch.get(safeUrl);
+```
+
+Do not assume that passing data through a utility automatically makes the application's overall network operation safe.
+
+---
+
+# Environment Model
+
+Capabilities may target different environments.
+
+| Type       | Meaning                                                    |
+| ---------- | ---------------------------------------------------------- |
+| Client     | Browser APIs such as DOM, window or navigator              |
+| Server     | Node.js, Bun or Deno APIs                                  |
+| Isomorphic | Designed to operate in both client and server environments |
+
+Examples:
+
+```text
+dphelper.ai       → Isomorphic
+dphelper.fetch    → Isomorphic
+dphelper.sse      → Client
+dphelper.socket   → Client
+dphelper.sync     → Client
+dphelper.UI       → Client
+dphelper.worker   → Client
+```
+
+Always respect the execution environment of the capability being used.
+
+---
+
+# State Management Rules
+
+### NEVER generate:
+
+```javascript
+dphelper.store
+```
+
+### USE:
+
+```text
+Simple/global application state
+        ↓
+     Memorio
+```
+
+or:
+
+```text
+Enterprise / complex reactive state
+        ↓
+     Argis RGS
+```
+
+### Cross-tab communication:
+
+```javascript
+dphelper.sync.pulse(...)
+```
+
+Use `sync.pulse` for events and communication, not as a replacement for the application's state manager.
+
+---
+
+# AI Code Generation Rules
+
+When generating code for a project using `dphelper`:
+
+1. Prefer an existing `dphelper` capability over adding another dependency for the same operation.
+2. Do not introduce `dphelper.store` or legacy state-management APIs.
+3. Keep application state outside `dphelper`.
+4. Initialize the global namespace once at the application root when using global mode.
+5. Use modular imports when explicit capability imports are preferable.
+6. Use `dphelper.sync.pulse` for cross-tab event communication.
+7. Use Memorio or Argis RGS for application state.
+8. Treat network URLs and worker sources as potentially untrusted input.
+9. Respect client/server/isomorphic environment constraints.
+10. Do not assume that a `dphelper` capability exists unless it is part of the published API.
+
+---
+
+# Architectural Summary
+
+```text
+                 APPLICATION
+                      │
+          ┌───────────┴───────────┐
+          │                       │
+       STATE                 CAPABILITIES
+          │                       │
+     ┌────┴────┐                  │
+     │         │                  │
+ Memorio    Argis RGS             │
+                                dphelper
+                                   │
+              ┌────────────┬───────┼────────┐
+              │            │       │        │
+             AI          Worker   Web    Security
+              │            │       │        │
+            TOON        Pools    Fetch    Crypto
+            RAG         Shared   SSE      Sanitize
+            Tokens      Worker   Socket
+```
+
+**dphelper is the stateless capability layer.**
+
+**Memorio and Argis RGS are state-management layers.**
+
+Do not merge these responsibilities.
+
+---
+
+## Package
+
+`dphelper` is distributed through npm:
+
+```text
+npm install dphelper
+```
+
+Official package:
+
+https://www.npmjs.com/package/dphelper
+
+---
+
+## Related Packages
+
+### Memorio
+
+Application-wide state management for simpler applications.
+
+```text
+https://www.npmjs.com/package/memorio
+```
+
+### Argis RGS
+
+Enterprise-oriented reactive state architecture.
+
+```text
+https://www.npmjs.com/package/@biglogic/rgs
+```

package/modules/ai.cjs

@@ -1,4 +1,4 @@
-'use strict';var P={info:{title:"List",description:"Complete list of tools"},categories:["3party","system","financial","memory","numbers","time","path","file","forms","ui","other","development"]};var v={version:"4.6.0"};Object.defineProperty(globalThis,"dphelper",{value:new Proxy({},{}),writable:true,configurable:true,enumerable:false});Object.defineProperties(dphelper,{_list:{value:{scripts:[],sockets:[],...P},configurable:true,writable:true},version:{value:v.version,configurable:true,writable:true},isServer:{value:false,configurable:true,writable:true},isBrowser:{value:true,configurable:true,writable:true}});var f=dphelper;Object.defineProperty(f,"setProps",{value:(e,t,r)=>{Object.defineProperty(e,t.name,r||{writable:false,configurable:false,enumerable:false}),r?.lock&&Object.freeze(e[t.name]);},writable:false,configurable:false,enumerable:false});Object.defineProperty(f,"setDescription",{value:(e,t)=>{Object.defineProperties(f,{[e.name]:{value:t,writable:false,configurable:false,enumerable:false}}),Object.keys(t).map(r=>(Object.defineProperties(f[e.name],{[r]:{writable:false,configurable:false,enumerable:false}}),null)),f.setProps(f,e,{writable:false,configurable:false,enumerable:false}),f._list.scripts.push(e);}});var M={name:"ai",active:true,subCommand:[{name:"tokenCount",version:"0.0.3",example:"dphelper.ai.tokenCount({ users: [1,2,3] })",author:"Dario Passariello",creationDate:"20260220",lastMod:"20260221",type:"function",active:true,description:"Estimate token count for LLMs. If an object is passed, it uses TOON format for calculation.",env:"both",subCommand:[]},{name:"smartSanitize",version:"0.0.2",example:"dphelper.ai.smartSanitize('My email is test@example.com')",author:"Dario Passariello & Jo",creationDate:"20260220",lastMod:"20260220",type:"function",active:true,description:"Remove PII (emails, phones, etc) from text for AI privacy",subCommand:[]},{name:"toon",version:"0.0.1",example:"dphelper.ai.toon({ users: [{id: 1, name: 'Ada'}] })",author:"TOON + Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Convert JSON to TOON format (Token-Oriented Object Notation)",subCommand:[]},{name:"toonToJson",version:"0.0.1",example:"dphelper.ai.toonToJson('users[1]{id,name}:\\n  1,Ada')",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Convert TOON format back to JSON/Object",subCommand:[]},{name:"chunker",version:"0.0.1",example:"dphelper.ai.chunker(text, { size: 1000, overlap: 200 })",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Split long text into chunks for RAG or AI processing.",subCommand:[]},{name:"similarity",version:"0.0.1",example:"dphelper.ai.similarity(vecA, vecB)",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Calculate cosine similarity between two embedding vectors.",subCommand:[]},{name:"extractReasoning",version:"0.0.1",example:"dphelper.ai.extractReasoning(aiResponse)",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Extract <think> tags or internal reasoning from AI responses.",subCommand:[]},{name:"prompt",version:"0.0.1",example:"dphelper.ai.prompt('Hello {{name}}', { name: 'Ada' })",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Simple prompt template engine with variable injection.",subCommand:[]},{name:"schema",version:"0.0.1",example:"dphelper.ai.schema({ id: 1, name: 'Ada' })",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Generate a TOON-style schema definition for AI instructions.",subCommand:[]},{name:"snapshot",version:"0.0.1",example:"dphelper.ai.snapshot()",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Capture a 'mental snapshot' of the app state (logs/globals) in TOON format for AI debugging.",env:"both",subCommand:[]}]},x=e=>e===null||typeof e!="object",O=e=>e===null?"null":typeof e=="string"?e.includes(",")||e.includes(":")||e.includes('"')||e.includes(`
+'use strict';var P={info:{title:"List",description:"Complete list of tools"},categories:["3party","system","financial","memory","numbers","time","path","file","forms","ui","other","development"]};var v={version:"4.6.2"};Object.defineProperty(globalThis,"dphelper",{value:new Proxy({},{}),writable:true,configurable:true,enumerable:false});Object.defineProperties(dphelper,{_list:{value:{scripts:[],sockets:[],...P},configurable:true,writable:true},version:{value:v.version,configurable:true,writable:true},isServer:{value:false,configurable:true,writable:true},isBrowser:{value:true,configurable:true,writable:true}});var f=dphelper;Object.defineProperty(f,"setProps",{value:(e,t,r)=>{Object.defineProperty(e,t.name,r||{writable:false,configurable:false,enumerable:false}),r?.lock&&Object.freeze(e[t.name]);},writable:false,configurable:false,enumerable:false});Object.defineProperty(f,"setDescription",{value:(e,t)=>{Object.defineProperties(f,{[e.name]:{value:t,writable:false,configurable:false,enumerable:false}}),Object.keys(t).map(r=>(Object.defineProperties(f[e.name],{[r]:{writable:false,configurable:false,enumerable:false}}),null)),f.setProps(f,e,{writable:false,configurable:false,enumerable:false}),f._list.scripts.push(e);}});var M={name:"ai",active:true,subCommand:[{name:"tokenCount",version:"0.0.3",example:"dphelper.ai.tokenCount({ users: [1,2,3] })",author:"Dario Passariello",creationDate:"20260220",lastMod:"20260221",type:"function",active:true,description:"Estimate token count for LLMs. If an object is passed, it uses TOON format for calculation.",env:"both",subCommand:[]},{name:"smartSanitize",version:"0.0.2",example:"dphelper.ai.smartSanitize('My email is test@example.com')",author:"Dario Passariello & Jo",creationDate:"20260220",lastMod:"20260220",type:"function",active:true,description:"Remove PII (emails, phones, etc) from text for AI privacy",subCommand:[]},{name:"toon",version:"0.0.1",example:"dphelper.ai.toon({ users: [{id: 1, name: 'Ada'}] })",author:"TOON + Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Convert JSON to TOON format (Token-Oriented Object Notation)",subCommand:[]},{name:"toonToJson",version:"0.0.1",example:"dphelper.ai.toonToJson('users[1]{id,name}:\\n  1,Ada')",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Convert TOON format back to JSON/Object",subCommand:[]},{name:"chunker",version:"0.0.1",example:"dphelper.ai.chunker(text, { size: 1000, overlap: 200 })",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Split long text into chunks for RAG or AI processing.",subCommand:[]},{name:"similarity",version:"0.0.1",example:"dphelper.ai.similarity(vecA, vecB)",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Calculate cosine similarity between two embedding vectors.",subCommand:[]},{name:"extractReasoning",version:"0.0.1",example:"dphelper.ai.extractReasoning(aiResponse)",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Extract <think> tags or internal reasoning from AI responses.",subCommand:[]},{name:"prompt",version:"0.0.1",example:"dphelper.ai.prompt('Hello {{name}}', { name: 'Ada' })",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Simple prompt template engine with variable injection.",subCommand:[]},{name:"schema",version:"0.0.1",example:"dphelper.ai.schema({ id: 1, name: 'Ada' })",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Generate a TOON-style schema definition for AI instructions.",subCommand:[]},{name:"snapshot",version:"0.0.1",example:"dphelper.ai.snapshot()",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Capture a 'mental snapshot' of the app state (logs/globals) in TOON format for AI debugging.",env:"both",subCommand:[]}]},x=e=>e===null||typeof e!="object",O=e=>e===null?"null":typeof e=="string"?e.includes(",")||e.includes(":")||e.includes('"')||e.includes(`
 `)||e.trim()!==e?`"${e.replace(/"/g,'\\"')}"`:e||'""':String(e),b=(e,t=0)=>{let r="  ".repeat(t);if(x(e))return O(e);if(Array.isArray(e)){if(e.length===0)return "[0]:";let n=e[0];if(!x(n)&&!Array.isArray(n)){let s=Object.keys(n),o=`[${e.length}]{${s.join(",")}}:`;for(let i of e){let u=s.map(a=>O(i[a])).join(",");o+=`
 ${r}  ${u}`;}return o}else return `[${e.length}]: `+e.map(O).join(",")}else return Object.entries(e).map(([n,s])=>{let o=n.includes(" ")||n.includes(":")?`"${n}"`:n;if(!x(s)){let i=b(s,t+1);return i.startsWith("[")?`${o}${i}`:`${o}:
   ${r}${i}`}return `${o}: ${O(s)}`}).join(`

package/modules/ai.d.ts

@@ -1,15 +1,15 @@
 /// <reference path="../types/dphelper.d.ts" />
-export interface AiTool {
-  tokenCount: (data: any) => number
-  smartSanitize: (text: string) => string
-  toon: (data: any) => string
-  toonToJson: (toon: string) => any
-  chunker: (text: string, options?: { size?: number, overlap?: number }) => string[]
-  similarity: (a: number[], b: number[]) => number
-  extractReasoning: (text: string) => { reasoning: string, content: string }
-  prompt: (template: string, vars: Record<string, any>) => string
-  schema: (data: any) => string
-  snapshot: () => string
+export interface AiTool {
+  tokenCount: (data: any) => number
+  smartSanitize: (text: string) => string
+  toon: (data: any) => string
+  toonToJson: (toon: string) => any
+  chunker: (text: string, options?: { size?: number, overlap?: number }) => string[]
+  similarity: (a: number[], b: number[]) => number
+  extractReasoning: (text: string) => { reasoning: string, content: string }
+  prompt: (template: string, vars: Record<string, any>) => string
+  schema: (data: any) => string
+  snapshot: () => string
 }
 
 export const ai: AiTool

package/modules/ai.js

@@ -1,4 +1,4 @@
-var v={info:{title:"List",description:"Complete list of tools"},categories:["3party","system","financial","memory","numbers","time","path","file","forms","ui","other","development"]};var $={version:"4.6.0"};Object.defineProperty(globalThis,"dphelper",{value:new Proxy({},{}),writable:true,configurable:true,enumerable:false});Object.defineProperties(dphelper,{_list:{value:{scripts:[],sockets:[],...v},configurable:true,writable:true},version:{value:$.version,configurable:true,writable:true},isServer:{value:false,configurable:true,writable:true},isBrowser:{value:true,configurable:true,writable:true}});var f=dphelper;Object.defineProperty(f,"setProps",{value:(e,t,r)=>{Object.defineProperty(e,t.name,r||{writable:false,configurable:false,enumerable:false}),r?.lock&&Object.freeze(e[t.name]);},writable:false,configurable:false,enumerable:false});Object.defineProperty(f,"setDescription",{value:(e,t)=>{Object.defineProperties(f,{[e.name]:{value:t,writable:false,configurable:false,enumerable:false}}),Object.keys(t).map(r=>(Object.defineProperties(f[e.name],{[r]:{writable:false,configurable:false,enumerable:false}}),null)),f.setProps(f,e,{writable:false,configurable:false,enumerable:false}),f._list.scripts.push(e);}});var N={name:"ai",active:true,subCommand:[{name:"tokenCount",version:"0.0.3",example:"dphelper.ai.tokenCount({ users: [1,2,3] })",author:"Dario Passariello",creationDate:"20260220",lastMod:"20260221",type:"function",active:true,description:"Estimate token count for LLMs. If an object is passed, it uses TOON format for calculation.",env:"both",subCommand:[]},{name:"smartSanitize",version:"0.0.2",example:"dphelper.ai.smartSanitize('My email is test@example.com')",author:"Dario Passariello & Jo",creationDate:"20260220",lastMod:"20260220",type:"function",active:true,description:"Remove PII (emails, phones, etc) from text for AI privacy",subCommand:[]},{name:"toon",version:"0.0.1",example:"dphelper.ai.toon({ users: [{id: 1, name: 'Ada'}] })",author:"TOON + Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Convert JSON to TOON format (Token-Oriented Object Notation)",subCommand:[]},{name:"toonToJson",version:"0.0.1",example:"dphelper.ai.toonToJson('users[1]{id,name}:\\n  1,Ada')",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Convert TOON format back to JSON/Object",subCommand:[]},{name:"chunker",version:"0.0.1",example:"dphelper.ai.chunker(text, { size: 1000, overlap: 200 })",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Split long text into chunks for RAG or AI processing.",subCommand:[]},{name:"similarity",version:"0.0.1",example:"dphelper.ai.similarity(vecA, vecB)",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Calculate cosine similarity between two embedding vectors.",subCommand:[]},{name:"extractReasoning",version:"0.0.1",example:"dphelper.ai.extractReasoning(aiResponse)",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Extract <think> tags or internal reasoning from AI responses.",subCommand:[]},{name:"prompt",version:"0.0.1",example:"dphelper.ai.prompt('Hello {{name}}', { name: 'Ada' })",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Simple prompt template engine with variable injection.",subCommand:[]},{name:"schema",version:"0.0.1",example:"dphelper.ai.schema({ id: 1, name: 'Ada' })",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Generate a TOON-style schema definition for AI instructions.",subCommand:[]},{name:"snapshot",version:"0.0.1",example:"dphelper.ai.snapshot()",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Capture a 'mental snapshot' of the app state (logs/globals) in TOON format for AI debugging.",env:"both",subCommand:[]}]},A=e=>e===null||typeof e!="object",O=e=>e===null?"null":typeof e=="string"?e.includes(",")||e.includes(":")||e.includes('"')||e.includes(`
+var v={info:{title:"List",description:"Complete list of tools"},categories:["3party","system","financial","memory","numbers","time","path","file","forms","ui","other","development"]};var $={version:"4.6.2"};Object.defineProperty(globalThis,"dphelper",{value:new Proxy({},{}),writable:true,configurable:true,enumerable:false});Object.defineProperties(dphelper,{_list:{value:{scripts:[],sockets:[],...v},configurable:true,writable:true},version:{value:$.version,configurable:true,writable:true},isServer:{value:false,configurable:true,writable:true},isBrowser:{value:true,configurable:true,writable:true}});var f=dphelper;Object.defineProperty(f,"setProps",{value:(e,t,r)=>{Object.defineProperty(e,t.name,r||{writable:false,configurable:false,enumerable:false}),r?.lock&&Object.freeze(e[t.name]);},writable:false,configurable:false,enumerable:false});Object.defineProperty(f,"setDescription",{value:(e,t)=>{Object.defineProperties(f,{[e.name]:{value:t,writable:false,configurable:false,enumerable:false}}),Object.keys(t).map(r=>(Object.defineProperties(f[e.name],{[r]:{writable:false,configurable:false,enumerable:false}}),null)),f.setProps(f,e,{writable:false,configurable:false,enumerable:false}),f._list.scripts.push(e);}});var N={name:"ai",active:true,subCommand:[{name:"tokenCount",version:"0.0.3",example:"dphelper.ai.tokenCount({ users: [1,2,3] })",author:"Dario Passariello",creationDate:"20260220",lastMod:"20260221",type:"function",active:true,description:"Estimate token count for LLMs. If an object is passed, it uses TOON format for calculation.",env:"both",subCommand:[]},{name:"smartSanitize",version:"0.0.2",example:"dphelper.ai.smartSanitize('My email is test@example.com')",author:"Dario Passariello & Jo",creationDate:"20260220",lastMod:"20260220",type:"function",active:true,description:"Remove PII (emails, phones, etc) from text for AI privacy",subCommand:[]},{name:"toon",version:"0.0.1",example:"dphelper.ai.toon({ users: [{id: 1, name: 'Ada'}] })",author:"TOON + Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Convert JSON to TOON format (Token-Oriented Object Notation)",subCommand:[]},{name:"toonToJson",version:"0.0.1",example:"dphelper.ai.toonToJson('users[1]{id,name}:\\n  1,Ada')",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Convert TOON format back to JSON/Object",subCommand:[]},{name:"chunker",version:"0.0.1",example:"dphelper.ai.chunker(text, { size: 1000, overlap: 200 })",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Split long text into chunks for RAG or AI processing.",subCommand:[]},{name:"similarity",version:"0.0.1",example:"dphelper.ai.similarity(vecA, vecB)",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Calculate cosine similarity between two embedding vectors.",subCommand:[]},{name:"extractReasoning",version:"0.0.1",example:"dphelper.ai.extractReasoning(aiResponse)",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Extract <think> tags or internal reasoning from AI responses.",subCommand:[]},{name:"prompt",version:"0.0.1",example:"dphelper.ai.prompt('Hello {{name}}', { name: 'Ada' })",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Simple prompt template engine with variable injection.",subCommand:[]},{name:"schema",version:"0.0.1",example:"dphelper.ai.schema({ id: 1, name: 'Ada' })",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Generate a TOON-style schema definition for AI instructions.",subCommand:[]},{name:"snapshot",version:"0.0.1",example:"dphelper.ai.snapshot()",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Capture a 'mental snapshot' of the app state (logs/globals) in TOON format for AI debugging.",env:"both",subCommand:[]}]},A=e=>e===null||typeof e!="object",O=e=>e===null?"null":typeof e=="string"?e.includes(",")||e.includes(":")||e.includes('"')||e.includes(`
 `)||e.trim()!==e?`"${e.replace(/"/g,'\\"')}"`:e||'""':String(e),b=(e,t=0)=>{let r="  ".repeat(t);if(A(e))return O(e);if(Array.isArray(e)){if(e.length===0)return "[0]:";let n=e[0];if(!A(n)&&!Array.isArray(n)){let s=Object.keys(n),o=`[${e.length}]{${s.join(",")}}:`;for(let i of e){let u=s.map(a=>O(i[a])).join(",");o+=`
 ${r}  ${u}`;}return o}else return `[${e.length}]: `+e.map(O).join(",")}else return Object.entries(e).map(([n,s])=>{let o=n.includes(" ")||n.includes(":")?`"${n}"`:n;if(!A(s)){let i=b(s,t+1);return i.startsWith("[")?`${o}${i}`:`${o}:
   ${r}${i}`}return `${o}: ${O(s)}`}).join(`