cizgile 0.2.0 → 0.3.0

package/dist/uri.mjs

@@ -2,23 +2,40 @@ import { _ as isUnreserved, a as readHexByte, c as isDigit, d as isPchar, f as i
 
 //#region src/uri/parse.ts
 const URI_REFERENCE = /^(?:([A-Za-z][A-Za-z0-9+.-]*):)?(?:\/\/([^/?#]*))?([^?#]*)(?:\?([^#]*))?(?:#(.*))?$/s;
-/** Splits a URI reference into its components with the RFC 3986 Appendix B regular expression; never throws. */
-function parseUri(input) {
+/** Splits a URI reference into its components with the RFC 3986 Appendix B regular expression; never throws. With `authority: true` the authority is split further. */
+function parseUri(input, options = {}) {
 	const [, scheme, authority, path = "", query, fragment] = URI_REFERENCE.exec(input) ?? [];
 	const out = { path };
 	if (scheme !== void 0) out.scheme = scheme;
-	if (authority !== void 0) out.authority = authority;
+	if (authority !== void 0) {
+		out.authority = authority;
+		if (options.authority === true) {
+			const parts = parseAuthority(authority);
+			Object.assign(out, parts);
+			const port = parts.port;
+			if (port !== void 0 && port !== "" && port.length <= 5 && Number(port) <= 65535) out.portNumber = Number(port);
+		}
+	}
 	if (query !== void 0) out.query = query;
 	if (fragment !== void 0) out.fragment = fragment;
 	return out;
 }
-/** Recomposes components per RFC 3986 section 5.3, inserting `/.` or `./` where the grammar requires it. */
+function authorityOf(components) {
+	if (components.authority !== void 0) return components.authority;
+	if (components.host === void 0) return void 0;
+	const parts = { host: components.host };
+	if (components.userinfo !== void 0) parts.userinfo = components.userinfo;
+	if (components.port !== void 0) parts.port = components.port;
+	return serializeAuthority(parts);
+}
+/** Recomposes components per RFC 3986 section 5.3, inserting `/.` or `./` where the grammar requires it. `authority` wins over `host`, `port` and `userinfo`. */
 function serializeUri(components) {
 	let out = "";
 	let path = components.path;
+	const authority = authorityOf(components);
 	if (components.scheme !== void 0) out += components.scheme + ":";
-	if (components.authority !== void 0) {
-		out += "//" + components.authority;
+	if (authority !== void 0) {
+		out += "//" + authority;
 		if (path !== "" && !path.startsWith("/")) path = "/" + path;
 	} else if (path.startsWith("//")) path = "/." + path;
 	else if (components.scheme === void 0) {
@@ -29,57 +46,6 @@ function serializeUri(components) {
 	if (components.fragment !== void 0) out += "#" + components.fragment;
 	return out;
 }
-
-//#endregion
-//#region src/uri/path.ts
-function removeLastSegment(output) {
-	const index = output.lastIndexOf("/");
-	return index === -1 ? "" : output.slice(0, index);
-}
-/** RFC 3986 section 5.2.4, the two-buffer algorithm as written: resolves `.` and `..` segments. */
-function removeDotSegments(path) {
-	let input = path;
-	let output = "";
-	while (input.length > 0) if (input.startsWith("../")) input = input.slice(3);
-	else if (input.startsWith("./")) input = input.slice(2);
-	else if (input.startsWith("/./")) input = input.slice(2);
-	else if (input === "/.") input = "/";
-	else if (input.startsWith("/../")) {
-		input = input.slice(3);
-		output = removeLastSegment(output);
-	} else if (input === "/..") {
-		input = "/";
-		output = removeLastSegment(output);
-	} else if (input === "." || input === "..") input = "";
-	else {
-		const start = input.startsWith("/") ? 1 : 0;
-		const next = input.indexOf("/", start);
-		const end = next === -1 ? input.length : next;
-		output += input.slice(0, end);
-		input = input.slice(end);
-	}
-	return output;
-}
-/** Removes dot segments and normalises percent-encoding in a path, relative paths included. */
-function normalizePath(path, options = {}) {
-	let out = normalizePercentEncoding(path);
-	if (out.startsWith("/")) out = removeDotSegments(out);
-	const mode = options.trailingSlash ?? "keep";
-	if (mode === "add" && out.length > 0 && !out.endsWith("/")) out += "/";
-	if (mode === "remove" && out.length > 1 && out.endsWith("/")) out = out.slice(0, -1);
-	return out;
-}
-
-//#endregion
-//#region src/uri/normalize.ts
-/** Default ports of the common schemes, used by `normalizeUri` and `equivalentUris`. */
-const DEFAULT_PORTS = {
-	http: 80,
-	https: 443,
-	ws: 80,
-	wss: 443,
-	ftp: 21
-};
 /** Splits an authority into userinfo, host and port. */
 function parseAuthority(authority) {
 	const at = authority.lastIndexOf("@");
@@ -109,184 +75,6 @@ function serializeAuthority(components) {
 	if (components.port !== void 0) out += ":" + components.port;
 	return out;
 }
-/** RFC 3986 section 6.2 syntax-based and scheme-based normalisation: case, percent-encoding, dot segments, default ports, empty path. */
-function normalizeUri(input, options = {}) {
-	const ports = options.defaultPorts ?? DEFAULT_PORTS;
-	const schemeBased = options.schemeBased ?? true;
-	const c = parseUri(input);
-	const scheme = c.scheme?.toLowerCase();
-	if (scheme !== void 0) c.scheme = scheme;
-	const defaultPort = scheme === void 0 || !schemeBased ? void 0 : ports[scheme];
-	if (c.authority !== void 0) {
-		const a = parseAuthority(c.authority);
-		const userinfo = options.userinfo ?? "keep";
-		if (userinfo === "strip") delete a.userinfo;
-		else if (a.userinfo !== void 0) {
-			if (userinfo === "strip-password") a.userinfo = a.userinfo.split(":", 1)[0] ?? "";
-			a.userinfo = normalizePercentEncoding(a.userinfo);
-		}
-		a.host = normalizePercentEncoding(a.host.replace(/[A-Z]+/g, (m) => m.toLowerCase()));
-		if (a.port !== void 0 && (a.port === "" || Number(a.port) === defaultPort)) delete a.port;
-		c.authority = serializeAuthority(a);
-	}
-	c.path = normalizePercentEncoding(c.path);
-	if (c.scheme !== void 0 || c.authority !== void 0) c.path = removeDotSegments(c.path);
-	if (schemeBased && c.scheme !== void 0 && c.authority !== void 0 && c.path === "") c.path = "/";
-	if (c.query !== void 0) c.query = normalizePercentEncoding(c.query);
-	if (c.fragment !== void 0) c.fragment = normalizePercentEncoding(c.fragment);
-	return serializeUri(c);
-}
-
-//#endregion
-//#region src/uri/resolve.ts
-/** RFC 3986 section 5.2.3: merges a relative path reference with the base path. */
-function mergePaths(base, referencePath) {
-	if (base.authority !== void 0 && base.path === "") return "/" + referencePath;
-	const index = base.path.lastIndexOf("/");
-	return index === -1 ? referencePath : base.path.slice(0, index + 1) + referencePath;
-}
-/**
-* RFC 3986 section 5.2 reference resolution; every section 5.4 example passes.
-* @throws {TypeError} when `base` is not an absolute URI, unless `allowRelativeBase` is set.
-*/
-function resolveUri(base, reference, options = {}) {
-	const b = parseUri(base);
-	if (b.scheme === void 0 && options.allowRelativeBase !== true) throw new RangeError("resolveUri: base must be an absolute-URI (RFC 3986 §5.1); pass { allowRelativeBase: true } to resolve against a relative reference");
-	delete b.fragment;
-	if (b.scheme !== void 0 || b.authority !== void 0) b.path = removeDotSegments(b.path);
-	const r = parseUri(reference);
-	if (!(options.strict ?? true) && r.scheme !== void 0 && b.scheme !== void 0 && r.scheme.toLowerCase() === b.scheme.toLowerCase()) delete r.scheme;
-	const target = { path: "" };
-	if (r.scheme !== void 0) {
-		target.scheme = r.scheme;
-		if (r.authority !== void 0) target.authority = r.authority;
-		target.path = removeDotSegments(r.path);
-		if (r.query !== void 0) target.query = r.query;
-	} else {
-		if (r.authority !== void 0) {
-			target.authority = r.authority;
-			target.path = removeDotSegments(r.path);
-			if (r.query !== void 0) target.query = r.query;
-		} else {
-			if (r.path === "") {
-				target.path = b.path;
-				const query = r.query ?? b.query;
-				if (query !== void 0) target.query = query;
-			} else {
-				target.path = removeDotSegments(r.path.startsWith("/") ? r.path : mergePaths(b, r.path));
-				if (r.query !== void 0) target.query = r.query;
-			}
-			if (b.authority !== void 0) target.authority = b.authority;
-		}
-		if (b.scheme !== void 0) target.scheme = b.scheme;
-	}
-	if (r.fragment !== void 0) target.fragment = r.fragment;
-	return serializeUri(target);
-}
-
-//#endregion
-//#region src/uri/compare.ts
-function withoutFragment(uri) {
-	const c = parseUri(uri);
-	delete c.fragment;
-	return serializeUri(c);
-}
-function prepare(uri, options) {
-	let out = options.base === void 0 ? uri : resolveUri(options.base, uri);
-	if (options.ignoreFragment === true) out = withoutFragment(out);
-	switch (options.level ?? "scheme") {
-		case "simple": return out;
-		case "syntax": return normalizeUri(out, { schemeBased: false });
-		default: return options.defaultPorts === void 0 ? normalizeUri(out) : normalizeUri(out, { defaultPorts: options.defaultPorts });
-	}
-}
-/** Whether two URIs identify the same resource under the chosen normalisation level. IRIs are never mapped to URIs (RFC 3987 section 5.3.1). */
-function equivalentUris(a, b, options = {}) {
-	return prepare(a, options) === prepare(b, options);
-}
-/** RFC 3986 section 4.4: whether `reference` resolved against `base` differs from it only in the fragment. */
-function isSameDocumentReference(base, reference, options = {}) {
-	const target = withoutFragment(resolveUri(base, reference));
-	const origin = withoutFragment(base);
-	return options.normalize === true ? normalizeUri(target) === normalizeUri(origin) : target === origin;
-}
-
-//#endregion
-//#region src/uri/encode.ts
-/** Encodes one path segment so that `/`, `?` and `#` inside it cannot be mistaken for delimiters. */
-function encodePathSegment(segment, options = {}) {
-	return percentEncode(segment, options.noColon ? "segment-nz-nc" : "pchar");
-}
-/** Encodes each segment of `path`, keeping the `/` separators. */
-function encodePath(path, options = {}) {
-	const noColonFirst = options.relative === true && !path.startsWith("/");
-	return path.split("/").map((segment, index) => encodePathSegment(segment, { noColon: noColonFirst && index === 0 })).join("/");
-}
-/** Encodes `query` with the RFC 3986 `query` set, keeping `/`, `?`, `=` and `&`. */
-function encodeQuery(query) {
-	return percentEncode(query, "query");
-}
-/** Encodes `fragment` with the RFC 3986 `fragment` set. */
-function encodeFragment(fragment) {
-	return percentEncode(fragment, "fragment");
-}
-/** `application/x-www-form-urlencoded` encoding of one value: spaces become `+`, `*-._` and alphanumerics stay. */
-function encodeForm(value) {
-	return percentEncode(value, "form");
-}
-
-//#endregion
-//#region src/uri/extract.ts
-const WRAPPERS = [
-	["<", ">"],
-	["\"", "\""],
-	["'", "'"],
-	["(", ")"],
-	["[", "]"],
-	["{", "}"]
-];
-const TRAILING_PUNCTUATION = /[.,;:!?'"]+$/;
-const LEADING_PUNCTUATION = /^[(<["'{]+/;
-const MARKDOWN_LINK = /^\[[^\]]*\]\(\s*(?:<([^>]*)>|([^)\s]+))(?:\s+["'][^"']*["'])?\s*\)$/;
-const HTML_ATTRIBUTE = /\b(?:href|src|action|content)\s*=\s*(["'])(.*?)\1/i;
-/** RFC 3986 Appendix C: recovers a URI from text that wraps it in `<>`, quotes or brackets, prefixes it with `URL:`, breaks it across lines or ends it with punctuation. Markdown links and `href`/`src` attributes yield their URL. */
-function extractUri(text) {
-	let out = text.trim().replace(/^url:\s*/i, "");
-	const markdown = MARKDOWN_LINK.exec(out);
-	if (markdown !== null) return extractUri(markdown[1] ?? markdown[2] ?? "");
-	const attribute = HTML_ATTRIBUTE.exec(out);
-	if (attribute !== null) return extractUri(attribute[2] ?? "");
-	let wrapped = true;
-	while (wrapped) {
-		wrapped = false;
-		for (const [open, close] of WRAPPERS) if (out.length >= 2 && out.startsWith(open) && out.endsWith(close)) {
-			out = out.slice(open.length, -close.length).trim();
-			wrapped = true;
-		}
-		for (const [open, close] of WRAPPERS) {
-			const closeAt = out.lastIndexOf(close);
-			if (out.startsWith(open) && closeAt !== -1 && open !== close) {
-				out = out.slice(open.length, closeAt).trim();
-				wrapped = true;
-				break;
-			}
-		}
-	}
-	out = out.replace(LEADING_PUNCTUATION, "");
-	out = out.replace(/\s+/g, "");
-	let trimmed = true;
-	while (trimmed) {
-		trimmed = false;
-		const before = out;
-		out = out.replace(TRAILING_PUNCTUATION, "");
-		for (const [open, close] of WRAPPERS) if (open !== close && out.endsWith(close) && count(out, open) < count(out, close)) out = out.slice(0, -close.length);
-		if (out !== before) trimmed = true;
-	}
-	return out;
-}
-function count(text, char) {
-	return text.split(char).length - 1;
-}
 
 //#endregion
 //#region src/uri/host.ts
@@ -318,6 +106,54 @@ function isIPv6Address(text) {
 	const right = h16Groups(text.slice(gap + 2), true);
 	return left >= 0 && right >= 0 && left + right <= 7;
 }
+function splitGroups(part) {
+	return part === "" ? [] : part.split(":");
+}
+function zeroRun(groups) {
+	let bestStart = -1;
+	let bestLength = 0;
+	let i = 0;
+	while (i < groups.length) {
+		if (groups[i] !== "0") {
+			i += 1;
+			continue;
+		}
+		let j = i;
+		while (j < groups.length && groups[j] === "0") j += 1;
+		if (j - i > bestLength) {
+			bestStart = i;
+			bestLength = j - i;
+		}
+		i = j;
+	}
+	return [bestStart, bestLength];
+}
+/** RFC 5952 canonical text of an IPv6 address: lowercase, no leading zeros, the longest zero run as `::`, an embedded IPv4 tail kept. Anything that is not an IPv6 address is returned as is. */
+function normalizeIPv6Address(text) {
+	if (!isIPv6Address(text)) return text;
+	const lower = text.toLowerCase();
+	const lastColon = lower.lastIndexOf(":");
+	const tail = lower.includes(".", lastColon) ? lower.slice(lastColon + 1) : void 0;
+	const body = tail === void 0 ? lower : lower.slice(0, lastColon + 1);
+	const total = tail === void 0 ? 8 : 6;
+	const gap = body.indexOf("::");
+	let groups;
+	if (gap === -1) groups = splitGroups(body.replace(/:$/, ""));
+	else {
+		const left = splitGroups(body.slice(0, gap));
+		const right = splitGroups(body.slice(gap + 2).replace(/:$/, ""));
+		groups = [
+			...left,
+			...Array.from({ length: total - left.length - right.length }, () => "0"),
+			...right
+		];
+	}
+	groups = groups.map((group) => group.replace(/^0+(?=.)/, ""));
+	const [start, length] = zeroRun(groups);
+	const out = length >= 2 ? `${groups.slice(0, start).join(":")}::${groups.slice(start + length).join(":")}` : groups.join(":");
+	if (tail === void 0) return out;
+	return out.endsWith(":") ? out + tail : `${out}:${tail}`;
+}
 /** RFC 3986 `IPvFuture`: `v` + hex + `.` + unreserved or sub-delims. */
 function isIPvFuture(text) {
 	return IPV_FUTURE.test(text);
@@ -363,6 +199,46 @@ function isHost(text) {
 	return parseHost(text) !== void 0;
 }
 
+//#endregion
+//#region src/uri/path.ts
+function removeLastSegment(output) {
+	const index = output.lastIndexOf("/");
+	return index === -1 ? "" : output.slice(0, index);
+}
+/** RFC 3986 section 5.2.4, the two-buffer algorithm as written: resolves `.` and `..` segments. */
+function removeDotSegments(path) {
+	let input = path;
+	let output = "";
+	while (input.length > 0) if (input.startsWith("../")) input = input.slice(3);
+	else if (input.startsWith("./")) input = input.slice(2);
+	else if (input.startsWith("/./")) input = input.slice(2);
+	else if (input === "/.") input = "/";
+	else if (input.startsWith("/../")) {
+		input = input.slice(3);
+		output = removeLastSegment(output);
+	} else if (input === "/..") {
+		input = "/";
+		output = removeLastSegment(output);
+	} else if (input === "." || input === "..") input = "";
+	else {
+		const start = input.startsWith("/") ? 1 : 0;
+		const next = input.indexOf("/", start);
+		const end = next === -1 ? input.length : next;
+		output += input.slice(0, end);
+		input = input.slice(end);
+	}
+	return output;
+}
+/** Removes dot segments and normalises percent-encoding in a path, relative paths included. */
+function normalizePath(path, options = {}) {
+	let out = normalizePercentEncoding(path);
+	if (out.startsWith("/")) out = removeDotSegments(out);
+	const mode = options.trailingSlash ?? "keep";
+	if (mode === "add" && out.length > 0 && !out.endsWith("/")) out += "/";
+	if (mode === "remove" && out.length > 1 && out.endsWith("/")) out = out.slice(0, -1);
+	return out;
+}
+
 //#endregion
 //#region src/uri/punycode.ts
 const BASE = 36;
@@ -542,6 +418,293 @@ function domainToUnicode(host) {
 	return host.endsWith(".") && out !== "" ? `${out}.` : out;
 }
 
+//#endregion
+//#region src/uri/normalize.ts
+/** Default ports of the common schemes, used by `normalizeUri` and `equivalentUris`. */
+const DEFAULT_PORTS = {
+	http: 80,
+	https: 443,
+	ws: 80,
+	wss: 443,
+	ftp: 21
+};
+/** RFC 3986 section 6.2 syntax-based and scheme-based normalisation: case, percent-encoding, dot segments, default ports, empty path. */
+function normalizeUri(input, options = {}) {
+	const ports = options.defaultPorts ?? DEFAULT_PORTS;
+	const schemeBased = options.schemeBased ?? true;
+	const c = parseUri(input);
+	const scheme = c.scheme?.toLowerCase();
+	if (scheme !== void 0) c.scheme = scheme;
+	const defaultPort = scheme === void 0 || !schemeBased ? void 0 : ports[scheme];
+	if (c.authority !== void 0) {
+		const a = parseAuthority(c.authority);
+		const userinfo = options.userinfo ?? "keep";
+		if (userinfo === "strip") delete a.userinfo;
+		else if (a.userinfo !== void 0) {
+			if (userinfo === "strip-password") a.userinfo = a.userinfo.split(":", 1)[0] ?? "";
+			a.userinfo = normalizePercentEncoding(a.userinfo);
+		}
+		a.host = normalizePercentEncoding(a.host.replace(/[A-Z]+/g, (m) => m.toLowerCase()));
+		if (options.strict === true) {
+			if (!isHost(a.host)) throw new TypeError(`normalizeUri: invalid host ${JSON.stringify(a.host)}`);
+			if (a.port !== void 0 && !/^\d*$/.test(a.port)) throw new TypeError(`normalizeUri: invalid port ${JSON.stringify(a.port)}`);
+		}
+		if (isIPLiteral(a.host)) a.host = `[${normalizeIPv6Address(a.host.slice(1, -1))}]`;
+		else if (options.host === "idna") a.host = domainToAscii(a.host);
+		else if (options.host === "unicode") a.host = domainToUnicode(a.host);
+		if (a.port !== void 0 && (a.port === "" || Number(a.port) === defaultPort)) delete a.port;
+		c.authority = serializeAuthority(a);
+	}
+	c.path = normalizePercentEncoding(c.path);
+	if (c.scheme !== void 0 || c.authority !== void 0) c.path = removeDotSegments(c.path);
+	if (schemeBased && c.scheme !== void 0 && c.authority !== void 0 && c.path === "") c.path = "/";
+	const trailing = options.trailingSlash ?? "keep";
+	if (trailing === "remove" && c.path.length > 1 && c.path.endsWith("/")) c.path = c.path.replace(/\/+$/, "");
+	else if (trailing === "add" && c.path !== "" && !c.path.endsWith("/")) c.path += "/";
+	if (c.query !== void 0) c.query = normalizePercentEncoding(c.query);
+	if (c.fragment !== void 0) c.fragment = normalizePercentEncoding(c.fragment);
+	if (options.emptyQuery === "remove" && c.query === "") delete c.query;
+	if (options.emptyFragment === "remove" && c.fragment === "") delete c.fragment;
+	return serializeUri(c);
+}
+
+//#endregion
+//#region src/uri/helpers.ts
+/** RFC 6454 origin of a URI: lowercase `scheme://host` plus the port unless it is the scheme's default. `undefined` when there is no scheme or no authority. */
+function getOrigin(uri) {
+	const c = parseUri(uri, { authority: true });
+	if (c.scheme === void 0 || c.host === void 0) return void 0;
+	const scheme = c.scheme.toLowerCase();
+	return `${scheme}://${c.host.replace(/[A-Z]+/g, (m) => m.toLowerCase())}${c.port === void 0 || c.port === "" || Number(c.port) === DEFAULT_PORTS[scheme] ? "" : `:${c.port}`}`;
+}
+/** Whether two URIs share an RFC 6454 origin. Two URIs without an origin never match. */
+function isSameOrigin(a, b) {
+	const origin = getOrigin(a);
+	return origin !== void 0 && origin === getOrigin(b);
+}
+/** The URI without its fragment. */
+function stripFragment(uri) {
+	const c = parseUri(uri);
+	if (c.fragment === void 0) return uri;
+	delete c.fragment;
+	return serializeUri(c);
+}
+/** Decodes an `application/x-www-form-urlencoded` query (`a=1&b=2`, `+` as space) into pairs in order; a leading `?` is ignored. */
+function parseQuery(query) {
+	const text = query.startsWith("?") ? query.slice(1) : query;
+	const out = [];
+	if (text === "") return out;
+	for (const part of text.split("&")) {
+		if (part === "") continue;
+		const eq = part.indexOf("=");
+		const name = eq === -1 ? part : part.slice(0, eq);
+		const value = eq === -1 ? "" : part.slice(eq + 1);
+		out.push([percentDecode(name, { plusAsSpace: true }), percentDecode(value, { plusAsSpace: true })]);
+	}
+	return out;
+}
+/** Encodes pairs as an `application/x-www-form-urlencoded` query without the leading `?`. */
+function stringifyQuery(pairs) {
+	const parts = [];
+	for (const [name, value] of pairs) parts.push(`${percentEncode(name, "form")}=${percentEncode(value, "form")}`);
+	return parts.join("&");
+}
+/** The URI with its query parameters sorted by name, then value, byte-wise on the encoded text; parameters are otherwise left as written. */
+function sortQuery(uri) {
+	const c = parseUri(uri);
+	if (c.query === void 0 || c.query === "") return uri;
+	const parts = c.query.split("&").filter((part) => part !== "");
+	parts.sort((x, y) => {
+		const [xn, xv] = splitPair(x);
+		const [yn, yv] = splitPair(y);
+		return xn < yn ? -1 : xn > yn ? 1 : xv < yv ? -1 : xv > yv ? 1 : 0;
+	});
+	c.query = parts.join("&");
+	return serializeUri(c);
+}
+function splitPair(part) {
+	const eq = part.indexOf("=");
+	return eq === -1 ? [part, ""] : [part.slice(0, eq), part.slice(eq + 1)];
+}
+/** Joins path pieces with single slashes, keeps the first piece's leading slash and the last piece's trailing slash, and resolves `.` and `..` so the result never contains `//` or a dot segment. */
+function joinPaths(...pieces) {
+	const parts = pieces.filter((piece) => piece !== "");
+	if (parts.length === 0) return "";
+	const first = parts[0] ?? "";
+	const last = parts[parts.length - 1] ?? "";
+	const leading = first.startsWith("/") ? "/" : "";
+	const trailing = last.endsWith("/") && last !== "/" ? "/" : "";
+	const body = parts.map((piece) => piece.replace(/^\/+|\/+$/g, "")).filter((piece) => piece !== "").join("/");
+	if (body === "") return leading === "" ? "" : "/";
+	const joined = normalizePath(leading + body.replace(/\/{2,}/g, "/"));
+	return joined === "/" || joined === "" ? joined : joined + trailing;
+}
+
+//#endregion
+//#region src/uri/resolve.ts
+/** RFC 3986 section 5.2.3: merges a relative path reference with the base path. */
+function mergePaths(base, referencePath) {
+	if (base.authority !== void 0 && base.path === "") return "/" + referencePath;
+	const index = base.path.lastIndexOf("/");
+	return index === -1 ? referencePath : base.path.slice(0, index + 1) + referencePath;
+}
+/**
+* RFC 3986 section 5.2 reference resolution; every section 5.4 example passes.
+* @throws {TypeError} when `base` is not an absolute URI, unless `allowRelativeBase` is set.
+*/
+function resolveUri(base, reference, options = {}) {
+	const b = parseUri(base);
+	if (b.scheme === void 0 && options.allowRelativeBase !== true) throw new RangeError("resolveUri: base must be an absolute-URI (RFC 3986 §5.1); pass { allowRelativeBase: true } to resolve against a relative reference");
+	delete b.fragment;
+	if (b.scheme !== void 0 || b.authority !== void 0) b.path = removeDotSegments(b.path);
+	const r = parseUri(reference);
+	if (!(options.strict ?? true) && r.scheme !== void 0 && b.scheme !== void 0 && r.scheme.toLowerCase() === b.scheme.toLowerCase()) delete r.scheme;
+	const target = { path: "" };
+	if (r.scheme !== void 0) {
+		target.scheme = r.scheme;
+		if (r.authority !== void 0) target.authority = r.authority;
+		target.path = removeDotSegments(r.path);
+		if (r.query !== void 0) target.query = r.query;
+	} else {
+		if (r.authority !== void 0) {
+			target.authority = r.authority;
+			target.path = removeDotSegments(r.path);
+			if (r.query !== void 0) target.query = r.query;
+		} else {
+			if (r.path === "") {
+				target.path = b.path;
+				const query = r.query ?? b.query;
+				if (query !== void 0) target.query = query;
+			} else {
+				target.path = removeDotSegments(r.path.startsWith("/") ? r.path : mergePaths(b, r.path));
+				if (r.query !== void 0) target.query = r.query;
+			}
+			if (b.authority !== void 0) target.authority = b.authority;
+		}
+		if (b.scheme !== void 0) target.scheme = b.scheme;
+	}
+	if (r.fragment !== void 0) target.fragment = r.fragment;
+	return serializeUri(target);
+}
+
+//#endregion
+//#region src/uri/compare.ts
+function prepare(uri, options) {
+	let out = options.base === void 0 ? uri : resolveUri(options.base, uri);
+	if (options.ignoreFragment === true) out = stripFragment(out);
+	switch (options.level ?? "scheme") {
+		case "simple": return out;
+		case "syntax": return normalizeUri(out, { schemeBased: false });
+		default: return options.defaultPorts === void 0 ? normalizeUri(out) : normalizeUri(out, { defaultPorts: options.defaultPorts });
+	}
+}
+/** Whether two URIs identify the same resource under the chosen normalisation level. IRIs are never mapped to URIs (RFC 3987 section 5.3.1). */
+function equivalentUris(a, b, options = {}) {
+	return prepare(a, options) === prepare(b, options);
+}
+/** RFC 3986 section 4.4: whether `reference` resolved against `base` differs from it only in the fragment. */
+function isSameDocumentReference(base, reference, options = {}) {
+	const target = stripFragment(resolveUri(base, reference));
+	const origin = stripFragment(base);
+	return options.normalize === true ? normalizeUri(target) === normalizeUri(origin) : target === origin;
+}
+
+//#endregion
+//#region src/uri/encode.ts
+/** Encodes one path segment so that `/`, `?` and `#` inside it cannot be mistaken for delimiters. */
+function encodePathSegment(segment, options = {}) {
+	return percentEncode(segment, options.noColon ? "segment-nz-nc" : "pchar");
+}
+/** Encodes each segment of `path`, keeping the `/` separators. */
+function encodePath(path, options = {}) {
+	const noColonFirst = options.relative === true && !path.startsWith("/");
+	return path.split("/").map((segment, index) => encodePathSegment(segment, { noColon: noColonFirst && index === 0 })).join("/");
+}
+/** Encodes `query` with the RFC 3986 `query` set, keeping `/`, `?`, `=` and `&`. */
+function encodeQuery(query) {
+	return percentEncode(query, "query");
+}
+/** Encodes `fragment` with the RFC 3986 `fragment` set. */
+function encodeFragment(fragment) {
+	return percentEncode(fragment, "fragment");
+}
+/** `application/x-www-form-urlencoded` encoding of one value: spaces become `+`, `*-._` and alphanumerics stay. */
+function encodeForm(value) {
+	return percentEncode(value, "form");
+}
+
+//#endregion
+//#region src/uri/extract.ts
+const WRAPPERS = [
+	["<", ">"],
+	["\"", "\""],
+	["'", "'"],
+	["(", ")"],
+	["[", "]"],
+	["{", "}"]
+];
+const TRAILING_PUNCTUATION = /[.,;:!?'"]+$/;
+const LEADING_PUNCTUATION = /^[(<["'{]+/;
+const MARKDOWN_LINK = /^\[[^\]]*\]\(\s*(?:<([^>]*)>|([^)\s]+))(?:\s+["'][^"']*["'])?\s*\)$/;
+const HTML_ATTRIBUTE = /\b(?:href|src|action|content)\s*=\s*(["'])(.*?)\1/i;
+const IN_PROSE = /\b(?:[A-Za-z][A-Za-z0-9+.-]*:\/\/|(?:mailto|tel|urn|data|sms|geo|magnet|xmpp|sip|sips):|www\.)[^\s<>"']+/g;
+/** Finds the URIs in ordinary text: anything with `scheme://`, a `www.` host, or a `mailto:`, `tel:`, `urn:`, `data:` style scheme, ending at whitespace or a quote and trimmed of trailing punctuation the way `extractUri` does. */
+function findUris(text) {
+	const out = [];
+	for (const match of text.matchAll(IN_PROSE)) {
+		const uri = trimTrailing(match[0]);
+		if (uri === "" || uri.startsWith("www.") && !uri.includes(".", 4)) continue;
+		out.push({
+			uri,
+			start: match.index,
+			end: match.index + uri.length
+		});
+	}
+	return out;
+}
+/** RFC 3986 Appendix C: recovers a URI from text that wraps it in `<>`, quotes or brackets, prefixes it with `URL:`, breaks it across lines or ends it with punctuation. Markdown links and `href`/`src` attributes yield their URL. */
+function extractUri(text) {
+	let out = text.trim().replace(/^url:\s*/i, "");
+	const markdown = MARKDOWN_LINK.exec(out);
+	if (markdown !== null) return extractUri(markdown[1] ?? markdown[2] ?? "");
+	const attribute = HTML_ATTRIBUTE.exec(out);
+	if (attribute !== null) return extractUri(attribute[2] ?? "");
+	let wrapped = true;
+	while (wrapped) {
+		wrapped = false;
+		for (const [open, close] of WRAPPERS) if (out.length >= 2 && out.startsWith(open) && out.endsWith(close)) {
+			out = out.slice(open.length, -close.length).trim();
+			wrapped = true;
+		}
+		for (const [open, close] of WRAPPERS) {
+			const closeAt = out.lastIndexOf(close);
+			if (out.startsWith(open) && closeAt !== -1 && open !== close) {
+				out = out.slice(open.length, closeAt).trim();
+				wrapped = true;
+				break;
+			}
+		}
+	}
+	out = out.replace(LEADING_PUNCTUATION, "");
+	out = out.replace(/\s+/g, "");
+	return trimTrailing(out);
+}
+function trimTrailing(text) {
+	let out = text;
+	let trimmed = true;
+	while (trimmed) {
+		trimmed = false;
+		const before = out;
+		out = out.replace(TRAILING_PUNCTUATION, "");
+		for (const [open, close] of WRAPPERS) if (open !== close && out.endsWith(close) && count(out, open) < count(out, close)) out = out.slice(0, -close.length);
+		if (out !== before) trimmed = true;
+	}
+	return out;
+}
+function count(text, char) {
+	return text.split(char).length - 1;
+}
+
 //#endregion
 //#region src/uri/iri.ts
 /** RFC 3987 `ucschar`: the non-ASCII code points an IRI may contain unencoded. */
@@ -793,4 +956,4 @@ function isIri(input) {
 }
 
 //#endregion
-export { DEFAULT_PORTS, classifyReference, domainToAscii, domainToUnicode, encodeForm, encodeFragment, encodePath, encodePathSegment, encodeQuery, equivalentUris, extractUri, hasBidiControls, iriToUri, isAbsoluteUri, isAlpha, isBidiControl, isDigit, isGenDelim, isHexDigit, isHost, isIPLiteral, isIPv4Address, isIPv6Address, isIPvFuture, isIpchar, isIprivate, isIri, isIriReference, isIunreserved, isPchar, isQueryChar, isRegName, isRelativeReference, isReserved, isSameDocumentReference, isScheme, isSegmentNzNc, isSubDelim, isUcschar, isUnreserved, isUri, isUriReference, mergePaths, normalizePath, normalizePercentEncoding, normalizeUri, parseAuthority, parseHost, parseUri, pathForm, percentDecode, percentEncode, punycodeDecode, punycodeEncode, relativize, removeDotSegments, resolveEncodeSet, resolveUri, serializeAuthority, serializeUri, uriToIri };
+export { DEFAULT_PORTS, classifyReference, domainToAscii, domainToUnicode, encodeForm, encodeFragment, encodePath, encodePathSegment, encodeQuery, equivalentUris, extractUri, findUris, getOrigin, hasBidiControls, iriToUri, isAbsoluteUri, isAlpha, isBidiControl, isDigit, isGenDelim, isHexDigit, isHost, isIPLiteral, isIPv4Address, isIPv6Address, isIPvFuture, isIpchar, isIprivate, isIri, isIriReference, isIunreserved, isPchar, isQueryChar, isRegName, isRelativeReference, isReserved, isSameDocumentReference, isSameOrigin, isScheme, isSegmentNzNc, isSubDelim, isUcschar, isUnreserved, isUri, isUriReference, joinPaths, mergePaths, normalizeIPv6Address, normalizePath, normalizePercentEncoding, normalizeUri, parseAuthority, parseHost, parseQuery, parseUri, pathForm, percentDecode, percentEncode, punycodeDecode, punycodeEncode, relativize, removeDotSegments, resolveEncodeSet, resolveUri, serializeAuthority, serializeUri, sortQuery, stringifyQuery, stripFragment, uriToIri };