tool-shack 0.0.42 → 1.1.0

package/README.md

@@ -4,7 +4,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
 
-A lightweight, zero-dependency TypeScript utility library providing essential helper functions for the browser, DOM manipulation, strings, date/time formatting, scheduling, and general data validation.
+A lightweight, zero-dependency TypeScript utility library providing essential helper functions for the browser, DOM manipulation, storage, strings, date/time formatting, scheduling, and general data validation.
 
 ---
 
@@ -36,14 +36,30 @@ yarn add tool-shack
 ## Quick Start
 
 ```typescript
-import { slugify, parseDuration, createElement, isTouchSupported, isValidJson } from 'tool-shack';
+import {
+  slugify,
+  parseDuration,
+  createElement,
+  isTouchSupported,
+  isValidJson,
+  timeAgo,
+  formatBytes,
+  setLocalStorage,
+  getLocalStorage,
+} from 'tool-shack';
 
 // String manipulation
 console.log(slugify('Hello World!')); // 'hello-world'
+console.log(formatBytes(1572864)); // '1.5 MB'
+
+// Storage
+setLocalStorage('user', { name: 'Alice' });
+console.log(getLocalStorage('user')); // { name: 'Alice' }
 
 // Date & Time
 console.log(parseDuration(3661000));
 // { days: 0, hours: 1, minutes: 1, seconds: 1, milliseconds: 0 }
+console.log(timeAgo(new Date(Date.now() - 5 * 60000))); // '5 minutes ago'
 
 // General Validation
 console.log(isValidJson('{"valid": true}')); // true
@@ -55,103 +71,141 @@ console.log(isValidJson('{"valid": true}')); // true
 
 ### 🌐 Browser (`browser`)
 
-Utilities for feature detection, device capabilities, viewport scrolling, and tab focus.
-
-| Function                            | Description                                                           |
-| ----------------------------------- | --------------------------------------------------------------------- |
-| `isTouchSupported()`                | Checks if the current device/browser supports touch events            |
-| `isPushNotificationSupported()`     | Checks if Push Notifications and Service Workers are supported        |
-| `isScrollBehaviorSupported()`       | Checks if native smooth scroll behavior is supported                  |
-| `isShareSupported()`                | Checks if the Web Share API (`navigator.share`) is supported          |
-| `isTabFocused()`                    | Checks whether the browser tab currently has focus                    |
-| `tabFocusListener(onFocus, onBlur)` | Subscribes callbacks for window/tab focus and blur events             |
-| `preferColorScheme()`               | Detects user color scheme preference (`'dark'`, `'light'`, or `null`) |
-| `scrollToElement(element, options)` | Smoothly scrolls the window or container to a target element          |
-| `scrollToPosition(options)`         | Smoothly scrolls to specific x/y coordinates                          |
+Utilities for feature detection, device capabilities, cookies, downloads, URL parameters, and page visibility.
+
+| Function                                           | Description                                                                         |
+| -------------------------------------------------- | ----------------------------------------------------------------------------------- |
+| `detectOS()`                                       | Detects user operating system (`'ios'`, `'android'`, `'macos'`, etc.)               |
+| `isTouchSupported()`                               | Checks if the current device/browser supports touch events                          |
+| `isPushNotificationSupported()`                    | Checks Web Push support (Notification, Service Worker, and PushManager)             |
+| `isScrollBehaviorSupported()`                      | Checks if native smooth scroll behavior is supported                                |
+| `isShareSupported()`                               | Checks if the Web Share API (`navigator.share`) is supported                        |
+| `isPageVisible()`                                  | Checks whether the page is currently visible (`!document.hidden`)                   |
+| `pageVisibilityListener(onVisible, onHidden)`      | Subscribes to Page Visibility changes with a cleanup handle                         |
+| `isTabFocused()`                                   | Deprecated alias of `isPageVisible`                                                 |
+| `tabFocusListener(onVisible, onHidden)`            | Deprecated alias of `pageVisibilityListener`                                        |
+| `preferColorScheme()`                              | Returns `'light'` if that media query matches, otherwise `'dark'`                   |
+| `preferLightColorScheme()`                         | Whether `(prefers-color-scheme: light)` matches                                     |
+| `preferDarkColorScheme()`                          | Whether `(prefers-color-scheme: dark)` matches                                      |
+| `scrollToElement(element, offset?, smoothScroll?)` | Scrolls the window to the element (offset default `0`, smoothScroll default `true`) |
+| `scrollToPosition(x, y, smoothScroll?, target?)`   | Scrolls window or a given element to `x`/`y` (smoothScroll default `true`)          |
+| `downloadFile(data, filename, mimeType?)`          | Programmatically triggers file download in the browser                              |
+| `getQueryParams(url?)`                             | Extracts URL search query parameters into a key-value object                        |
+| `networkStatusListener(onOnline, onOffline)`       | Subscribes to browser online/offline events with cleanup handle                     |
+| `getCookie(name)`                                  | Retrieves and decodes a cookie value by name                                        |
+| `setCookie(name, value, options?)`                 | Sets a browser cookie with days, path, domain, secure, and sameSite                 |
+| `deleteCookie(name, options?)`                     | Deletes a browser cookie by name                                                    |
 
 ---
 
-### 🧱 DOM (`dom`)
+### 💾 Storage (`storage`)
 
-Simplified element creation, event handling, and DOM placement.
+Type-safe `localStorage` and `sessionStorage` helpers with JSON serialization, optional Base64 encoding, and exception safety.
 
-| Function                                                 | Description                                                                                            |
-| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
-| `createElement(tagName, props)`                          | Creates a DOM element with attributes, styles, dataset, ARIA, listeners, and children in a single call |
-| `addEventListener(target, type, listener, options)`      | Attaches event listener(s) with support for multiple event types and array of targets                  |
-| `addAsyncEventListener(target, type, listener, options)` | Attaches an asynchronous event listener                                                                |
-| `addClickOutsideListener(element, callback)`             | Triggers a callback when clicking outside a specified element                                          |
-| `appendBefore(target, element)`                          | Inserts an element immediately before the target node                                                  |
-| `appendAfter(target, element)`                           | Inserts an element immediately after the target node                                                   |
-| `fireEvent(element, eventName, detail)`                  | Dispatches a custom or native DOM event                                                                |
-| `getElementOffset(element)`                              | Computes top, left, width, and height offsets relative to viewport/document                            |
+| Function                                      | Description                                                                                          |
+| --------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
+| `getLocalStorage(key, fallback?, options?)`   | JSON-parses localStorage; optional `{ encode: true }` Base64 decode; fallback default `null`         |
+| `setLocalStorage(key, value, options?)`       | JSON-serializes to localStorage; optional Base64; returns `false` if the value is not serializable   |
+| `removeLocalStorage(key)`                     | Removes item from localStorage                                                                       |
+| `clearLocalStorage()`                         | Clears all items from localStorage                                                                   |
+| `getSessionStorage(key, fallback?, options?)` | JSON-parses sessionStorage; optional `{ encode: true }` Base64 decode; fallback default `null`       |
+| `setSessionStorage(key, value, options?)`     | JSON-serializes to sessionStorage; optional Base64; returns `false` if the value is not serializable |
+| `removeSessionStorage(key)`                   | Removes item from sessionStorage                                                                     |
+| `clearSessionStorage()`                       | Clears all items from sessionStorage                                                                 |
 
-#### `createElement` Example
+---
 
-```typescript
-import { createElement } from 'tool-shack';
-
-const button = createElement<HTMLButtonElement>('button', {
-  className: 'btn primary',
-  style: { backgroundColor: '#0070f3', color: '#fff' },
-  aria: { label: 'Submit form' },
-  dataset: { action: 'submit' },
-  listeners: {
-    click: () => console.log('Clicked!'),
-  },
-  children: ['Click Me'],
-});
-
-document.body.appendChild(button);
-```
+### 🧱 DOM (`dom`)
+
+Simplified element creation, async/outside event handling, clipboard operations, viewport detection, and fullscreen.
+
+| Function                                                      | Description                                                                                                                |
+| ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `createElement(tagName, props?)`                              | Creates a DOM element with attributes, styles, dataset, ARIA, listeners, and children; known tags infer their element type |
+| `addEventListener(element, listeners)`                        | Attaches a map of event-name handlers to one element or a list of elements (no cleanup)                                    |
+| `addAsyncEventListener(selector, listeners, acceptBubbling?)` | Attaches delegated document listeners for matching elements, with cleanup                                                  |
+| `addClickOutsideListener(element, callback)`                  | Triggers a callback when clicking outside a specified element, with cleanup                                                |
+| `appendBefore(newNode, referenceNode)`                        | Inserts `newNode` immediately before `referenceNode`                                                                       |
+| `appendAfter(newNode, referenceNode)`                         | Inserts `newNode` immediately after `referenceNode`                                                                        |
+| `copyToClipboard(text)`                                       | Copies text via Clipboard API with textarea fallback; returns `Promise<boolean>`                                           |
+| `fireEvent(element, eventType)`                               | Dispatches a native `Event` (no `detail` payload)                                                                          |
+| `getElementOffset(element)`                                   | Returns document-relative `{ top, left }`                                                                                  |
+| `isInViewport(element, offset?)`                              | Checks if an element is currently within the visible viewport                                                              |
+| `toggleFullscreen(element?)`                                  | Toggles native fullscreen mode for an element or document root                                                             |
+| `toggleFullscreenWithFallback(element?, options?)`            | Toggles fullscreen with CSS pseudo-fullscreen fallback for iOS Safari and unsupported browsers                             |
+| `waitForElement(selector, timeout?, parent?)`                 | Waits for an element to appear in the DOM using `MutationObserver`                                                         |
 
 ---
 
 ### 🔤 String (`string`)
 
-String transformations, formatting, and sanitation.
-
-| Function                           | Description                                                               |
-| ---------------------------------- | ------------------------------------------------------------------------- |
-| `slugify(value, separator?)`       | Converts text into URL-safe slug with diacritics removal (default `-`)    |
-| `removeDiacritics(value)`          | Strips accent marks and diacritics from text                              |
-| `truncate(value, length, suffix?)` | Truncates a string to a given length and appends a suffix (default `...`) |
-| `escapeHTML(value)`                | Escapes HTML entities (`&`, `<`, `>`, `"`, `'`)                           |
-| `byteSize(value)`                  | Calculates the byte length of a string in UTF-8                           |
+Case conversions, string transformations, formatting, escaping, masking, and random string generators.
+
+| Function                                | Description                                                                                                  |
+| --------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| `camelCase(value)`                      | Converts string to `camelCase`                                                                               |
+| `capitalize(value)`                     | Capitalizes the first character of a string                                                                  |
+| `decodeBase64(value)`                   | Safely decodes a Base64 string to a Unicode string                                                           |
+| `encodeBase64(value)`                   | Safely encodes a Unicode string to a Base64 string                                                           |
+| `kebabCase(value)`                      | Converts string to `kebab-case`                                                                              |
+| `pascalCase(value)`                     | Converts string to `PascalCase`                                                                              |
+| `snakeCase(value)`                      | Converts string to `snake_case`                                                                              |
+| `slugify(value, separator?)`            | Converts text into URL-safe slug with diacritics removal (default `-`)                                       |
+| `removeDiacritics(value)`               | Strips accent marks and diacritics from text                                                                 |
+| `truncate(value, maxLength, suffix?)`   | Truncates a string to a given length and appends a suffix (default `...`)                                    |
+| `mask(value, options?)`                 | Masks sensitive string characters (e.g. for card numbers or tokens)                                          |
+| `formatBytes(bytes, decimals?)`         | Formats byte number into readable string (`'1.5 MB'`, `'2 KB'`)                                              |
+| `escapeHTML(value)`                     | Encodes `&`, `<`, `>`, `"`, and `'` as HTML entities for ordinary text or quoted attributes; not a sanitizer |
+| `unescapeHTML(value)`                   | Unescapes HTML entities back to plain text                                                                   |
+| `byteSize(value)`                       | Calculates the byte length of a string in UTF-8                                                              |
+| `randomString(length?, charset?)`       | Generates random string using `Math.random`                                                                  |
+| `randomCryptoString(length?, charset?)` | Generates cryptographically secure random string using Web Crypto API                                        |
 
 ---
 
 ### ⏱️ Date & Time (`dateTime`)
 
-Date formatting and duration parsing.
+Date formatting, duration parsing, relative time, and calendar day comparison.
 
-| Function                      | Description                                                                     |
-| ----------------------------- | ------------------------------------------------------------------------------- |
-| `parseDuration(durationInMs)` | Breaks down milliseconds into `{ days, hours, minutes, seconds, milliseconds }` |
-| `dateAsIso(date?)`            | Formats a Date object as an ISO string (`YYYY-MM-DDTHH:mm:ss.sssZ`)             |
+| Function                      | Description                                                                          |
+| ----------------------------- | ------------------------------------------------------------------------------------ |
+| `parseDuration(durationInMs)` | Breaks down milliseconds into `{ days, hours, minutes, seconds, milliseconds }`      |
+| `dateAsIso(date)`             | Formats a Date as local `YYYY-MM-DDTHH:mm:ss±HH:mm` (required Date; no milliseconds) |
+| `timeAgo(date, locale?)`      | Formats a date into a human-readable relative string (`'5 minutes ago'`)             |
+| `isSameDay(date1, date2)`     | Checks if two Date, timestamp, or date-string values fall on the same calendar day   |
 
 ---
 
 ### ⚙️ General (`general`)
 
-Value safety checks and JSON validation.
+Array deduplication, picking, grouping & chunking, value comparison, number clamping, value safety checks, and JSON validation.
 
-| Function             | Description                                             |
-| -------------------- | ------------------------------------------------------- |
-| `isEmpty(value)`     | Checks if a string, array, map, set, or object is empty |
-| `isNil(value)`       | Checks if a value is `null` or `undefined`              |
-| `isValidJson(value)` | Validates whether a given string is valid JSON          |
+| Function                 | Description                                                                 |
+| ------------------------ | --------------------------------------------------------------------------- |
+| `pick(object, keys)`     | Creates object composed of picked object properties                         |
+| `unique(array, keyFn?)`  | Deduplicates array items by reference or key callback                       |
+| `isEqual(a, b)`          | Compares primitives, arrays, Dates, RegExps, and own enumerable string keys |
+| `clamp(value, min, max)` | Constrains a number between min and max boundaries                          |
+| `groupBy(array, keyFn)`  | Groups array elements into an object by key                                 |
+| `chunk(array, size?)`    | Splits array into chunks of specified size (default `1`)                    |
+| `isEmpty(value)`         | Checks if a string, array, map, set, or object is empty                     |
+| `isNil(value)`           | Checks if a value is `null` or `undefined`                                  |
+| `isValidJson(value)`     | Validates whether a given string is valid JSON                              |
 
 ---
 
 ### ⏳ Schedule (`schedule`)
 
-Animation frames and async execution helpers.
+Debouncing, throttling, async retry, sleep, and animation frames.
 
-| Function                     | Description                                                                    |
-| ---------------------------- | ------------------------------------------------------------------------------ |
-| `runAnimation(callback)`     | Executes a callback with `requestAnimationFrame` and returns a cancel function |
-| `runAsync(callback, delay?)` | Runs a callback asynchronously (via microtask or `setTimeout`)                 |
+| Function                             | Description                                                                |
+| ------------------------------------ | -------------------------------------------------------------------------- |
+| `debounce(fn, delay?)`               | Creates debounced function with `.cancel()` (delay default `300`)          |
+| `throttle(fn, limit?)`               | Creates throttled function with `.cancel()` (limit default `300`)          |
+| `sleep(ms)`                          | Promise-based delay helper (`await sleep(500)`)                            |
+| `retry(fn, options?)`                | Retries async function with exponential backoff before failing             |
+| `runAnimation(callback, autoStart?)` | `requestAnimationFrame` loop; returns `{ startAnimation, stopAnimation }`  |
+| `runAsync(callback)`                 | Runs function source in a Blob Web Worker (no closures; async not awaited) |
 
 ---
 

package/dist/cjs/browser/deleteCookie.d.ts

@@ -0,0 +1,10 @@
+import type { ICookieOptions } from './interfaces/setCookie.js';
+/**
+ * Delete a browser cookie by name
+ *
+ * @param name Cookie name to delete
+ * @param options Optional path and domain to match cookie scope
+ * @returns void
+ */
+export declare const deleteCookie: (name: string, options?: Pick<ICookieOptions, "path" | "domain">) => void;
+//# sourceMappingURL=deleteCookie.d.ts.map

package/dist/cjs/browser/deleteCookie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteCookie.d.ts","sourceRoot":"","sources":["../../../src/browser/deleteCookie.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GACvB,MAAM,MAAM,EACZ,UAAU,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAC,KAChD,IAEF,CAAC"}

package/dist/cjs/browser/deleteCookie.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteCookie = void 0;
+const setCookie_js_1 = require("./setCookie.js");
+/**
+ * Delete a browser cookie by name
+ *
+ * @param name Cookie name to delete
+ * @param options Optional path and domain to match cookie scope
+ * @returns void
+ */
+const deleteCookie = (name, options) => {
+    (0, setCookie_js_1.setCookie)(name, '', { ...options, days: -1 });
+};
+exports.deleteCookie = deleteCookie;
+//# sourceMappingURL=deleteCookie.js.map

package/dist/cjs/browser/deleteCookie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteCookie.js","sourceRoot":"","sources":["../../../src/browser/deleteCookie.ts"],"names":[],"mappings":";;;AACA,iDAA2C;AAE3C;;;;;;GAMG;AACI,MAAM,YAAY,GAAG,CAC1B,IAAY,EACZ,OAAiD,EAC3C,EAAE;IACR,IAAA,wBAAS,EAAC,IAAI,EAAE,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAChD,CAAC,CAAC;AALW,QAAA,YAAY,gBAKvB"}

package/dist/cjs/browser/detectOS.d.ts

@@ -0,0 +1,8 @@
+import type { TOSName } from './interfaces/detectOS.js';
+/**
+ * Detect user operating system from browser environment
+ *
+ * @returns Detected OS name ('ios' | 'android' | 'macos' | 'windows' | 'linux' | 'unknown')
+ */
+export declare const detectOS: () => TOSName;
+//# sourceMappingURL=detectOS.d.ts.map

package/dist/cjs/browser/detectOS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectOS.d.ts","sourceRoot":"","sources":["../../../src/browser/detectOS.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,QAAQ,QAAO,OAwB3B,CAAC"}

package/dist/cjs/browser/detectOS.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectOS = void 0;
+/**
+ * Detect user operating system from browser environment
+ *
+ * @returns Detected OS name ('ios' | 'android' | 'macos' | 'windows' | 'linux' | 'unknown')
+ */
+const detectOS = () => {
+    if (typeof navigator === 'undefined') {
+        return 'unknown';
+    }
+    const userAgent = navigator.userAgent.toLowerCase();
+    if (/iphone|ipad|ipod/.test(userAgent)) {
+        return 'ios';
+    }
+    if (/android/.test(userAgent)) {
+        return 'android';
+    }
+    if (/macintosh|mac os x/.test(userAgent)) {
+        return 'macos';
+    }
+    if (/windows|win32|win64/.test(userAgent)) {
+        return 'windows';
+    }
+    if (/linux/.test(userAgent)) {
+        return 'linux';
+    }
+    return 'unknown';
+};
+exports.detectOS = detectOS;
+//# sourceMappingURL=detectOS.js.map

package/dist/cjs/browser/detectOS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectOS.js","sourceRoot":"","sources":["../../../src/browser/detectOS.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACI,MAAM,QAAQ,GAAG,GAAY,EAAE;IACpC,IAAI,OAAO,SAAS,KAAK,WAAW,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;IAEpD,IAAI,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAxBW,QAAA,QAAQ,YAwBnB"}

package/dist/cjs/browser/downloadFile.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Programmatically download a file in browser
+ *
+ * @param data File content as string or Blob
+ * @param filename Desired filename
+ * @param mimeType Optional MIME type when data is string (default 'text/plain')
+ * @returns void
+ */
+export declare const downloadFile: (data: string | Blob, filename: string, mimeType?: string) => void;
+//# sourceMappingURL=downloadFile.d.ts.map

package/dist/cjs/browser/downloadFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloadFile.d.ts","sourceRoot":"","sources":["../../../src/browser/downloadFile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GACvB,MAAM,MAAM,GAAG,IAAI,EACnB,UAAU,MAAM,EAChB,iBAAuB,KACtB,IAcF,CAAC"}

package/dist/cjs/browser/downloadFile.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadFile = void 0;
+/**
+ * Programmatically download a file in browser
+ *
+ * @param data File content as string or Blob
+ * @param filename Desired filename
+ * @param mimeType Optional MIME type when data is string (default 'text/plain')
+ * @returns void
+ */
+const downloadFile = (data, filename, mimeType = 'text/plain') => {
+    const blob = typeof data === 'string' ? new Blob([data], { type: mimeType }) : data;
+    const url = URL.createObjectURL(blob);
+    const tempLink = document.createElement('a');
+    tempLink.href = url;
+    tempLink.download = filename;
+    tempLink.style.display = 'none';
+    document.body.appendChild(tempLink);
+    tempLink.click();
+    document.body.removeChild(tempLink);
+    URL.revokeObjectURL(url);
+};
+exports.downloadFile = downloadFile;
+//# sourceMappingURL=downloadFile.js.map

package/dist/cjs/browser/downloadFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloadFile.js","sourceRoot":"","sources":["../../../src/browser/downloadFile.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACI,MAAM,YAAY,GAAG,CAC1B,IAAmB,EACnB,QAAgB,EAChB,QAAQ,GAAG,YAAY,EACjB,EAAE;IACR,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpF,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAE7C,QAAQ,CAAC,IAAI,GAAG,GAAG,CAAC;IACpB,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;IAEhC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACjB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAEpC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC,CAAC;AAlBW,QAAA,YAAY,gBAkBvB"}

package/dist/cjs/browser/getCookie.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Get browser cookie value by name
+ *
+ * @param name Cookie name
+ * @returns Decoded cookie value or null if not found
+ */
+export declare const getCookie: (name: string) => string | null;
+//# sourceMappingURL=getCookie.d.ts.map

package/dist/cjs/browser/getCookie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCookie.d.ts","sourceRoot":"","sources":["../../../src/browser/getCookie.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,IAiBjD,CAAC"}

package/dist/cjs/browser/getCookie.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCookie = void 0;
+/**
+ * Get browser cookie value by name
+ *
+ * @param name Cookie name
+ * @returns Decoded cookie value or null if not found
+ */
+const getCookie = (name) => {
+    const encodedName = encodeURIComponent(name);
+    for (const part of document.cookie.split(';')) {
+        const entry = part.trim();
+        const separatorIndex = entry.indexOf('=');
+        if (separatorIndex === -1) {
+            continue;
+        }
+        if (entry.slice(0, separatorIndex) === encodedName) {
+            return decodeURIComponent(entry.slice(separatorIndex + 1));
+        }
+    }
+    return null;
+};
+exports.getCookie = getCookie;
+//# sourceMappingURL=getCookie.js.map

package/dist/cjs/browser/getCookie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCookie.js","sourceRoot":"","sources":["../../../src/browser/getCookie.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACI,MAAM,SAAS,GAAG,CAAC,IAAY,EAAiB,EAAE;IACvD,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAE7C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAE1C,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,KAAK,WAAW,EAAE,CAAC;YACnD,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAjBW,QAAA,SAAS,aAiBpB"}

package/dist/cjs/browser/getQueryParams.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Extract query parameters from URL into a key-value record
+ *
+ * @param url Optional URL string (defaults to window.location.href)
+ * @returns Record of query parameters; empty if the URL is invalid or has no search
+ */
+export declare const getQueryParams: (url?: string) => Record<string, string>;
+//# sourceMappingURL=getQueryParams.d.ts.map

package/dist/cjs/browser/getQueryParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getQueryParams.d.ts","sourceRoot":"","sources":["../../../src/browser/getQueryParams.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAalE,CAAC"}

package/dist/cjs/browser/getQueryParams.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getQueryParams = void 0;
+/**
+ * Extract query parameters from URL into a key-value record
+ *
+ * @param url Optional URL string (defaults to window.location.href)
+ * @returns Record of query parameters; empty if the URL is invalid or has no search
+ */
+const getQueryParams = (url) => {
+    const result = {};
+    const base = typeof window !== 'undefined' ? window.location.href : 'http://localhost/';
+    try {
+        new URL(url ?? base, base).searchParams.forEach((value, key) => {
+            result[key] = value;
+        });
+    }
+    catch {
+        return result;
+    }
+    return result;
+};
+exports.getQueryParams = getQueryParams;
+//# sourceMappingURL=getQueryParams.js.map

package/dist/cjs/browser/getQueryParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getQueryParams.js","sourceRoot":"","sources":["../../../src/browser/getQueryParams.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACI,MAAM,cAAc,GAAG,CAAC,GAAY,EAA0B,EAAE;IACrE,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAExF,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,GAAG,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7D,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAbW,QAAA,cAAc,kBAazB"}

package/dist/cjs/browser/index.d.ts

@@ -1,10 +1,20 @@
+export * from './interfaces/index.js';
+export * from './deleteCookie.js';
+export * from './detectOS.js';
+export * from './downloadFile.js';
+export * from './getCookie.js';
+export * from './getQueryParams.js';
+export * from './isPageVisible.js';
 export * from './isPushNotificationSupported.js';
 export * from './isScrollBehaviorSupported.js';
 export * from './isShareSupported.js';
 export * from './isTabFocused.js';
 export * from './isTouchSupported.js';
+export * from './networkStatusListener.js';
+export * from './pageVisibilityListener.js';
 export * from './preferColorScheme.js';
 export * from './scrollToElement.js';
 export * from './scrollToPosition.js';
+export * from './setCookie.js';
 export * from './tabFocusListener.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/browser/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}

package/dist/cjs/browser/index.js

@@ -1,13 +1,36 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./isPushNotificationSupported.js"), exports);
-tslib_1.__exportStar(require("./isScrollBehaviorSupported.js"), exports);
-tslib_1.__exportStar(require("./isShareSupported.js"), exports);
-tslib_1.__exportStar(require("./isTabFocused.js"), exports);
-tslib_1.__exportStar(require("./isTouchSupported.js"), exports);
-tslib_1.__exportStar(require("./preferColorScheme.js"), exports);
-tslib_1.__exportStar(require("./scrollToElement.js"), exports);
-tslib_1.__exportStar(require("./scrollToPosition.js"), exports);
-tslib_1.__exportStar(require("./tabFocusListener.js"), exports);
+__exportStar(require("./interfaces/index.js"), exports);
+__exportStar(require("./deleteCookie.js"), exports);
+__exportStar(require("./detectOS.js"), exports);
+__exportStar(require("./downloadFile.js"), exports);
+__exportStar(require("./getCookie.js"), exports);
+__exportStar(require("./getQueryParams.js"), exports);
+__exportStar(require("./isPageVisible.js"), exports);
+__exportStar(require("./isPushNotificationSupported.js"), exports);
+__exportStar(require("./isScrollBehaviorSupported.js"), exports);
+__exportStar(require("./isShareSupported.js"), exports);
+__exportStar(require("./isTabFocused.js"), exports);
+__exportStar(require("./isTouchSupported.js"), exports);
+__exportStar(require("./networkStatusListener.js"), exports);
+__exportStar(require("./pageVisibilityListener.js"), exports);
+__exportStar(require("./preferColorScheme.js"), exports);
+__exportStar(require("./scrollToElement.js"), exports);
+__exportStar(require("./scrollToPosition.js"), exports);
+__exportStar(require("./setCookie.js"), exports);
+__exportStar(require("./tabFocusListener.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/browser/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":";;;AAAA,2EAAiD;AACjD,yEAA+C;AAC/C,gEAAsC;AACtC,4DAAkC;AAClC,gEAAsC;AACtC,iEAAuC;AACvC,+DAAqC;AACrC,gEAAsC;AACtC,gEAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AAEtC,oDAAkC;AAClC,gDAA8B;AAC9B,oDAAkC;AAClC,iDAA+B;AAC/B,sDAAoC;AACpC,qDAAmC;AACnC,mEAAiD;AACjD,iEAA+C;AAC/C,wDAAsC;AACtC,oDAAkC;AAClC,wDAAsC;AACtC,6DAA2C;AAC3C,8DAA4C;AAC5C,yDAAuC;AACvC,uDAAqC;AACrC,wDAAsC;AACtC,iDAA+B;AAC/B,wDAAsC"}

package/dist/cjs/browser/interfaces/detectOS.d.ts

@@ -0,0 +1,2 @@
+export type TOSName = 'ios' | 'android' | 'macos' | 'windows' | 'linux' | 'unknown';
+//# sourceMappingURL=detectOS.d.ts.map

package/dist/cjs/browser/interfaces/detectOS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectOS.d.ts","sourceRoot":"","sources":["../../../../src/browser/interfaces/detectOS.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC"}

package/dist/cjs/browser/interfaces/detectOS.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=detectOS.js.map

package/dist/cjs/browser/interfaces/detectOS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectOS.js","sourceRoot":"","sources":["../../../../src/browser/interfaces/detectOS.ts"],"names":[],"mappings":""}

package/dist/cjs/browser/interfaces/index.d.ts

@@ -0,0 +1,4 @@
+export * from './detectOS.js';
+export * from './isTouchSupported.js';
+export * from './setCookie.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/browser/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/browser/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC"}