dphelper 4.5.2 → 4.6.0

package/SECURITY.md

@@ -1,27 +1,27 @@
-# Security Policy
-
-## Supported Versions
-
-| Version | Supported |
-| ------- | --------- |
-| 3.9.x   | ✅        |
-| < 3.5   | ❌        |
-
-## Security Standards
-
-- **NIST SP 800-53:** 98% compliance
-- **OWASP Top 10:** 100% compliance
-- **Socket.dev:** 90%+ target
-
-## Reporting a Vulnerability
-
-Email: architecture@biglogic.ca
-Response: Within 24 hours
-
-## Security Features
-
-- PBKDF2 310k iterations (OWASP 2023)
-- AES-GCM 256-bit encryption
-- TLS 1.2+ enforcement
-- WebSocket wss:// only
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported |
+| ------- | --------- |
+| 3.9.x   | ✅        |
+| < 3.5   | ❌        |
+
+## Security Standards
+
+- **NIST SP 800-53:** 98% compliance
+- **OWASP Top 10:** 100% compliance
+- **Socket.dev:** 90%+ target
+
+## Reporting a Vulnerability
+
+Email: architecture@biglogic.ca
+Response: Within 24 hours
+
+## Security Features
+
+- PBKDF2 310k iterations (OWASP 2023)
+- AES-GCM 256-bit encryption
+- TLS 1.2+ enforcement
+- WebSocket wss:// only
 - Input validation on all endpoints

package/SUMMARY.md

@@ -1,83 +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)
+# 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/index.cjs

@@ -1,4 +1,4 @@
-'use strict';var V={info:{title:"List",description:"Complete list of tools"},categories:["3party","system","financial","memory","numbers","time","path","file","forms","ui","other","development"]};var x={codeName:"dphelper",version:"4.5.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:x.version,configurable:true,writable:true},isServer:{value:false,configurable:true,writable:true},isBrowser:{value:true,configurable:true,writable:true}});var P=dphelper;Object.defineProperty(P,"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(P,"setDescription",{value:(e,t)=>{Object.defineProperties(P,{[e.name]:{value:t,writable:false,configurable:false,enumerable:false}}),Object.keys(t).map(r=>(Object.defineProperties(P[e.name],{[r]:{writable:false,configurable:false,enumerable:false}}),null)),P.setProps(P,e,{writable:false,configurable:false,enumerable:false}),P._list.scripts.push(e);}});var ue={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:[]}]},B=e=>e===null||typeof e!="object",H=e=>e===null?"null":typeof e=="string"?e.includes(",")||e.includes(":")||e.includes('"')||e.includes(`
+'use strict';var V={info:{title:"List",description:"Complete list of tools"},categories:["3party","system","financial","memory","numbers","time","path","file","forms","ui","other","development"]};var x={codeName:"dphelper",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:x.version,configurable:true,writable:true},isServer:{value:false,configurable:true,writable:true},isBrowser:{value:true,configurable:true,writable:true}});var P=dphelper;Object.defineProperty(P,"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(P,"setDescription",{value:(e,t)=>{Object.defineProperties(P,{[e.name]:{value:t,writable:false,configurable:false,enumerable:false}}),Object.keys(t).map(r=>(Object.defineProperties(P[e.name],{[r]:{writable:false,configurable:false,enumerable:false}}),null)),P.setProps(P,e,{writable:false,configurable:false,enumerable:false}),P._list.scripts.push(e);}});var ue={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:[]}]},B=e=>e===null||typeof e!="object",H=e=>e===null?"null":typeof e=="string"?e.includes(",")||e.includes(":")||e.includes('"')||e.includes(`
 `)||e.trim()!==e?`"${e.replace(/"/g,'\\"')}"`:e||'""':String(e),N=(e,t=0)=>{let r="  ".repeat(t);if(B(e))return H(e);if(Array.isArray(e)){if(e.length===0)return "[0]:";let n=e[0];if(!B(n)&&!Array.isArray(n)){let o=Object.keys(n),a=`[${e.length}]{${o.join(",")}}:`;for(let i of e){let s=o.map(l=>H(i[l])).join(",");a+=`
 ${r}  ${s}`;}return a}else return `[${e.length}]: `+e.map(H).join(",")}else return Object.entries(e).map(([n,o])=>{let a=n.includes(" ")||n.includes(":")?`"${n}"`:n;if(!B(o)){let i=N(o,t+1);return i.startsWith("[")?`${a}${i}`:`${a}:
   ${r}${i}`}return `${a}: ${H(o)}`}).join(`
@@ -143,7 +143,7 @@ ${t(i,`${n}  `)}${n}</${a}>
         )
 
       Copyright text (c) became an html symbol
-      `,env:"both",subCommand:[],author:"Dario Passariello",creationDate:"20250612",lastMod:"20250612"}]},Xr={trim:(e,t,r,n)=>e.charAt(0)===t?e.substring(r,n):e,capitalize:e=>e.toLowerCase().replace(/\b\w/g,t=>t.toUpperCase()),lower:e=>e.toLowerCase(),upper:e=>e.toUpperCase(),nl2br:e=>e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/(?:\r\n|\r|\n)/g,"<br>"),sanitize:e=>e.replace(/<(|\/|[^>\bi]|\/[^>bi]|[^/>][^>]+|\/[^>][^>]+)>/g,""),camelCase:{toSpace:e=>e.replace(/([A-Z])/g," $1").replace(/^./,t=>t.toUpperCase()),toUnderscore:e=>e.replace(/\.?([A-Z])/g,(t,r)=>`_${r.toLowerCase()}`).replace(/^_/,"")},fitContainer:e=>{if(!e)return;function t(r){let n=document.querySelectorAll(r),o=n.length;if(!(o<=0))for(let a=0;a<o;a++){let i=n[a].offsetWidth*.05;n[a].style.fontSize=`${i}px`;}}dphelper.addListenerMulti(window,"load resize",()=>t(e));},keywords:e=>{let t=/\b[A-Z][a-z]+\b/g,r=e.match(t)?.filter(n=>n.length>3)||[];return [...new Set(r.map(n=>n.toLowerCase()))]},replaceText:(e,t)=>{let r=e;for(let n in t)Object.hasOwn(t,n)&&(r=r.replaceAll(n,t[n]||""));return r}};dphelper?.setDescription(Zr,Xr);var Qr={name:"timer",active:true,subCommand:[{name:"sleep",version:"0.0.2",example:"dphelper.timer.sleep([ms]) ",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Pauses execution for a specified number of milliseconds.",env:"both",subCommand:[]},{name:"percentage",version:"0.0.2",example:"dphelper.timer.percentage([start], [end])",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Calculates the percentage of time elapsed between two time strings.",env:"both",subCommand:[]}]},en={sleep:e=>new Promise(t=>setTimeout(t,e)),percentage:(e,t)=>{function r(n){let o=n.split(":");return Number.parseInt(o[0]||"",10)*3600+Number.parseInt(o[1]||"",10)*60+Number.parseInt(o[2]||"",10)}return (100*r(e)/r(t)).toFixed(2)}};dphelper?.setDescription(Qr,en);var tn={name:"tools",active:true,subCommand:[{name:"byteSize",description:"Give you the total in 'Kb', 'Mb', 'Gb', 'Tb', 'Pb', 'Eb', 'Zb', 'Yb' starting from bytes",example:"dphelper.tools.byteSize(bytes)",version:"0.0.2",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,env:"both",subCommand:[]},{name:"hashPass",description:"Hashes a password using a specified number and total.",example:"dphelper.tools.hashPass(number, total)",version:"0.0.2",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,env:"both",subCommand:[]},{name:"zIndex",description:"Finds the highest z-index value in the document.",example:"dphelper.tools.zIndex()",version:"0.0.2",author:"Dario Passariello",creationDate:"20240807",lastMod:"20240807",type:"function",active:true,env:"both",subCommand:[]},{name:"zeroToFalse",description:"Converts zero to false, otherwise returns the value.",example:"dphelper.tools.zeroToFalse(num)",version:"0.0.2",author:"Dario Passariello",creationDate:"20240924",lastMod:"20240924",type:"function",active:true,env:"both",subCommand:[]}]},rn={byteSize:e=>{if(Math.abs(e)<1024)return `${e}b`;let r=["Kb","Mb","Gb","Tb","Pb","Eb","Zb","Yb"],n=-1,o=e;do o/=1024,++n;while(Math.abs(o)>=1024&&n<r.length-1);return o.toFixed(1)+r[n]},zIndex:()=>Array.from(document.querySelectorAll("body *")).map(e=>Number.parseFloat(getComputedStyle(e).zIndex)).reduce((e,t)=>t>e?t:e,1),zeroToFalse:e=>e===0?false:e};dphelper?.setDescription(tn,rn);var nn={name:"translators",active:true,subCommand:[{name:"convertMatrixToScale",version:"0.0.2",example:"dphelper.translators.convertMatrixToScale({value})",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Converts a transformation matrix to a scale value.",env:"both",subCommand:[]}]},on={convertMatrixToScale:e=>{let t=e.split("(");if(t.length<2)return 0;let r=t[1].split(")")[0];if(!r)return 0;let n=r.split(","),o=Number.parseFloat(n[0]||"0"),a=Number.parseFloat(n[1]||"0");return Math.sqrt(o*o+a*a)}};dphelper?.setDescription(nn,on);var an={name:"triggers",active:true,subCommand:[{name:"add",version:"0.0.1",example:"dphelper.triggers.add('event', callback)",author:"Dario Passariello",creationDate:"20250220",lastMod:"20250220",type:"function",active:true,description:"Add a trigger for custom events.",env:"client",subCommand:[]},{name:"on",version:"0.0.1",example:"dphelper.triggers.on('event', callback)",author:"Dario Passariello",creationDate:"20250220",lastMod:"20250220",type:"function",active:true,description:"Listen for a trigger event.",env:"client",subCommand:[]},{name:"emit",version:"0.0.1",example:"dphelper.triggers.emit('event', data)",author:"Dario Passariello",creationDate:"20250220",lastMod:"20250220",type:"function",active:true,description:"Emit a trigger event.",env:"client",subCommand:[]},{name:"remove",version:"0.0.1",example:"dphelper.triggers.remove('event')",author:"Dario Passariello",creationDate:"20250220",lastMod:"20250220",type:"function",active:true,description:"Remove a trigger event.",env:"client",subCommand:[]}]},M=new Map,ie={add:(e,t)=>{M.has(e)||M.set(e,new Set),M.get(e).add(t);},on:(e,t)=>{ie.add(e,t);},emit:(e,...t)=>{let r=M.get(e);r&&r.forEach(n=>{try{n(...t);}catch(o){console.error(`Error in trigger callback for event '${e}':`,o);}});},remove:e=>{M.delete(e);},off:(e,t)=>{let r=M.get(e);r&&r.delete(t);},clear:()=>{M.clear();},list:()=>Array.from(M.keys())};dphelper?.setDescription(an,ie);var sn={name:"type",active:true,subCommand:[{name:"of",version:"0.0.2",example:"dphelper.type.of(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Returns the type of the given parameter.",env:"both",subCommand:[]},{name:"instOfObj",version:"0.0.2",example:"dphelper.type.instOfObj(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Checks if the given parameter is an instance of Object.",env:"both",subCommand:[]},{name:"isNaN",version:"0.0.2",example:"dphelper.type.isNaN(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Checks if the given parameter is NaN.",env:"both",subCommand:[]},{name:"isBool",version:"0.0.2",example:"dphelper.type.isBool(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Checks if the given parameter is a boolean.",env:"both",subCommand:[]}]},ln={of:e=>typeof e,instOfObj:e=>e instanceof Object,isNull:e=>t=>!e(t),isBool:e=>!e||e.length==null?true:e==="1"};dphelper?.setDescription(sn,ln);var cn={name:"UI",active:true,subCommand:[{name:"input",version:"0.0.2",example:"dphelper.UI.input(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Creates an input element with specified options.",env:"client",subCommand:[]},{name:"fps",version:"0.0.2",example:"dphelper.UI.fps(true)",author:"Dario Passariello & Jo",creationDate:"20260220",lastMod:"20260220",type:"function",active:true,description:"Toggle a real-time FPS and Memory monitor overlay",env:"client",subCommand:[]},{name:"boxModel",version:"0.0.2",example:"dphelper.UI.boxModel(true)",author:"Dario Passariello & Jo",creationDate:"20260220",lastMod:"20260220",type:"function",active:true,description:"Toggle visual box-model highlighter for all elements",env:"client",subCommand:[]},{name:"anchorContext",version:"0.0.1",example:"dphelper.UI.anchorContext()",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Snapshot and auto-restore UI state (inputs, scroll) across reloads.",env:"client",subCommand:[]}]},dn={anchorContext:()=>{if(typeof window>"u"||typeof localStorage>"u")return;let e=`dp_anchor_${btoa(location.pathname).replace(/=/g,"")}`,t=()=>{let n={scroll:{x:window.scrollX,y:window.scrollY},inputs:Array.from(document.querySelectorAll("input, textarea, select")).filter(o=>o.type!=="password"&&!o.hasAttribute("data-private")&&o.getAttribute("autocomplete")!=="off").map(o=>({id:o.id,name:o.name,value:o.value}))};localStorage.setItem(e,JSON.stringify(n));},r=()=>{let n=localStorage.getItem(e);if(n)try{let o=JSON.parse(n);window.scrollTo(o.scroll.x,o.scroll.y),o.inputs.forEach(a=>{let i=a.id?document.getElementById(a.id):document.querySelector(`[name="${a.name}"]`);i&&(i.value=a.value);});}catch{console.warn("dphelper: anchorContext restoration failed.");}};window.addEventListener("beforeunload",t),r();},fps:(e=true)=>{if(typeof document>"u")return;let t=document.getElementById("dphelper-fps-monitor");if(!e){t?.remove();return}t||(t=document.createElement("div"),t.id="dphelper-fps-monitor",Object.assign(t.style,{position:"fixed",top:"10px",right:"10px",padding:"8px 12px",background:"rgba(0,0,0,0.8)",color:"#0f0",fontFamily:"monospace",fontSize:"12px",zIndex:"99999",borderRadius:"4px",pointerEvents:"none",boxShadow:"0 2px 10px rgba(0,0,0,0.5)",border:"1px solid #333"}),document.body.appendChild(t));let r=0,n=performance.now(),o=()=>{if(!document.getElementById("dphelper-fps-monitor"))return;r++;let a=performance.now();if(a>=n+1e3){let i=Math.round(r*1e3/(a-n)),s=performance.memory?` | Mem: ${Math.round(performance.memory.usedJSHeapSize/1048576)}MB`:"";t.innerText=`FPS: ${i}${s}`,r=0,n=a;}requestAnimationFrame(o);};requestAnimationFrame(o);},boxModel:(e=true)=>{if(typeof document>"u")return;let t=document.getElementById("dphelper-boxmodel-style");if(!e){t?.remove();return}t||(t=document.createElement("style"),t.id="dphelper-boxmodel-style",t.innerHTML=`
+      `,env:"both",subCommand:[],author:"Dario Passariello",creationDate:"20250612",lastMod:"20250612"},{name:"subString",version:"0.0.1",example:"dphelper.text.subString(text)",type:"function",active:true,description:"Length Of Longest Substring",env:"both",subCommand:[],author:"Dario Passariello",creationDate:"20260801",lastMod:"20260801"}]},Xr={trim:(e,t,r,n)=>e.charAt(0)===t?e.substring(r,n):e,capitalize:e=>e.toLowerCase().replace(/\b\w/g,t=>t.toUpperCase()),lower:e=>e.toLowerCase(),upper:e=>e.toUpperCase(),nl2br:e=>e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/(?:\r\n|\r|\n)/g,"<br>"),sanitize:e=>e.replace(/<(|\/|[^>\bi]|\/[^>bi]|[^/>][^>]+|\/[^>][^>]+)>/g,""),camelCase:{toSpace:e=>e.replace(/([A-Z])/g," $1").replace(/^./,t=>t.toUpperCase()),toUnderscore:e=>e.replace(/\.?([A-Z])/g,(t,r)=>`_${r.toLowerCase()}`).replace(/^_/,"")},fitContainer:e=>{if(!e)return;function t(r){let n=document.querySelectorAll(r),o=n.length;if(!(o<=0))for(let a=0;a<o;a++){let i=n[a].offsetWidth*.05;n[a].style.fontSize=`${i}px`;}}dphelper.addListenerMulti(window,"load resize",()=>t(e));},keywords:e=>{let t=/\b[A-Z][a-z]+\b/g,r=e.match(t)?.filter(n=>n.length>3)||[];return [...new Set(r.map(n=>n.toLowerCase()))]},replaceText:(e,t)=>{let r=e;for(let n in t)Object.hasOwn(t,n)&&(r=r.replaceAll(n,t[n]||""));return r},subString:e=>{let t=new Int32Array(65536);t.fill(-1);let r=0,n=0;for(let o=0;o<e.length;o++){let a=e.charCodeAt(o),i=t[a];r=r+(i-r+1&-(i>=r)),t[a]=o;let s=o-r+1;n=n+(s-n&-(s>n));}return n}};dphelper?.setDescription(Zr,Xr);var Qr={name:"timer",active:true,subCommand:[{name:"sleep",version:"0.0.2",example:"dphelper.timer.sleep([ms]) ",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Pauses execution for a specified number of milliseconds.",env:"both",subCommand:[]},{name:"percentage",version:"0.0.2",example:"dphelper.timer.percentage([start], [end])",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Calculates the percentage of time elapsed between two time strings.",env:"both",subCommand:[]}]},en={sleep:e=>new Promise(t=>setTimeout(t,e)),percentage:(e,t)=>{function r(n){let o=n.split(":");return Number.parseInt(o[0]||"",10)*3600+Number.parseInt(o[1]||"",10)*60+Number.parseInt(o[2]||"",10)}return (100*r(e)/r(t)).toFixed(2)}};dphelper?.setDescription(Qr,en);var tn={name:"tools",active:true,subCommand:[{name:"byteSize",description:"Give you the total in 'Kb', 'Mb', 'Gb', 'Tb', 'Pb', 'Eb', 'Zb', 'Yb' starting from bytes",example:"dphelper.tools.byteSize(bytes)",version:"0.0.2",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,env:"both",subCommand:[]},{name:"hashPass",description:"Hashes a password using a specified number and total.",example:"dphelper.tools.hashPass(number, total)",version:"0.0.2",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,env:"both",subCommand:[]},{name:"zIndex",description:"Finds the highest z-index value in the document.",example:"dphelper.tools.zIndex()",version:"0.0.2",author:"Dario Passariello",creationDate:"20240807",lastMod:"20240807",type:"function",active:true,env:"both",subCommand:[]},{name:"zeroToFalse",description:"Converts zero to false, otherwise returns the value.",example:"dphelper.tools.zeroToFalse(num)",version:"0.0.2",author:"Dario Passariello",creationDate:"20240924",lastMod:"20240924",type:"function",active:true,env:"both",subCommand:[]}]},rn={byteSize:e=>{if(Math.abs(e)<1024)return `${e}b`;let r=["Kb","Mb","Gb","Tb","Pb","Eb","Zb","Yb"],n=-1,o=e;do o/=1024,++n;while(Math.abs(o)>=1024&&n<r.length-1);return o.toFixed(1)+r[n]},zIndex:()=>Array.from(document.querySelectorAll("body *")).map(e=>Number.parseFloat(getComputedStyle(e).zIndex)).reduce((e,t)=>t>e?t:e,1),zeroToFalse:e=>e===0?false:e};dphelper?.setDescription(tn,rn);var nn={name:"translators",active:true,subCommand:[{name:"convertMatrixToScale",version:"0.0.2",example:"dphelper.translators.convertMatrixToScale({value})",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Converts a transformation matrix to a scale value.",env:"both",subCommand:[]}]},on={convertMatrixToScale:e=>{let t=e.split("(");if(t.length<2)return 0;let r=t[1].split(")")[0];if(!r)return 0;let n=r.split(","),o=Number.parseFloat(n[0]||"0"),a=Number.parseFloat(n[1]||"0");return Math.sqrt(o*o+a*a)}};dphelper?.setDescription(nn,on);var an={name:"triggers",active:true,subCommand:[{name:"add",version:"0.0.1",example:"dphelper.triggers.add('event', callback)",author:"Dario Passariello",creationDate:"20250220",lastMod:"20250220",type:"function",active:true,description:"Add a trigger for custom events.",env:"client",subCommand:[]},{name:"on",version:"0.0.1",example:"dphelper.triggers.on('event', callback)",author:"Dario Passariello",creationDate:"20250220",lastMod:"20250220",type:"function",active:true,description:"Listen for a trigger event.",env:"client",subCommand:[]},{name:"emit",version:"0.0.1",example:"dphelper.triggers.emit('event', data)",author:"Dario Passariello",creationDate:"20250220",lastMod:"20250220",type:"function",active:true,description:"Emit a trigger event.",env:"client",subCommand:[]},{name:"remove",version:"0.0.1",example:"dphelper.triggers.remove('event')",author:"Dario Passariello",creationDate:"20250220",lastMod:"20250220",type:"function",active:true,description:"Remove a trigger event.",env:"client",subCommand:[]}]},M=new Map,ie={add:(e,t)=>{M.has(e)||M.set(e,new Set),M.get(e).add(t);},on:(e,t)=>{ie.add(e,t);},emit:(e,...t)=>{let r=M.get(e);r&&r.forEach(n=>{try{n(...t);}catch(o){console.error(`Error in trigger callback for event '${e}':`,o);}});},remove:e=>{M.delete(e);},off:(e,t)=>{let r=M.get(e);r&&r.delete(t);},clear:()=>{M.clear();},list:()=>Array.from(M.keys())};dphelper?.setDescription(an,ie);var sn={name:"type",active:true,subCommand:[{name:"of",version:"0.0.2",example:"dphelper.type.of(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Returns the type of the given parameter.",env:"both",subCommand:[]},{name:"instOfObj",version:"0.0.2",example:"dphelper.type.instOfObj(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Checks if the given parameter is an instance of Object.",env:"both",subCommand:[]},{name:"isNaN",version:"0.0.2",example:"dphelper.type.isNaN(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Checks if the given parameter is NaN.",env:"both",subCommand:[]},{name:"isBool",version:"0.0.2",example:"dphelper.type.isBool(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Checks if the given parameter is a boolean.",env:"both",subCommand:[]}]},ln={of:e=>typeof e,instOfObj:e=>e instanceof Object,isNull:e=>t=>!e(t),isBool:e=>!e||e.length==null?true:e==="1"};dphelper?.setDescription(sn,ln);var cn={name:"UI",active:true,subCommand:[{name:"input",version:"0.0.2",example:"dphelper.UI.input(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Creates an input element with specified options.",env:"client",subCommand:[]},{name:"fps",version:"0.0.2",example:"dphelper.UI.fps(true)",author:"Dario Passariello & Jo",creationDate:"20260220",lastMod:"20260220",type:"function",active:true,description:"Toggle a real-time FPS and Memory monitor overlay",env:"client",subCommand:[]},{name:"boxModel",version:"0.0.2",example:"dphelper.UI.boxModel(true)",author:"Dario Passariello & Jo",creationDate:"20260220",lastMod:"20260220",type:"function",active:true,description:"Toggle visual box-model highlighter for all elements",env:"client",subCommand:[]},{name:"anchorContext",version:"0.0.1",example:"dphelper.UI.anchorContext()",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Snapshot and auto-restore UI state (inputs, scroll) across reloads.",env:"client",subCommand:[]}]},dn={anchorContext:()=>{if(typeof window>"u"||typeof localStorage>"u")return;let e=`dp_anchor_${btoa(location.pathname).replace(/=/g,"")}`,t=()=>{let n={scroll:{x:window.scrollX,y:window.scrollY},inputs:Array.from(document.querySelectorAll("input, textarea, select")).filter(o=>o.type!=="password"&&!o.hasAttribute("data-private")&&o.getAttribute("autocomplete")!=="off").map(o=>({id:o.id,name:o.name,value:o.value}))};localStorage.setItem(e,JSON.stringify(n));},r=()=>{let n=localStorage.getItem(e);if(n)try{let o=JSON.parse(n);window.scrollTo(o.scroll.x,o.scroll.y),o.inputs.forEach(a=>{let i=a.id?document.getElementById(a.id):document.querySelector(`[name="${a.name}"]`);i&&(i.value=a.value);});}catch{console.warn("dphelper: anchorContext restoration failed.");}};window.addEventListener("beforeunload",t),r();},fps:(e=true)=>{if(typeof document>"u")return;let t=document.getElementById("dphelper-fps-monitor");if(!e){t?.remove();return}t||(t=document.createElement("div"),t.id="dphelper-fps-monitor",Object.assign(t.style,{position:"fixed",top:"10px",right:"10px",padding:"8px 12px",background:"rgba(0,0,0,0.8)",color:"#0f0",fontFamily:"monospace",fontSize:"12px",zIndex:"99999",borderRadius:"4px",pointerEvents:"none",boxShadow:"0 2px 10px rgba(0,0,0,0.5)",border:"1px solid #333"}),document.body.appendChild(t));let r=0,n=performance.now(),o=()=>{if(!document.getElementById("dphelper-fps-monitor"))return;r++;let a=performance.now();if(a>=n+1e3){let i=Math.round(r*1e3/(a-n)),s=performance.memory?` | Mem: ${Math.round(performance.memory.usedJSHeapSize/1048576)}MB`:"";t.innerText=`FPS: ${i}${s}`,r=0,n=a;}requestAnimationFrame(o);};requestAnimationFrame(o);},boxModel:(e=true)=>{if(typeof document>"u")return;let t=document.getElementById("dphelper-boxmodel-style");if(!e){t?.remove();return}t||(t=document.createElement("style"),t.id="dphelper-boxmodel-style",t.innerHTML=`
     * { outline: 1px solid rgba(255, 0, 0, 0.3) !important; }
     * * { outline: 1px solid rgba(0, 255, 0, 0.3) !important; }
     * * * { outline: 1px solid rgba(0, 0, 255, 0.3) !important; }

package/index.d.ts

@@ -1 +1 @@
-/// <reference path="./types/dphelper.d.ts" />
+/// <reference path="./types/dphelper.d.ts" />

package/index.js

@@ -1,4 +1,4 @@
-var K={info:{title:"List",description:"Complete list of tools"},categories:["3party","system","financial","memory","numbers","time","path","file","forms","ui","other","development"]};var C={codeName:"dphelper",version:"4.5.2"};Object.defineProperty(globalThis,"dphelper",{value:new Proxy({},{}),writable:true,configurable:true,enumerable:false});Object.defineProperties(dphelper,{_list:{value:{scripts:[],sockets:[],...K},configurable:true,writable:true},version:{value:C.version,configurable:true,writable:true},isServer:{value:false,configurable:true,writable:true},isBrowser:{value:true,configurable:true,writable:true}});var k=dphelper;Object.defineProperty(k,"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(k,"setDescription",{value:(e,t)=>{Object.defineProperties(k,{[e.name]:{value:t,writable:false,configurable:false,enumerable:false}}),Object.keys(t).map(r=>(Object.defineProperties(k[e.name],{[r]:{writable:false,configurable:false,enumerable:false}}),null)),k.setProps(k,e,{writable:false,configurable:false,enumerable:false}),k._list.scripts.push(e);}});var pe={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:[]}]},W=e=>e===null||typeof e!="object",U=e=>e===null?"null":typeof e=="string"?e.includes(",")||e.includes(":")||e.includes('"')||e.includes(`
+var K={info:{title:"List",description:"Complete list of tools"},categories:["3party","system","financial","memory","numbers","time","path","file","forms","ui","other","development"]};var C={codeName:"dphelper",version:"4.6.0"};Object.defineProperty(globalThis,"dphelper",{value:new Proxy({},{}),writable:true,configurable:true,enumerable:false});Object.defineProperties(dphelper,{_list:{value:{scripts:[],sockets:[],...K},configurable:true,writable:true},version:{value:C.version,configurable:true,writable:true},isServer:{value:false,configurable:true,writable:true},isBrowser:{value:true,configurable:true,writable:true}});var k=dphelper;Object.defineProperty(k,"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(k,"setDescription",{value:(e,t)=>{Object.defineProperties(k,{[e.name]:{value:t,writable:false,configurable:false,enumerable:false}}),Object.keys(t).map(r=>(Object.defineProperties(k[e.name],{[r]:{writable:false,configurable:false,enumerable:false}}),null)),k.setProps(k,e,{writable:false,configurable:false,enumerable:false}),k._list.scripts.push(e);}});var pe={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:[]}]},W=e=>e===null||typeof e!="object",U=e=>e===null?"null":typeof e=="string"?e.includes(",")||e.includes(":")||e.includes('"')||e.includes(`
 `)||e.trim()!==e?`"${e.replace(/"/g,'\\"')}"`:e||'""':String(e),$=(e,t=0)=>{let r="  ".repeat(t);if(W(e))return U(e);if(Array.isArray(e)){if(e.length===0)return "[0]:";let n=e[0];if(!W(n)&&!Array.isArray(n)){let o=Object.keys(n),a=`[${e.length}]{${o.join(",")}}:`;for(let i of e){let s=o.map(l=>U(i[l])).join(",");a+=`
 ${r}  ${s}`;}return a}else return `[${e.length}]: `+e.map(U).join(",")}else return Object.entries(e).map(([n,o])=>{let a=n.includes(" ")||n.includes(":")?`"${n}"`:n;if(!W(o)){let i=$(o,t+1);return i.startsWith("[")?`${a}${i}`:`${a}:
   ${r}${i}`}return `${a}: ${U(o)}`}).join(`
@@ -143,7 +143,7 @@ ${t(i,`${n}  `)}${n}</${a}>
         )
 
       Copyright text (c) became an html symbol
-      `,env:"both",subCommand:[],author:"Dario Passariello",creationDate:"20250612",lastMod:"20250612"}]},Qr={trim:(e,t,r,n)=>e.charAt(0)===t?e.substring(r,n):e,capitalize:e=>e.toLowerCase().replace(/\b\w/g,t=>t.toUpperCase()),lower:e=>e.toLowerCase(),upper:e=>e.toUpperCase(),nl2br:e=>e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/(?:\r\n|\r|\n)/g,"<br>"),sanitize:e=>e.replace(/<(|\/|[^>\bi]|\/[^>bi]|[^/>][^>]+|\/[^>][^>]+)>/g,""),camelCase:{toSpace:e=>e.replace(/([A-Z])/g," $1").replace(/^./,t=>t.toUpperCase()),toUnderscore:e=>e.replace(/\.?([A-Z])/g,(t,r)=>`_${r.toLowerCase()}`).replace(/^_/,"")},fitContainer:e=>{if(!e)return;function t(r){let n=document.querySelectorAll(r),o=n.length;if(!(o<=0))for(let a=0;a<o;a++){let i=n[a].offsetWidth*.05;n[a].style.fontSize=`${i}px`;}}dphelper.addListenerMulti(window,"load resize",()=>t(e));},keywords:e=>{let t=/\b[A-Z][a-z]+\b/g,r=e.match(t)?.filter(n=>n.length>3)||[];return [...new Set(r.map(n=>n.toLowerCase()))]},replaceText:(e,t)=>{let r=e;for(let n in t)Object.hasOwn(t,n)&&(r=r.replaceAll(n,t[n]||""));return r}};dphelper?.setDescription(Xr,Qr);var en={name:"timer",active:true,subCommand:[{name:"sleep",version:"0.0.2",example:"dphelper.timer.sleep([ms]) ",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Pauses execution for a specified number of milliseconds.",env:"both",subCommand:[]},{name:"percentage",version:"0.0.2",example:"dphelper.timer.percentage([start], [end])",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Calculates the percentage of time elapsed between two time strings.",env:"both",subCommand:[]}]},tn={sleep:e=>new Promise(t=>setTimeout(t,e)),percentage:(e,t)=>{function r(n){let o=n.split(":");return Number.parseInt(o[0]||"",10)*3600+Number.parseInt(o[1]||"",10)*60+Number.parseInt(o[2]||"",10)}return (100*r(e)/r(t)).toFixed(2)}};dphelper?.setDescription(en,tn);var rn={name:"tools",active:true,subCommand:[{name:"byteSize",description:"Give you the total in 'Kb', 'Mb', 'Gb', 'Tb', 'Pb', 'Eb', 'Zb', 'Yb' starting from bytes",example:"dphelper.tools.byteSize(bytes)",version:"0.0.2",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,env:"both",subCommand:[]},{name:"hashPass",description:"Hashes a password using a specified number and total.",example:"dphelper.tools.hashPass(number, total)",version:"0.0.2",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,env:"both",subCommand:[]},{name:"zIndex",description:"Finds the highest z-index value in the document.",example:"dphelper.tools.zIndex()",version:"0.0.2",author:"Dario Passariello",creationDate:"20240807",lastMod:"20240807",type:"function",active:true,env:"both",subCommand:[]},{name:"zeroToFalse",description:"Converts zero to false, otherwise returns the value.",example:"dphelper.tools.zeroToFalse(num)",version:"0.0.2",author:"Dario Passariello",creationDate:"20240924",lastMod:"20240924",type:"function",active:true,env:"both",subCommand:[]}]},nn={byteSize:e=>{if(Math.abs(e)<1024)return `${e}b`;let r=["Kb","Mb","Gb","Tb","Pb","Eb","Zb","Yb"],n=-1,o=e;do o/=1024,++n;while(Math.abs(o)>=1024&&n<r.length-1);return o.toFixed(1)+r[n]},zIndex:()=>Array.from(document.querySelectorAll("body *")).map(e=>Number.parseFloat(getComputedStyle(e).zIndex)).reduce((e,t)=>t>e?t:e,1),zeroToFalse:e=>e===0?false:e};dphelper?.setDescription(rn,nn);var on={name:"translators",active:true,subCommand:[{name:"convertMatrixToScale",version:"0.0.2",example:"dphelper.translators.convertMatrixToScale({value})",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Converts a transformation matrix to a scale value.",env:"both",subCommand:[]}]},an={convertMatrixToScale:e=>{let t=e.split("(");if(t.length<2)return 0;let r=t[1].split(")")[0];if(!r)return 0;let n=r.split(","),o=Number.parseFloat(n[0]||"0"),a=Number.parseFloat(n[1]||"0");return Math.sqrt(o*o+a*a)}};dphelper?.setDescription(on,an);var sn={name:"triggers",active:true,subCommand:[{name:"add",version:"0.0.1",example:"dphelper.triggers.add('event', callback)",author:"Dario Passariello",creationDate:"20250220",lastMod:"20250220",type:"function",active:true,description:"Add a trigger for custom events.",env:"client",subCommand:[]},{name:"on",version:"0.0.1",example:"dphelper.triggers.on('event', callback)",author:"Dario Passariello",creationDate:"20250220",lastMod:"20250220",type:"function",active:true,description:"Listen for a trigger event.",env:"client",subCommand:[]},{name:"emit",version:"0.0.1",example:"dphelper.triggers.emit('event', data)",author:"Dario Passariello",creationDate:"20250220",lastMod:"20250220",type:"function",active:true,description:"Emit a trigger event.",env:"client",subCommand:[]},{name:"remove",version:"0.0.1",example:"dphelper.triggers.remove('event')",author:"Dario Passariello",creationDate:"20250220",lastMod:"20250220",type:"function",active:true,description:"Remove a trigger event.",env:"client",subCommand:[]}]},S=new Map,se={add:(e,t)=>{S.has(e)||S.set(e,new Set),S.get(e).add(t);},on:(e,t)=>{se.add(e,t);},emit:(e,...t)=>{let r=S.get(e);r&&r.forEach(n=>{try{n(...t);}catch(o){console.error(`Error in trigger callback for event '${e}':`,o);}});},remove:e=>{S.delete(e);},off:(e,t)=>{let r=S.get(e);r&&r.delete(t);},clear:()=>{S.clear();},list:()=>Array.from(S.keys())};dphelper?.setDescription(sn,se);var ln={name:"type",active:true,subCommand:[{name:"of",version:"0.0.2",example:"dphelper.type.of(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Returns the type of the given parameter.",env:"both",subCommand:[]},{name:"instOfObj",version:"0.0.2",example:"dphelper.type.instOfObj(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Checks if the given parameter is an instance of Object.",env:"both",subCommand:[]},{name:"isNaN",version:"0.0.2",example:"dphelper.type.isNaN(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Checks if the given parameter is NaN.",env:"both",subCommand:[]},{name:"isBool",version:"0.0.2",example:"dphelper.type.isBool(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Checks if the given parameter is a boolean.",env:"both",subCommand:[]}]},cn={of:e=>typeof e,instOfObj:e=>e instanceof Object,isNull:e=>t=>!e(t),isBool:e=>!e||e.length==null?true:e==="1"};dphelper?.setDescription(ln,cn);var dn={name:"UI",active:true,subCommand:[{name:"input",version:"0.0.2",example:"dphelper.UI.input(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Creates an input element with specified options.",env:"client",subCommand:[]},{name:"fps",version:"0.0.2",example:"dphelper.UI.fps(true)",author:"Dario Passariello & Jo",creationDate:"20260220",lastMod:"20260220",type:"function",active:true,description:"Toggle a real-time FPS and Memory monitor overlay",env:"client",subCommand:[]},{name:"boxModel",version:"0.0.2",example:"dphelper.UI.boxModel(true)",author:"Dario Passariello & Jo",creationDate:"20260220",lastMod:"20260220",type:"function",active:true,description:"Toggle visual box-model highlighter for all elements",env:"client",subCommand:[]},{name:"anchorContext",version:"0.0.1",example:"dphelper.UI.anchorContext()",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Snapshot and auto-restore UI state (inputs, scroll) across reloads.",env:"client",subCommand:[]}]},un={anchorContext:()=>{if(typeof window>"u"||typeof localStorage>"u")return;let e=`dp_anchor_${btoa(location.pathname).replace(/=/g,"")}`,t=()=>{let n={scroll:{x:window.scrollX,y:window.scrollY},inputs:Array.from(document.querySelectorAll("input, textarea, select")).filter(o=>o.type!=="password"&&!o.hasAttribute("data-private")&&o.getAttribute("autocomplete")!=="off").map(o=>({id:o.id,name:o.name,value:o.value}))};localStorage.setItem(e,JSON.stringify(n));},r=()=>{let n=localStorage.getItem(e);if(n)try{let o=JSON.parse(n);window.scrollTo(o.scroll.x,o.scroll.y),o.inputs.forEach(a=>{let i=a.id?document.getElementById(a.id):document.querySelector(`[name="${a.name}"]`);i&&(i.value=a.value);});}catch{console.warn("dphelper: anchorContext restoration failed.");}};window.addEventListener("beforeunload",t),r();},fps:(e=true)=>{if(typeof document>"u")return;let t=document.getElementById("dphelper-fps-monitor");if(!e){t?.remove();return}t||(t=document.createElement("div"),t.id="dphelper-fps-monitor",Object.assign(t.style,{position:"fixed",top:"10px",right:"10px",padding:"8px 12px",background:"rgba(0,0,0,0.8)",color:"#0f0",fontFamily:"monospace",fontSize:"12px",zIndex:"99999",borderRadius:"4px",pointerEvents:"none",boxShadow:"0 2px 10px rgba(0,0,0,0.5)",border:"1px solid #333"}),document.body.appendChild(t));let r=0,n=performance.now(),o=()=>{if(!document.getElementById("dphelper-fps-monitor"))return;r++;let a=performance.now();if(a>=n+1e3){let i=Math.round(r*1e3/(a-n)),s=performance.memory?` | Mem: ${Math.round(performance.memory.usedJSHeapSize/1048576)}MB`:"";t.innerText=`FPS: ${i}${s}`,r=0,n=a;}requestAnimationFrame(o);};requestAnimationFrame(o);},boxModel:(e=true)=>{if(typeof document>"u")return;let t=document.getElementById("dphelper-boxmodel-style");if(!e){t?.remove();return}t||(t=document.createElement("style"),t.id="dphelper-boxmodel-style",t.innerHTML=`
+      `,env:"both",subCommand:[],author:"Dario Passariello",creationDate:"20250612",lastMod:"20250612"},{name:"subString",version:"0.0.1",example:"dphelper.text.subString(text)",type:"function",active:true,description:"Length Of Longest Substring",env:"both",subCommand:[],author:"Dario Passariello",creationDate:"20260801",lastMod:"20260801"}]},Qr={trim:(e,t,r,n)=>e.charAt(0)===t?e.substring(r,n):e,capitalize:e=>e.toLowerCase().replace(/\b\w/g,t=>t.toUpperCase()),lower:e=>e.toLowerCase(),upper:e=>e.toUpperCase(),nl2br:e=>e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/(?:\r\n|\r|\n)/g,"<br>"),sanitize:e=>e.replace(/<(|\/|[^>\bi]|\/[^>bi]|[^/>][^>]+|\/[^>][^>]+)>/g,""),camelCase:{toSpace:e=>e.replace(/([A-Z])/g," $1").replace(/^./,t=>t.toUpperCase()),toUnderscore:e=>e.replace(/\.?([A-Z])/g,(t,r)=>`_${r.toLowerCase()}`).replace(/^_/,"")},fitContainer:e=>{if(!e)return;function t(r){let n=document.querySelectorAll(r),o=n.length;if(!(o<=0))for(let a=0;a<o;a++){let i=n[a].offsetWidth*.05;n[a].style.fontSize=`${i}px`;}}dphelper.addListenerMulti(window,"load resize",()=>t(e));},keywords:e=>{let t=/\b[A-Z][a-z]+\b/g,r=e.match(t)?.filter(n=>n.length>3)||[];return [...new Set(r.map(n=>n.toLowerCase()))]},replaceText:(e,t)=>{let r=e;for(let n in t)Object.hasOwn(t,n)&&(r=r.replaceAll(n,t[n]||""));return r},subString:e=>{let t=new Int32Array(65536);t.fill(-1);let r=0,n=0;for(let o=0;o<e.length;o++){let a=e.charCodeAt(o),i=t[a];r=r+(i-r+1&-(i>=r)),t[a]=o;let s=o-r+1;n=n+(s-n&-(s>n));}return n}};dphelper?.setDescription(Xr,Qr);var en={name:"timer",active:true,subCommand:[{name:"sleep",version:"0.0.2",example:"dphelper.timer.sleep([ms]) ",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Pauses execution for a specified number of milliseconds.",env:"both",subCommand:[]},{name:"percentage",version:"0.0.2",example:"dphelper.timer.percentage([start], [end])",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Calculates the percentage of time elapsed between two time strings.",env:"both",subCommand:[]}]},tn={sleep:e=>new Promise(t=>setTimeout(t,e)),percentage:(e,t)=>{function r(n){let o=n.split(":");return Number.parseInt(o[0]||"",10)*3600+Number.parseInt(o[1]||"",10)*60+Number.parseInt(o[2]||"",10)}return (100*r(e)/r(t)).toFixed(2)}};dphelper?.setDescription(en,tn);var rn={name:"tools",active:true,subCommand:[{name:"byteSize",description:"Give you the total in 'Kb', 'Mb', 'Gb', 'Tb', 'Pb', 'Eb', 'Zb', 'Yb' starting from bytes",example:"dphelper.tools.byteSize(bytes)",version:"0.0.2",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,env:"both",subCommand:[]},{name:"hashPass",description:"Hashes a password using a specified number and total.",example:"dphelper.tools.hashPass(number, total)",version:"0.0.2",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,env:"both",subCommand:[]},{name:"zIndex",description:"Finds the highest z-index value in the document.",example:"dphelper.tools.zIndex()",version:"0.0.2",author:"Dario Passariello",creationDate:"20240807",lastMod:"20240807",type:"function",active:true,env:"both",subCommand:[]},{name:"zeroToFalse",description:"Converts zero to false, otherwise returns the value.",example:"dphelper.tools.zeroToFalse(num)",version:"0.0.2",author:"Dario Passariello",creationDate:"20240924",lastMod:"20240924",type:"function",active:true,env:"both",subCommand:[]}]},nn={byteSize:e=>{if(Math.abs(e)<1024)return `${e}b`;let r=["Kb","Mb","Gb","Tb","Pb","Eb","Zb","Yb"],n=-1,o=e;do o/=1024,++n;while(Math.abs(o)>=1024&&n<r.length-1);return o.toFixed(1)+r[n]},zIndex:()=>Array.from(document.querySelectorAll("body *")).map(e=>Number.parseFloat(getComputedStyle(e).zIndex)).reduce((e,t)=>t>e?t:e,1),zeroToFalse:e=>e===0?false:e};dphelper?.setDescription(rn,nn);var on={name:"translators",active:true,subCommand:[{name:"convertMatrixToScale",version:"0.0.2",example:"dphelper.translators.convertMatrixToScale({value})",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Converts a transformation matrix to a scale value.",env:"both",subCommand:[]}]},an={convertMatrixToScale:e=>{let t=e.split("(");if(t.length<2)return 0;let r=t[1].split(")")[0];if(!r)return 0;let n=r.split(","),o=Number.parseFloat(n[0]||"0"),a=Number.parseFloat(n[1]||"0");return Math.sqrt(o*o+a*a)}};dphelper?.setDescription(on,an);var sn={name:"triggers",active:true,subCommand:[{name:"add",version:"0.0.1",example:"dphelper.triggers.add('event', callback)",author:"Dario Passariello",creationDate:"20250220",lastMod:"20250220",type:"function",active:true,description:"Add a trigger for custom events.",env:"client",subCommand:[]},{name:"on",version:"0.0.1",example:"dphelper.triggers.on('event', callback)",author:"Dario Passariello",creationDate:"20250220",lastMod:"20250220",type:"function",active:true,description:"Listen for a trigger event.",env:"client",subCommand:[]},{name:"emit",version:"0.0.1",example:"dphelper.triggers.emit('event', data)",author:"Dario Passariello",creationDate:"20250220",lastMod:"20250220",type:"function",active:true,description:"Emit a trigger event.",env:"client",subCommand:[]},{name:"remove",version:"0.0.1",example:"dphelper.triggers.remove('event')",author:"Dario Passariello",creationDate:"20250220",lastMod:"20250220",type:"function",active:true,description:"Remove a trigger event.",env:"client",subCommand:[]}]},S=new Map,se={add:(e,t)=>{S.has(e)||S.set(e,new Set),S.get(e).add(t);},on:(e,t)=>{se.add(e,t);},emit:(e,...t)=>{let r=S.get(e);r&&r.forEach(n=>{try{n(...t);}catch(o){console.error(`Error in trigger callback for event '${e}':`,o);}});},remove:e=>{S.delete(e);},off:(e,t)=>{let r=S.get(e);r&&r.delete(t);},clear:()=>{S.clear();},list:()=>Array.from(S.keys())};dphelper?.setDescription(sn,se);var ln={name:"type",active:true,subCommand:[{name:"of",version:"0.0.2",example:"dphelper.type.of(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Returns the type of the given parameter.",env:"both",subCommand:[]},{name:"instOfObj",version:"0.0.2",example:"dphelper.type.instOfObj(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Checks if the given parameter is an instance of Object.",env:"both",subCommand:[]},{name:"isNaN",version:"0.0.2",example:"dphelper.type.isNaN(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Checks if the given parameter is NaN.",env:"both",subCommand:[]},{name:"isBool",version:"0.0.2",example:"dphelper.type.isBool(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Checks if the given parameter is a boolean.",env:"both",subCommand:[]}]},cn={of:e=>typeof e,instOfObj:e=>e instanceof Object,isNull:e=>t=>!e(t),isBool:e=>!e||e.length==null?true:e==="1"};dphelper?.setDescription(ln,cn);var dn={name:"UI",active:true,subCommand:[{name:"input",version:"0.0.2",example:"dphelper.UI.input(...)",author:"Dario Passariello",creationDate:"20210101",lastMod:"20260220",type:"function",active:true,description:"Creates an input element with specified options.",env:"client",subCommand:[]},{name:"fps",version:"0.0.2",example:"dphelper.UI.fps(true)",author:"Dario Passariello & Jo",creationDate:"20260220",lastMod:"20260220",type:"function",active:true,description:"Toggle a real-time FPS and Memory monitor overlay",env:"client",subCommand:[]},{name:"boxModel",version:"0.0.2",example:"dphelper.UI.boxModel(true)",author:"Dario Passariello & Jo",creationDate:"20260220",lastMod:"20260220",type:"function",active:true,description:"Toggle visual box-model highlighter for all elements",env:"client",subCommand:[]},{name:"anchorContext",version:"0.0.1",example:"dphelper.UI.anchorContext()",author:"Dario Passariello",creationDate:"20260221",lastMod:"20260221",type:"function",active:true,description:"Snapshot and auto-restore UI state (inputs, scroll) across reloads.",env:"client",subCommand:[]}]},un={anchorContext:()=>{if(typeof window>"u"||typeof localStorage>"u")return;let e=`dp_anchor_${btoa(location.pathname).replace(/=/g,"")}`,t=()=>{let n={scroll:{x:window.scrollX,y:window.scrollY},inputs:Array.from(document.querySelectorAll("input, textarea, select")).filter(o=>o.type!=="password"&&!o.hasAttribute("data-private")&&o.getAttribute("autocomplete")!=="off").map(o=>({id:o.id,name:o.name,value:o.value}))};localStorage.setItem(e,JSON.stringify(n));},r=()=>{let n=localStorage.getItem(e);if(n)try{let o=JSON.parse(n);window.scrollTo(o.scroll.x,o.scroll.y),o.inputs.forEach(a=>{let i=a.id?document.getElementById(a.id):document.querySelector(`[name="${a.name}"]`);i&&(i.value=a.value);});}catch{console.warn("dphelper: anchorContext restoration failed.");}};window.addEventListener("beforeunload",t),r();},fps:(e=true)=>{if(typeof document>"u")return;let t=document.getElementById("dphelper-fps-monitor");if(!e){t?.remove();return}t||(t=document.createElement("div"),t.id="dphelper-fps-monitor",Object.assign(t.style,{position:"fixed",top:"10px",right:"10px",padding:"8px 12px",background:"rgba(0,0,0,0.8)",color:"#0f0",fontFamily:"monospace",fontSize:"12px",zIndex:"99999",borderRadius:"4px",pointerEvents:"none",boxShadow:"0 2px 10px rgba(0,0,0,0.5)",border:"1px solid #333"}),document.body.appendChild(t));let r=0,n=performance.now(),o=()=>{if(!document.getElementById("dphelper-fps-monitor"))return;r++;let a=performance.now();if(a>=n+1e3){let i=Math.round(r*1e3/(a-n)),s=performance.memory?` | Mem: ${Math.round(performance.memory.usedJSHeapSize/1048576)}MB`:"";t.innerText=`FPS: ${i}${s}`,r=0,n=a;}requestAnimationFrame(o);};requestAnimationFrame(o);},boxModel:(e=true)=>{if(typeof document>"u")return;let t=document.getElementById("dphelper-boxmodel-style");if(!e){t?.remove();return}t||(t=document.createElement("style"),t.id="dphelper-boxmodel-style",t.innerHTML=`
     * { outline: 1px solid rgba(255, 0, 0, 0.3) !important; }
     * * { outline: 1px solid rgba(0, 255, 0, 0.3) !important; }
     * * * { outline: 1px solid rgba(0, 0, 255, 0.3) !important; }

package/llms.txt

@@ -1,73 +1,73 @@
-# 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
+
+> [!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.

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.5.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(`
+'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(`
 `)||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(`