dphelper 3.2.1 → 3.2.3

package/docs/tools/logging.md

@@ -0,0 +1,27 @@
+# logging
+
+Advanced logging system.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `list` | Lists all logs | `dphelper.log.list()` |
+| `reg` | Logs a regular message | `dphelper.log.reg('message')` |
+| `debug` | Logs a debug message | `dphelper.log.debug('message')` |
+| `error` | Logs an error message | `dphelper.log.error('message')` |
+
+## Description
+
+Tool for managing application logging with different severity levels.
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.1
+- **Creation Date:** 20210101
+- **Last Modified:** 20210101
+
+---
+
+*Automatically generated document*

package/docs/tools/math.md

@@ -0,0 +1,28 @@
+# math
+
+Advanced mathematical functions and utilities.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `rnd` | Generates a random number based on time | `dphelper.math.rnd()` |
+| `tmr` | Measures current time in seconds (epoch) | `dphelper.math.tmr()` |
+| `isOdd` | Checks if a number is odd | `dphelper.math.isOdd(5)` |
+| `percent` | Calculates the percentage of a value relative to a total | `dphelper.math.percent(25, 100)` |
+| `isPrime` | Checks if a number is prime | `dphelper.math.isPrime(7)` |
+
+## Description
+
+Tool with optimized mathematical functions and utilities. Note: basic operations (addition, subtraction, etc.) have been removed in favor of native JavaScript operators.
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.2
+- **Creation Date:** 20210101
+- **Last Modified:** 20260220
+
+---
+
+*Automatically generated document*

package/docs/tools/memory.md

@@ -0,0 +1,25 @@
+# memory
+
+Memory and state management.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `lock` | Locks a state | `dphelper.memory.lock('state[key]')` |
+| `unlock` | Unlocks a state | `dphelper.memory.unlock('state[key]')` |
+
+## Description
+
+Tool for locking and unlocking memory states.
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.1
+- **Creation Date:** 20230101
+- **Last Modified:** 20230111
+
+---
+
+*Automatically generated document*

package/docs/tools/navigation.md

@@ -0,0 +1,43 @@
+# navigation
+
+Single Page Application (SPA) navigation engine in Vanilla JavaScript.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `ajax` | Activates the SPA engine that intercepts local links | `dphelper.navigation.ajax()` |
+| `load` | Loads a specific page via AJAX and updates the body | `dphelper.navigation.load('/home')` |
+
+## Description
+
+This tool transforms the site into a Single Page Application. It intercepts clicks on links starting with `/`, fetches the page content via `fetch`, and injects it into the `body` without reloading the entire page. It automatically manages browser history (`history.pushState`), page title updates, and body classes.
+
+## Usage Examples
+
+### Global Activation
+
+Insert this command during site initialization to activate smooth navigation:
+
+```javascript
+dphelper.navigation.ajax();
+```
+
+### Programmatic Loading
+
+Load a specific section via code:
+
+```javascript
+await dphelper.navigation.load('/products');
+```
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.2
+- **Creation Date:** 20260223
+- **Last Modified:** 20260223
+
+---
+
+*Automatically generated document*

package/docs/tools/net.md

@@ -0,0 +1,24 @@
+# net
+
+Resilient networking and fetch utilities.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `smartFetch` | Fetch with automatic exponential backoff retry | `dphelper.net.smartFetch(url, options)` |
+
+## Description
+
+The Net module focuses on communication resilience, handling transient network errors automatically through smart retry strategies.
+
+## Details
+
+- **Author:** Dario Passariello & Jo
+- **Version:** 0.0.1
+- **Creation Date:** 20260220
+- **Last Modified:** 20260220
+
+---
+
+*Automatically generated document*

package/docs/tools/obj.md

@@ -0,0 +1,34 @@
+# obj (objects)
+
+Utilities for JavaScript object manipulation.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `replaceNullObjects` | Replaces null values with empty strings | `dphelper.obj.replaceNullObjects(obj)` |
+| `serialize` | Serializes objects while preserving functions (toString) | `dphelper.obj.serialize(obj)` |
+| `deSerialize` | Deserializes objects by processing their values | `dphelper.obj.deSerialize(obj)` |
+| `sort` | Sorts an object by its keys | `dphelper.obj.sort(obj)` |
+| `toXML` | Converts an object to an XML string | `dphelper.obj.toXML(obj)` |
+| `updateByKey` | Updates a value if the key exists | `dphelper.obj.updateByKey(obj, 'k', 'v')` |
+| `parse` | Safe JSON.parse that avoids crashes | `dphelper.obj.parse(str)` |
+| `isObject` | Checks if a value is a non-null object | `dphelper.obj.isObject(val)` |
+| `diff` | Highlights differences between two objects | `dphelper.obj.diff(obj1, obj2)` |
+| `path` | Creates a path string from an array of properties | `dphelper.obj.path('prop', ['a','b'])` |
+| `setProps` | Recursively sets configuration properties (enumerable, etc.) | `dphelper.obj.setProps(obj, {writable: false})` |
+
+## Description
+
+Tool for advanced JavaScript object manipulation. Basic functions like `Object.entries` or `Object.create` have been removed in favor of native methods.
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.2
+- **Creation Date:** 20210101
+- **Last Modified:** 20260220
+
+---
+
+*Automatically generated document*

package/docs/tools/path.md

@@ -0,0 +1,46 @@
+# path
+
+Management of URL paths.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `rail` | Extracts path segments from the URL | `dphelper.path.rail()` |
+| `hash` | Extracts hash from the URL | `dphelper.path.hash([hashUrl])` |
+| `query` | Extracts query parameters from the URL | `dphelper.path.query([queryString])` |
+
+## Description
+
+Tool for extracting segments, hashes, and query parameters from URLs.
+
+## Usage Examples
+
+### Extract URL segments
+
+If the URL is `https://example.com/blog/article-1`, `rail()` will return `['blog', 'article-1']`.
+
+```javascript
+const segments = dphelper.path.rail();
+console.log(segments[0]); // 'blog'
+```
+
+### Extract Query parameters
+
+If the URL is `?id=123&user=dario`, `query()` will return `{"id": "123", "user": "dario"}`.
+
+```javascript
+const params = dphelper.path.query();
+console.log(params.id); // '123'
+```
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.1
+- **Creation Date:** 20210101
+- **Last Modified:** 20250513
+
+---
+
+*Automatically generated document*

package/docs/tools/promise.md

@@ -0,0 +1,24 @@
+# promise
+
+Utilities for Promise management.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `check` | Checks if a value is a Promise (even in cross-environments) | `dphelper.promise.check(promise)` |
+
+## Description
+
+Tool for controlling JavaScript Promises. The `resolve` function has been removed in favor of the native `Promise.resolve()` method.
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.2
+- **Creation Date:** 20210101
+- **Last Modified:** 20260220
+
+---
+
+*Automatically generated document*

package/docs/tools/sanitize.md

@@ -0,0 +1,24 @@
+# sanitize
+
+Input/output sanitization for security.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `html` | Sanitizes HTML by escaping special characters | `dphelper.sanitize.html([html])` |
+
+## Description
+
+Tool for sanitizing HTML strings and escaping special characters to prevent XSS (Cross-Site Scripting).
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.1
+- **Creation Date:** 20241204
+- **Last Modified:** 20241204
+
+---
+
+*Automatically generated document*

package/docs/tools/screen.md

@@ -0,0 +1,25 @@
+# screen
+
+Functionality for screen and fullscreen management.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `fullScreen` | Enters fullscreen mode | `dphelper.screen.fullScreen([element])` |
+| `toggle` | Toggles fullscreen mode | `dphelper.screen.toggle([element])` |
+
+## Description
+
+Tool for managing the browser's fullscreen mode.
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.2
+- **Creation Date:** 20240101
+- **Last Modified:** 20240101
+
+---
+
+*Automatically generated document*

package/docs/tools/scrollbar.md

@@ -0,0 +1,29 @@
+# scrollbar
+
+Advanced scrollbar management.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `custom` | Applies custom styles to the scrollbar | `dphelper.scrollbar.custom(selector)` |
+| `indicator` | Adds a scroll indicator | `dphelper.scrollbar.indicator(selector)` |
+| `position.get` | Gets the scroll position | `dphelper.scrollbar.position.get(selector)` |
+| `position.set` | Sets the scroll position | `dphelper.scrollbar.position.set(selector, position)` |
+| `smooth` | Enables smooth scrolling | `dphelper.scrollbar.smooth()` |
+| `scrollTo` | Scrolls to a specific element | `dphelper.scrollbar.scrollTo()` |
+
+## Description
+
+Tool for customizing and managing scrollbars: custom styles, indicators, position control, and smooth scrolling.
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.1
+- **Creation Date:** 20210101
+- **Last Modified:** 20210101
+
+---
+
+*Automatically generated document*

package/docs/tools/security.md

@@ -0,0 +1,32 @@
+# security
+
+Security and cryptography functions.
+
+## Functions
+
+| Function | Description | Example |
+| :--- | :--- | :--- |
+| `fingerprint` | Generates a unique browser fingerprint | `dphelper.security.fingerprint()` |
+| `saveEncrypted` | Encrypts and saves data to localStorage | `dphelper.security.saveEncrypted(key, val, secret)` |
+| `getEncrypted` | Retrieves and decrypts data from localStorage | `dphelper.security.getEncrypted(key, secret)` |
+| `ulid` | Generates a Universally Unique Lexicographically Sortable Identifier | `dphelper.security.ulid()` |
+| `uuid.v4` / `v5` | Generates random UUIDs | `dphelper.security.uuid.v4` |
+| `uuid.byVal` | Generates a stable UUID based on a string | `dphelper.security.uuid.byVal('string')` |
+| `crypt` / `deCrypt` | Encrypts or Decrypts strings using AES | `dphelper.security.crypt(data, secret)` |
+| `hashPass` | Generates a secure password hash (SHA-256) | `dphelper.security.hashPass(user, pass)` |
+| `SHA256_Hex` | Generates a raw SHA256 hex string | `dphelper.security.SHA256_Hex(data)` |
+
+## Description
+
+The security module provides advanced tools for data protection, identity generation, and browser identification. It includes modern ID systems like ULID and fingerprinting techniques to secure web applications.
+
+## Details
+
+- **Author:** Dario Passariello & Jo
+- **Version:** 0.0.2
+- **Creation Date:** 20210101
+- **Last Modified:** 20260220
+
+---
+
+*Automatically generated document*

package/docs/tools/shortcut.md

@@ -0,0 +1,24 @@
+# shortcut
+
+Keyboard shortcut management.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `keys` | Manages keyboard shortcuts | `dphelper.shortcut.keys([e, trigger])` |
+
+## Description
+
+Tool for managing application-wide keyboard shortcuts.
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.1
+- **Creation Date:** 20210101
+- **Last Modified:** 20210101
+
+---
+
+*Automatically generated document*

package/docs/tools/socket.md

@@ -0,0 +1,29 @@
+# socket
+
+WebSocket management for real-time communication.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `start` | Initializes and starts a named socket connection | `dphelper.socket.start(el, 'ws://...', 'main')` |
+| `send` | Sends a message through a specific socket | `dphelper.socket.send('msg', 'type', 'main')` |
+| `receive` | Manages data reception and DOM updates | `dphelper.socket.receive('#target', 'main')` |
+| `check` | Cleans the internal list of closed connections | `dphelper.socket.check()` |
+| `list` | Returns the list of tracked active sockets | `dphelper.socket.list()` |
+| `keepAlive` | Keeps the connection active via ping/pong | `dphelper.socket.keepAlive('main')` |
+
+## Description
+
+Tool for simplified WebSocket management. Note: socket tracking has been made safer by removing global monkey patching of the `WebSocket` object.
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.2
+- **Creation Date:** 20210101
+- **Last Modified:** 20260220
+
+---
+
+*Automatically generated document*

package/docs/tools/svg.md

@@ -0,0 +1,29 @@
+# svg
+
+Advanced management of SVG elements and connections.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `init` | Initializes a dynamic connection between two HTML elements via an SVG path | `dphelper.svg.init(source1, source2, container)` |
+| `check` | Verifies native SVG support in the browser (obsolete VML logic removed) | `dphelper.svg.check()` |
+| `update` | Recalculates coordinates for an existing connection | `dphelper.svg.update(rect1, rect2, path)` |
+| `removeConnection` | Safely removes connections created by the tool in the container | `dphelper.svg.removeConnection(container)` |
+| `makeDraggable` | Enables drag & drop on an SVG element | `dphelper.svg.makeDraggable(svg)` |
+| `makeScrollable` | Enables drag-based scrolling on a container | `dphelper.svg.makeScrollable(container)` |
+
+## Description
+
+Advanced tool for managing graphical connections between elements. The current version has been cleaned of legacy technology support (VML) and optimized to handle multiple simultaneous connections using dynamic IDs and `data-*` attributes.
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.2
+- **Creation Date:** 20210101
+- **Last Modified:** 20260220
+
+---
+
+*Automatically generated document*

package/docs/tools/sync.md

@@ -0,0 +1,25 @@
+# sync
+
+Modern state synchronization and browser storage helpers.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `tab` | Synchronizes data between browser tabs/windows | `dphelper.sync.tab('ch', cb)` |
+| `storageProxy` | Creates an auto-syncing Proxy linked to localStorage | `dphelper.sync.storageProxy('key', {})` |
+
+## Description
+
+The Sync module provides tools to keep application state consistent across different browser contexts or persisted storage with minimal boilerplate.
+
+## Details
+
+- **Author:** Dario Passariello & Jo
+- **Version:** 0.0.1
+- **Creation Date:** 20260220
+- **Last Modified:** 20260220
+
+---
+
+*Automatically generated document*

package/docs/tools/system.md

@@ -0,0 +1,32 @@
+# system
+
+Utilities for extending system-level functionality.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `multiSplit` | Splits a string using multiple delimiters simultaneously | `dphelper.system.multiSplit(str, [',', ':', ';'])` |
+
+## Description
+
+System functionalities have been cleaned to avoid *Prototype Pollution*. The `multiSplit` function is now a standalone utility and no longer modifies the global behavior of `String.prototype`.
+
+## Example
+
+```javascript
+const str = "apple,pear:banana;orange";
+const fruits = dphelper.system.multiSplit(str, [',', ':', ';']);
+// Result: ["apple", "pear", "banana", "orange"]
+```
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.2
+- **Creation Date:** 20231121
+- **Last Modified:** 20260220
+
+---
+
+*Automatically generated document*

package/docs/tools/terminal.md

@@ -0,0 +1,28 @@
+# terminal
+
+Creates a terminal-like interface in the browser console or a DOM element.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `terminal` | Creates a terminal in a DOM element | `dphelper.terminal([dom])` |
+
+## Description
+
+Creates an interactive terminal within a specified DOM element. It redirects `console.debug`, `console.info`, `console.warn`, and `console.error` to that HTML element.
+
+## Parameters
+
+- `parentDom` - The DOM element where the terminal will be created.
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.1
+- **Creation Date:** 20240525
+- **Last Modified:** 20240525
+
+---
+
+*Automatically generated document*

package/docs/tools/text.md

@@ -0,0 +1,28 @@
+# text
+
+Utilities for text manipulation.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `trim` | Trims specific characters from the start and end of a string | `dphelper.text.trim()` |
+| `capitalize` | Capitalizes the first letter of each word | `dphelper.text.capitalize()` |
+| `lower` | Converts string to lowercase | `dphelper.text.lower()` |
+| `upper` | Converts string to uppercase | `dphelper.text.upper()` |
+| `nl2br` | Converts newlines to `<br>` tags | `dphelper.text.nl2br()` |
+
+## Description
+
+Tool for string and text manipulation.
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.1
+- **Creation Date:** 20210101
+- **Last Modified:** 20210101
+
+---
+
+*Automatically generated document*

package/docs/tools/timer.md

@@ -0,0 +1,25 @@
+# timer
+
+Management of timers, delays, and intervals.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `sleep` | Pauses execution for a specified number of milliseconds | `dphelper.timer.sleep([ms])` |
+| `percentage` | Calculates the percentage of time elapsed between two dates | `dphelper.timer.percentage([start], [end])` |
+
+## Description
+
+Tool for managing timers and asynchronous pauses.
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.1
+- **Creation Date:** 20210101
+- **Last Modified:** 20210101
+
+---
+
+*Automatically generated document*

package/docs/tools/tools.md

@@ -0,0 +1,26 @@
+# tools
+
+Miscellaneous developer utilities.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `byteSize` | Converts bytes to larger units (KB, MB, etc.) | `dphelper.tools.byteSize(bytes)` |
+| `hashPass` | Hashes a password | `dphelper.tools.hashPass(number, total)` |
+| `zIndex` | Finds the highest z-index value in the DOM | `dphelper.tools.zIndex()` |
+
+## Description
+
+Tool containing various utility functions: byte size conversion, password hashing, and z-index calculation.
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.1
+- **Creation Date:** 20210101
+- **Last Modified:** 20210101
+
+---
+
+*Automatically generated document*

package/docs/tools/translators.md

@@ -0,0 +1,24 @@
+# translators
+
+Utilities for transformation conversions.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `convertMatrixToScale` | Converts a transformation matrix to scale values | `dphelper.translators.convertMatrixToScale({value})` |
+
+## Description
+
+Tool for converting CSS transformation matrices into scale values.
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.1
+- **Creation Date:** 20210101
+- **Last Modified:** 20210101
+
+---
+
+*Automatically generated document*

package/docs/tools/trigger.md

@@ -0,0 +1,26 @@
+# trigger
+
+Programmatic DOM event triggers.
+
+## Functions
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `click` | Triggers a click event on an element | `dphelper.trigger.click()` |
+| `change` | Triggers a change event on an element | `dphelper.trigger.change([element])` |
+| `input` | Triggers an input event on an element | `dphelper.trigger.input([element])` |
+
+## Description
+
+Tool for programmatically triggering DOM events.
+
+## Details
+
+- **Author:** Dario Passariello
+- **Version:** 0.0.1
+- **Creation Date:** 20210101
+- **Last Modified:** 20241001
+
+---
+
+*Automatically generated document*