@koine/browser 2.0.0-beta.2 → 2.0.0-beta.20

package/createStorage.d.ts

@@ -1,54 +1,12 @@
 export type CreateStorageConfig = Record<string, any>;
-/**
- * Utility to create a storage instance to interact with `localStorage` using
- * encrypted (encoded) key/values.
- */
 export declare const createStorage: <T extends CreateStorageConfig>(config: Partial<T>, useSessionStorage?: boolean) => {
-    /**
-     * Get all storage value (it uses `localStorage.get()`).
-     *
-     * Unparseable values with `JSON.parse()` return their value as it is.
-     * On ssr or if the given `key` argument is not found `defaultValue` is
-     * returned, otherwise `null`.
-     */
     get<TKey extends Extract<keyof T, string>>(key: TKey, defaultValue?: T[TKey] | null | undefined): T[TKey] | null;
-    /**
-     * Get all storage values (it uses `localStorage.get()`).
-     *
-     * `undefined` and `null` values are not returned.
-     */
     getAll(defaultValues?: Partial<T> | undefined): T;
-    /**
-     * Set a storage value (it uses `localStorage.set()`).
-     *
-     * Non-string values are stringified with `JSON.stringify()`
-     */
     set<TKey_1 extends Extract<keyof T, string>>(key: TKey_1, value?: T[TKey_1] | undefined): void;
-    /**
-     * Set all given storage values (it uses `localStorage.set()`).
-     *
-     * Non-string values are stringified with `JSON.stringify()`, `undefined`
-     * and `null` values are removed from the storage
-     */
     setMany(newValues: Partial<T>): void;
-    /**
-     * Check if a storage value is _truthy_ (it uses `localStorage.get()`).
-     */
     has<TKey_2 extends Extract<keyof T, string>>(key: TKey_2): any;
-    /**
-     * Remove a storage value (it uses `localStorage.remove()`).
-     */
     remove<TKey_3 extends Extract<keyof T, string>>(key: TKey_3): void;
-    /**
-     * Clear all storage values (it uses `localStorage.remove()`).
-     */
     clear(): void;
-    /**
-     * Watch a storage value changes, this needs to be executed only in browser
-     * context (it uses `window.addEventListener("storage")`).
-     *
-     * Inspiration from [Multi Tab Logout in React — Redux](https://medium.com/front-end-weekly/multi-tab-logout-in-react-redux-4715f071c7fa)
-     */
     watch: <TKey_4 extends keyof T>(keyToWatch: TKey_4, onRemoved?: () => void, onAdded?: () => void) => () => void | undefined;
 };
 export default createStorage;

package/createStorage.js

@@ -1,42 +1,19 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createStorage = void 0;
-var tslib_1 = require("tslib");
-var decode_1 = tslib_1.__importDefault(require("@koine/utils/decode"));
-var encode_1 = tslib_1.__importDefault(require("@koine/utils/encode"));
-var isBrowser_1 = tslib_1.__importDefault(require("@koine/utils/isBrowser"));
-var isNullOrUndefined_1 = tslib_1.__importDefault(require("@koine/utils/isNullOrUndefined"));
-var noop_1 = tslib_1.__importDefault(require("@koine/utils/noop"));
-var on_1 = tslib_1.__importDefault(require("@koine/dom/on"));
-var storage_1 = tslib_1.__importDefault(require("./storage"));
-/**
- * Utility to create a storage instance to interact with `localStorage` using
- * encrypted (encoded) key/values.
- */
-var createStorage = function (config, useSessionStorage) {
-    var client = useSessionStorage ? storage_1.default.s : storage_1.default.l;
+import { __assign } from "tslib";
+import { decode, encode, isBrowser, isNullOrUndefined, noop, } from "@koine/utils";
+import { on } from "@koine/dom";
+import storage from "./storage.js";
+export var createStorage = function (config, useSessionStorage) {
+    var client = useSessionStorage ? storage.s : storage.l;
     var keys = Object.keys(config).reduce(function (map, key) {
         var _a;
-        return (tslib_1.__assign(tslib_1.__assign({}, map), (_a = {}, _a[key] = (0, encode_1.default)(key), _a)));
+        return (__assign(__assign({}, map), (_a = {}, _a[key] = encode(key), _a)));
     }, {});
     return {
-        /**
-         * Get all storage value (it uses `localStorage.get()`).
-         *
-         * Unparseable values with `JSON.parse()` return their value as it is.
-         * On ssr or if the given `key` argument is not found `defaultValue` is
-         * returned, otherwise `null`.
-         */
         get: function (key, defaultValue) {
-            return client.get(keys[key], decode_1.default, defaultValue);
+            return client.get(keys[key], decode, defaultValue);
         },
-        /**
-         * Get all storage values (it uses `localStorage.get()`).
-         *
-         * `undefined` and `null` values are not returned.
-         */
         getAll: function (defaultValues) {
-            if (!isBrowser_1.default) {
+            if (!isBrowser) {
                 if (process.env["NODE_ENV"] !== "production") {
                     console.log("[@koine/utils:createStorage] attempt to use 'getAll' outside of browser.");
                 }
@@ -46,7 +23,7 @@ var createStorage = function (config, useSessionStorage) {
             for (var key in keys) {
                 var value = this.get(key);
                 var defaultValue = defaultValues === null || defaultValues === void 0 ? void 0 : defaultValues[key];
-                if (!(0, isNullOrUndefined_1.default)(value)) {
+                if (!isNullOrUndefined(value)) {
                     all[key] = value;
                 }
                 else if (defaultValue) {
@@ -55,30 +32,19 @@ var createStorage = function (config, useSessionStorage) {
             }
             return all;
         },
-        /**
-         * Set a storage value (it uses `localStorage.set()`).
-         *
-         * Non-string values are stringified with `JSON.stringify()`
-         */
         set: function (key, value) {
-            client.set(keys[key], value, encode_1.default);
+            client.set(keys[key], value, encode);
         },
-        /**
-         * Set all given storage values (it uses `localStorage.set()`).
-         *
-         * Non-string values are stringified with `JSON.stringify()`, `undefined`
-         * and `null` values are removed from the storage
-         */
         setMany: function (newValues) {
             if (process.env["NODE_ENV"] !== "production") {
-                if (!isBrowser_1.default) {
+                if (!isBrowser) {
                     console.log("[@koine/utils:createStorage] attempt to use 'setMany' outside of browser.");
                 }
             }
-            if (isBrowser_1.default) {
+            if (isBrowser) {
                 for (var key in newValues) {
                     var value = newValues[key];
-                    if (!(0, isNullOrUndefined_1.default)(value)) {
+                    if (!isNullOrUndefined(value)) {
                         this.set(key, value);
                     }
                     else {
@@ -87,45 +53,30 @@ var createStorage = function (config, useSessionStorage) {
                 }
             }
         },
-        /**
-         * Check if a storage value is _truthy_ (it uses `localStorage.get()`).
-         */
         has: function (key) {
             return client.has(keys[key]);
         },
-        /**
-         * Remove a storage value (it uses `localStorage.remove()`).
-         */
         remove: function (key) {
             client.remove(keys[key]);
         },
-        /**
-         * Clear all storage values (it uses `localStorage.remove()`).
-         */
         clear: function () {
             if (process.env["NODE_ENV"] !== "production") {
-                if (!isBrowser_1.default) {
+                if (!isBrowser) {
                     console.log("[@koine/utils:createStorage] attempt to use 'clear' outside of browser.");
                 }
             }
-            if (isBrowser_1.default) {
+            if (isBrowser) {
                 for (var key in keys) {
                     client.remove(keys[key]);
                 }
             }
         },
-        /**
-         * Watch a storage value changes, this needs to be executed only in browser
-         * context (it uses `window.addEventListener("storage")`).
-         *
-         * Inspiration from [Multi Tab Logout in React — Redux](https://medium.com/front-end-weekly/multi-tab-logout-in-react-redux-4715f071c7fa)
-         */
         watch: function (keyToWatch, onRemoved, onAdded) {
-            if (!isBrowser_1.default) {
+            if (!isBrowser) {
                 if (process.env["NODE_ENV"] !== "production") {
                     console.log("[@koine/utils:createStorage] attempt to use 'watch' outside of browser.");
                 }
-                return noop_1.default;
+                return noop;
             }
             var handler = function (event) {
                 var key = event.key, oldValue = event.oldValue, newValue = event.newValue;
@@ -138,10 +89,9 @@ var createStorage = function (config, useSessionStorage) {
                     }
                 }
             };
-            var listener = (0, on_1.default)(window, "storage", handler);
+            var listener = on(window, "storage", handler);
             return listener;
         },
     };
 };
-exports.createStorage = createStorage;
-exports.default = exports.createStorage;
+export default createStorage;

package/getZonedDate.d.ts

@@ -1,16 +1,2 @@
-/**
- * It returns a `Date` object from a date `string` adjusted on the user timeZone,
- * if a timeZone is not provided we try getting it from the `Intl` browwser native
- * API. It gracefully falls back returning a _non-timezone-based_ `Date`.
- *
- * @category date
- *
- * @resources
- * - to get the timeZone client side see [this article](https://attacomsian.com/blog/javascript-current-timezone)
- * - for converting the date based on the time zone [date-fns docs](https://date-fns.org/v2.27.0/docs/Time-Zones) and [date-fns-tz docs](https://github.com/marnusw/date-fns-tz)
- *
- * @param dateString A parseable date as string, `Z` is automatically suffixed if not present to correctly get time zone based time from a UTC date.
- * @param timeZone Optionally pass a timeZone (e.g. from user preference or from the server), it falls back trying to read it from the `Intl` browwser native API.
- */
 export declare function getZonedDate(dateString?: string, timeZone?: string): Date;
 export default getZonedDate;

package/getZonedDate.js

@@ -1,28 +1,10 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getZonedDate = void 0;
-var tslib_1 = require("tslib");
-var utcToZonedTime_1 = tslib_1.__importDefault(require("date-fns-tz/utcToZonedTime"));
-var isBrowser_1 = tslib_1.__importDefault(require("@koine/utils/isBrowser"));
-/**
- * It returns a `Date` object from a date `string` adjusted on the user timeZone,
- * if a timeZone is not provided we try getting it from the `Intl` browwser native
- * API. It gracefully falls back returning a _non-timezone-based_ `Date`.
- *
- * @category date
- *
- * @resources
- * - to get the timeZone client side see [this article](https://attacomsian.com/blog/javascript-current-timezone)
- * - for converting the date based on the time zone [date-fns docs](https://date-fns.org/v2.27.0/docs/Time-Zones) and [date-fns-tz docs](https://github.com/marnusw/date-fns-tz)
- *
- * @param dateString A parseable date as string, `Z` is automatically suffixed if not present to correctly get time zone based time from a UTC date.
- * @param timeZone Optionally pass a timeZone (e.g. from user preference or from the server), it falls back trying to read it from the `Intl` browwser native API.
- */
-function getZonedDate(dateString, timeZone) {
+import utcToZonedTime from "date-fns-tz/utcToZonedTime";
+import { isBrowser } from "@koine/utils";
+export function getZonedDate(dateString, timeZone) {
     if (dateString === void 0) { dateString = ""; }
     if (!dateString.endsWith("Z"))
         dateString += "Z";
-    if (!timeZone && isBrowser_1.default) {
+    if (!timeZone && isBrowser) {
         try {
             timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
         }
@@ -30,13 +12,10 @@ function getZonedDate(dateString, timeZone) {
             if (process.env["NODE_ENV"] !== "production") {
                 console.warn("[@koine/utils:getZonedDate] failed reading timeZone, error", e);
             }
-            // no need to do anything here, it just means `Intl` failed, probably
-            // because the browser does not support it
         }
     }
     return timeZone
-        ? (0, utcToZonedTime_1.default)(new Date(dateString), timeZone)
+        ? utcToZonedTime(new Date(dateString), timeZone)
         : new Date(dateString);
 }
-exports.getZonedDate = getZonedDate;
-exports.default = getZonedDate;
+export default getZonedDate;

package/gtagPageview.d.ts

@@ -3,8 +3,5 @@ export type GtmPageviewArgs = [
     page_title?: string,
     page_location?: string
 ];
-/**
- * @category analytics-google
- */
 export declare const gtagPageview: (page_path?: string | undefined, page_title?: string | undefined, page_location?: string | undefined) => void;
 export default gtagPageview;

package/gtagPageview.js

@@ -1,35 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.gtagPageview = void 0;
-var tslib_1 = require("tslib");
-var isUndefined_1 = tslib_1.__importDefault(require("@koine/utils/isUndefined"));
-/**
- * @category analytics-google
- */
-var gtagPageview = function () {
+import { isUndefined } from "@koine/utils";
+export var gtagPageview = function () {
     var args = [];
     for (var _i = 0; _i < arguments.length; _i++) {
         args[_i] = arguments[_i];
     }
-    if (!(0, isUndefined_1.default)(window) && !(0, isUndefined_1.default)(window.gtag)) {
+    if (!isUndefined(window) && !isUndefined(window.gtag)) {
         window.gtag("event", "page_view", {
             page_path: args[0] || location.pathname,
             page_title: args[1] || document.title,
             page_location: args[2] || location.href,
-            // send_to: '<GA_MEASUREMENT_ID>'
         });
     }
 };
-exports.gtagPageview = gtagPageview;
-exports.default = exports.gtagPageview;
-// export type GtmEventArgs = [
-//   eventCategory?: string,
-//   eventAction?: string,
-//   eventLabel?: string,
-//   eventValue?: string
-// ];
-// export const event = (...args: GtmEventArgs) => {
-//   if (!isUndefined(window) && !isUndefined(window.gtag)) {
-//     window.gtag("send", "event", ...args);
-//   }
-// };
+export default gtagPageview;

package/index.d.ts

@@ -1,15 +1,17 @@
-export { createStorage, type CreateStorageConfig } from "./createStorage";
-export { getZonedDate } from "./getZonedDate";
-export { gtagPageview, type GtmPageviewArgs } from "./gtagPageview";
-export { isIE } from "./isIE";
-export { isMobile } from "./isMobile";
-export { navigateToHash } from "./navigateToHash";
-export { navigateToHashParams } from "./navigateToHashParams";
-export { navigateToMergedHashParams } from "./navigateToMergedHashParams";
-export { navigateToMergedParams } from "./navigateToMergedParams";
-export { navigateToParams } from "./navigateToParams";
-export { navigateToUrl } from "./navigateToUrl";
-export { navigateWithoutUrlParam } from "./navigateWithoutUrlParam";
-export { redirectTo } from "./redirectTo";
-export { storage } from "./storage";
-export { storageClient, type StorageClientConfig } from "./storageClient";
+export { createStorage, type CreateStorageConfig } from "./createStorage.js";
+export { getZonedDate } from "./getZonedDate.js";
+export { gtagPageview, type GtmPageviewArgs } from "./gtagPageview.js";
+export { isIE } from "./isIE.js";
+export { isMobile } from "./isMobile.js";
+export { listenUrlSearch } from "./listenUrlSearch.js";
+export { listenUrlSearchParams } from "./listenUrlSearchParams.js";
+export { navigateToHash } from "./navigateToHash.js";
+export { navigateToHashParams } from "./navigateToHashParams.js";
+export { navigateToMergedHashParams } from "./navigateToMergedHashParams.js";
+export { navigateToMergedParams } from "./navigateToMergedParams.js";
+export { navigateToParams } from "./navigateToParams.js";
+export { navigateToUrl } from "./navigateToUrl.js";
+export { navigateWithoutUrlParam } from "./navigateWithoutUrlParam.js";
+export { redirectTo } from "./redirectTo.js";
+export { storage } from "./storage.js";
+export { storageClient, type StorageClientConfig } from "./storageClient.js";

package/index.js

@@ -1,33 +1,17 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.storageClient = exports.storage = exports.redirectTo = exports.navigateWithoutUrlParam = exports.navigateToUrl = exports.navigateToParams = exports.navigateToMergedParams = exports.navigateToMergedHashParams = exports.navigateToHashParams = exports.navigateToHash = exports.isMobile = exports.isIE = exports.gtagPageview = exports.getZonedDate = exports.createStorage = void 0;
-var createStorage_1 = require("./createStorage");
-Object.defineProperty(exports, "createStorage", { enumerable: true, get: function () { return createStorage_1.createStorage; } });
-var getZonedDate_1 = require("./getZonedDate");
-Object.defineProperty(exports, "getZonedDate", { enumerable: true, get: function () { return getZonedDate_1.getZonedDate; } });
-var gtagPageview_1 = require("./gtagPageview");
-Object.defineProperty(exports, "gtagPageview", { enumerable: true, get: function () { return gtagPageview_1.gtagPageview; } });
-var isIE_1 = require("./isIE");
-Object.defineProperty(exports, "isIE", { enumerable: true, get: function () { return isIE_1.isIE; } });
-var isMobile_1 = require("./isMobile");
-Object.defineProperty(exports, "isMobile", { enumerable: true, get: function () { return isMobile_1.isMobile; } });
-var navigateToHash_1 = require("./navigateToHash");
-Object.defineProperty(exports, "navigateToHash", { enumerable: true, get: function () { return navigateToHash_1.navigateToHash; } });
-var navigateToHashParams_1 = require("./navigateToHashParams");
-Object.defineProperty(exports, "navigateToHashParams", { enumerable: true, get: function () { return navigateToHashParams_1.navigateToHashParams; } });
-var navigateToMergedHashParams_1 = require("./navigateToMergedHashParams");
-Object.defineProperty(exports, "navigateToMergedHashParams", { enumerable: true, get: function () { return navigateToMergedHashParams_1.navigateToMergedHashParams; } });
-var navigateToMergedParams_1 = require("./navigateToMergedParams");
-Object.defineProperty(exports, "navigateToMergedParams", { enumerable: true, get: function () { return navigateToMergedParams_1.navigateToMergedParams; } });
-var navigateToParams_1 = require("./navigateToParams");
-Object.defineProperty(exports, "navigateToParams", { enumerable: true, get: function () { return navigateToParams_1.navigateToParams; } });
-var navigateToUrl_1 = require("./navigateToUrl");
-Object.defineProperty(exports, "navigateToUrl", { enumerable: true, get: function () { return navigateToUrl_1.navigateToUrl; } });
-var navigateWithoutUrlParam_1 = require("./navigateWithoutUrlParam");
-Object.defineProperty(exports, "navigateWithoutUrlParam", { enumerable: true, get: function () { return navigateWithoutUrlParam_1.navigateWithoutUrlParam; } });
-var redirectTo_1 = require("./redirectTo");
-Object.defineProperty(exports, "redirectTo", { enumerable: true, get: function () { return redirectTo_1.redirectTo; } });
-var storage_1 = require("./storage");
-Object.defineProperty(exports, "storage", { enumerable: true, get: function () { return storage_1.storage; } });
-var storageClient_1 = require("./storageClient");
-Object.defineProperty(exports, "storageClient", { enumerable: true, get: function () { return storageClient_1.storageClient; } });
+export { createStorage } from "./createStorage.js";
+export { getZonedDate } from "./getZonedDate.js";
+export { gtagPageview } from "./gtagPageview.js";
+export { isIE } from "./isIE.js";
+export { isMobile } from "./isMobile.js";
+export { listenUrlSearch } from "./listenUrlSearch.js";
+export { listenUrlSearchParams } from "./listenUrlSearchParams.js";
+export { navigateToHash } from "./navigateToHash.js";
+export { navigateToHashParams } from "./navigateToHashParams.js";
+export { navigateToMergedHashParams } from "./navigateToMergedHashParams.js";
+export { navigateToMergedParams } from "./navigateToMergedParams.js";
+export { navigateToParams } from "./navigateToParams.js";
+export { navigateToUrl } from "./navigateToUrl.js";
+export { navigateWithoutUrlParam } from "./navigateWithoutUrlParam.js";
+export { redirectTo } from "./redirectTo.js";
+export { storage } from "./storage.js";
+export { storageClient } from "./storageClient.js";

package/isIE.d.ts

@@ -1,7 +1,2 @@
-/**
- * @category detect
- * @category is
- * @see https://stackoverflow.com/a/21712356/12285349
- */
 export declare function isIE(ssrValue?: boolean): boolean;
 export default isIE;

package/isIE.js

@@ -1,16 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isIE = void 0;
-var tslib_1 = require("tslib");
-var isServer_1 = tslib_1.__importDefault(require("@koine/utils/isServer"));
-/**
- * @category detect
- * @category is
- * @see https://stackoverflow.com/a/21712356/12285349
- */
-function isIE(ssrValue) {
+import { isServer } from "@koine/utils";
+export function isIE(ssrValue) {
     if (ssrValue === void 0) { ssrValue = true; }
-    if (isServer_1.default) {
+    if (isServer) {
         return ssrValue;
     }
     var ua = window.navigator.userAgent;
@@ -19,5 +10,4 @@ function isIE(ssrValue) {
     }
     return false;
 }
-exports.isIE = isIE;
-exports.default = isIE;
+export default isIE;

package/isMobile.d.ts

@@ -1,7 +1,2 @@
-/**
- * @category detect
- * @category is
- * @see https://stackoverflow.com/a/3540295
- */
 export declare function isMobile(ssrValue?: boolean): boolean;
 export default isMobile;

package/isMobile.js

@@ -1,21 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isMobile = void 0;
-var tslib_1 = require("tslib");
-var isServer_1 = tslib_1.__importDefault(require("@koine/utils/isServer"));
-/**
- * @category detect
- * @category is
- * @see https://stackoverflow.com/a/3540295
- */
-function isMobile(ssrValue) {
+import { isServer } from "@koine/utils";
+export function isMobile(ssrValue) {
     if (ssrValue === void 0) { ssrValue = true; }
-    if (isServer_1.default) {
+    if (isServer) {
         return ssrValue;
     }
     return /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(window.navigator.userAgent);
-    // return /(android|bb\d+|meego).+mobile|avantgo|bada\/|blackberry|blazer|compal|elaine|fennec|hiptop|iemobile|ip(hone|od)|ipad|iris|kindle|Android|Silk|lge |maemo|midp|mmp|netfront|opera m(ob|in)i|palm( os)?|phone|p(ixi|re)\/|plucker|pocket|psp|series(4|6)0|symbian|treo|up\.(browser|link)|vodafone|wap|windows (ce|phone)|xda|xiino/i.test(navigator.userAgent)
-    //   || /1207|6310|6590|3gso|4thp|50[1-6]i|770s|802s|a wa|abac|ac(er|oo|s\-)|ai(ko|rn)|al(av|ca|co)|amoi|an(ex|ny|yw)|aptu|ar(ch|go)|as(te|us)|attw|au(di|\-m|r |s )|avan|be(ck|ll|nq)|bi(lb|rd)|bl(ac|az)|br(e|v)w|bumb|bw\-(n|u)|c55\/|capi|ccwa|cdm\-|cell|chtm|cldc|cmd\-|co(mp|nd)|craw|da(it|ll|ng)|dbte|dc\-s|devi|dica|dmob|do(c|p)o|ds(12|\-d)|el(49|ai)|em(l2|ul)|er(ic|k0)|esl8|ez([4-7]0|os|wa|ze)|fetc|fly(\-|_)|g1 u|g560|gene|gf\-5|g\-mo|go(\.w|od)|gr(ad|un)|haie|hcit|hd\-(m|p|t)|hei\-|hi(pt|ta)|hp( i|ip)|hs\-c|ht(c(\-| |_|a|g|p|s|t)|tp)|hu(aw|tc)|i\-(20|go|ma)|i230|iac( |\-|\/)|ibro|idea|ig01|ikom|im1k|inno|ipaq|iris|ja(t|v)a|jbro|jemu|jigs|kddi|keji|kgt( |\/)|klon|kpt |kwc\-|kyo(c|k)|le(no|xi)|lg( g|\/(k|l|u)|50|54|\-[a-w])|libw|lynx|m1\-w|m3ga|m50\/|ma(te|ui|xo)|mc(01|21|ca)|m\-cr|me(rc|ri)|mi(o8|oa|ts)|mmef|mo(01|02|bi|de|do|t(\-| |o|v)|zz)|mt(50|p1|v )|mwbp|mywa|n10[0-2]|n20[2-3]|n30(0|2)|n50(0|2|5)|n7(0(0|1)|10)|ne((c|m)\-|on|tf|wf|wg|wt)|nok(6|i)|nzph|o2im|op(ti|wv)|oran|owg1|p800|pan(a|d|t)|pdxg|pg(13|\-([1-8]|c))|phil|pire|pl(ay|uc)|pn\-2|po(ck|rt|se)|prox|psio|pt\-g|qa\-a|qc(07|12|21|32|60|\-[2-7]|i\-)|qtek|r380|r600|raks|rim9|ro(ve|zo)|s55\/|sa(ge|ma|mm|ms|ny|va)|sc(01|h\-|oo|p\-)|sdk\/|se(c(\-|0|1)|47|mc|nd|ri)|sgh\-|shar|sie(\-|m)|sk\-0|sl(45|id)|sm(al|ar|b3|it|t5)|so(ft|ny)|sp(01|h\-|v\-|v )|sy(01|mb)|t2(18|50)|t6(00|10|18)|ta(gt|lk)|tcl\-|tdg\-|tel(i|m)|tim\-|t\-mo|to(pl|sh)|ts(70|m\-|m3|m5)|tx\-9|up(\.b|g1|si)|utst|v400|v750|veri|vi(rg|te)|vk(40|5[0-3]|\-v)|vm40|voda|vulc|vx(52|53|60|61|70|80|81|83|85|98)|w3c(\-| )|webc|whit|wi(g |nc|nw)|wmlb|wonu|x700|yas\-|your|zeto|zte\-/i.test(navigator.userAgent.substr(0,4)
 }
-exports.isMobile = isMobile;
-exports.default = isMobile;
+export default isMobile;

package/listenUrlSearch.d.ts

@@ -0,0 +1,3 @@
+type Handler = (prevLocationSearch: string, newLocationSearch: string) => void;
+export declare function listenUrlSearch(handler: Handler): () => void;
+export default listenUrlSearch;

package/listenUrlSearch.js

@@ -0,0 +1,55 @@
+import { __values } from "tslib";
+import { isBrowser } from "@koine/utils";
+import { on } from "@koine/dom";
+function extendHistoryMethod(fn, runHandlers, before) {
+    return function interceptor() {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        if (before) {
+            runHandlers();
+            return fn.apply(this, args);
+        }
+        var result = fn.apply(this, args);
+        runHandlers();
+        return result;
+    };
+}
+var prevSearch = isBrowser ? location.search : "";
+function runHandlers() {
+    var e_1, _a;
+    var newSearch = location.search;
+    if (newSearch !== prevSearch) {
+        var listeners = history.__.h.values();
+        try {
+            for (var listeners_1 = __values(listeners), listeners_1_1 = listeners_1.next(); !listeners_1_1.done; listeners_1_1 = listeners_1.next()) {
+                var listener = listeners_1_1.value;
+                listener(prevSearch, newSearch);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (listeners_1_1 && !listeners_1_1.done && (_a = listeners_1.return)) _a.call(listeners_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+    }
+    prevSearch = newSearch;
+}
+export function listenUrlSearch(handler) {
+    if (!history.__) {
+        history.pushState = extendHistoryMethod(history.pushState, runHandlers);
+        history.replaceState = extendHistoryMethod(history.replaceState, runHandlers);
+        on(window, "popstate", runHandlers);
+        history.__ = { h: new Set() };
+    }
+    if (!history.__.h.has(handler)) {
+        history.__.h.add(handler);
+    }
+    return function () {
+        history.__.h.delete(handler);
+    };
+}
+export default listenUrlSearch;

package/listenUrlSearchParams.d.ts

@@ -0,0 +1,2 @@
+export declare const listenUrlSearchParams: (paramName: string, handler: (paramNewValue: string | null) => void) => () => void;
+export default listenUrlSearchParams;

package/listenUrlSearchParams.js

@@ -0,0 +1,12 @@
+import listenUrlSearch from "./listenUrlSearch.js";
+export var listenUrlSearchParams = function (paramName, handler) {
+    return listenUrlSearch(function (prevSearch, newSearch) {
+        var prevParams = new URLSearchParams(prevSearch);
+        var newParams = new URLSearchParams(newSearch);
+        var newValue = newParams.get(paramName);
+        if (prevParams.get(paramName) !== newValue) {
+            handler(newValue);
+        }
+    });
+};
+export default listenUrlSearchParams;

package/navigateToHash.d.ts

@@ -1,8 +1,2 @@
-/**
- * It updates the browser's location hash by replacing the history state.
- * The non-silent standard way would simply be `location.hash = "#new-hash"`
- *
- * @category location
- */
 export declare function navigateToHash(hash?: string): void;
 export default navigateToHash;

package/navigateToHash.js

@@ -1,18 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.navigateToHash = void 0;
-var tslib_1 = require("tslib");
-var navigateToUrl_1 = tslib_1.__importDefault(require("./navigateToUrl"));
-/**
- * It updates the browser's location hash by replacing the history state.
- * The non-silent standard way would simply be `location.hash = "#new-hash"`
- *
- * @category location
- */
-function navigateToHash(hash) {
+import navigateToUrl from "./navigateToUrl.js";
+export function navigateToHash(hash) {
     if (hash === void 0) { hash = ""; }
     var pathname = location.pathname, search = location.search;
-    (0, navigateToUrl_1.default)(pathname + (search ? "?" + search : "") + (hash ? "#" + hash : ""), true);
+    navigateToUrl(pathname + (search ? "?" + search : "") + (hash ? "#" + hash : ""), true);
 }
-exports.navigateToHash = navigateToHash;
-exports.default = navigateToHash;
+export default navigateToHash;

package/navigateToHashParams.d.ts

@@ -1,9 +1,3 @@
-import type { AnyQueryParams } from "@koine/utils/location";
-/**
- * It updates the `location.hash` with the given query params, it uses `location.hash`
- * if a second argument `hash` is not provded
- *
- * @category location
- */
+import { type AnyQueryParams } from "@koine/utils";
 export declare function navigateToHashParams(params?: string | AnyQueryParams, hash?: string): string;
 export default navigateToHashParams;