@koine/browser 2.0.0-beta.8 → 2.0.0-beta.80

package/listenUrlSearch.cjs.d.ts

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

package/listenUrlSearch.cjs.default.js

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

package/listenUrlSearch.cjs.js

@@ -0,0 +1,46 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils = require('@koine/utils');
+var dom = require('@koine/dom');
+
+let extendHistoryMethod = (fn, runHandlers, before) => {
+    return function interceptor(...args) {
+        if (before) {
+            runHandlers();
+            return fn.apply(this, args);
+        }
+        const result = fn.apply(this, args);
+        runHandlers();
+        return result;
+    };
+};
+let prevSearch = utils.isBrowser ? location.search : "";
+let runHandlers = () => {
+    const newSearch = location.search;
+    if (newSearch !== prevSearch) {
+        const listeners = history.__.h.values();
+        for (const listener of listeners) {
+            listener(prevSearch, newSearch);
+        }
+    }
+    prevSearch = newSearch;
+};
+let listenUrlSearch = (handler) => {
+    if (!history.__) {
+        history.pushState = extendHistoryMethod(history.pushState, runHandlers);
+        history.replaceState = extendHistoryMethod(history.replaceState, runHandlers);
+        dom.on(window, "popstate", runHandlers);
+        history.__ = { h: new Set() };
+    }
+    if (!history.__.h.has(handler)) {
+        history.__.h.add(handler);
+    }
+    return () => {
+        history.__.h.delete(handler);
+    };
+};
+
+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.js

@@ -0,0 +1,41 @@
+import { isBrowser } from '@koine/utils';
+import { on } from '@koine/dom';
+
+let extendHistoryMethod = (fn, runHandlers, before) => {
+    return function interceptor(...args) {
+        if (before) {
+            runHandlers();
+            return fn.apply(this, args);
+        }
+        const result = fn.apply(this, args);
+        runHandlers();
+        return result;
+    };
+};
+let prevSearch = isBrowser ? location.search : "";
+let runHandlers = () => {
+    const newSearch = location.search;
+    if (newSearch !== prevSearch) {
+        const listeners = history.__.h.values();
+        for (const listener of listeners) {
+            listener(prevSearch, newSearch);
+        }
+    }
+    prevSearch = newSearch;
+};
+let 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 () => {
+        history.__.h.delete(handler);
+    };
+};
+
+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,19 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var listenUrlSearch = require('./listenUrlSearch.cjs.js');
+require('@koine/utils');
+require('@koine/dom');
+
+let listenUrlSearchParams = (paramName, handler) => listenUrlSearch.listenUrlSearch((prevSearch, newSearch) => {
+    const prevParams = new URLSearchParams(prevSearch);
+    const newParams = new URLSearchParams(newSearch);
+    const newValue = newParams.get(paramName);
+    if (prevParams.get(paramName) !== newValue) {
+        handler(newValue);
+    }
+});
+
+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.js

@@ -0,0 +1,14 @@
+import { listenUrlSearch } from './listenUrlSearch.esm.js';
+import '@koine/utils';
+import '@koine/dom';
+
+let listenUrlSearchParams = (paramName, handler) => listenUrlSearch((prevSearch, newSearch) => {
+    const prevParams = new URLSearchParams(prevSearch);
+    const newParams = new URLSearchParams(newSearch);
+    const newValue = newParams.get(paramName);
+    if (prevParams.get(paramName) !== newValue) {
+        handler(newValue);
+    }
+});
+
+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,13 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var navigateToUrl = require('./navigateToUrl.cjs.js');
+
+let navigateToHash = (hash = "") => {
+    const { pathname, search } = location;
+    navigateToUrl.navigateToUrl(pathname + (search ? "?" + search : "") + (hash ? "#" + hash : ""), true);
+};
+
+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.js

@@ -0,0 +1,8 @@
+import { navigateToUrl } from './navigateToUrl.esm.js';
+
+let navigateToHash = (hash = "") => {
+    const { pathname, search } = location;
+    navigateToUrl(pathname + (search ? "?" + search : "") + (hash ? "#" + hash : ""), true);
+};
+
+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,20 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils = require('@koine/utils');
+
+let navigateToHashParams = (params = {}, hash = "") => {
+    const useLocation = !hash;
+    hash = hash || location.hash;
+    const hashQueryLess = utils.getUrlHashPathname(hash);
+    const queryString = typeof params === "string" ? params : utils.buildUrlQueryString(params);
+    const newHash = "#/" + hashQueryLess + queryString;
+    if (useLocation) {
+        location.hash = newHash;
+    }
+    return newHash;
+};
+
+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.js

@@ -0,0 +1,15 @@
+import { getUrlHashPathname, buildUrlQueryString } from '@koine/utils';
+
+let navigateToHashParams = (params = {}, hash = "") => {
+    const useLocation = !hash;
+    hash = hash || location.hash;
+    const hashQueryLess = getUrlHashPathname(hash);
+    const queryString = typeof params === "string" ? params : buildUrlQueryString(params);
+    const newHash = "#/" + hashQueryLess + queryString;
+    if (useLocation) {
+        location.hash = newHash;
+    }
+    return newHash;
+};
+
+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,11 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils = require('@koine/utils');
+var navigateToHashParams = require('./navigateToHashParams.cjs.js');
+
+let navigateToMergedHashParams = (params = {}, hash = "") => navigateToHashParams.navigateToHashParams(utils.mergeUrlQueryParams(utils.getUrlHashParams(hash), params), hash);
+
+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.js

@@ -0,0 +1,6 @@
+import { mergeUrlQueryParams, getUrlHashParams } from '@koine/utils';
+import { navigateToHashParams } from './navigateToHashParams.esm.js';
+
+let navigateToMergedHashParams = (params = {}, hash = "") => navigateToHashParams(mergeUrlQueryParams(getUrlHashParams(hash), params), hash);
+
+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,12 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils = require('@koine/utils');
+var navigateToParams = require('./navigateToParams.cjs.js');
+require('./navigateToUrl.cjs.js');
+
+let navigateToMergedParams = (params = {}, replace) => navigateToParams.navigateToParams(utils.mergeUrlQueryParams(utils.getUrlQueryParams(), params), replace);
+
+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.js

@@ -0,0 +1,7 @@
+import { mergeUrlQueryParams, getUrlQueryParams } from '@koine/utils';
+import { navigateToParams } from './navigateToParams.esm.js';
+import './navigateToUrl.esm.js';
+
+let navigateToMergedParams = (params = {}, replace) => navigateToParams(mergeUrlQueryParams(getUrlQueryParams(), params), replace);
+
+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');
+
+let navigateToParams = (params = {}, replace) => {
+    const queryString = typeof params === "string" ? params : utils.buildUrlQueryString(params);
+    if (utils.isBrowser) {
+        navigateToUrl.navigateToUrl(location.pathname + queryString, replace);
+    }
+    return queryString;
+};
+
+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.js

@@ -0,0 +1,12 @@
+import { buildUrlQueryString, isBrowser } from '@koine/utils';
+import { navigateToUrl } from './navigateToUrl.esm.js';
+
+let navigateToParams = (params = {}, replace) => {
+    const queryString = typeof params === "string" ? params : buildUrlQueryString(params);
+    if (isBrowser) {
+        navigateToUrl(location.pathname + queryString, replace);
+    }
+    return queryString;
+};
+
+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 });
+
+let navigateToUrl = (url = "", replace) => {
+    if (url) {
+        history[replace ? "replaceState" : "pushState"](history.state, "", url);
+    }
+};
+
+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.js

@@ -0,0 +1,7 @@
+let navigateToUrl = (url = "", replace) => {
+    if (url) {
+        history[replace ? "replaceState" : "pushState"](history.state, "", url);
+    }
+};
+
+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,21 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils = require('@koine/utils');
+var navigateToParams = require('./navigateToParams.cjs.js');
+require('./navigateToUrl.cjs.js');
+
+let navigateWithoutUrlParam = (paramName, replace) => {
+    const params = {};
+    const currentParams = utils.getUrlQueryParams();
+    for (const key in currentParams) {
+        if (key !== paramName) {
+            params[key] = currentParams[key];
+        }
+    }
+    return navigateToParams.navigateToParams(params, replace);
+};
+
+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.js

@@ -0,0 +1,16 @@
+import { getUrlQueryParams } from '@koine/utils';
+import { navigateToParams } from './navigateToParams.esm.js';
+import './navigateToUrl.esm.js';
+
+let navigateWithoutUrlParam = (paramName, replace) => {
+    const params = {};
+    const currentParams = getUrlQueryParams();
+    for (const key in currentParams) {
+        if (key !== paramName) {
+            params[key] = currentParams[key];
+        }
+    }
+    return navigateToParams(params, replace);
+};
+
+export { navigateWithoutUrlParam as default, navigateWithoutUrlParam };