tool-shack 1.0.0 → 1.1.0

package/README.md

@@ -71,65 +71,69 @@ console.log(isValidJson('{"valid": true}')); // true
 
 ### 🌐 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                                      |
+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                                                    |
 
 ---
 
 ### 💾 Storage (`storage`)
 
-Type-safe `localStorage` and `sessionStorage` helpers with automatic JSON serialization and exception safety.
+Type-safe `localStorage` and `sessionStorage` helpers with JSON serialization, optional Base64 encoding, 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                            |
+| 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                                                                 |
 
 ---
 
 ### 🧱 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`                                     |
+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`                                                         |
 
 ---
 
@@ -137,25 +141,25 @@ Simplified element creation, async/outside event handling, clipboard operations,
 
 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     |
+| 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                                        |
 
 ---
 
@@ -163,30 +167,30 @@ Case conversions, string transformations, formatting, escaping, masking, and ran
 
 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                               |
+| 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`)
 
-Array deduplication, picking, grouping & chunking, deep equality, number clamping, value safety checks, and JSON validation.
+Array deduplication, picking, grouping & chunking, value comparison, 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          |
+| 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                              |
 
 ---
 
@@ -194,14 +198,14 @@ Array deduplication, picking, grouping & chunking, deep equality, number clampin
 
 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                                 |
+| 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/getCookie.d.ts.map

@@ -1 +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"}
+{"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

@@ -8,8 +8,18 @@ exports.getCookie = void 0;
  * @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;
+    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

@@ -1 +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"}
+{"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

@@ -2,7 +2,7 @@
  * 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
+ * @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

@@ -1 +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"}
+{"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

@@ -5,24 +5,19 @@ 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
+ * @returns Record of query parameters; empty if the URL is invalid or has no search
  */
 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;
-    });
+    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;

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

@@ -1 +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"}
+{"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

@@ -4,12 +4,14 @@ 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';

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,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"}
+{"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,21 +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("./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);
+__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,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"}
+{"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/index.js

@@ -1,7 +1,20 @@
 "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("./detectOS.js"), exports);
-tslib_1.__exportStar(require("./isTouchSupported.js"), exports);
-tslib_1.__exportStar(require("./setCookie.js"), exports);
+__exportStar(require("./detectOS.js"), exports);
+__exportStar(require("./isTouchSupported.js"), exports);
+__exportStar(require("./setCookie.js"), exports);
 //# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Check whether the page is currently visible
+ *
+ * Uses the Page Visibility API (`document.hidden`). This is not window or tab
+ * input focus.
+ *
+ * @returns Whether the document is currently visible
+ */
+export declare const isPageVisible: () => boolean;
+//# sourceMappingURL=isPageVisible.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"isPageVisible.d.ts","sourceRoot":"","sources":["../../../src/browser/isPageVisible.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,QAAO,OAA2B,CAAC"}

package/dist/cjs/browser/isPageVisible.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPageVisible = void 0;
+/**
+ * Check whether the page is currently visible
+ *
+ * Uses the Page Visibility API (`document.hidden`). This is not window or tab
+ * input focus.
+ *
+ * @returns Whether the document is currently visible
+ */
+const isPageVisible = () => !document.hidden;
+exports.isPageVisible = isPageVisible;
+//# sourceMappingURL=isPageVisible.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"isPageVisible.js","sourceRoot":"","sources":["../../../src/browser/isPageVisible.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACI,MAAM,aAAa,GAAG,GAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;AAAhD,QAAA,aAAa,iBAAmC"}

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

@@ -1,7 +1,10 @@
 /**
- * Check if user's browser supports push notifications
+ * Check whether the environment supports the Web Push API
  *
- * @returns Boolean indicating if user's browser supports push notifications
+ * Requires Notification, Service Worker, and PushManager. Does not check
+ * permission and does not register a service worker.
+ *
+ * @returns Whether Web Push is supported
  */
 export declare const isPushNotificationSupported: () => boolean;
 //# sourceMappingURL=isPushNotificationSupported.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"isPushNotificationSupported.d.ts","sourceRoot":"","sources":["../../../src/browser/isPushNotificationSupported.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,QAAO,OACa,CAAC"}
+{"version":3,"file":"isPushNotificationSupported.d.ts","sourceRoot":"","sources":["../../../src/browser/isPushNotificationSupported.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,QAAO,OACsC,CAAC"}

package/dist/cjs/browser/isPushNotificationSupported.js

@@ -2,10 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isPushNotificationSupported = void 0;
 /**
- * Check if user's browser supports push notifications
+ * Check whether the environment supports the Web Push API
  *
- * @returns Boolean indicating if user's browser supports push notifications
+ * Requires Notification, Service Worker, and PushManager. Does not check
+ * permission and does not register a service worker.
+ *
+ * @returns Whether Web Push is supported
  */
-const isPushNotificationSupported = () => !!(window.Notification || 'webkitNotifications' in window);
+const isPushNotificationSupported = () => 'Notification' in window && 'serviceWorker' in navigator && 'PushManager' in window;
 exports.isPushNotificationSupported = isPushNotificationSupported;
 //# sourceMappingURL=isPushNotificationSupported.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"isPushNotificationSupported.js","sourceRoot":"","sources":["../../../src/browser/isPushNotificationSupported.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACI,MAAM,2BAA2B,GAAG,GAAY,EAAE,CACvD,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,IAAI,qBAAqB,IAAI,MAAM,CAAC,CAAC;AADhD,QAAA,2BAA2B,+BACqB"}
+{"version":3,"file":"isPushNotificationSupported.js","sourceRoot":"","sources":["../../../src/browser/isPushNotificationSupported.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACI,MAAM,2BAA2B,GAAG,GAAY,EAAE,CACvD,cAAc,IAAI,MAAM,IAAI,eAAe,IAAI,SAAS,IAAI,aAAa,IAAI,MAAM,CAAC;AADzE,QAAA,2BAA2B,+BAC8C"}

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

@@ -1,7 +1,6 @@
 /**
- * Check if current browser tab is in focus
- *
- * @returns Boolean indicating if current browser tab is in focus
+ * @deprecated Use {@link isPageVisible}. Same as `!document.hidden`; not window
+ * or tab input focus.
  */
 export declare const isTabFocused: () => boolean;
 //# sourceMappingURL=isTabFocused.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"isTabFocused.d.ts","sourceRoot":"","sources":["../../../src/browser/isTabFocused.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAAO,OAA2B,CAAC"}
+{"version":3,"file":"isTabFocused.d.ts","sourceRoot":"","sources":["../../../src/browser/isTabFocused.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,YAAY,eAAgB,CAAC"}

package/dist/cjs/browser/isTabFocused.js

@@ -1,11 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isTabFocused = void 0;
+const isPageVisible_js_1 = require("./isPageVisible.js");
 /**
- * Check if current browser tab is in focus
- *
- * @returns Boolean indicating if current browser tab is in focus
+ * @deprecated Use {@link isPageVisible}. Same as `!document.hidden`; not window
+ * or tab input focus.
  */
-const isTabFocused = () => !document.hidden;
-exports.isTabFocused = isTabFocused;
+exports.isTabFocused = isPageVisible_js_1.isPageVisible;
 //# sourceMappingURL=isTabFocused.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"isTabFocused.js","sourceRoot":"","sources":["../../../src/browser/isTabFocused.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACI,MAAM,YAAY,GAAG,GAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;AAA/C,QAAA,YAAY,gBAAmC"}
+{"version":3,"file":"isTabFocused.js","sourceRoot":"","sources":["../../../src/browser/isTabFocused.ts"],"names":[],"mappings":";;;AAAA,yDAAmD;AAEnD;;;GAGG;AACU,QAAA,YAAY,GAAG,gCAAa,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * Subscribe to Page Visibility changes
+ *
+ * Uses `visibilitychange` and `document.hidden`. This is not window focus or
+ * blur.
+ *
+ * @param onVisible Called when the page becomes visible
+ * @param onHidden Called when the page becomes hidden
+ * @returns Cleanup function to remove the listener
+ */
+export declare const pageVisibilityListener: (onVisible?: () => void, onHidden?: () => void) => (() => void);
+//# sourceMappingURL=pageVisibilityListener.d.ts.map