dphelper 4.2.0 → 4.2.3

package/markdown/compress.md

@@ -1,310 +0,0 @@
-# compress
-
-Compression and encoding utilities for data compression, decompression, and various encoding formats including gzip, deflate, LZW, base64, URL, and HTML encoding.
-
-## Functions
-
-| Function | Description | Example |
-|----------|-------------|---------|
-| `gzip` | Compress with gzip | `await dphelper.compress.gzip('Hello World')` |
-| `gunzip` | Decompress gzip | `await dphelper.compress.gunzip(compressedBlob)` |
-| `deflate` | Compress with deflate | `await dphelper.compress.deflate('Hello World')` |
-| `inflate` | Decompress deflate | `await dphelper.compress.inflate(compressedBlob)` |
-| `compress` | LZW compress | `dphelper.compress.compress('Hello World')` |
-| `decompress` | LZW decompress | `dphelper.compress.decompress(compressedString)` |
-| `base64Encode` | Encode to base64 | `dphelper.compress.base64Encode('Hello')` |
-| `base64Decode` | Decode from base64 | `dphelper.compress.base64Decode('SGVsbG8=')` |
-| `urlEncode` | URL encode | `dphelper.compress.urlEncode('Hello World!')` |
-| `urlDecode` | URL decode | `dphelper.compress.urlDecode('Hello%20World!')` |
-| `htmlEncode` | HTML encode | `dphelper.compress.htmlEncode('<script>')` |
-| `htmlDecode` | HTML decode | `dphelper.compress.htmlDecode('<script>')` |
-
-## Description
-
-Comprehensive compression and encoding module providing:
-- **Gzip/Deflate** - Browser-native compression using CompressionStream API
-- **LZW Compression** - JavaScript-compatible compression for data storage
-- **Base64** - Binary-to-text encoding for data transfer
-- **URL Encoding** - Percent-encoding for URLs and query strings
-- **HTML Encoding** - Escape special characters for safe HTML rendering
-- **Universal** - Works in both browser and server environments
-
-## Usage Examples
-
-### Gzip Compression
-
-```javascript
-// Compress string with gzip
-const original = 'Hello World! This is a test string for compression.';
-const compressed = await dphelper.compress.gzip(original);
-
-console.log('Original size:', original.length);
-console.log('Compressed type:', compressed.type); // "application/gzip"
-
-// Decompress
-const decompressed = await dphelper.compress.gunzip(compressed);
-console.log('Decompressed:', decompressed); // "Hello World! This is a test..."
-```
-
-### Deflate Compression
-
-```javascript
-// Compress with deflate (smaller than gzip, no header)
-const data = JSON.stringify({ users: [...], metadata: {...} });
-const deflated = await dphelper.compress.deflate(data);
-
-// Decompress
-const inflated = await dphelper.compress.inflate(deflated);
-console.log(JSON.parse(inflated));
-```
-
-### LZW Compression (JavaScript Compatible)
-
-```javascript
-// LZW compression - works in both browser and Node.js
-const original = 'ABABABABABABABAB';
-const compressed = dphelper.compress.compress(original);
-
-console.log('Original:', original.length, 'chars');
-console.log('Compressed:', compressed.length, 'chars');
-
-// Decompress
-const decompressed = dphelper.compress.decompress(compressed);
-console.log('Decompressed:', decompressed); // "ABABABABABABABAB"
-```
-
-### Base64 Encoding
-
-```javascript
-// Encode string to base64
-const plain = 'Hello, World!';
-const encoded = dphelper.compress.base64Encode(plain);
-console.log(encoded); // "SGVsbG8sIFdvcmxkIQ=="
-
-// Decode from base64
-const decoded = dphelper.compress.base64Decode(encoded);
-console.log(decoded); // "Hello, World!"
-
-// Encode binary data
-const bytes = new Uint8Array([72, 101, 108, 108, 111]);
-const binaryEncoded = dphelper.compress.base64Encode(String.fromCharCode(...bytes));
-console.log(binaryEncoded); // "SGVsbG8="
-```
-
-### URL Encoding
-
-```javascript
-// URL encode (percent-encoding)
-const url = 'Hello World! Test=1&value=abc';
-const encoded = dphelper.compress.urlEncode(url);
-console.log(encoded); // "Hello%20World!%20Test%3D1%26value%3Dabc"
-
-// URL decode
-const decoded = dphelper.compress.urlDecode(encoded);
-console.log(decoded); // "Hello World! Test=1&value=abc"
-
-// Encode for query string
-const query = 'name=John Doe&city=New York';
-const queryEncoded = dphelper.compress.urlEncode(query);
-console.log(queryEncoded); // "name%3DJohn%20Doe%26city%3DNew%20York"
-```
-
-### HTML Encoding
-
-```javascript
-// HTML encode (escape special characters)
-const unsafe = '<script>alert("XSS!")</script>';
-const encoded = dphelper.compress.htmlEncode(unsafe);
-console.log(encoded);
-// "<script>alert("XSS!")</script>"
-
-// HTML decode
-const decoded = dphelper.compress.htmlDecode(encoded);
-console.log(decoded); // '<script>alert("XSS!")</script>'
-
-// Encode user input before displaying
-const userInput = '<div onclick="evil()">Click me</div>';
-const safe = dphelper.compress.htmlEncode(userInput);
-// In HTML: <div onclick="evil()">Click me</div>
-```
-
-## Advanced Usage
-
-### Data Compression for Storage
-
-```javascript
-class CompressedStorage {
-  async compress(key, data) {
-    const json = JSON.stringify(data);
-    const compressed = await dphelper.compress.gzip(json);
-    localStorage.setItem(key, await compressed.text());
-  }
-
-  async decompress(key) {
-    const stored = localStorage.getItem(key);
-    if (!stored) return null;
-
-    const blob = new Blob([stored], { type: 'application/gzip' });
-    const decompressed = await dphelper.compress.gunzip(blob);
-    return JSON.parse(decompressed);
-  }
-}
-
-// Usage
-const storage = new CompressedStorage();
-await storage.compress('cache', { users: [...], timestamp: Date.now() });
-const data = await storage.decompress('cache');
-```
-
-### API Response Compression
-
-```javascript
-// Compress data before sending to server
-async function sendCompressed(url, data) {
-  const json = JSON.stringify(data);
-  const compressed = await dphelper.compress.gzip(json);
-
-  return fetch(url, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/gzip'
-    },
-    body: compressed
-  });
-}
-
-// Decompress server response
-async function fetchCompressed(url) {
-  const response = await fetch(url);
-  const compressed = await response.blob();
-  const decompressed = await dphelper.compress.gunzip(compressed);
-  return JSON.parse(decompressed);
-}
-```
-
-### String Compression for URLs
-
-```javascript
-// Compress data for URL-safe storage (using LZW)
-function compressForUrl(data) {
-  const compressed = dphelper.compress.compress(JSON.stringify(data));
-  return dphelper.compress.base64Encode(compressed)
-    .replace(/\+/g, '-')
-    .replace(/\//g, '_')
-    .replace(/=+$/, '');
-}
-
-// Decompress from URL
-function decompressFromUrl(encoded) {
-  const base64 = encoded.replace(/-/g, '+').replace(/_/g, '/');
-  const padded = base64.padEnd(base64.length + (4 - base64.length % 4) % 4, '=');
-  const compressed = dphelper.compress.base64Decode(padded);
-  return JSON.parse(dphelper.compress.decompress(compressed));
-}
-
-// Usage
-const data = { id: 123, type: 'test', values: [1,2,3] };
-const encoded = compressForUrl(data);
-console.log(encoded); // URL-safe compressed string
-
-const decoded = decompressFromUrl(encoded);
-console.log(decoded); // { id: 123, type: 'test', values: [1,2,3] }
-```
-
-### Secure Data Transfer
-
-```javascript
-// Encode sensitive data for transfer
-function encodeSecure(data) {
-  const json = JSON.stringify(data);
-  const base64 = dphelper.compress.base64Encode(json);
-  return base64;
-}
-
-// Decode secure data
-function decodeSecure(encoded) {
-  const json = dphelper.compress.base64Decode(encoded);
-  return JSON.parse(json);
-}
-
-// Sanitize HTML content
-function sanitizeHtml(content) {
-  return dphelper.compress.htmlEncode(content);
-}
-
-// Build safe query string
-function buildQueryString(params) {
-  return Object.entries(params)
-    .map(([k, v]) => `${dphelper.compress.urlEncode(k)}=${dphelper.compress.urlEncode(v)}`)
-    .join('&');
-}
-
-console.log(buildQueryString({ name: 'John Doe', age: '30' }));
-// "name=John%20Doe=30"
-```
-
-### Cache with Compression
-
-```javascript
-class CacheManager {
-  constructor(prefix = 'cache_') {
-    this.prefix = prefix;
-  }
-
-  async set(key, value, maxAge = 3600000) {
-    const entry = {
-      data: value,
-      expires: Date.now() + maxAge
-    };
-
-    const compressed = await dphelper.compress.gzip(JSON.stringify(entry));
-    localStorage.setItem(
-      this.prefix + key,
-      await compressed.text()
-    );
-  }
-
-  async get(key) {
-    const stored = localStorage.getItem(this.prefix + key);
-    if (!stored) return null;
-
-    try {
-      const blob = new Blob([stored], { type: 'application/gzip' });
-      const decompressed = await dphelper.compress.gunzip(blob);
-      const entry = JSON.parse(decompressed);
-
-      if (Date.now() > entry.expires) {
-        localStorage.removeItem(this.prefix + key);
-        return null;
-      }
-
-      return entry.data;
-    } catch {
-      return null;
-    }
-  }
-
-  clear() {
-    Object.keys(localStorage)
-      .filter(k => k.startsWith(this.prefix))
-      .forEach(k => localStorage.removeItem(k));
-  }
-}
-
-// Usage
-const cache = new CacheManager();
-await cache.set('user_123', { name: 'John', email: 'john@example.com' });
-const user = await cache.get('user_123');
-```
-
-## Details
-
-- **Author:** Dario Passariello
-- **Version:** 0.0.1
-- **Creation Date:** 20260313
-- **Last Modified:** 20260313
-- **Environment:** Works in both client and server environments
-
----
-
-*Automatically generated document*

package/markdown/cookie.md

@@ -1,115 +0,0 @@
-# cookie
-
-Cookie management utilities with security features.
-
-## Functions
-
-| Function | Description | Example |
-|----------|-------------|---------|
-| `set` | Creates a cookie with specified properties | `dphelper.cookie.set({name: 'user', value: 'john', time: 365})` |
-| `get` | Retrieves a cookie value by name | `dphelper.cookie.get('user')` |
-| `delete` | Deletes a cookie by name | `dphelper.cookie.delete('user')` |
-| `removeAll` | Clears all cookies | `dphelper.cookie.removeAll()` |
-
-## Description
-
-Complete cookie management:
-- **Create** - Set cookies with expiration, path, security
-- **Read** - Get cookie values
-- **Delete** - Remove specific or all cookies
-- **Security** - SameSite, Secure flags for CSRF protection
-
-## Usage Examples
-
-### Setting Cookies
-
-```javascript
-// Simple cookie
-dphelper.cookie.set({
-  name: 'theme',
-  value: 'dark'
-});
-
-// Cookie with expiration (days)
-dphelper.cookie.set({
-  name: 'user',
-  value: 'john@example.com',
-  time: 30 // 30 days
-});
-
-// Secure cookie (HTTPS only)
-dphelper.cookie.set({
-  name: 'session',
-  value: 'abc123',
-  secure: true,
-  sameSite: 'Strict'
-});
-```
-
-### Reading Cookies
-
-```javascript
-// Get cookie value
-const theme = dphelper.cookie.get('theme');
-console.log(theme); // "dark"
-
-// Get session
-const session = dphelper.cookie.get('session');
-```
-
-### Deleting Cookies
-
-```javascript
-// Delete specific cookie
-dphelper.cookie.delete('theme');
-
-// Clear all cookies
-dphelper.cookie.removeAll();
-```
-
-### Complete Example
-
-```javascript
-class CookieManager {
-  constructor() {}
-
-  // Save user preferences
-  savePreferences(prefs) {
-    dphelper.cookie.set({
-      name: 'preferences',
-      value: JSON.stringify(prefs),
-      time: 365,
-      sameSite: 'Lax'
-    });
-  }
-
-  // Load preferences
-  loadPreferences() {
-    const prefs = dphelper.cookie.get('preferences');
-    return prefs ? JSON.parse(prefs) : null;
-  }
-
-  // Clear all
-  clearAll() {
-    dphelper.cookie.removeAll();
-  }
-}
-```
-
-## Security Features
-
-- **SameSite** - Default 'Lax' for CSRF protection
-- **Secure** - Automatic on HTTPS
-- **Value Encoding** - URL encoding to prevent injection
-
-## Details
-
-- **Author:** Dario Passariello
-- **Version:** 0.0.2
-- **Creation Date:** 20210101
-- **Last Modified:** 20240613
-- **Environment:** Client-side only (browser)
-
----
-
-*Automatically generated document*

package/markdown/coords.md

@@ -1,127 +0,0 @@
-# coords
-
-Coordinate and geometry utilities for GPS, mapping, and calculations.
-
-## Functions
-
-| Function | Description | Example |
-|----------|-------------|---------|
-| `degreesToRadians` | Convert degrees to radians | `dphelper.coords.degreesToRadians(45)` |
-| `latToMeters` | Convert latitude to meters | `dphelper.coords.latToMeters([40.68, -74.04])` |
-| `toVector` | Convert coordinates to 3D vector | `dphelper.coords.toVector([lat, lon, alt])` |
-| `convertToDecDegrees` | Convert DMS to decimal degrees | `dphelper.coords.convertToDecDegrees(39, 5, 59, 'N')` |
-| `distance` | Calculate distance between two points (Haversine) | `dphelper.coords.distance([lat1, lon1], [lat2, lon2])` |
-| `polarToCartesian` | Convert polar to Cartesian coordinates | `dphelper.coords.polarToCartesian(x, y, radius, angle)` |
-| `mapDegreesToPixels` | Map degrees to pixel values | `dphelper.coords.mapDegreesToPixels(deg, min, max, minPx, maxPx, pad)` |
-
-## Description
-
-Coordinate manipulation toolkit:
-- **Unit Conversion** - Degrees, radians, meters
-- **Distance Calculation** - Haversine formula for GPS
-- **Coordinate Systems** - Polar, Cartesian, 3D vectors
-- **Mapping** - Degrees to pixels for maps
-
-## Usage Examples
-
-### Degree/Radian Conversion
-
-```javascript
-// Degrees to radians
-console.log(dphelper.coords.degreesToRadians(0));    // 0
-console.log(dphelper.coords.degreesToRadians(90));   // 1.57...
-console.log(dphelper.coords.degreesToRadians(180));  // 3.14...
-console.log(dphelper.coords.degreesToRadians(360));  // 6.28...
-```
-
-### Distance Calculation (GPS)
-
-```javascript
-// Distance between New York and Washington DC
-const nyc = [40.7128, -74.0060];
-const dc = [38.9072, -77.0369];
-
-const dist = dphelper.coords.distance(nyc, dc);
-console.log(dist);
-// { km: 328.54, mi: 204.18, nMi: 177.4 }
-
-// Calculate travel distance for logistics
-const locations = [
-  [40.7128, -74.0060],  // NYC
-  [39.9526, -75.1652],  // Philadelphia
-  [39.2894, -76.6152],  // Baltimore
-  [38.9072, -77.0369]   // Washington DC
-];
-
-function calculateTotalDistance(points) {
-  let total = 0;
-  for (let i = 0; i < points.length - 1; i++) {
-    const dist = dphelper.coords.distance(points[i], points[i + 1]);
-    total += dist.km;
-  }
-  return total;
-}
-```
-
-### Coordinate Conversion
-
-```javascript
-// Convert DMS to decimal degrees
-// 39° 5' 59" N -> decimal
-const dec = dphelper.coords.convertToDecDegrees(39, 5, 59, 'N');
-console.log(dec); // 39.0997...
-
-// With South/West (negative)
-const south = dphelper.coords.convertToDecDegrees(33, 51, 30, 'S');
-console.log(south); // -33.8583...
-```
-
-### 3D Vector from GPS
-
-```javascript
-// Convert GPS coordinates to 3D Earth-centered vector
-const vector = dphelper.coords.toVector([40.7128, -74.0060, 0]);
-console.log(vector);
-// [x, y, z] in meters from Earth center
-```
-
-### Polar to Cartesian
-
-```javascript
-// Convert polar to Cartesian for graphics
-const cart = dphelper.coords.polarToCartesian(100, 100, 50, 90);
-console.log(cart);
-// { x: 100, y: 150 }
-
-// Create circular motion
-for (let angle = 0; angle < 360; angle += 30) {
-  const pos = dphelper.coords.polarToCartesian(200, 200, 80, angle);
-  console.log(`Angle ${angle}:`, pos);
-}
-```
-
-### Map Pixel Mapping
-
-```javascript
-// Map latitude to pixel for interactive maps
-const pixel = dphelper.coords.mapDegreesToPixels(
-  45,     // Current degree
-  30,     // Min latitude
-  60,      // Max latitude
-  0,       // Min pixel
-  500,     // Max pixel
-  10       // Padding
-);
-```
-
-## Details
-
-- **Author:** Dario Passariello
-- **Version:** 0.0.2
-- **Creation Date:** 20210101
-- **Last Modified:** 20260220
-- **Environment:** Client-side only (browser)
-
----
-
-*Automatically generated document*

package/markdown/credits.md

@@ -1,56 +0,0 @@
-# credits
-
-Application startup credits and initialization logger.
-
-## Functions
-
-| Function | Description |
-|----------|-------------|
-| `credits` | Logs application startup information to console |
-
-## Description
-
-Displays application information on startup:
-- **Version** - Current application version
-- **Author** - Developer credits
-- **Console Logging** - Grouped, styled output
-
-## Usage Examples
-
-### Automatic Startup
-
-```javascript
-// Automatically called on dphelper initialization
-// Shows in console:
-//
-// ┌─────────────────────────────────────┐
-// │  dphelper v1.0.0                    │
-// │  by Dario Passariello started       │
-// │  name: dphelper                     │
-// │  version: 1.0.0                     │
-// └─────────────────────────────────────┘
-
-// Output is styled with orange color for visibility
-```
-
-### Console Output
-
-```javascript
-// When called, displays:
-// dphelper v1.0.0
-// by Dario Passariello started
-// name: dphelper
-// version: 1.0.0
-```
-
-## Details
-
-- **Author:** Dario Passariello
-- **Version:** 0.0.1
-- **Creation Date:** 20210101
-- **Last Modified:** 20210101
-- **Environment:** Client-side only (browser)
-
----
-
-*Automatically generated document*