@koine/browser 2.0.0-beta.13 → 2.0.0-beta.131

package/listenUrlSearch.cjs.js

@@ -0,0 +1,32 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils = require('@koine/utils');
+var dom = require('@koine/dom');
+
+/**
+   * Flag that tells if `history` methods have been replaced
+   *//**
+ * @param prevLocationSearch The previous URL search query e.g. `?myparam=mvalue`
+ * @param newLocationSearch The previous URL search query e.g. `?myparam=mvalue`
+ */let r=(t,e,r)=>function(...o){let i=t.apply(this,o);return e(),i},o=utils.isBrowser?location.search:"",i=()=>{let t=location.search;// console.log(`listenUrlSearch: "${prevSearch}" vs "${newSearch}`);
+if(t!==o)for(let e of history.__.h.values())e(o,t);o=t;};/**
+ * Here we extend and mutate the native `window.history` object so that multiple
+ * scripts can add url change handlers without interfering each other and using
+ * the same single listener.
+ *
+ * @borrows [SO answer](https://stackoverflow.com/a/42727249/1938970)
+ *
+ * @category location
+ * @category navigation
+ * @category events
+ *
+ * @returns A de-register function to remove the handler
+ */let listenUrlSearch=t=>(history.__||(// replace browser's history global methods
+    history.pushState=r(history.pushState,i),history.replaceState=r(history.replaceState,i),// listen native history events
+    dom.on(window,"popstate",i),// extend history object
+    history.__={h:new Set}),history.__.h.has(t)||history.__.h.add(t),()=>{history.__.h.delete(t);});
+
+exports.default = listenUrlSearch;
+exports.listenUrlSearch = listenUrlSearch;

package/listenUrlSearch.cjs.mjs

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

package/listenUrlSearch.d.ts

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

package/listenUrlSearch.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./listenUrlSearch";
+export { default } from "./listenUrlSearch";

package/listenUrlSearch.esm.js

@@ -0,0 +1,27 @@
+import { isBrowser } from '@koine/utils';
+import { on } from '@koine/dom';
+
+/**
+   * Flag that tells if `history` methods have been replaced
+   *//**
+ * @param prevLocationSearch The previous URL search query e.g. `?myparam=mvalue`
+ * @param newLocationSearch The previous URL search query e.g. `?myparam=mvalue`
+ */let r=(t,e,r)=>function(...o){let i=t.apply(this,o);return e(),i},o=isBrowser?location.search:"",i=()=>{let t=location.search;// console.log(`listenUrlSearch: "${prevSearch}" vs "${newSearch}`);
+if(t!==o)for(let e of history.__.h.values())e(o,t);o=t;};/**
+ * Here we extend and mutate the native `window.history` object so that multiple
+ * scripts can add url change handlers without interfering each other and using
+ * the same single listener.
+ *
+ * @borrows [SO answer](https://stackoverflow.com/a/42727249/1938970)
+ *
+ * @category location
+ * @category navigation
+ * @category events
+ *
+ * @returns A de-register function to remove the handler
+ */let listenUrlSearch=t=>(history.__||(// replace browser's history global methods
+    history.pushState=r(history.pushState,i),history.replaceState=r(history.replaceState,i),// listen native history events
+    on(window,"popstate",i),// extend history object
+    history.__={h:new Set}),history.__.h.has(t)||history.__.h.add(t),()=>{history.__.h.delete(t);});
+
+export { listenUrlSearch as default, listenUrlSearch };

package/listenUrlSearchParams.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./listenUrlSearchParams";
+export { default } from "./listenUrlSearchParams";

package/listenUrlSearchParams.cjs.default.js

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

package/listenUrlSearchParams.cjs.js

@@ -0,0 +1,14 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var listenUrlSearch = require('./listenUrlSearch.cjs.js');
+
+/**
+ * @category events
+ * @category navigation
+ * @category events
+ */let listenUrlSearchParams=(r,a)=>listenUrlSearch.listenUrlSearch((e,t)=>{let l=new URLSearchParams(e),s=new URLSearchParams(t).get(r);l.get(r)!==s&&a(s);});
+
+exports.default = listenUrlSearchParams;
+exports.listenUrlSearchParams = listenUrlSearchParams;

package/listenUrlSearchParams.cjs.mjs

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

package/listenUrlSearchParams.d.ts

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

package/listenUrlSearchParams.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./listenUrlSearchParams";
+export { default } from "./listenUrlSearchParams";

package/listenUrlSearchParams.esm.js

@@ -0,0 +1,9 @@
+import { listenUrlSearch } from './listenUrlSearch.esm.js';
+
+/**
+ * @category events
+ * @category navigation
+ * @category events
+ */let listenUrlSearchParams=(r,a)=>listenUrlSearch((e,t)=>{let l=new URLSearchParams(e),s=new URLSearchParams(t).get(r);l.get(r)!==s&&a(s);});
+
+export { listenUrlSearchParams as default, listenUrlSearchParams };

package/navigateToHash.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./navigateToHash";
+export { default } from "./navigateToHash";

package/navigateToHash.cjs.default.js

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

package/navigateToHash.cjs.js

@@ -0,0 +1,15 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var navigateToUrl = require('./navigateToUrl.cjs.js');
+
+/**
+ * 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
+ */let navigateToHash=(t="")=>{let{pathname:o,search:e}=location;navigateToUrl.navigateToUrl(o+(e?"?"+e:"")+(t?"#"+t:""),!0);};
+
+exports.default = navigateToHash;
+exports.navigateToHash = navigateToHash;

package/navigateToHash.cjs.mjs

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

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 declare let navigateToHash: (hash?: string) => void;
 export default navigateToHash;

package/navigateToHash.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./navigateToHash";
+export { default } from "./navigateToHash";

package/navigateToHash.esm.js

@@ -0,0 +1,10 @@
+import { navigateToUrl } from './navigateToUrl.esm.js';
+
+/**
+ * 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
+ */let navigateToHash=(t="")=>{let{pathname:o,search:e}=location;navigateToUrl(o+(e?"?"+e:"")+(t?"#"+t:""),!0);};
+
+export { navigateToHash as default, navigateToHash };

package/navigateToHashParams.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./navigateToHashParams";
+export { default } from "./navigateToHashParams";

package/navigateToHashParams.cjs.default.js

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

package/navigateToHashParams.cjs.js

@@ -0,0 +1,15 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils = require('@koine/utils');
+
+/**
+ * It updates the `location.hash` with the given query params, it uses `location.hash`
+ * if a second argument `hash` is not provded
+ *
+ * @category location
+ */let navigateToHashParams=(o={},e="")=>{let r=!e,i="#/"+utils.getUrlHashPathname(e=e||location.hash)+("string"==typeof o?o:utils.buildUrlQueryString(o));return r&&(location.hash=i),i};
+
+exports.default = navigateToHashParams;
+exports.navigateToHashParams = navigateToHashParams;

package/navigateToHashParams.cjs.mjs

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

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

package/navigateToHashParams.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./navigateToHashParams";
+export { default } from "./navigateToHashParams";

package/navigateToHashParams.esm.js

@@ -0,0 +1,10 @@
+import { getUrlHashPathname, buildUrlQueryString } from '@koine/utils';
+
+/**
+ * It updates the `location.hash` with the given query params, it uses `location.hash`
+ * if a second argument `hash` is not provded
+ *
+ * @category location
+ */let navigateToHashParams=(o={},e="")=>{let r=!e,i="#/"+getUrlHashPathname(e=e||location.hash)+("string"==typeof o?o:buildUrlQueryString(o));return r&&(location.hash=i),i};
+
+export { navigateToHashParams as default, navigateToHashParams };

package/navigateToMergedHashParams.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./navigateToMergedHashParams";
+export { default } from "./navigateToMergedHashParams";

package/navigateToMergedHashParams.cjs.default.js

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

package/navigateToMergedHashParams.cjs.js

@@ -0,0 +1,15 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils = require('@koine/utils');
+var navigateToHashParams = require('./navigateToHashParams.cjs.js');
+
+/**
+ * It updates the "query params" within the `location.hash`, it uses `location`
+ *
+ * @category location
+ */let navigateToMergedHashParams=(o={},t="")=>navigateToHashParams.navigateToHashParams(utils.mergeUrlQueryParams(utils.getUrlHashParams(t),o),t);
+
+exports.default = navigateToMergedHashParams;
+exports.navigateToMergedHashParams = navigateToMergedHashParams;

package/navigateToMergedHashParams.cjs.mjs

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

package/navigateToMergedHashParams.d.ts

@@ -1,8 +1,3 @@
-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;
+import { type AnyQueryParams } from "@koine/utils";
+export declare let navigateToMergedHashParams: (params?: NonNullable<AnyQueryParams>, hash?: string) => string;
 export default navigateToMergedHashParams;

package/navigateToMergedHashParams.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./navigateToMergedHashParams";
+export { default } from "./navigateToMergedHashParams";

package/navigateToMergedHashParams.esm.js

@@ -0,0 +1,10 @@
+import { mergeUrlQueryParams, getUrlHashParams } from '@koine/utils';
+import { navigateToHashParams } from './navigateToHashParams.esm.js';
+
+/**
+ * It updates the "query params" within the `location.hash`, it uses `location`
+ *
+ * @category location
+ */let navigateToMergedHashParams=(o={},t="")=>navigateToHashParams(mergeUrlQueryParams(getUrlHashParams(t),o),t);
+
+export { navigateToMergedHashParams as default, navigateToMergedHashParams };

package/navigateToMergedParams.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./navigateToMergedParams";
+export { default } from "./navigateToMergedParams";

package/navigateToMergedParams.cjs.default.js

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

package/navigateToMergedParams.cjs.js

@@ -0,0 +1,16 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils = require('@koine/utils');
+var navigateToParams = require('./navigateToParams.cjs.js');
+
+/**
+ * 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.
+ */let navigateToMergedParams=(o={},t)=>navigateToParams.navigateToParams(utils.mergeUrlQueryParams(utils.getUrlQueryParams(),o),t);
+
+exports.default = navigateToMergedParams;
+exports.navigateToMergedParams = navigateToMergedParams;

package/navigateToMergedParams.cjs.mjs

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

package/navigateToMergedParams.d.ts

@@ -1,9 +1,3 @@
-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;
+import { type AnyQueryParams } from "@koine/utils";
+export declare let navigateToMergedParams: (params?: NonNullable<AnyQueryParams>, replace?: boolean) => string;
 export default navigateToMergedParams;

package/navigateToMergedParams.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./navigateToMergedParams";
+export { default } from "./navigateToMergedParams";

package/navigateToMergedParams.esm.js

@@ -0,0 +1,11 @@
+import { mergeUrlQueryParams, getUrlQueryParams } from '@koine/utils';
+import { navigateToParams } from './navigateToParams.esm.js';
+
+/**
+ * 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.
+ */let navigateToMergedParams=(o={},t)=>navigateToParams(mergeUrlQueryParams(getUrlQueryParams(),o),t);
+
+export { navigateToMergedParams as default, navigateToMergedParams };

package/navigateToParams.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./navigateToParams";
+export { default } from "./navigateToParams";

package/navigateToParams.cjs.default.js

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

package/navigateToParams.cjs.js

@@ -0,0 +1,17 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils = require('@koine/utils');
+var navigateToUrl = require('./navigateToUrl.cjs.js');
+
+/**
+ * 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 `?`
+ */let navigateToParams=(e={},r)=>{let i="string"==typeof e?e:utils.buildUrlQueryString(e);return utils.isBrowser&&navigateToUrl.navigateToUrl(location.pathname+i,r),i};
+
+exports.default = navigateToParams;
+exports.navigateToParams = navigateToParams;

package/navigateToParams.cjs.mjs

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

package/navigateToParams.d.ts

@@ -1,10 +1,3 @@
-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;
+import { type AnyQueryParams } from "@koine/utils";
+export declare let navigateToParams: (params?: string | AnyQueryParams, replace?: boolean) => string;
 export default navigateToParams;

package/navigateToParams.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./navigateToParams";
+export { default } from "./navigateToParams";

package/navigateToParams.esm.js

@@ -0,0 +1,12 @@
+import { buildUrlQueryString, isBrowser } from '@koine/utils';
+import { navigateToUrl } from './navigateToUrl.esm.js';
+
+/**
+ * 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 `?`
+ */let navigateToParams=(e={},r)=>{let i="string"==typeof e?e:buildUrlQueryString(e);return isBrowser&&navigateToUrl(location.pathname+i,r),i};
+
+export { navigateToParams as default, navigateToParams };

package/navigateToUrl.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./navigateToUrl";
+export { default } from "./navigateToUrl";

package/navigateToUrl.cjs.default.js

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

package/navigateToUrl.cjs.js

@@ -0,0 +1,12 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * It updates the browser's location URL with global `history` object
+ *
+ * @category location
+ */let navigateToUrl=(t="",e)=>{t&&history[e?"replaceState":"pushState"](history.state,"",t);};
+
+exports.default = navigateToUrl;
+exports.navigateToUrl = navigateToUrl;

package/navigateToUrl.cjs.mjs

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

package/navigateToUrl.d.ts

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

package/navigateToUrl.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./navigateToUrl";
+export { default } from "./navigateToUrl";

package/navigateToUrl.esm.js

@@ -0,0 +1,7 @@
+/**
+ * It updates the browser's location URL with global `history` object
+ *
+ * @category location
+ */let navigateToUrl=(t="",e)=>{t&&history[e?"replaceState":"pushState"](history.state,"",t);};
+
+export { navigateToUrl as default, navigateToUrl };

package/navigateWithoutUrlParam.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./navigateWithoutUrlParam";
+export { default } from "./navigateWithoutUrlParam";

package/navigateWithoutUrlParam.cjs.default.js

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

package/navigateWithoutUrlParam.cjs.js

@@ -0,0 +1,16 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils = require('@koine/utils');
+var navigateToParams = require('./navigateToParams.cjs.js');
+
+/**
+ * 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.
+ */let navigateWithoutUrlParam=(a,e)=>{let o={},i=utils.getUrlQueryParams();for(let t in i)t!==a&&(o[t]=i[t]);return navigateToParams.navigateToParams(o,e)};
+
+exports.default = navigateWithoutUrlParam;
+exports.navigateWithoutUrlParam = navigateWithoutUrlParam;

package/navigateWithoutUrlParam.cjs.mjs

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

package/navigateWithoutUrlParam.d.ts

@@ -1,8 +1,2 @@
-/**
- * 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 declare let navigateWithoutUrlParam: (paramName?: string, replace?: boolean) => string;
 export default navigateWithoutUrlParam;

package/navigateWithoutUrlParam.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./navigateWithoutUrlParam";
+export { default } from "./navigateWithoutUrlParam";

package/navigateWithoutUrlParam.esm.js

@@ -0,0 +1,11 @@
+import { getUrlQueryParams } from '@koine/utils';
+import { navigateToParams } from './navigateToParams.esm.js';
+
+/**
+ * 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.
+ */let navigateWithoutUrlParam=(a,e)=>{let o={},i=getUrlQueryParams();for(let t in i)t!==a&&(o[t]=i[t]);return navigateToParams(o,e)};
+
+export { navigateWithoutUrlParam as default, navigateWithoutUrlParam };