tool-shack 0.0.41 → 1.0.0

package/README.md

@@ -1 +1,217 @@
 # tool-shack
+
+[![npm version](https://img.shields.io/npm/v/tool-shack.svg)](https://www.npmjs.com/package/tool-shack)
+[![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, storage, strings, date/time formatting, scheduling, and general data validation.
+
+---
+
+## Features
+
+- 🪶 **Zero dependencies** & lightweight
+- 📦 **Dual module support**: ESM (`import`) and CommonJS (`require`)
+- 🏷️ **Full TypeScript support** with built-in type definitions
+- 🌐 **Browser & DOM utilities** to streamline frontend development
+- ⚡ **Tree-shakeable** exports
+
+---
+
+## Installation
+
+```bash
+# npm
+npm install tool-shack
+
+# pnpm
+pnpm add tool-shack
+
+# yarn
+yarn add tool-shack
+```
+
+---
+
+## Quick Start
+
+```typescript
+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
+```
+
+---
+
+## Modules & APIs
+
+### 🌐 Browser (`browser`)
+
+Utilities for feature detection, device capabilities, cookies, downloads, URL parameters, and tab focus.
+
+| Function                                     | Description                                                           |
+| -------------------------------------------- | --------------------------------------------------------------------- |
+| `detectOS()`                                 | Detects user operating system (`'ios'`, `'android'`, `'macos'`, etc.) |
+| `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                          |
+| `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                                      |
+
+---
+
+### 💾 Storage (`storage`)
+
+Type-safe `localStorage` and `sessionStorage` helpers with automatic JSON serialization and exception safety.
+
+| Function                            | Description                                                     |
+| ----------------------------------- | --------------------------------------------------------------- |
+| `getLocalStorage(key, fallback?)`   | Retrieves item from localStorage with automatic JSON parsing    |
+| `setLocalStorage(key, value)`       | Stores item in localStorage with automatic JSON serialization   |
+| `removeLocalStorage(key)`           | Removes item from localStorage                                  |
+| `clearLocalStorage()`               | Clears all items from localStorage                              |
+| `getSessionStorage(key, fallback?)` | Retrieves item from sessionStorage with automatic JSON parsing  |
+| `setSessionStorage(key, value)`     | Stores item in sessionStorage with automatic JSON serialization |
+| `removeSessionStorage(key)`         | Removes item from sessionStorage                                |
+| `clearSessionStorage()`             | Clears all items from sessionStorage                            |
+
+---
+
+### 🧱 DOM (`dom`)
+
+Simplified element creation, async/outside event handling, clipboard operations, viewport detection, layout-shift-free scroll lock, and fullscreen.
+
+| 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 delegated 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                                                   |
+| `copyToClipboard(text)`                                  | Copies text to clipboard via Clipboard API with legacy fallback                                        |
+| `fireEvent(element, eventName, detail)`                  | Dispatches a custom or native DOM event                                                                |
+| `getElementOffset(element)`                              | Computes top, left, width, and height offsets relative to viewport/document                            |
+| `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`)
+
+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, length, 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)`                     | Escapes HTML entities (`&`, `<`, `>`, `"`, `'`)                           |
+| `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, 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`)             |
+| `timeAgo(date, locale?)`      | Formats a date into a human-readable relative string (`'5 minutes ago'`)        |
+| `isSameDay(date1, date2)`     | Checks if two dates fall on the same calendar day                               |
+
+---
+
+### ⚙️ General (`general`)
+
+Array deduplication, picking, grouping & chunking, deep equality, number clamping, value safety checks, and JSON validation.
+
+| 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)`          | Performs deep structural comparison between two values  |
+| `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              |
+| `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`)
+
+Debouncing, throttling, async retry, sleep, and animation frames.
+
+| Function                             | Description                                                                    |
+| ------------------------------------ | ------------------------------------------------------------------------------ |
+| `debounce(fn, delay?)`               | Creates debounced function with `.cancel()` handle                             |
+| `throttle(fn, limit?)`               | Creates throttled function with `.cancel()` handle                             |
+| `sleep(ms)`                          | Promise-based delay helper (`await sleep(500)`)                                |
+| `retry(fn, options?)`                | Retries async function with exponential backoff before failing                 |
+| `runAnimation(callback, autoStart?)` | Executes a callback with `requestAnimationFrame` and returns a cancel function |
+| `runAsync(callback)`                 | Runs a callback asynchronously in a Web Worker                                 |
+
+---
+
+## Documentation
+
+Full API documentation and type definitions are available at:  
+👉 **[https://storage.davidmyska.com/tool-shack/](https://storage.davidmyska.com/tool-shack/)**
+
+---
+
+## License
+
+[MIT](https://opensource.org/licenses/MIT) © [David Myška](https://www.davidmyska.com/)

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,IAIjD,CAAC"}

package/dist/cjs/browser/getCookie.js

@@ -0,0 +1,15 @@
+"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 match = document.cookie.match(new RegExp(`(?:^|;\\s*)${encodeURIComponent(name)}=([^;]*)`));
+    return match ? decodeURIComponent(match[1]) : 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,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,cAAc,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAElG,OAAO,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACrD,CAAC,CAAC;AAJW,QAAA,SAAS,aAIpB"}

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
+ */
+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,CAqBlE,CAAC"}

package/dist/cjs/browser/getQueryParams.js

@@ -0,0 +1,29 @@
+"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
+ */
+const getQueryParams = (url) => {
+    let search = url
+        ? url.includes('?')
+            ? url.substring(url.indexOf('?'))
+            : ''
+        : typeof window !== 'undefined'
+            ? window.location.search
+            : '';
+    if (search.includes('#')) {
+        search = search.substring(0, search.indexOf('#'));
+    }
+    const params = new URLSearchParams(search);
+    const result = {};
+    params.forEach((value, key) => {
+        result[key] = value;
+    });
+    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,IAAI,MAAM,GAAG,GAAG;QACd,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YACjB,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,CAAC,CAAC,EAAE;QACN,CAAC,CAAC,OAAO,MAAM,KAAK,WAAW;YAC7B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM;YACxB,CAAC,CAAC,EAAE,CAAC;IAET,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AArBW,QAAA,cAAc,kBAqBzB"}

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

@@ -1,10 +1,18 @@
+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 './isPushNotificationSupported.js';
 export * from './isScrollBehaviorSupported.js';
 export * from './isShareSupported.js';
 export * from './isTabFocused.js';
 export * from './isTouchSupported.js';
+export * from './networkStatusListener.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,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,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,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./interfaces/index.js"), exports);
+tslib_1.__exportStar(require("./deleteCookie.js"), exports);
+tslib_1.__exportStar(require("./detectOS.js"), exports);
+tslib_1.__exportStar(require("./downloadFile.js"), exports);
+tslib_1.__exportStar(require("./getCookie.js"), exports);
+tslib_1.__exportStar(require("./getQueryParams.js"), exports);
 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("./networkStatusListener.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("./setCookie.js"), exports);
 tslib_1.__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,gEAAsC;AAEtC,4DAAkC;AAClC,wDAA8B;AAC9B,4DAAkC;AAClC,yDAA+B;AAC/B,8DAAoC;AACpC,2EAAiD;AACjD,yEAA+C;AAC/C,gEAAsC;AACtC,4DAAkC;AAClC,gEAAsC;AACtC,qEAA2C;AAC3C,iEAAuC;AACvC,+DAAqC;AACrC,gEAAsC;AACtC,yDAA+B;AAC/B,gEAAsC"}

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"}

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./detectOS.js"), exports);
+tslib_1.__exportStar(require("./isTouchSupported.js"), exports);
+tslib_1.__exportStar(require("./setCookie.js"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/browser/interfaces/index.ts"],"names":[],"mappings":";;;AAAA,wDAA8B;AAC9B,gEAAsC;AACtC,yDAA+B"}

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

@@ -1,4 +1,6 @@
 export interface IExtendedWindow extends Window {
-    DocumentTouch: any;
+    DocumentTouch: {
+        new (...args: unknown[]): unknown;
+    };
 }
 //# sourceMappingURL=isTouchSupported.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"isTouchSupported.d.ts","sourceRoot":"","sources":["../../../../src/browser/interfaces/isTouchSupported.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAgB,SAAQ,MAAM;IAC7C,aAAa,EAAE,GAAG,CAAC;CACpB"}
+{"version":3,"file":"isTouchSupported.d.ts","sourceRoot":"","sources":["../../../../src/browser/interfaces/isTouchSupported.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAgB,SAAQ,MAAM;IAC7C,aAAa,EAAE;QAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;KAAE,CAAC;CACtD"}

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

@@ -0,0 +1,8 @@
+export interface ICookieOptions {
+    days?: number;
+    path?: string;
+    domain?: string;
+    secure?: boolean;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+}
+//# sourceMappingURL=setCookie.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setCookie.d.ts","sourceRoot":"","sources":["../../../../src/browser/interfaces/setCookie.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;CACtC"}

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"isTouchSupported.d.ts","sourceRoot":"","sources":["../../../src/browser/isTouchSupported.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,QAAO,OAGyC,CAAC"}
+{"version":3,"file":"isTouchSupported.d.ts","sourceRoot":"","sources":["../../../src/browser/isTouchSupported.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,QAAO,OAKjC,CAAC"}

package/dist/cjs/browser/isTouchSupported.js

@@ -6,8 +6,8 @@ exports.isTouchSupported = void 0;
  *
  * @returns Boolean indicating if user's browser supports touch events
  */
-const isTouchSupported = () => 'ontouchstart' in window ||
+const isTouchSupported = () => !!('ontouchstart' in window ||
     (window.DocumentTouch &&
-        document instanceof window.DocumentTouch);
+        document instanceof window.DocumentTouch));
 exports.isTouchSupported = isTouchSupported;
 //# sourceMappingURL=isTouchSupported.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"isTouchSupported.js","sourceRoot":"","sources":["../../../src/browser/isTouchSupported.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACI,MAAM,gBAAgB,GAAG,GAAY,EAAE,CAC5C,cAAc,IAAI,MAAM;IACxB,CAAE,MAAqC,CAAC,aAAa;QACnD,QAAQ,YAAa,MAAqC,CAAC,aAAa,CAAC,CAAC;AAHjE,QAAA,gBAAgB,oBAGiD"}
+{"version":3,"file":"isTouchSupported.js","sourceRoot":"","sources":["../../../src/browser/isTouchSupported.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACI,MAAM,gBAAgB,GAAG,GAAY,EAAE,CAC5C,CAAC,CAAC,CACA,cAAc,IAAI,MAAM;IACxB,CAAE,MAAqC,CAAC,aAAa;QACnD,QAAQ,YAAa,MAAqC,CAAC,aAAa,CAAC,CAC5E,CAAC;AALS,QAAA,gBAAgB,oBAKzB"}

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

@@ -0,0 +1,9 @@
+/**
+ * Set callbacks for when browser goes online or offline
+ *
+ * @param onOnline Callback when connection is restored
+ * @param onOffline Callback when connection is lost
+ * @returns Cleanup function to remove event listeners
+ */
+export declare const networkStatusListener: (onOnline?: () => void, onOffline?: () => void) => (() => void);
+//# sourceMappingURL=networkStatusListener.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"networkStatusListener.d.ts","sourceRoot":"","sources":["../../../src/browser/networkStatusListener.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,WAAW,MAAM,IAAI,EACrB,YAAY,MAAM,IAAI,KACrB,CAAC,MAAM,IAAI,CAWb,CAAC"}

package/dist/cjs/browser/networkStatusListener.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.networkStatusListener = void 0;
+/**
+ * Set callbacks for when browser goes online or offline
+ *
+ * @param onOnline Callback when connection is restored
+ * @param onOffline Callback when connection is lost
+ * @returns Cleanup function to remove event listeners
+ */
+const networkStatusListener = (onOnline, onOffline) => {
+    const handleOnline = () => onOnline?.();
+    const handleOffline = () => onOffline?.();
+    window.addEventListener('online', handleOnline);
+    window.addEventListener('offline', handleOffline);
+    return () => {
+        window.removeEventListener('online', handleOnline);
+        window.removeEventListener('offline', handleOffline);
+    };
+};
+exports.networkStatusListener = networkStatusListener;
+//# sourceMappingURL=networkStatusListener.js.map