@koine/browser 2.0.0-beta.7 → 2.0.0-beta.71

package/README.md

@@ -1 +1 @@
-# @koine/browser
+# @koine/i18n

package/createStorage.d.ts

@@ -1,54 +1,11 @@
 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`.
-     */
+export declare let createStorage: <T extends CreateStorageConfig>(config: Partial<T>, useSessionStorage?: boolean) => {
     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/getZonedDate.d.ts

@@ -1,16 +1 @@
-/**
- * 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;
+export declare let getZonedDate: (dateString?: string, timeZone?: string) => Date;

package/gtag.d.ts

@@ -0,0 +1 @@
+export declare let gtag: <T extends unknown[]>(...args: T) => void;

package/gtagPageview.d.ts

@@ -3,8 +3,4 @@ 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;
+export declare let gtagPageview: (page_path?: string | undefined, page_title?: string | undefined, page_location?: string | undefined) => void;

package/index.cjs.d.ts

@@ -0,0 +1 @@
+export * from "./index";

package/index.cjs.default.js

@@ -0,0 +1 @@
+exports._default = require('./index.cjs.js').default;

package/index.cjs.js

@@ -0,0 +1,61 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils = require('@koine/utils');
+var dom = require('@koine/dom');
+
+let t$1={g:"getItem",s:"setItem",r:"removeItem"};let storageClient=s=>{let r=(o,r,l)=>utils.isBrowser?window[s?"sessionStorage":"localStorage"][t$1[o]](r,l):()=>{"development"===process.env.NODE_ENV&&console.warn(`[@koine/utils:storageClient]: ${s?"sessionStorage":"localStorage"} does not exists outside of browser.`);};return {get:(o,t,s)=>{let l=s??null;if("development"!==process.env.NODE_ENV||utils.isBrowser||console.log(`[@koine/utils:storage] called 'get' outside of browser with default value '${JSON.stringify(s)}'.`),utils.isBrowser){let e=r("g",o);if(e){e=t?t(e):e;try{let o=JSON.parse(e);o&&(l=o);}catch(o){l=e;}}}return l},set:(t,s,l=e=>e)=>{if("development"!==process.env.NODE_ENV||utils.isBrowser||console.log("[@koine/utils:storage] called 'set' outside of browser does not work."),utils.isBrowser)try{let e=l(utils.isString(s)?s:JSON.stringify(s));r("s",t,e);}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:createStorage]: 'set' error.",e);}},remove:o=>{if("development"!==process.env.NODE_ENV||utils.isBrowser||console.log("[@koine/utils:storage] called 'remove' outside of browser does not work."),utils.isBrowser)try{r("r",o);}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:createStorage]: 'remove' error.",e);}},has:(o,t)=>{let s=t??!1;return "development"!==process.env.NODE_ENV||utils.isBrowser||console.log(`[@koine/utils:storage] called 'has' outside of browser with default value '${JSON.stringify(t)}'.`),utils.isBrowser&&(s=r("g",o)??!1),s}}};
+
+let storage={l:storageClient(),s:storageClient(!0)};
+
+let createStorage=(n,a)=>{let c=a?storage.s:storage.l,m=Object.keys(n).reduce((e,o)=>({...e,[o]:utils.encode(o)}),{});return {get:(t,o)=>c.get(m[t],utils.decode,o),getAll(e){if(!utils.isBrowser)return "development"===process.env.NODE_ENV&&console.log("[@koine/utils:createStorage] attempt to use 'getAll' outside of browser."),{};let t={};for(let o in m){let s=this.get(o),l=e?.[o];utils.isNullOrUndefined(s)?l&&(t[o]=l):t[o]=s;}return t},set(e,o){c.set(m[e],o,utils.encode);},setMany(e){if("development"!==process.env.NODE_ENV||utils.isBrowser||console.log("[@koine/utils:createStorage] attempt to use 'setMany' outside of browser."),utils.isBrowser)for(let t in e){let o=e[t];utils.isNullOrUndefined(o)?this.remove(t):this.set(t,o);}},has:e=>c.has(m[e]),remove(e){c.remove(m[e]);},clear(){if("development"!==process.env.NODE_ENV||utils.isBrowser||console.log("[@koine/utils:createStorage] attempt to use 'clear' outside of browser."),utils.isBrowser)for(let e in m)c.remove(m[e]);},watch:(e,t,r)=>utils.isBrowser?dom.on(window,"storage",o=>{let{key:s,oldValue:l,newValue:i}=o;s===m[e]&&(l&&!i?t?.():!l&&i&&r?.());}):("development"===process.env.NODE_ENV&&console.log("[@koine/utils:createStorage] attempt to use 'watch' outside of browser."),utils.noop)}};
+
+let t=(e,t)=>e;let getZonedDate=(o="",n)=>{if(o.endsWith("Z")||(o+="Z"),!n&&utils.isBrowser)try{n=Intl.DateTimeFormat().resolvedOptions().timeZone;}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/browser:getZonedDate] failed reading timeZone, error",e);}return n?t(new Date(o)):new Date(o)};
+
+let gtag=(...g)=>{utils.isUndefined(window)||utils.isUndefined(window.gtag)?utils.noop():window.gtag(...g);};
+
+let gtagPageview=(...t)=>gtag("event","page_view",{page_path:t[0]||location.pathname,page_title:t[1]||document.title,page_location:t[2]||location.href});
+
+let isIE=(i=!0)=>{if(utils.isServer)return i;let r=window.navigator.userAgent;return !!(r.indexOf("MSIE ")>0||r.indexOf("Trident/")>0)};
+
+let isMobile=(e=!0)=>utils.isServer?e:/Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(window.navigator.userAgent);
+
+let o=(t,e,o)=>function(...r){if(o)return e(),t.apply(this,r);let i=t.apply(this,r);return e(),i},r=utils.isBrowser?location.search:"",i=()=>{let t=location.search;if(t!==r)for(let e of history.__.h.values())e(r,t);r=t;};let listenUrlSearch=t=>(history.__||(history.pushState=o(history.pushState,i),history.replaceState=o(history.replaceState,i),dom.on(window,"popstate",i),history.__={h:new Set}),history.__.h.has(t)||history.__.h.add(t),()=>{history.__.h.delete(t);});
+
+let listenUrlSearchParams=(r,a)=>listenUrlSearch((e,t)=>{let l=new URLSearchParams(e),m=new URLSearchParams(t).get(r);l.get(r)!==m&&a(m);});
+
+let navigateToUrl=(t="",e)=>{t&&history[e?"replaceState":"pushState"](history.state,"",t);};
+
+let navigateToHash=(t="")=>{let{pathname:a,search:e}=location;navigateToUrl(a+(e?"?"+e:"")+(t?"#"+t:""),!0);};
+
+let navigateToHashParams=(a={},e="")=>{let i=!e,r="#/"+utils.getUrlHashPathname(e=e||location.hash)+("string"==typeof a?a:utils.buildUrlQueryString(a));return i&&(location.hash=r),r};
+
+let navigateToMergedHashParams=(e={},t="")=>navigateToHashParams(utils.mergeUrlQueryParams(utils.getUrlHashParams(t),e),t);
+
+let navigateToParams=(a={},e)=>{let i="string"==typeof a?a:utils.buildUrlQueryString(a);return utils.isBrowser&&navigateToUrl(location.pathname+i,e),i};
+
+let navigateToMergedParams=(e={},t)=>navigateToParams(utils.mergeUrlQueryParams(utils.getUrlQueryParams(),e),t);
+
+let navigateWithoutUrlParam=(o,a)=>{let e={},i=utils.getUrlQueryParams();for(let t in i)t!==o&&(e[t]=i[t]);return navigateToParams(e,a)};
+
+let redirectTo=(r,t)=>{if(utils.isBrowser){let o=utils.buildUrlQueryString(t);location.href=r.replace(/\?+$/g,"")+o;}};
+
+exports.createStorage = createStorage;
+exports.getZonedDate = getZonedDate;
+exports.gtag = gtag;
+exports.gtagPageview = gtagPageview;
+exports.isIE = isIE;
+exports.isMobile = isMobile;
+exports.listenUrlSearch = listenUrlSearch;
+exports.listenUrlSearchParams = listenUrlSearchParams;
+exports.navigateToHash = navigateToHash;
+exports.navigateToHashParams = navigateToHashParams;
+exports.navigateToMergedHashParams = navigateToMergedHashParams;
+exports.navigateToMergedParams = navigateToMergedParams;
+exports.navigateToParams = navigateToParams;
+exports.navigateToUrl = navigateToUrl;
+exports.navigateWithoutUrlParam = navigateWithoutUrlParam;
+exports.redirectTo = redirectTo;
+exports.storage = storage;
+exports.storageClient = storageClient;

package/index.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './index.cjs.js';
+export { _default as default } from './index.cjs.default.js';

package/index.d.ts

@@ -1,8 +1,11 @@
 export { createStorage, type CreateStorageConfig } from "./createStorage";
 export { getZonedDate } from "./getZonedDate";
+export { gtag } from "./gtag";
 export { gtagPageview, type GtmPageviewArgs } from "./gtagPageview";
 export { isIE } from "./isIE";
 export { isMobile } from "./isMobile";
+export { listenUrlSearch } from "./listenUrlSearch";
+export { listenUrlSearchParams } from "./listenUrlSearchParams";
 export { navigateToHash } from "./navigateToHash";
 export { navigateToHashParams } from "./navigateToHashParams";
 export { navigateToMergedHashParams } from "./navigateToMergedHashParams";

package/index.esm.js

@@ -0,0 +1,40 @@
+import { isBrowser, isString, encode, decode, isNullOrUndefined, noop, isUndefined, isServer, getUrlHashPathname, buildUrlQueryString, mergeUrlQueryParams, getUrlHashParams, getUrlQueryParams } from '@koine/utils';
+import { on } from '@koine/dom';
+
+let t$1={g:"getItem",s:"setItem",r:"removeItem"};let storageClient=s=>{let r=(o,r,l)=>isBrowser?window[s?"sessionStorage":"localStorage"][t$1[o]](r,l):()=>{"development"===process.env.NODE_ENV&&console.warn(`[@koine/utils:storageClient]: ${s?"sessionStorage":"localStorage"} does not exists outside of browser.`);};return {get:(o,t,s)=>{let l=s??null;if("development"!==process.env.NODE_ENV||isBrowser||console.log(`[@koine/utils:storage] called 'get' outside of browser with default value '${JSON.stringify(s)}'.`),isBrowser){let e=r("g",o);if(e){e=t?t(e):e;try{let o=JSON.parse(e);o&&(l=o);}catch(o){l=e;}}}return l},set:(t,s,l=e=>e)=>{if("development"!==process.env.NODE_ENV||isBrowser||console.log("[@koine/utils:storage] called 'set' outside of browser does not work."),isBrowser)try{let e=l(isString(s)?s:JSON.stringify(s));r("s",t,e);}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:createStorage]: 'set' error.",e);}},remove:o=>{if("development"!==process.env.NODE_ENV||isBrowser||console.log("[@koine/utils:storage] called 'remove' outside of browser does not work."),isBrowser)try{r("r",o);}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/utils:createStorage]: 'remove' error.",e);}},has:(o,t)=>{let s=t??!1;return "development"!==process.env.NODE_ENV||isBrowser||console.log(`[@koine/utils:storage] called 'has' outside of browser with default value '${JSON.stringify(t)}'.`),isBrowser&&(s=r("g",o)??!1),s}}};
+
+let storage={l:storageClient(),s:storageClient(!0)};
+
+let createStorage=(n,a)=>{let c=a?storage.s:storage.l,m=Object.keys(n).reduce((e,o)=>({...e,[o]:encode(o)}),{});return {get:(t,o)=>c.get(m[t],decode,o),getAll(e){if(!isBrowser)return "development"===process.env.NODE_ENV&&console.log("[@koine/utils:createStorage] attempt to use 'getAll' outside of browser."),{};let t={};for(let o in m){let s=this.get(o),l=e?.[o];isNullOrUndefined(s)?l&&(t[o]=l):t[o]=s;}return t},set(e,o){c.set(m[e],o,encode);},setMany(e){if("development"!==process.env.NODE_ENV||isBrowser||console.log("[@koine/utils:createStorage] attempt to use 'setMany' outside of browser."),isBrowser)for(let t in e){let o=e[t];isNullOrUndefined(o)?this.remove(t):this.set(t,o);}},has:e=>c.has(m[e]),remove(e){c.remove(m[e]);},clear(){if("development"!==process.env.NODE_ENV||isBrowser||console.log("[@koine/utils:createStorage] attempt to use 'clear' outside of browser."),isBrowser)for(let e in m)c.remove(m[e]);},watch:(e,t,r)=>isBrowser?on(window,"storage",o=>{let{key:s,oldValue:l,newValue:i}=o;s===m[e]&&(l&&!i?t?.():!l&&i&&r?.());}):("development"===process.env.NODE_ENV&&console.log("[@koine/utils:createStorage] attempt to use 'watch' outside of browser."),noop)}};
+
+let t=(e,t)=>e;let getZonedDate=(o="",n)=>{if(o.endsWith("Z")||(o+="Z"),!n&&isBrowser)try{n=Intl.DateTimeFormat().resolvedOptions().timeZone;}catch(e){"development"===process.env.NODE_ENV&&console.warn("[@koine/browser:getZonedDate] failed reading timeZone, error",e);}return n?t(new Date(o)):new Date(o)};
+
+let gtag=(...g)=>{isUndefined(window)||isUndefined(window.gtag)?noop():window.gtag(...g);};
+
+let gtagPageview=(...t)=>gtag("event","page_view",{page_path:t[0]||location.pathname,page_title:t[1]||document.title,page_location:t[2]||location.href});
+
+let isIE=(i=!0)=>{if(isServer)return i;let r=window.navigator.userAgent;return !!(r.indexOf("MSIE ")>0||r.indexOf("Trident/")>0)};
+
+let isMobile=(e=!0)=>isServer?e:/Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(window.navigator.userAgent);
+
+let o=(t,e,o)=>function(...r){if(o)return e(),t.apply(this,r);let i=t.apply(this,r);return e(),i},r=isBrowser?location.search:"",i=()=>{let t=location.search;if(t!==r)for(let e of history.__.h.values())e(r,t);r=t;};let listenUrlSearch=t=>(history.__||(history.pushState=o(history.pushState,i),history.replaceState=o(history.replaceState,i),on(window,"popstate",i),history.__={h:new Set}),history.__.h.has(t)||history.__.h.add(t),()=>{history.__.h.delete(t);});
+
+let listenUrlSearchParams=(r,a)=>listenUrlSearch((e,t)=>{let l=new URLSearchParams(e),m=new URLSearchParams(t).get(r);l.get(r)!==m&&a(m);});
+
+let navigateToUrl=(t="",e)=>{t&&history[e?"replaceState":"pushState"](history.state,"",t);};
+
+let navigateToHash=(t="")=>{let{pathname:a,search:e}=location;navigateToUrl(a+(e?"?"+e:"")+(t?"#"+t:""),!0);};
+
+let navigateToHashParams=(a={},e="")=>{let i=!e,r="#/"+getUrlHashPathname(e=e||location.hash)+("string"==typeof a?a:buildUrlQueryString(a));return i&&(location.hash=r),r};
+
+let navigateToMergedHashParams=(e={},t="")=>navigateToHashParams(mergeUrlQueryParams(getUrlHashParams(t),e),t);
+
+let navigateToParams=(a={},e)=>{let i="string"==typeof a?a:buildUrlQueryString(a);return isBrowser&&navigateToUrl(location.pathname+i,e),i};
+
+let navigateToMergedParams=(e={},t)=>navigateToParams(mergeUrlQueryParams(getUrlQueryParams(),e),t);
+
+let navigateWithoutUrlParam=(o,a)=>{let e={},i=getUrlQueryParams();for(let t in i)t!==o&&(e[t]=i[t]);return navigateToParams(e,a)};
+
+let redirectTo=(r,t)=>{if(isBrowser){let o=buildUrlQueryString(t);location.href=r.replace(/\?+$/g,"")+o;}};
+
+export { createStorage, getZonedDate, gtag, gtagPageview, isIE, isMobile, listenUrlSearch, listenUrlSearchParams, navigateToHash, navigateToHashParams, navigateToMergedHashParams, navigateToMergedParams, navigateToParams, navigateToUrl, navigateWithoutUrlParam, redirectTo, storage, storageClient };

package/isIE.d.ts

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

package/isMobile.d.ts

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

package/listenUrlSearch.d.ts

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

package/listenUrlSearchParams.d.ts

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

package/navigateToHash.d.ts

@@ -1,8 +1 @@
-/**
- * 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;
+export declare let navigateToHash: (hash?: string) => void;

package/navigateToHashParams.d.ts

@@ -1,9 +1,2 @@
-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
- */
-export declare function navigateToHashParams(params?: string | AnyQueryParams, hash?: string): string;
-export default navigateToHashParams;
+import { type AnyQueryParams } from "@koine/utils";
+export declare let navigateToHashParams: (params?: string | AnyQueryParams, hash?: string) => string;

package/navigateToMergedHashParams.d.ts

@@ -1,8 +1,2 @@
-import type { AnyQueryParams } from "@koine/utils/location";
-/**
- * It updates the "query params" within the `location.hash`, it uses `location`
- *
- * @category location
- */
-export declare function navigateToMergedHashParams(params?: NonNullable<AnyQueryParams>, hash?: string): string;
-export default navigateToMergedHashParams;
+import { type AnyQueryParams } from "@koine/utils";
+export declare let navigateToMergedHashParams: (params?: NonNullable<AnyQueryParams>, hash?: string) => string;

package/navigateToMergedParams.d.ts

@@ -1,9 +1,2 @@
-import type { AnyQueryParams } from "@koine/utils/location";
-/**
- * Merge current URL query parameters with the given ones, it uses `history`.
- *
- * @category location
- * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
- */
-export declare function navigateToMergedParams(params?: NonNullable<AnyQueryParams>, replace?: boolean): string;
-export default navigateToMergedParams;
+import { type AnyQueryParams } from "@koine/utils";
+export declare let navigateToMergedParams: (params?: NonNullable<AnyQueryParams>, replace?: boolean) => string;

package/navigateToParams.d.ts

@@ -1,10 +1,2 @@
-import type { AnyQueryParams } from "@koine/utils/location";
-/**
- * Change current URL query parameters, it uses `history`.
- *
- * @category location
- * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
- * @returns The query string with initial `?`
- */
-export declare function navigateToParams(params?: string | AnyQueryParams, replace?: boolean): string;
-export default navigateToParams;
+import { type AnyQueryParams } from "@koine/utils";
+export declare let navigateToParams: (params?: string | AnyQueryParams, replace?: boolean) => string;

package/navigateToUrl.d.ts

@@ -1,7 +1 @@
-/**
- * It updates the browser's location URL with global `history` object
- *
- * @category location
- */
-export declare function navigateToUrl(url?: string, replace?: boolean): void;
-export default navigateToUrl;
+export declare let navigateToUrl: (url?: string, replace?: boolean) => void;

package/navigateWithoutUrlParam.d.ts

@@ -1,8 +1 @@
-/**
- * Remove URL query parameter, it uses `history`
- *
- * @category location
- * @param replace Replace URL instead of pushing it in the history stack. By default it pushes it.
- */
-export declare function navigateWithoutUrlParam(paramName?: string, replace?: boolean): string;
-export default navigateWithoutUrlParam;
+export declare let navigateWithoutUrlParam: (paramName?: string, replace?: boolean) => string;

package/package.json

@@ -2,12 +2,23 @@
   "name": "@koine/browser",
   "sideEffects": false,
   "dependencies": {
-    "@koine/dom": "2.0.0-beta.7",
-    "@koine/utils": "2.0.0-beta.7"
+    "@koine/dom": "2.0.0-beta.71",
+    "@koine/utils": "2.0.0-beta.71"
   },
-  "module": "./index.mjs",
-  "main": "./index.js",
-  "types": "./index.d.ts",
-  "peerDependencies": {},
-  "version": "2.0.0-beta.7"
-}
+  "peerDependenciesMeta": {
+    "date-fns-tz": {
+      "optional": true
+    }
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "module": "./index.esm.js",
+      "import": "./index.cjs.mjs",
+      "default": "./index.cjs.js"
+    }
+  },
+  "module": "./index.esm.js",
+  "main": "./index.cjs.js",
+  "version": "2.0.0-beta.71"
+}

package/redirectTo.d.ts

@@ -1,9 +1,2 @@
-import type { AnyQueryParams } from "@koine/utils/location";
-/**
- * Redirect to url with params {optionally}, removes eventual trailing question
- * marks from the given URL, it uses `location`
- *
- * @category location
- */
-export declare function redirectTo(url: string, params?: AnyQueryParams): void;
-export default redirectTo;
+import { type AnyQueryParams } from "@koine/utils";
+export declare let redirectTo: (url: string, params?: AnyQueryParams) => void;

package/storage.d.ts

@@ -1,7 +1,4 @@
-/**
- * Storage, for `localStorage` and `sessionStorage`
- */
-export declare const storage: {
+export declare let storage: {
     l: {
         get: <TKey extends string, TValue = any>(key: TKey, transform?: ((value: string) => TValue) | undefined, defaultValue?: TValue | null | undefined) => NonNullable<TValue> | null;
         set: <TKey_1 extends string, TValue_1 = any>(key: TKey_1, value?: TValue_1 | undefined, transform?: (value: any) => string) => void;
@@ -15,4 +12,3 @@ export declare const storage: {
         has: <TKey_3 extends string, TValue_2 = any>(key: TKey_3, defaultValue?: TValue_2 | undefined) => boolean | NonNullable<TValue_2>;
     };
 };
-export default storage;

package/storageClient.d.ts

@@ -1,11 +1,7 @@
 export type StorageClientConfig = Record<string, any>;
-/**
- * Super minifiable `local/session Storage` client creator with SSR safety
- */
-export declare const storageClient: <TConfig extends StorageClientConfig = StorageClientConfig>(useSessionStorage?: boolean) => {
+export declare let storageClient: <TConfig extends StorageClientConfig = StorageClientConfig>(useSessionStorage?: boolean) => {
     get: <TKey extends Extract<keyof TConfig, string>, TValue = TConfig[TKey]>(key: TKey, transform?: ((value: string) => TValue) | undefined, defaultValue?: TValue | null | undefined) => NonNullable<TValue> | null;
     set: <TKey_1 extends Extract<keyof TConfig, string>, TValue_1 = TConfig[TKey_1]>(key: TKey_1, value?: TValue_1 | undefined, transform?: (value: any) => string) => void;
     remove: <TKey_2 extends Extract<keyof TConfig, string>>(key: TKey_2) => void;
     has: <TKey_3 extends Extract<keyof TConfig, string>, TValue_2 = TConfig[TKey_3]>(key: TKey_3, defaultValue?: TValue_2 | undefined) => boolean | NonNullable<TValue_2>;
 };
-export default storageClient;

package/createStorage.js

@@ -1,146 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    createStorage: function() {
-        return createStorage;
-    },
-    default: function() {
-        return _default;
-    }
-});
-const _interop_require_default = require("@swc/helpers/_/_interop_require_default");
-const _decode = /*#__PURE__*/ _interop_require_default._(require("@koine/utils/decode"));
-const _encode = /*#__PURE__*/ _interop_require_default._(require("@koine/utils/encode"));
-const _isBrowser = /*#__PURE__*/ _interop_require_default._(require("@koine/utils/isBrowser"));
-const _isNullOrUndefined = /*#__PURE__*/ _interop_require_default._(require("@koine/utils/isNullOrUndefined"));
-const _noop = /*#__PURE__*/ _interop_require_default._(require("@koine/utils/noop"));
-const _on = /*#__PURE__*/ _interop_require_default._(require("@koine/dom/on"));
-const _storage = /*#__PURE__*/ _interop_require_default._(require("./storage"));
-const createStorage = (config, useSessionStorage)=>{
-    const client = useSessionStorage ? _storage.default.s : _storage.default.l;
-    const keys = Object.keys(config).reduce((map, key)=>({
-            ...map,
-            [key]: (0, _encode.default)(key)
-        }), {});
-    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 (key, defaultValue) {
-            return client.get(keys[key], _decode.default, defaultValue);
-        },
-        /**
-     * Get all storage values (it uses `localStorage.get()`).
-     *
-     * `undefined` and `null` values are not returned.
-     */ getAll (defaultValues) {
-            if (!_isBrowser.default) {
-                if (process.env["NODE_ENV"] !== "production") {
-                    console.log(`[@koine/utils:createStorage] attempt to use 'getAll' outside of browser.`);
-                }
-                return {};
-            }
-            const all = {};
-            for(const key in keys){
-                const value = this.get(key);
-                const defaultValue = defaultValues?.[key];
-                if (!(0, _isNullOrUndefined.default)(value)) {
-                    all[key] = value;
-                } else if (defaultValue) {
-                    all[key] = defaultValue;
-                }
-            }
-            return all;
-        },
-        /**
-     * Set a storage value (it uses `localStorage.set()`).
-     *
-     * Non-string values are stringified with `JSON.stringify()`
-     */ set (key, value) {
-            client.set(keys[key], value, _encode.default);
-        },
-        /**
-     * 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) {
-            if (process.env["NODE_ENV"] !== "production") {
-                if (!_isBrowser.default) {
-                    console.log(`[@koine/utils:createStorage] attempt to use 'setMany' outside of browser.`);
-                }
-            }
-            if (_isBrowser.default) {
-                for(const key in newValues){
-                    const value = newValues[key];
-                    if (!(0, _isNullOrUndefined.default)(value)) {
-                        this.set(key, value);
-                    } else {
-                        this.remove(key);
-                    }
-                }
-            }
-        },
-        /**
-     * Check if a storage value is _truthy_ (it uses `localStorage.get()`).
-     */ has (key) {
-            return client.has(keys[key]);
-        },
-        /**
-     * Remove a storage value (it uses `localStorage.remove()`).
-     */ remove (key) {
-            client.remove(keys[key]);
-        },
-        /**
-     * Clear all storage values (it uses `localStorage.remove()`).
-     */ clear () {
-            if (process.env["NODE_ENV"] !== "production") {
-                if (!_isBrowser.default) {
-                    console.log(`[@koine/utils:createStorage] attempt to use 'clear' outside of browser.`);
-                }
-            }
-            if (_isBrowser.default) {
-                for(const 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: (keyToWatch, onRemoved, onAdded)=>{
-            if (!_isBrowser.default) {
-                if (process.env["NODE_ENV"] !== "production") {
-                    console.log(`[@koine/utils:createStorage] attempt to use 'watch' outside of browser.`);
-                }
-                return _noop.default;
-            }
-            const handler = (event)=>{
-                const { key, oldValue, newValue } = event;
-                if (key === keys[keyToWatch]) {
-                    if (oldValue && !newValue) {
-                        onRemoved?.();
-                    } else if (!oldValue && newValue) {
-                        onAdded?.();
-                    }
-                }
-            };
-            const listener = (0, _on.default)(window, "storage", handler);
-            return listener;
-        }
-    };
-};
-const _default = createStorage;