npm - use-navigation-api - Versions diffs - 0.1.0 → 0.3.0 - Mend

use-navigation-api 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

package/dist/index.d.ts +6 -0
package/dist/location/useLocation.d.ts +15 -0
package/dist/location/useLocationWithParam.d.ts +13 -0
package/dist/location/useQueryParam.d.ts +9 -0
package/dist/location/useQueryParams.d.ts +5 -0
package/dist/navigationProvider.d.ts +18 -0
package/dist/use-navigation-api.es.js +645 -0
package/dist/use-navigation-api.umd.js +1 -0
package/dist/useNavigate.d.ts +1 -0
package/dist/util/future.d.ts +11 -0
package/package.json +12 -2
package/src/index.ts +2 -1
package/src/location/useLocation.ts +24 -46
package/src/location/useLocationWithParam.ts +36 -5
package/src/location/useQueryParam.ts +7 -2
package/src/location/useQueryParams.ts +31 -0
package/src/navigationProvider.ts +9 -8
package/src/useNavigate.ts +5 -7
package/eslint.config.js +0 -22
package/tsconfig.app.json +0 -30
package/tsconfig.json +0 -7
package/tsconfig.node.json +0 -26
package/vite.config.ts +0 -28

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+export * from './navigationProvider';
+export * from './useNavigate';
+export * from './location/useQueryParam';
+export * from './location/useQueryParams';
+export * from './location/useLocation';
+export * from './location/useLocationWithParam';

package/dist/location/useLocation.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+export type Location = string;
+export declare function resolveLocation(location: string, base: string): string;
+/**
+ * Returns the current location for the navigation context.
+ */
+export declare function useLocation(): Location;
+/**
+ * Resolves a URL string relative to the current location and returns its parts.
+ */
+export declare function useLocation(url: string, base?: string): Location;
+/**
+ * Returns a location based on the returned url if present, or the modified input argument.
+ * For instance, `useLocation(url => url.searchParams.set("parameter", "value"))` returns the current location with only a single parameter updated.
+ */
+export declare function useLocation(url: (current: URL) => URL | void, base?: string): Location;

package/dist/location/useLocationWithParam.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+/**
+ * returns The current location with the specified parameter set to the provided value or removed if the value === null.
+ * @param param name of the query parameter to set
+ * @param value value to set the parameter to, or `null` to remove any existing value of that parameter
+ * @param base If provided, uses this value instead of the current location.
+ */
+export declare function useLocationWithParam(param: string, value: string | null, base?: string): string;
+/**
+ * returns The current location with the specified parameter set to the provided value or removed if the value === null.
+ * @param params map of parameters to update. null or empty entries will be removed.
+ * @param base If provided, uses this value instead of the current location.
+ */
+export declare function useLocationWithParams(params: Record<string, string | string[] | null>, base?: string): string;

package/dist/location/useQueryParam.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+export declare function parseSearchParams(location?: string): URLSearchParams;
+/**
+ * Returns the first value for a query parameter, or null if it is missing.
+ */
+export declare function useQueryParam(param: string, all?: false): string | null;
+/**
+ * Returns all values for a query parameter when it appears multiple times.
+ */
+export declare function useQueryParam(param: string, all: true): string[];

package/dist/location/useQueryParams.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+export type ParamsMapper<T> = (params: URLSearchParams) => T;
+export declare function mapQueryParams(params: URLSearchParams, keys?: string[]): Record<string, string | string[]>;
+export declare function useQueryParams(): Record<string, string | string[]>;
+export declare function useQueryParams<K extends string>(keys: K[]): Record<K, string | string[]>;
+export declare function useQueryParams<T>(mapper: ParamsMapper<T>): T;

package/dist/navigationProvider.d.ts ADDED Viewed

@@ -0,0 +1,18 @@
+import { Dispatch, FC, ReactNode, SetStateAction } from 'react';
+export type NavigationContextState = {
+    url: string;
+    store: "url" | "hash" | "memory";
+};
+type NavigationContextValue = NavigationContextState & {
+    setState?: Dispatch<SetStateAction<NavigationContextState>>;
+};
+export declare const NavigationContext: import('react').Context<NavigationContextValue>;
+declare function defaultShouldHandle(event: NavigateEvent): boolean;
+type ShouldHandle = typeof defaultShouldHandle;
+export declare const NavigationProvider: FC<{
+    children: ReactNode;
+    store?: "url" | "hash" | "memory";
+    scoped?: boolean;
+    shouldHandle?: ShouldHandle;
+}>;
+export {};

package/dist/use-navigation-api.es.js ADDED Viewed

@@ -0,0 +1,645 @@
+import { createContext, createElement, useContext, useEffect, useMemo, useState } from "react";
+var __create = Object.create, __defProp = Object.defineProperty, __getOwnPropDesc = Object.getOwnPropertyDescriptor, __getOwnPropNames = Object.getOwnPropertyNames, __getProtoOf = Object.getPrototypeOf, __hasOwnProp = Object.prototype.hasOwnProperty, __commonJSMin = (e, t) => () => (t || e((t = { exports: {} }).exports, t), t.exports), __copyProps = (e, t, n, r) => {
+	if (t && typeof t == "object" || typeof t == "function") for (var i = __getOwnPropNames(t), a = 0, o = i.length, u; a < o; a++) u = i[a], !__hasOwnProp.call(e, u) && u !== n && __defProp(e, u, {
+		get: ((e) => t[e]).bind(null, u),
+		enumerable: !(r = __getOwnPropDesc(t, u)) || r.enumerable
+	});
+	return e;
+}, __toESM = (e, t, n) => (n = e == null ? {} : __create(__getProtoOf(e)), __copyProps(t || !e || !e.__esModule ? __defProp(n, "default", {
+	value: e,
+	enumerable: !0
+}) : n, e)), require_uri_all = /* @__PURE__ */ __commonJSMin(((e, t) => {
+	/** @license URI.js v4.4.1 (c) 2011 Gary Court. License: http://github.com/garycourt/uri-js */
+	(function(n, r) {
+		typeof e == "object" && t !== void 0 ? r(e) : typeof define == "function" && define.amd ? define(["exports"], r) : r(n.URI = n.URI || {});
+	})(e, (function(e) {
+		function t() {
+			var e = [...arguments];
+			if (e.length > 1) {
+				e[0] = e[0].slice(0, -1);
+				for (var t = e.length - 1, n = 1; n < t; ++n) e[n] = e[n].slice(1, -1);
+				return e[t] = e[t].slice(1), e.join("");
+			} else return e[0];
+		}
+		function n(e) {
+			return "(?:" + e + ")";
+		}
+		function r(e) {
+			return e === void 0 ? "undefined" : e === null ? "null" : Object.prototype.toString.call(e).split(" ").pop().split("]").shift().toLowerCase();
+		}
+		function i(e) {
+			return e.toUpperCase();
+		}
+		function a(e) {
+			return e == null ? [] : e instanceof Array ? e : typeof e.length != "number" || e.split || e.setInterval || e.call ? [e] : Array.prototype.slice.call(e);
+		}
+		function o(e, t) {
+			var n = e;
+			if (t) for (var r in t) n[r] = t[r];
+			return n;
+		}
+		function s(e) {
+			var r = "[A-Za-z]", i = "[0-9]", a = t(i, "[A-Fa-f]"), o = n(n("%[EFef]" + a + "%" + a + a + "%" + a + a) + "|" + n("%[89A-Fa-f]" + a + "%" + a + a) + "|" + n("%" + a + a)), s = "[\\:\\/\\?\\#\\[\\]\\@]", c = "[\\!\\$\\&\\'\\(\\)\\*\\+\\,\\;\\=]", l = t(s, c), u = e ? "[\\xA0-\\u200D\\u2010-\\u2029\\u202F-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFEF]" : "[]", d = e ? "[\\uE000-\\uF8FF]" : "[]", f = t(r, i, "[\\-\\.\\_\\~]", u), p = n(r + t(r, i, "[\\+\\-\\.]") + "*"), m = n(n(o + "|" + t(f, c, "[\\:]")) + "*");
+			n(n("25[0-5]") + "|" + n("2[0-4]" + i) + "|" + n("1" + i + i) + "|" + n("[1-9]" + i) + "|" + i);
+			var h = n(n("25[0-5]") + "|" + n("2[0-4]" + i) + "|" + n("1" + i + i) + "|" + n("0?[1-9]" + i) + "|0?0?" + i), g = n(h + "\\." + h + "\\." + h + "\\." + h), _ = n(a + "{1,4}"), v = n(n(_ + "\\:" + _) + "|" + g), y = n([
+				n(n(_ + "\\:") + "{6}" + v),
+				n("\\:\\:" + n(_ + "\\:") + "{5}" + v),
+				n(n(_) + "?\\:\\:" + n(_ + "\\:") + "{4}" + v),
+				n(n(n(_ + "\\:") + "{0,1}" + _) + "?\\:\\:" + n(_ + "\\:") + "{3}" + v),
+				n(n(n(_ + "\\:") + "{0,2}" + _) + "?\\:\\:" + n(_ + "\\:") + "{2}" + v),
+				n(n(n(_ + "\\:") + "{0,3}" + _) + "?\\:\\:" + _ + "\\:" + v),
+				n(n(n(_ + "\\:") + "{0,4}" + _) + "?\\:\\:" + v),
+				n(n(n(_ + "\\:") + "{0,5}" + _) + "?\\:\\:" + _),
+				n(n(n(_ + "\\:") + "{0,6}" + _) + "?\\:\\:")
+			].join("|")), b = n(n(f + "|" + o) + "+");
+			n(y + "\\%25" + b);
+			var x = n(y + n("\\%25|\\%(?!" + a + "{2})") + b), S = n("[vV]" + a + "+\\." + t(f, c, "[\\:]") + "+"), C = n("\\[" + n(x + "|" + y + "|" + S) + "\\]"), w = n(n(o + "|" + t(f, c)) + "*"), T = n(C + "|" + g + "(?!" + w + ")|" + w), E = n(i + "*"), D = n(n(m + "@") + "?" + T + n("\\:" + E) + "?"), O = n(o + "|" + t(f, c, "[\\:\\@]")), k = n(O + "*"), A = n(O + "+"), ee = n(n(o + "|" + t(f, c, "[\\@]")) + "+"), j = n(n("\\/" + k) + "*"), M = n("\\/" + n(A + j) + "?"), N = n(ee + j), P = n(A + j), F = "(?!" + O + ")";
+			n(j + "|" + M + "|" + N + "|" + P + "|" + F);
+			var I = n(n(O + "|" + t("[\\/\\?]", d)) + "*"), L = n(n(O + "|[\\/\\?]") + "*"), R = n(n("\\/\\/" + D + j) + "|" + M + "|" + P + "|" + F), z = n(p + "\\:" + R + n("\\?" + I) + "?" + n("\\#" + L) + "?"), B = n(n(n("\\/\\/" + D + j) + "|" + M + "|" + N + "|" + F) + n("\\?" + I) + "?" + n("\\#" + L) + "?");
+			return n(z + "|" + B), n(p + "\\:" + R + n("\\?" + I) + "?"), "" + p + n(n("\\/\\/(" + n("(" + m + ")@") + "?(" + T + ")" + n("\\:(" + E + ")") + "?)") + "?(" + j + "|" + M + "|" + P + "|" + F + ")") + n("\\?(" + I + ")") + n("\\#(" + L + ")"), "" + n(n("\\/\\/(" + n("(" + m + ")@") + "?(" + T + ")" + n("\\:(" + E + ")") + "?)") + "?(" + j + "|" + M + "|" + N + "|" + F + ")") + n("\\?(" + I + ")") + n("\\#(" + L + ")"), "" + p + n(n("\\/\\/(" + n("(" + m + ")@") + "?(" + T + ")" + n("\\:(" + E + ")") + "?)") + "?(" + j + "|" + M + "|" + P + "|" + F + ")") + n("\\?(" + I + ")"), "" + n("\\#(" + L + ")"), "" + n("(" + m + ")@") + T + n("\\:(" + E + ")"), {
+				NOT_SCHEME: new RegExp(t("[^]", r, i, "[\\+\\-\\.]"), "g"),
+				NOT_USERINFO: new RegExp(t("[^\\%\\:]", f, c), "g"),
+				NOT_HOST: new RegExp(t("[^\\%\\[\\]\\:]", f, c), "g"),
+				NOT_PATH: new RegExp(t("[^\\%\\/\\:\\@]", f, c), "g"),
+				NOT_PATH_NOSCHEME: new RegExp(t("[^\\%\\/\\@]", f, c), "g"),
+				NOT_QUERY: new RegExp(t("[^\\%]", f, c, "[\\:\\@\\/\\?]", d), "g"),
+				NOT_FRAGMENT: new RegExp(t("[^\\%]", f, c, "[\\:\\@\\/\\?]"), "g"),
+				ESCAPE: new RegExp(t("[^]", f, c), "g"),
+				UNRESERVED: new RegExp(f, "g"),
+				OTHER_CHARS: new RegExp(t("[^\\%]", f, l), "g"),
+				PCT_ENCODED: new RegExp(o, "g"),
+				IPV4ADDRESS: /* @__PURE__ */ RegExp("^(" + g + ")$"),
+				IPV6ADDRESS: /* @__PURE__ */ RegExp("^\\[?(" + y + ")" + n(n("\\%25|\\%(?!" + a + "{2})") + "(" + b + ")") + "?\\]?$")
+			};
+		}
+		var c = s(!1), l = s(!0), u = function() {
+			function e(e, t) {
+				var n = [], r = !0, i = !1, a = void 0;
+				try {
+					for (var o = e[Symbol.iterator](), s; !(r = (s = o.next()).done) && (n.push(s.value), !(t && n.length === t)); r = !0);
+				} catch (e) {
+					i = !0, a = e;
+				} finally {
+					try {
+						!r && o.return && o.return();
+					} finally {
+						if (i) throw a;
+					}
+				}
+				return n;
+			}
+			return function(t, n) {
+				if (Array.isArray(t)) return t;
+				if (Symbol.iterator in Object(t)) return e(t, n);
+				throw TypeError("Invalid attempt to destructure non-iterable instance");
+			};
+		}(), d = function(e) {
+			if (Array.isArray(e)) {
+				for (var t = 0, n = Array(e.length); t < e.length; t++) n[t] = e[t];
+				return n;
+			} else return Array.from(e);
+		}, f = 2147483647, p = 36, m = 1, h = 26, g = 38, _ = 700, v = 72, y = 128, b = "-", x = /^xn--/, S = /[^\0-\x7E]/, C = /[\x2E\u3002\uFF0E\uFF61]/g, w = {
+			overflow: "Overflow: input needs wider integers to process",
+			"not-basic": "Illegal input >= 0x80 (not a basic code point)",
+			"invalid-input": "Invalid input"
+		}, T = p - m, E = Math.floor, D = String.fromCharCode;
+		function O(e) {
+			throw RangeError(w[e]);
+		}
+		function k(e, t) {
+			for (var n = [], r = e.length; r--;) n[r] = t(e[r]);
+			return n;
+		}
+		function A(e, t) {
+			var n = e.split("@"), r = "";
+			n.length > 1 && (r = n[0] + "@", e = n[1]), e = e.replace(C, ".");
+			var i = k(e.split("."), t).join(".");
+			return r + i;
+		}
+		function ee(e) {
+			for (var t = [], n = 0, r = e.length; n < r;) {
+				var i = e.charCodeAt(n++);
+				if (i >= 55296 && i <= 56319 && n < r) {
+					var a = e.charCodeAt(n++);
+					(a & 64512) == 56320 ? t.push(((i & 1023) << 10) + (a & 1023) + 65536) : (t.push(i), n--);
+				} else t.push(i);
+			}
+			return t;
+		}
+		var j = function(e) {
+			return String.fromCodePoint.apply(String, d(e));
+		}, M = function(e) {
+			return e - 48 < 10 ? e - 22 : e - 65 < 26 ? e - 65 : e - 97 < 26 ? e - 97 : p;
+		}, N = function(e, t) {
+			return e + 22 + 75 * (e < 26) - ((t != 0) << 5);
+		}, P = function(e, t, n) {
+			var r = 0;
+			for (e = n ? E(e / _) : e >> 1, e += E(e / t); e > T * h >> 1; r += p) e = E(e / T);
+			return E(r + (T + 1) * e / (e + g));
+		}, F = function(e) {
+			var t = [], n = e.length, r = 0, i = y, a = v, o = e.lastIndexOf(b);
+			o < 0 && (o = 0);
+			for (var s = 0; s < o; ++s) e.charCodeAt(s) >= 128 && O("not-basic"), t.push(e.charCodeAt(s));
+			for (var c = o > 0 ? o + 1 : 0; c < n;) {
+				for (var l = r, u = 1, d = p;; d += p) {
+					c >= n && O("invalid-input");
+					var g = M(e.charCodeAt(c++));
+					(g >= p || g > E((f - r) / u)) && O("overflow"), r += g * u;
+					var _ = d <= a ? m : d >= a + h ? h : d - a;
+					if (g < _) break;
+					var x = p - _;
+					u > E(f / x) && O("overflow"), u *= x;
+				}
+				var S = t.length + 1;
+				a = P(r - l, S, l == 0), E(r / S) > f - i && O("overflow"), i += E(r / S), r %= S, t.splice(r++, 0, i);
+			}
+			return String.fromCodePoint.apply(String, t);
+		}, I = function(e) {
+			var t = [];
+			e = ee(e);
+			var n = e.length, r = y, i = 0, a = v, o = !0, s = !1, c = void 0;
+			try {
+				for (var l = e[Symbol.iterator](), u; !(o = (u = l.next()).done); o = !0) {
+					var d = u.value;
+					d < 128 && t.push(D(d));
+				}
+			} catch (e) {
+				s = !0, c = e;
+			} finally {
+				try {
+					!o && l.return && l.return();
+				} finally {
+					if (s) throw c;
+				}
+			}
+			var g = t.length, _ = g;
+			for (g && t.push(b); _ < n;) {
+				var x = f, S = !0, C = !1, w = void 0;
+				try {
+					for (var T = e[Symbol.iterator](), k; !(S = (k = T.next()).done); S = !0) {
+						var A = k.value;
+						A >= r && A < x && (x = A);
+					}
+				} catch (e) {
+					C = !0, w = e;
+				} finally {
+					try {
+						!S && T.return && T.return();
+					} finally {
+						if (C) throw w;
+					}
+				}
+				var j = _ + 1;
+				x - r > E((f - i) / j) && O("overflow"), i += (x - r) * j, r = x;
+				var M = !0, F = !1, I = void 0;
+				try {
+					for (var L = e[Symbol.iterator](), R; !(M = (R = L.next()).done); M = !0) {
+						var z = R.value;
+						if (z < r && ++i > f && O("overflow"), z == r) {
+							for (var B = i, V = p;; V += p) {
+								var H = V <= a ? m : V >= a + h ? h : V - a;
+								if (B < H) break;
+								var U = B - H, W = p - H;
+								t.push(D(N(H + U % W, 0))), B = E(U / W);
+							}
+							t.push(D(N(B, 0))), a = P(i, j, _ == g), i = 0, ++_;
+						}
+					}
+				} catch (e) {
+					F = !0, I = e;
+				} finally {
+					try {
+						!M && L.return && L.return();
+					} finally {
+						if (F) throw I;
+					}
+				}
+				++i, ++r;
+			}
+			return t.join("");
+		}, L = {
+			version: "2.1.0",
+			ucs2: {
+				decode: ee,
+				encode: j
+			},
+			decode: F,
+			encode: I,
+			toASCII: function(e) {
+				return A(e, function(e) {
+					return S.test(e) ? "xn--" + I(e) : e;
+				});
+			},
+			toUnicode: function(e) {
+				return A(e, function(e) {
+					return x.test(e) ? F(e.slice(4).toLowerCase()) : e;
+				});
+			}
+		}, R = {};
+		function z(e) {
+			var t = e.charCodeAt(0), n = void 0;
+			return n = t < 16 ? "%0" + t.toString(16).toUpperCase() : t < 128 ? "%" + t.toString(16).toUpperCase() : t < 2048 ? "%" + (t >> 6 | 192).toString(16).toUpperCase() + "%" + (t & 63 | 128).toString(16).toUpperCase() : "%" + (t >> 12 | 224).toString(16).toUpperCase() + "%" + (t >> 6 & 63 | 128).toString(16).toUpperCase() + "%" + (t & 63 | 128).toString(16).toUpperCase(), n;
+		}
+		function B(e) {
+			for (var t = "", n = 0, r = e.length; n < r;) {
+				var i = parseInt(e.substr(n + 1, 2), 16);
+				if (i < 128) t += String.fromCharCode(i), n += 3;
+				else if (i >= 194 && i < 224) {
+					if (r - n >= 6) {
+						var a = parseInt(e.substr(n + 4, 2), 16);
+						t += String.fromCharCode((i & 31) << 6 | a & 63);
+					} else t += e.substr(n, 6);
+					n += 6;
+				} else if (i >= 224) {
+					if (r - n >= 9) {
+						var o = parseInt(e.substr(n + 4, 2), 16), s = parseInt(e.substr(n + 7, 2), 16);
+						t += String.fromCharCode((i & 15) << 12 | (o & 63) << 6 | s & 63);
+					} else t += e.substr(n, 9);
+					n += 9;
+				} else t += e.substr(n, 3), n += 3;
+			}
+			return t;
+		}
+		function V(e, t) {
+			function n(e) {
+				var n = B(e);
+				return n.match(t.UNRESERVED) ? n : e;
+			}
+			return e.scheme &&= String(e.scheme).replace(t.PCT_ENCODED, n).toLowerCase().replace(t.NOT_SCHEME, ""), e.userinfo !== void 0 && (e.userinfo = String(e.userinfo).replace(t.PCT_ENCODED, n).replace(t.NOT_USERINFO, z).replace(t.PCT_ENCODED, i)), e.host !== void 0 && (e.host = String(e.host).replace(t.PCT_ENCODED, n).toLowerCase().replace(t.NOT_HOST, z).replace(t.PCT_ENCODED, i)), e.path !== void 0 && (e.path = String(e.path).replace(t.PCT_ENCODED, n).replace(e.scheme ? t.NOT_PATH : t.NOT_PATH_NOSCHEME, z).replace(t.PCT_ENCODED, i)), e.query !== void 0 && (e.query = String(e.query).replace(t.PCT_ENCODED, n).replace(t.NOT_QUERY, z).replace(t.PCT_ENCODED, i)), e.fragment !== void 0 && (e.fragment = String(e.fragment).replace(t.PCT_ENCODED, n).replace(t.NOT_FRAGMENT, z).replace(t.PCT_ENCODED, i)), e;
+		}
+		function H(e) {
+			return e.replace(/^0*(.*)/, "$1") || "0";
+		}
+		function U(e, t) {
+			var n = u(e.match(t.IPV4ADDRESS) || [], 2)[1];
+			return n ? n.split(".").map(H).join(".") : e;
+		}
+		function W(e, t) {
+			var n = u(e.match(t.IPV6ADDRESS) || [], 3), r = n[1], i = n[2];
+			if (r) {
+				for (var a = u(r.toLowerCase().split("::").reverse(), 2), o = a[0], s = a[1], c = s ? s.split(":").map(H) : [], l = o.split(":").map(H), d = t.IPV4ADDRESS.test(l[l.length - 1]), f = d ? 7 : 8, p = l.length - f, m = Array(f), h = 0; h < f; ++h) m[h] = c[h] || l[p + h] || "";
+				d && (m[f - 1] = U(m[f - 1], t));
+				var g = m.reduce(function(e, t, n) {
+					if (!t || t === "0") {
+						var r = e[e.length - 1];
+						r && r.index + r.length === n ? r.length++ : e.push({
+							index: n,
+							length: 1
+						});
+					}
+					return e;
+				}, []).sort(function(e, t) {
+					return t.length - e.length;
+				})[0], _ = void 0;
+				if (g && g.length > 1) {
+					var v = m.slice(0, g.index), y = m.slice(g.index + g.length);
+					_ = v.join(":") + "::" + y.join(":");
+				} else _ = m.join(":");
+				return i && (_ += "%" + i), _;
+			} else return e;
+		}
+		var te = /^(?:([^:\/?#]+):)?(?:\/\/((?:([^\/?#@]*)@)?(\[[^\/?#\]]+\]|[^\/?#:]*)(?:\:(\d*))?))?([^?#]*)(?:\?([^#]*))?(?:#((?:.|\n|\r)*))?/i, ne = "".match(/(){0}/)[1] === void 0;
+		function G(e) {
+			var t = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {}, n = {}, r = t.iri === !1 ? c : l;
+			t.reference === "suffix" && (e = (t.scheme ? t.scheme + ":" : "") + "//" + e);
+			var i = e.match(te);
+			if (i) {
+				ne ? (n.scheme = i[1], n.userinfo = i[3], n.host = i[4], n.port = parseInt(i[5], 10), n.path = i[6] || "", n.query = i[7], n.fragment = i[8], isNaN(n.port) && (n.port = i[5])) : (n.scheme = i[1] || void 0, n.userinfo = e.indexOf("@") === -1 ? void 0 : i[3], n.host = e.indexOf("//") === -1 ? void 0 : i[4], n.port = parseInt(i[5], 10), n.path = i[6] || "", n.query = e.indexOf("?") === -1 ? void 0 : i[7], n.fragment = e.indexOf("#") === -1 ? void 0 : i[8], isNaN(n.port) && (n.port = e.match(/\/\/(?:.|\n)*\:(?:\/|\?|\#|$)/) ? i[4] : void 0)), n.host &&= W(U(n.host, r), r), n.scheme === void 0 && n.userinfo === void 0 && n.host === void 0 && n.port === void 0 && !n.path && n.query === void 0 ? n.reference = "same-document" : n.scheme === void 0 ? n.reference = "relative" : n.fragment === void 0 ? n.reference = "absolute" : n.reference = "uri", t.reference && t.reference !== "suffix" && t.reference !== n.reference && (n.error = n.error || "URI is not a " + t.reference + " reference.");
+				var a = R[(t.scheme || n.scheme || "").toLowerCase()];
+				if (!t.unicodeSupport && (!a || !a.unicodeSupport)) {
+					if (n.host && (t.domainHost || a && a.domainHost)) try {
+						n.host = L.toASCII(n.host.replace(r.PCT_ENCODED, B).toLowerCase());
+					} catch (e) {
+						n.error = n.error || "Host's domain name can not be converted to ASCII via punycode: " + e;
+					}
+					V(n, c);
+				} else V(n, r);
+				a && a.parse && a.parse(n, t);
+			} else n.error = n.error || "URI can not be parsed.";
+			return n;
+		}
+		function re(e, t) {
+			var n = t.iri === !1 ? c : l, r = [];
+			return e.userinfo !== void 0 && (r.push(e.userinfo), r.push("@")), e.host !== void 0 && r.push(W(U(String(e.host), n), n).replace(n.IPV6ADDRESS, function(e, t, n) {
+				return "[" + t + (n ? "%25" + n : "") + "]";
+			})), (typeof e.port == "number" || typeof e.port == "string") && (r.push(":"), r.push(String(e.port))), r.length ? r.join("") : void 0;
+		}
+		var ie = /^\.\.?\//, ae = /^\/\.(\/|$)/, oe = /^\/\.\.(\/|$)/, se = /^\/?(?:.|\n)*?(?=\/|$)/;
+		function K(e) {
+			for (var t = []; e.length;) if (e.match(ie)) e = e.replace(ie, "");
+			else if (e.match(ae)) e = e.replace(ae, "/");
+			else if (e.match(oe)) e = e.replace(oe, "/"), t.pop();
+			else if (e === "." || e === "..") e = "";
+			else {
+				var n = e.match(se);
+				if (n) {
+					var r = n[0];
+					e = e.slice(r.length), t.push(r);
+				} else throw Error("Unexpected dot segment condition");
+			}
+			return t.join("");
+		}
+		function q(e) {
+			var t = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {}, n = t.iri ? l : c, r = [], i = R[(t.scheme || e.scheme || "").toLowerCase()];
+			if (i && i.serialize && i.serialize(e, t), e.host && !n.IPV6ADDRESS.test(e.host) && (t.domainHost || i && i.domainHost)) try {
+				e.host = t.iri ? L.toUnicode(e.host) : L.toASCII(e.host.replace(n.PCT_ENCODED, B).toLowerCase());
+			} catch (n) {
+				e.error = e.error || "Host's domain name can not be converted to " + (t.iri ? "Unicode" : "ASCII") + " via punycode: " + n;
+			}
+			V(e, n), t.reference !== "suffix" && e.scheme && (r.push(e.scheme), r.push(":"));
+			var a = re(e, t);
+			if (a !== void 0 && (t.reference !== "suffix" && r.push("//"), r.push(a), e.path && e.path.charAt(0) !== "/" && r.push("/")), e.path !== void 0) {
+				var o = e.path;
+				!t.absolutePath && (!i || !i.absolutePath) && (o = K(o)), a === void 0 && (o = o.replace(/^\/\//, "/%2F")), r.push(o);
+			}
+			return e.query !== void 0 && (r.push("?"), r.push(e.query)), e.fragment !== void 0 && (r.push("#"), r.push(e.fragment)), r.join("");
+		}
+		function ce(e, t) {
+			var n = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : {}, r = arguments[3], i = {};
+			return r || (e = G(q(e, n), n), t = G(q(t, n), n)), n ||= {}, !n.tolerant && t.scheme ? (i.scheme = t.scheme, i.userinfo = t.userinfo, i.host = t.host, i.port = t.port, i.path = K(t.path || ""), i.query = t.query) : (t.userinfo !== void 0 || t.host !== void 0 || t.port !== void 0 ? (i.userinfo = t.userinfo, i.host = t.host, i.port = t.port, i.path = K(t.path || ""), i.query = t.query) : (t.path ? (t.path.charAt(0) === "/" ? i.path = K(t.path) : ((e.userinfo !== void 0 || e.host !== void 0 || e.port !== void 0) && !e.path ? i.path = "/" + t.path : e.path ? i.path = e.path.slice(0, e.path.lastIndexOf("/") + 1) + t.path : i.path = t.path, i.path = K(i.path)), i.query = t.query) : (i.path = e.path, t.query === void 0 ? i.query = e.query : i.query = t.query), i.userinfo = e.userinfo, i.host = e.host, i.port = e.port), i.scheme = e.scheme), i.fragment = t.fragment, i;
+		}
+		function le(e, t, n) {
+			var r = o({ scheme: "null" }, n);
+			return q(ce(G(e, r), G(t, r), r, !0), r);
+		}
+		function ue(e, t) {
+			return typeof e == "string" ? e = q(G(e, t), t) : r(e) === "object" && (e = G(q(e, t), t)), e;
+		}
+		function de(e, t, n) {
+			return typeof e == "string" ? e = q(G(e, n), n) : r(e) === "object" && (e = q(e, n)), typeof t == "string" ? t = q(G(t, n), n) : r(t) === "object" && (t = q(t, n)), e === t;
+		}
+		function fe(e, t) {
+			return e && e.toString().replace(!t || !t.iri ? c.ESCAPE : l.ESCAPE, z);
+		}
+		function J(e, t) {
+			return e && e.toString().replace(!t || !t.iri ? c.PCT_ENCODED : l.PCT_ENCODED, B);
+		}
+		var Y = {
+			scheme: "http",
+			domainHost: !0,
+			parse: function(e, t) {
+				return e.host || (e.error = e.error || "HTTP URIs must have a host."), e;
+			},
+			serialize: function(e, t) {
+				var n = String(e.scheme).toLowerCase() === "https";
+				return (e.port === (n ? 443 : 80) || e.port === "") && (e.port = void 0), e.path ||= "/", e;
+			}
+		}, pe = {
+			scheme: "https",
+			domainHost: Y.domainHost,
+			parse: Y.parse,
+			serialize: Y.serialize
+		};
+		function me(e) {
+			return typeof e.secure == "boolean" ? e.secure : String(e.scheme).toLowerCase() === "wss";
+		}
+		var X = {
+			scheme: "ws",
+			domainHost: !0,
+			parse: function(e, t) {
+				var n = e;
+				return n.secure = me(n), n.resourceName = (n.path || "/") + (n.query ? "?" + n.query : ""), n.path = void 0, n.query = void 0, n;
+			},
+			serialize: function(e, t) {
+				if ((e.port === (me(e) ? 443 : 80) || e.port === "") && (e.port = void 0), typeof e.secure == "boolean" && (e.scheme = e.secure ? "wss" : "ws", e.secure = void 0), e.resourceName) {
+					var n = u(e.resourceName.split("?"), 2), r = n[0], i = n[1];
+					e.path = r && r !== "/" ? r : void 0, e.query = i, e.resourceName = void 0;
+				}
+				return e.fragment = void 0, e;
+			}
+		}, he = {
+			scheme: "wss",
+			domainHost: X.domainHost,
+			parse: X.parse,
+			serialize: X.serialize
+		}, ge = {}, _e = "[A-Za-z0-9\\-\\.\\_\\~\\xA0-\\u200D\\u2010-\\u2029\\u202F-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFEF]", Z = "[0-9A-Fa-f]", ve = n(n("%[EFef]" + Z + "%" + Z + Z + "%" + Z + Z) + "|" + n("%[89A-Fa-f]" + Z + "%" + Z + Z) + "|" + n("%" + Z + Z)), ye = "[A-Za-z0-9\\!\\$\\%\\'\\*\\+\\-\\^\\_\\`\\{\\|\\}\\~]", be = t("[\\!\\$\\%\\'\\(\\)\\*\\+\\,\\-\\.0-9\\<\\>A-Z\\x5E-\\x7E]", "[\\\"\\\\]"), xe = "[\\!\\$\\'\\(\\)\\*\\+\\,\\;\\:\\@]", Se = new RegExp(_e, "g"), Q = new RegExp(ve, "g"), Ce = new RegExp(t("[^]", ye, "[\\.]", "[\\\"]", be), "g"), we = new RegExp(t("[^]", _e, xe), "g"), Te = we;
+		function $(e) {
+			var t = B(e);
+			return t.match(Se) ? t : e;
+		}
+		var Ee = {
+			scheme: "mailto",
+			parse: function(e, t) {
+				var n = e, r = n.to = n.path ? n.path.split(",") : [];
+				if (n.path = void 0, n.query) {
+					for (var i = !1, a = {}, o = n.query.split("&"), s = 0, c = o.length; s < c; ++s) {
+						var l = o[s].split("=");
+						switch (l[0]) {
+							case "to":
+								for (var u = l[1].split(","), d = 0, f = u.length; d < f; ++d) r.push(u[d]);
+								break;
+							case "subject":
+								n.subject = J(l[1], t);
+								break;
+							case "body":
+								n.body = J(l[1], t);
+								break;
+							default:
+								i = !0, a[J(l[0], t)] = J(l[1], t);
+								break;
+						}
+					}
+					i && (n.headers = a);
+				}
+				n.query = void 0;
+				for (var p = 0, m = r.length; p < m; ++p) {
+					var h = r[p].split("@");
+					if (h[0] = J(h[0]), t.unicodeSupport) h[1] = J(h[1], t).toLowerCase();
+					else try {
+						h[1] = L.toASCII(J(h[1], t).toLowerCase());
+					} catch (e) {
+						n.error = n.error || "Email address's domain name can not be converted to ASCII via punycode: " + e;
+					}
+					r[p] = h.join("@");
+				}
+				return n;
+			},
+			serialize: function(e, t) {
+				var n = e, r = a(e.to);
+				if (r) {
+					for (var o = 0, s = r.length; o < s; ++o) {
+						var c = String(r[o]), l = c.lastIndexOf("@"), u = c.slice(0, l).replace(Q, $).replace(Q, i).replace(Ce, z), d = c.slice(l + 1);
+						try {
+							d = t.iri ? L.toUnicode(d) : L.toASCII(J(d, t).toLowerCase());
+						} catch (e) {
+							n.error = n.error || "Email address's domain name can not be converted to " + (t.iri ? "Unicode" : "ASCII") + " via punycode: " + e;
+						}
+						r[o] = u + "@" + d;
+					}
+					n.path = r.join(",");
+				}
+				var f = e.headers = e.headers || {};
+				e.subject && (f.subject = e.subject), e.body && (f.body = e.body);
+				var p = [];
+				for (var m in f) f[m] !== ge[m] && p.push(m.replace(Q, $).replace(Q, i).replace(we, z) + "=" + f[m].replace(Q, $).replace(Q, i).replace(Te, z));
+				return p.length && (n.query = p.join("&")), n;
+			}
+		}, De = /^([^\:]+)\:(.*)/, Oe = {
+			scheme: "urn",
+			parse: function(e, t) {
+				var n = e.path && e.path.match(De), r = e;
+				if (n) {
+					var i = t.scheme || r.scheme || "urn", a = n[1].toLowerCase(), o = n[2], s = R[i + ":" + (t.nid || a)];
+					r.nid = a, r.nss = o, r.path = void 0, s && (r = s.parse(r, t));
+				} else r.error = r.error || "URN can not be parsed.";
+				return r;
+			},
+			serialize: function(e, t) {
+				var n = t.scheme || e.scheme || "urn", r = e.nid, i = R[n + ":" + (t.nid || r)];
+				i && (e = i.serialize(e, t));
+				var a = e, o = e.nss;
+				return a.path = (r || t.nid) + ":" + o, a;
+			}
+		}, ke = /^[0-9A-Fa-f]{8}(?:\-[0-9A-Fa-f]{4}){3}\-[0-9A-Fa-f]{12}$/, Ae = {
+			scheme: "urn:uuid",
+			parse: function(e, t) {
+				var n = e;
+				return n.uuid = n.nss, n.nss = void 0, !t.tolerant && (!n.uuid || !n.uuid.match(ke)) && (n.error = n.error || "UUID is not valid."), n;
+			},
+			serialize: function(e, t) {
+				var n = e;
+				return n.nss = (e.uuid || "").toLowerCase(), n;
+			}
+		};
+		R[Y.scheme] = Y, R[pe.scheme] = pe, R[X.scheme] = X, R[he.scheme] = he, R[Ee.scheme] = Ee, R[Oe.scheme] = Oe, R[Ae.scheme] = Ae, e.SCHEMES = R, e.pctEncChar = z, e.pctDecChars = B, e.parse = G, e.removeDotSegments = K, e.serialize = q, e.resolveComponents = ce, e.resolve = le, e.normalize = ue, e.equal = de, e.escapeComponent = fe, e.unescapeComponent = J, Object.defineProperty(e, "__esModule", { value: !0 });
+	}));
+})), import_uri_all$3 = /* @__PURE__ */ __toESM(require_uri_all(), 1);
+const NavigationContext = createContext({
+	url: "/",
+	store: "url"
+});
+function defaultShouldHandle(e) {
+	return e.canIntercept && !e.downloadRequest;
+}
+const NavigationProvider = ({ children: e, store: n = "url", scoped: o, shouldHandle: s = defaultShouldHandle }) => {
+	let [c, l] = useState(null), [u, d] = useState(() => ({
+		store: n,
+		url: window.location.href
+	})), f = useMemo(() => (e) => {
+		let t = e.sourceElement;
+		return c && t && !c.contains(t) ? !0 : !s(e);
+	}, [s, c]);
+	useEffect(() => {
+		let e = (e) => {
+			if (f(e)) return;
+			let t = e.destination.url;
+			n === "memory" ? (e.preventDefault(), d((r) => {
+				if (e.sourceElement instanceof HTMLAnchorElement && e.navigationType === "push") {
+					let n = e.sourceElement.getAttribute("href");
+					n && !n.startsWith("/") && !/^[a-z]+:\/\//i.test(n) && (t = import_uri_all$3.default.resolve(r.url, n));
+				}
+				return {
+					...r,
+					url: t,
+					store: n
+				};
+			})) : e.intercept({ async handler() {
+				d({
+					url: t,
+					store: n
+				});
+			} });
+		};
+		return navigation?.addEventListener("navigate", e), () => navigation?.removeEventListener("navigate", e);
+	}, [
+		f,
+		o,
+		n
+	]);
+	let p = useMemo(() => ({
+		...u,
+		setState: d
+	}), [u]);
+	return createElement(NavigationContext.Provider, { value: p }, o ? createElement("div", { ref: l }, e) : e);
+};
+function future(e) {
+	let t = {}, n = new Promise((e, n) => {
+		t.resolve = e, t.reject = n;
+	});
+	return n.resolve = t.resolve, n.reject = t.reject, e && n.catch(() => {}), n;
+}
+var import_uri_all$2 = /* @__PURE__ */ __toESM(require_uri_all(), 1);
+function useNavigate() {
+	let { setState: e } = useContext(NavigationContext);
+	return useMemo(() => {
+		if (!e || !navigation) return navigation;
+		let t = (t, n) => {
+			let r = {
+				committed: future(!0),
+				finished: future(!0)
+			}, i = ({ committed: e, finished: t }) => {
+				e.then(r.committed.resolve, r.committed.reject), t.then(r.finished.resolve, r.finished.reject);
+			};
+			return e((e) => (Promise.resolve().then(() => {
+				try {
+					i(navigation.navigate(import_uri_all$2.default.resolve(e.url, t), n));
+				} catch {
+					i(navigation.navigate(t, n));
+				}
+			}), e)), r;
+		};
+		return new Proxy(navigation, { get(e, n, r) {
+			if (n === "navigate") return t;
+			let i = Reflect.get(e, n, r);
+			return typeof i == "function" ? i.bind(e) : i;
+		} });
+	}, [e]);
+}
+var import_uri_all$1 = /* @__PURE__ */ __toESM(require_uri_all(), 1), DUMMY_BASE = "fakeprotodonotuse://";
+function resolveLocation(e, t) {
+	let n = import_uri_all$1.default.parse(import_uri_all$1.default.resolve(t, e));
+	return n.scheme = void 0, n.host = void 0, n.port = void 0, import_uri_all$1.default.serialize(n);
+}
+function useLocation(e, t) {
+	let r = useContext(NavigationContext), a = t ?? r.url;
+	return useMemo(() => {
+		if (typeof e == "string") return resolveLocation(e, a);
+		if (typeof e == "function") {
+			let t = new URL(a, DUMMY_BASE);
+			return resolveLocation((e(t) || t).href, a);
+		}
+		return resolveLocation("", a);
+	}, [e, a]);
+}
+var import_uri_all = /* @__PURE__ */ __toESM(require_uri_all(), 1);
+function parseSearchParams(e) {
+	return new URLSearchParams(import_uri_all.default.parse(e || "").query);
+}
+function useQueryParam(e, t = !1) {
+	let n = useLocation();
+	return useMemo(() => {
+		try {
+			let r = parseSearchParams(n);
+			return t ? r.getAll(e) || [] : r.get(e);
+		} catch {
+			return null;
+		}
+	}, [
+		n,
+		t,
+		e
+	]);
+}
+function mapQueryParams(e, t) {
+	let n = {};
+	return e.forEach((e, r) => {
+		t && !t.includes(r) || (n[r] ? Array.isArray(n[r]) ? n[r].push(e) : n[r] = [n[r], e] : n[r] = e);
+	}), n;
+}
+function useQueryParams(e) {
+	let t = useLocation();
+	return useMemo(() => {
+		let n = parseSearchParams(t);
+		return Array.isArray(e) ? mapQueryParams(n, e) : (e || mapQueryParams)(n);
+	}, [t, e]);
+}
+function useLocationWithParam(e, t, n) {
+	return useLocation((n) => t === null ? n.searchParams.delete(e) : n.searchParams.set(e, t), n);
+}
+function useLocationWithParams(e, t) {
+	return useLocation((t) => {
+		for (let [n, r] of Object.entries(e)) r === null ? t.searchParams.delete(n) : Array.isArray(r) ? (t.searchParams.delete(n), r.forEach((e) => t.searchParams.append(n, e))) : t.searchParams.set(n, r);
+		return t;
+	}, t);
+}
+export { NavigationContext, NavigationProvider, mapQueryParams, parseSearchParams, resolveLocation, useLocation, useLocationWithParam, useLocationWithParams, useNavigate, useQueryParam, useQueryParams };

package/dist/use-navigation-api.umd.js ADDED Viewed

@@ -0,0 +1 @@

package/dist/useNavigate.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export declare function useNavigate(): Navigation \| undefined;

package/dist/util/future.d.ts ADDED Viewed

@@ -0,0 +1,11 @@
+type Resolution<T> = {
+    resolve: (value: T) => void;
+    reject: (reason?: unknown) => void;
+};
+type Future<T> = Promise<T> & Resolution<T>;
+/**
+ * Returns a Promise that can be resolved or rejected from outside.
+ * @param suppressUncaught If true, adds a dummy catch handler to bypass browsers' uncaught error logging.
+ */
+export declare function future<T>(suppressUncaught?: boolean): Future<T>;
+export {};

package/package.json CHANGED Viewed

@@ -19,14 +19,24 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/use-navigation-api.es.js",
       "require": "./dist/use-navigation-api.umd.js"
-    }
+    },
+    "./src": "./src/index.ts",
+    "./src/*": "./src/*"
   },
-  "version": "0.1.0",
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "version": "0.3.0",
   "type": "module",
   "scripts": {
     "build": "tsc -b && vite build",
     "lint": "eslint ."
   },
+  "dependencies": {
+    "uri-js": "^4.4.1"
+  },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"

package/src/index.ts CHANGED Viewed

@@ -1,5 +1,6 @@
 export * from "./navigationProvider";
 export * from "./useNavigate";
-export * from "./location/useLocation";
 export * from "./location/useQueryParam";
+export * from "./location/useQueryParams";
+export * from "./location/useLocation";
 export * from "./location/useLocationWithParam";

package/src/location/useLocation.ts CHANGED Viewed

@@ -1,37 +1,17 @@
 import { useContext, useMemo } from "react";
-import {
-  NavigationContext,
-  type NavigationContextState,
-} from "src/navigationProvider.ts";
+import { NavigationContext } from "src/navigationProvider.ts";
+import URI from "uri-js";
-type Location = { pathname: string; search: string; hash: string; url?: URL };
+const DUMMY_BASE = "fakeprotodonotuse://";
-export function parseLocation(
-  location: string,
-  {
-    url = window?.location?.href || "https://example.com/",
-  }: NavigationContextState,
-): Location {
-  try {
-    const parsed = new URL(location, url);
-    return {
-      url: parsed,
-      pathname: parsed.pathname,
-      search: parsed.search,
-      hash: parsed.hash,
-    };
-  } catch {
-    /* fall back to string parsing */
-  }
-  if (!location) return { pathname: "/", search: "", hash: "" };
-  const pathname = location.split("?")[0];
-  const search = location.substring(pathname.length).split("#")[0];
-  const hash = location.substring(pathname.length + search.length);
-  try {
-    return { url: undefined, pathname, search, hash };
-  } catch {
-    return { url: undefined, pathname, search, hash };
-  }
+export type Location = string;
+export function resolveLocation(location: string, base: string): string {
+  const parsed = URI.parse(URI.resolve(base, location));
+  parsed.scheme = undefined;
+  parsed.host = undefined;
+  parsed.port = undefined;
+  return URI.serialize(parsed);
 }
 /**
@@ -41,31 +21,29 @@ export function useLocation(): Location;
 /**
  * Resolves a URL string relative to the current location and returns its parts.
  */
-export function useLocation(url: string): Location;
-/**
- * Resolves a URL string relative to the current location after applying the supplied function.
- */
-export function useLocation<R>(
-  url: string,
-  parse: (location: string, value: NavigationContextState) => R,
-): R;
+export function useLocation(url: string, base?: string): Location;
 /**
  * Returns a location based on the returned url if present, or the modified input argument.
  * For instance, `useLocation(url => url.searchParams.set("parameter", "value"))` returns the current location with only a single parameter updated.
  */
-export function useLocation(url: (current: URL) => URL | void): Location;
+export function useLocation(
+  url: (current: URL) => URL | void,
+  base?: string,
+): Location;
 export function useLocation(
   url?: string | ((current: URL) => URL | void),
-  parse = parseLocation,
+  baseIn?: string,
 ) {
   const location = useContext(NavigationContext);
+  const base = baseIn ?? location.url;
   return useMemo(() => {
-    if (typeof url === "string") return parse(url, location);
+    if (typeof url === "string") return resolveLocation(url, base);
     if (typeof url === "function") {
-      const modified = new URL(location.url);
+      const modified = new URL(base, DUMMY_BASE);
       const returned = url(modified);
-      return parse((returned || modified).href, location);
+      return resolveLocation((returned || modified).href, base);
     }
-    return parse("", location);
-  }, [parse, url, location]);
+    return resolveLocation("", base);
+  }, [url, base]);
 }

package/src/location/useLocationWithParam.ts CHANGED Viewed

@@ -4,11 +4,42 @@ import { useLocation } from "src/location/useLocation.ts";
  * returns The current location with the specified parameter set to the provided value or removed if the value === null.
  * @param param name of the query parameter to set
  * @param value value to set the parameter to, or `null` to remove any existing value of that parameter
+ * @param base If provided, uses this value instead of the current location.
  */
-export function useLocationWithParam(param: string, value: string | null) {
-  return useLocation((url) =>
-    value === null
-      ? url.searchParams.delete(param)
-      : url.searchParams.set(param, value),
+export function useLocationWithParam(
+  param: string,
+  value: string | null,
+  base?: string,
+) {
+  return useLocation(
+    (url) =>
+      value === null
+        ? url.searchParams.delete(param)
+        : url.searchParams.set(param, value),
+    base,
   );
 }
+/**
+ * returns The current location with the specified parameter set to the provided value or removed if the value === null.
+ * @param params map of parameters to update. null or empty entries will be removed.
+ * @param base If provided, uses this value instead of the current location.
+ */
+export function useLocationWithParams(
+  params: Record<string, string | string[] | null>,
+  base?: string,
+) {
+  return useLocation((url) => {
+    for (const [param, value] of Object.entries(params)) {
+      if (value === null) {
+        url.searchParams.delete(param);
+      } else if (Array.isArray(value)) {
+        url.searchParams.delete(param);
+        value.forEach((v) => url.searchParams.append(param, v));
+      } else {
+        url.searchParams.set(param, value);
+      }
+    }
+    return url;
+  }, base);
+}

package/src/location/useQueryParam.ts CHANGED Viewed

@@ -1,5 +1,10 @@
 import { useLocation } from "src/location/useLocation.ts";
 import { useMemo } from "react";
+import URI from "uri-js";
+export function parseSearchParams(location?: string) {
+  return new URLSearchParams(URI.parse(location || "").query);
+}
 /**
  * Returns the first value for a query parameter, or null if it is missing.
@@ -9,12 +14,12 @@ export function useQueryParam(param: string, all?: false): string | null;
  * Returns all values for a query parameter when it appears multiple times.
  */
 export function useQueryParam(param: string, all: true): string[];
 export function useQueryParam(param: string, all: boolean = false) {
   const location = useLocation();
   return useMemo(() => {
     try {
-      const searchParams =
-        location.url?.searchParams || new URLSearchParams(location.search);
+      const searchParams = parseSearchParams(location);
       return all ? searchParams.getAll(param) || [] : searchParams.get(param);
     } catch {
       return null;

package/src/location/useQueryParams.ts ADDED Viewed

@@ -0,0 +1,31 @@
+import { useLocation } from "src/location/useLocation.ts";
+import { useMemo } from "react";
+import { parseSearchParams } from "src/location/useQueryParam.ts";
+export type ParamsMapper<T> = (params: URLSearchParams) => T;
+export function mapQueryParams(params: URLSearchParams, keys?: string[]) {
+  const result: Record<string, string | string[]> = {};
+  params.forEach((value, key) => {
+    if (keys && !keys.includes(key)) return;
+    if (!result[key]) result[key] = value;
+    else if (Array.isArray(result[key])) result[key].push(value);
+    else result[key] = [result[key] as string, value];
+  });
+  return result;
+}
+export function useQueryParams(): Record<string, string | string[]>;
+export function useQueryParams<K extends string>(
+  keys: K[],
+): Record<K, string | string[]>;
+export function useQueryParams<T>(mapper: ParamsMapper<T>): T;
+export function useQueryParams(mapping?: string[] | ParamsMapper<unknown>) {
+  const location = useLocation();
+  return useMemo(() => {
+    const params = parseSearchParams(location);
+    return Array.isArray(mapping)
+      ? mapQueryParams(params, mapping)
+      : (mapping || mapQueryParams)(params);
+  }, [location, mapping]);
+}

package/src/navigationProvider.ts CHANGED Viewed

@@ -9,9 +9,9 @@ import {
   useMemo,
   useState,
 } from "react";
+import URI from "uri-js";
 export type NavigationContextState = {
-  navigation: Navigation;
   url: string;
   store: "url" | "hash" | "memory";
 };
@@ -19,8 +19,7 @@ type NavigationContextValue = NavigationContextState & {
   setState?: Dispatch<SetStateAction<NavigationContextState>>;
 };
 const defaultValue: NavigationContextValue = {
-  navigation: window.navigation!,
-  url: window?.location?.href || "/",
+  url: "/",
   store: "url" as "url" | "hash" | "memory",
 };
 export const NavigationContext = createContext(defaultValue);
@@ -41,9 +40,11 @@ export const NavigationProvider: FC<{
   scoped,
   shouldHandle = defaultShouldHandle,
 }) => {
-  const navigation = defaultValue.navigation;
   const [scope, setScope] = useState<HTMLDivElement | null>(null);
-  const [state, setState] = useState(() => ({ ...defaultValue, store }));
+  const [state, setState] = useState(() => ({
+    store,
+    url: window.location.href,
+  }));
   const skip = useMemo(
     () => (event: NavigateEvent) => {
       const target = event.sourceElement;
@@ -70,7 +71,7 @@ export const NavigationProvider: FC<{
           ) {
             const href = event.sourceElement.getAttribute("href");
             if (href && !href.startsWith("/") && !/^[a-z]+:\/\//i.test(href)) {
-              url = new URL(href, prev.url).href;
+              url = URI.resolve(prev.url, href);
             }
           }
           return { ...prev, url, store };
@@ -78,7 +79,7 @@ export const NavigationProvider: FC<{
       } else {
         event.intercept({
           async handler() {
-            setState({ navigation, url, store });
+            setState({ url, store });
           },
         });
       }
@@ -86,7 +87,7 @@ export const NavigationProvider: FC<{
     navigation?.addEventListener("navigate", handler);
     return () => navigation?.removeEventListener("navigate", handler);
-  }, [skip, navigation, scoped, store]);
+  }, [skip, scoped, store]);
   const value = useMemo(() => ({ ...state, setState }), [state]);

package/src/useNavigate.ts CHANGED Viewed

@@ -1,11 +1,12 @@
 import { useContext, useMemo } from "react";
 import { NavigationContext } from "src/navigationProvider";
 import { future } from "src/util/future";
+import URI from "uri-js";
 export function useNavigate() {
-  const { navigation, setState } = useContext(NavigationContext);
+  const { setState } = useContext(NavigationContext);
   return useMemo(() => {
-    if (!setState) return navigation;
+    if (!setState || !navigation) return navigation;
     const navigate: Navigation["navigate"] = (destination, options) => {
       const result = {
         committed: future(true),
@@ -20,10 +21,7 @@ export function useNavigate() {
         Promise.resolve().then(() => {
           try {
             handle(
-              navigation.navigate(
-                new URL(destination, state.url).href,
-                options,
-              ),
+              navigation.navigate(URI.resolve(state.url, destination), options),
             );
           } catch {
             handle(navigation.navigate(destination, options));
@@ -40,5 +38,5 @@ export function useNavigate() {
         return typeof value === "function" ? value.bind(target) : value;
       },
     });
-  }, [navigation, setState]);
+  }, [setState]);
 }

package/eslint.config.js DELETED Viewed

@@ -1,22 +0,0 @@
-import js from "@eslint/js";
-import globals from "globals";
-import reactHooks from "eslint-plugin-react-hooks";
-import reactRefresh from "eslint-plugin-react-refresh";
-import tseslint from "typescript-eslint";
-import { defineConfig, globalIgnores } from "eslint/config";
-export default defineConfig([
-  globalIgnores(["dist"]),
-  {
-    files: ["**/*.{ts,tsx}"],
-    extends: [
-      js.configs.recommended,
-      tseslint.configs.recommended,
-      reactHooks.configs.flat.recommended,
-    ],
-    languageOptions: {
-      ecmaVersion: 2020,
-      globals: globals.browser,
-    },
-  },
-]);

package/tsconfig.app.json DELETED Viewed

@@ -1,30 +0,0 @@
-{
-  "compilerOptions": {
-    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
-    "target": "ES2022",
-    "useDefineForClassFields": true,
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
-    "types": ["vite/client"],
-    "skipLibCheck": true,
-    /* Bundler mode */
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "moduleDetection": "force",
-    "noEmit": true,
-    "jsx": "react-jsx",
-    /* Linting */
-    "strict": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "erasableSyntaxOnly": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedSideEffectImports": true,
-    "baseUrl": "."
-  },
-  "include": ["src"]
-}

package/tsconfig.json DELETED Viewed

@@ -1,7 +0,0 @@
-{
-  "files": [],
-  "references": [
-    { "path": "./tsconfig.app.json" },
-    { "path": "./tsconfig.node.json" }
-  ]
-}

package/tsconfig.node.json DELETED Viewed

@@ -1,26 +0,0 @@
-{
-  "compilerOptions": {
-    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
-    "target": "ES2023",
-    "lib": ["ES2023"],
-    "module": "ESNext",
-    "types": ["node"],
-    "skipLibCheck": true,
-    /* Bundler mode */
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "moduleDetection": "force",
-    "noEmit": true,
-    /* Linting */
-    "strict": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "erasableSyntaxOnly": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedSideEffectImports": true
-  },
-  "include": ["vite.config.ts"]
-}

package/vite.config.ts DELETED Viewed

@@ -1,28 +0,0 @@
-import { defineConfig } from "vite";
-import { resolve } from "path";
-import dts from "unplugin-dts/vite";
-import react from "@vitejs/plugin-react";
-import tsconfigPaths from "vite-tsconfig-paths";
-export default defineConfig({
-  build: {
-    lib: {
-      entry: resolve(__dirname, "src/index.ts"),
-      name: "useNavigationAPI",
-      fileName: (format) => `use-navigation-api.${format}.js`,
-    },
-    rollupOptions: {
-      external: ["react", "react-dom", "react/jsx-runtime"],
-      output: {
-        globals: {
-          react: "React",
-        },
-      },
-    },
-  },
-  plugins: [
-    react(),
-    dts({ tsconfigPath: "./tsconfig.app.json" }),
-    tsconfigPaths(),
-  ],
-});