@unicom-cloud/utils 0.1.38 → 0.1.40

package/snapdom/modules/snapFetch.js

@@ -0,0 +1,253 @@
+/* 潘启宝 2026-04-03 14:06:50 星期五 */
+import { safeEncodeURI as e } from "../utils/helpers.js";
+//#region utils/snapdom/modules/snapFetch.js
+function t(e = "[snapDOM]", { ttlMs: t = 5 * 6e4, maxEntries: n = 12 } = {}) {
+	let r = /* @__PURE__ */ new Map(), i = 0;
+	function a(a, o, s) {
+		if (i >= n) return;
+		let c = Date.now();
+		(r.get(o) || 0) > c || (r.set(o, c + t), i++, a === "warn" && console && console.warn ? console.warn(`${e} ${s}`) : console && console.error && console.error(`${e} ${s}`));
+	}
+	return {
+		warnOnce(e, t) {
+			a("warn", e, t);
+		},
+		errorOnce(e, t) {
+			a("error", e, t);
+		},
+		reset() {
+			r.clear(), i = 0;
+		}
+	};
+}
+var n = t("[snapDOM]", {
+	ttlMs: 3 * 6e4,
+	maxEntries: 10
+}), r = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map();
+function a(e) {
+	return /^data:|^blob:|^about:blank$/i.test(e);
+}
+function o(e, t) {
+	try {
+		let n = typeof location < "u" && location.href ? location.href : "http://localhost/", r = t.includes("{url}") ? t.split("{url}")[0] : t, i = new URL(r || ".", n), a = new URL(e, n);
+		if (a.origin === i.origin) return !0;
+		let o = a.searchParams;
+		if (o && (o.has("url") || o.has("target"))) return !0;
+	} catch {}
+	return !1;
+}
+function s(e, t) {
+	if (!t || a(e) || o(e, t)) return !1;
+	try {
+		let t = typeof location < "u" && location.href ? location.href : "http://localhost/", n = new URL(e, t);
+		return typeof location < "u" ? n.origin !== location.origin : !0;
+	} catch {
+		return !!t;
+	}
+}
+function c(t, n) {
+	return n ? n.includes("{url}") ? n.replace("{urlRaw}", e(t)).replace("{url}", encodeURIComponent(t)) : /[?&]url=?$/.test(n) ? `${n}${encodeURIComponent(t)}` : n.endsWith("?") ? `${n}url=${encodeURIComponent(t)}` : n.endsWith("/") ? `${n}${e(t)}` : `${n}${n.includes("?") ? "&" : "?"}url=${encodeURIComponent(t)}` : t;
+}
+function l(e) {
+	return new Promise((t, n) => {
+		let r = new FileReader();
+		r.onload = () => t(String(r.result || "")), r.onerror = () => n(/* @__PURE__ */ Error("read_failed")), r.readAsDataURL(e);
+	});
+}
+function u(e, t) {
+	return [
+		t.as || "blob",
+		t.timeout ?? 3e3,
+		t.useProxy || "",
+		t.errorTTL ?? 8e3,
+		e
+	].join("|");
+}
+async function d(e, t = {}) {
+	let a = t.as ?? "blob", o = t.timeout ?? 3e3, d = t.useProxy || "", f = t.errorTTL ?? 8e3, p = t.headers || {}, m = !!t.silent;
+	if (/^data:/i.test(e)) try {
+		if (a === "text") return {
+			ok: !0,
+			data: String(e),
+			status: 200,
+			url: e,
+			fromCache: !1
+		};
+		if (a === "dataURL") return {
+			ok: !0,
+			data: String(e),
+			status: 200,
+			url: e,
+			fromCache: !1,
+			mime: String(e).slice(5).split(";")[0] || ""
+		};
+		let [, t = "", n = ""] = String(e).match(/^data:([^,]*),(.*)$/) || [], r = /;base64/i.test(t) ? atob(n) : decodeURIComponent(n), i = new Uint8Array([...r].map((e) => e.charCodeAt(0))), o = new Blob([i], { type: (t || "").split(";")[0] || "" });
+		return {
+			ok: !0,
+			data: o,
+			status: 200,
+			url: e,
+			fromCache: !1,
+			mime: o.type || ""
+		};
+	} catch {
+		return {
+			ok: !1,
+			data: null,
+			status: 0,
+			url: e,
+			fromCache: !1,
+			reason: "special_url_error"
+		};
+	}
+	if (/^blob:/i.test(e)) try {
+		let t = await fetch(e);
+		if (!t.ok) return {
+			ok: !1,
+			data: null,
+			status: t.status,
+			url: e,
+			fromCache: !1,
+			reason: "http_error"
+		};
+		let n = await t.blob(), r = n.type || t.headers.get("content-type") || "";
+		return a === "dataURL" ? {
+			ok: !0,
+			data: await l(n),
+			status: t.status,
+			url: e,
+			fromCache: !1,
+			mime: r
+		} : a === "text" ? {
+			ok: !0,
+			data: await n.text(),
+			status: t.status,
+			url: e,
+			fromCache: !1,
+			mime: r
+		} : {
+			ok: !0,
+			data: n,
+			status: t.status,
+			url: e,
+			fromCache: !1,
+			mime: r
+		};
+	} catch {
+		return {
+			ok: !1,
+			data: null,
+			status: 0,
+			url: e,
+			fromCache: !1,
+			reason: "network"
+		};
+	}
+	if (/^about:blank$/i.test(e)) return a === "dataURL" ? {
+		ok: !0,
+		data: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR4nGMAAQAABQABDQottAAAAABJRU5ErkJggg==",
+		status: 200,
+		url: e,
+		fromCache: !1,
+		mime: "image/png"
+	} : {
+		ok: !0,
+		data: a === "text" ? "" : new Blob([]),
+		status: 200,
+		url: e,
+		fromCache: !1
+	};
+	let h = u(e, {
+		as: a,
+		timeout: o,
+		useProxy: d,
+		errorTTL: f
+	}), g = i.get(h);
+	if (g && g.until > Date.now()) return {
+		...g.result,
+		fromCache: !0
+	};
+	g && i.delete(h);
+	let _ = r.get(h);
+	if (_) return _;
+	let v = s(e, d) ? c(e, d) : e, y = t.credentials;
+	if (!y) try {
+		let t = typeof location < "u" && location.href ? location.href : "http://localhost/", n = new URL(e, t);
+		y = typeof location < "u" && n.origin === location.origin ? "include" : "omit";
+	} catch {
+		y = "omit";
+	}
+	let b = new AbortController(), x = setTimeout(() => b.abort("timeout"), o), S = (async () => {
+		try {
+			let r = await fetch(v, {
+				signal: b.signal,
+				credentials: y,
+				headers: p
+			});
+			if (!r.ok) {
+				let o = {
+					ok: !1,
+					data: null,
+					status: r.status,
+					url: v,
+					fromCache: !1,
+					reason: "http_error"
+				};
+				if (f > 0 && i.set(h, {
+					until: Date.now() + f,
+					result: o
+				}), !m) {
+					let t = `${r.status} ${r.statusText || ""}`.trim();
+					n.warnOnce(`http:${r.status}:${a}:${new URL(e, location?.href ?? "http://localhost/").origin}`, `HTTP error ${t} while fetching ${a} ${e}`);
+				}
+				return t.onError && t.onError(o), o;
+			}
+			if (a === "text") return {
+				ok: !0,
+				data: await r.text(),
+				status: r.status,
+				url: v,
+				fromCache: !1
+			};
+			let o = await r.blob(), s = o.type || r.headers.get("content-type") || "";
+			return a === "dataURL" ? {
+				ok: !0,
+				data: await l(o),
+				status: r.status,
+				url: v,
+				fromCache: !1,
+				mime: s
+			} : {
+				ok: !0,
+				data: o,
+				status: r.status,
+				url: v,
+				fromCache: !1,
+				mime: s
+			};
+		} catch (r) {
+			let s = r && typeof r == "object" && "name" in r && r.name === "AbortError" ? String(r.message || "").includes("timeout") ? "timeout" : "abort" : "network", c = {
+				ok: !1,
+				data: null,
+				status: 0,
+				url: v,
+				fromCache: !1,
+				reason: s
+			};
+			if (!/^blob:/i.test(e) && f > 0 && i.set(h, {
+				until: Date.now() + f,
+				result: c
+			}), !m) {
+				let t = `${s}:${a}:${new URL(e, location?.href ?? "http://localhost/").origin}`, r = s === "timeout" ? `Timeout after ${o}ms. Consider increasing timeout or using a proxy for ${e}` : s === "abort" ? `Request aborted while fetching ${a} ${e}` : `Network/CORS issue while fetching ${a} ${e}. A proxy may be required`;
+				n.errorOnce(t, r);
+			}
+			return t.onError && t.onError(c), c;
+		} finally {
+			clearTimeout(x), r.delete(h);
+		}
+	})();
+	return r.set(h, S), S;
+}
+//#endregion
+export { d as snapFetch };
+/* 独立思考，明辨是非 */

package/snapdom/modules/styles.js

@@ -0,0 +1,198 @@
+/* 潘启宝 2026-04-03 14:06:50 星期五 */
+import { cache as e } from "../core/cache.js";
+import { getStyleKey as t, shouldIgnoreProp as n } from "../utils/css.js";
+import "../utils/index.js";
+//#region utils/snapdom/modules/styles.js
+var r = /* @__PURE__ */ new WeakMap(), i = /* @__PURE__ */ new Map(), a = 2e3, o = 0;
+function s() {
+	o++, i.size > a && i.clear();
+}
+var c = !1;
+function l(e = document.documentElement) {
+	if (!c) {
+		c = !0;
+		try {
+			new MutationObserver(() => s()).observe(e, {
+				subtree: !0,
+				childList: !0,
+				characterData: !0,
+				attributes: !0
+			});
+		} catch {}
+		try {
+			new MutationObserver(() => s()).observe(document.head, {
+				subtree: !0,
+				childList: !0,
+				characterData: !0,
+				attributes: !0
+			});
+		} catch {}
+		try {
+			let e = document.fonts;
+			e && (e.addEventListener?.("loadingdone", s), e.ready?.then(() => s()).catch(() => {}));
+		} catch {}
+	}
+}
+function u(e, t = {}) {
+	let r = {}, i = e.getPropertyValue("visibility"), a = t.excludeStyleProps;
+	for (let t = 0; t < e.length; t++) {
+		let i = e[t];
+		if (n(i) || a && (a instanceof RegExp && a.test(i) || typeof a == "function" && a(i))) continue;
+		let o = e.getPropertyValue(i);
+		(i === "background-image" || i === "content") && o.includes("url(") && !o.includes("data:") && (o = "none"), r[i] = o;
+	}
+	for (let t of [
+		"text-decoration-line",
+		"text-decoration-color",
+		"text-decoration-style",
+		"text-decoration-thickness",
+		"text-underline-offset",
+		"text-decoration-skip-ink"
+	]) if (!r[t]) try {
+		let n = e.getPropertyValue(t);
+		n && (r[t] = n);
+	} catch {}
+	for (let t of [
+		"-webkit-text-stroke",
+		"-webkit-text-stroke-width",
+		"-webkit-text-stroke-color",
+		"paint-order"
+	]) if (!r[t]) try {
+		let n = e.getPropertyValue(t);
+		n && (r[t] = n);
+	} catch {}
+	if (t.embedFonts) {
+		for (let t of [
+			"font-feature-settings",
+			"font-variation-settings",
+			"font-kerning",
+			"font-variant",
+			"font-variant-ligatures",
+			"font-optical-sizing"
+		]) if (!r[t]) try {
+			let n = e.getPropertyValue(t);
+			n && (r[t] = n);
+		} catch {}
+	}
+	i === "hidden" && (r.opacity = "0");
+	try {
+		(r["content-visibility"] || e.getPropertyValue("content-visibility")) === "hidden" && (r.visibility = "hidden");
+	} catch {}
+	let o = parseFloat(e.getPropertyValue("border-top-width") || 0) || 0, s = parseFloat(e.getPropertyValue("border-right-width") || 0) || 0, c = parseFloat(e.getPropertyValue("border-bottom-width") || 0) || 0, l = parseFloat(e.getPropertyValue("border-left-width") || 0) || 0;
+	if (o === 0 && s === 0 && c === 0 && l === 0) {
+		let t = (e.getPropertyValue("border-image-source") || "").trim(), n = t && t !== "none";
+		for (let e of /* @__PURE__ */ "border.border-top.border-right.border-bottom.border-left.border-width.border-style.border-color.border-top-width.border-top-style.border-top-color.border-right-width.border-right-style.border-right-color.border-bottom-width.border-bottom-style.border-bottom-color.border-left-width.border-left-style.border-left-color.border-block.border-block-width.border-block-style.border-block-color.border-inline.border-inline-width.border-inline-style.border-inline-color".split(".")) delete r[e];
+		n || (r.border = "none");
+	}
+	return r;
+}
+var d = /* @__PURE__ */ new WeakMap();
+function f(e) {
+	let t = d.get(e);
+	return t || (t = Object.entries(e).sort((e, t) => e[0] < t[0] ? -1 : e[0] > t[0] ? 1 : 0).map(([e, t]) => `${e}:${t}`).join(";"), d.set(e, t), t);
+}
+function p(e, t = null, n = {}) {
+	let i = r.get(e);
+	if (i && i.epoch === o) return i.snapshot;
+	let a = t || getComputedStyle(e), s = u(a, n);
+	return x(e, a, s), r.set(e, {
+		epoch: o,
+		snapshot: s
+	}), s;
+}
+function m(t, n) {
+	return t && t.session && t.persist ? t : t && (t.styleMap || t.styleCache || t.nodeMap) ? {
+		session: t,
+		persist: {
+			snapshotKeyCache: i,
+			defaultStyle: e.defaultStyle,
+			baseStyle: e.baseStyle,
+			image: e.image,
+			resource: e.resource,
+			background: e.background,
+			font: e.font
+		},
+		options: n || {}
+	} : {
+		session: e.session,
+		persist: {
+			snapshotKeyCache: i,
+			defaultStyle: e.defaultStyle,
+			baseStyle: e.baseStyle,
+			image: e.image,
+			resource: e.resource,
+			background: e.background,
+			font: e.font
+		},
+		options: t || n || {}
+	};
+}
+function h(e, t, n) {
+	if (!(!e.style || e.style.length === 0)) for (let r = 0; r < e.style.length; r++) {
+		let i = e.style[r], a = n.getPropertyValue(i);
+		a && t.style.setProperty(i, a);
+	}
+}
+async function g(e, n, r, a) {
+	if (e.tagName === "STYLE") return;
+	let o = m(r, a), c = o.options && o.options.cache || "auto";
+	c !== "disabled" && l(document.documentElement), c === "disabled" && !o.session.__bumpedForDisabled && (s(), i.clear(), o.session.__bumpedForDisabled = !0);
+	let { session: u, persist: d } = o;
+	if (!u.styleCache.has(e)) {
+		let t = null;
+		try {
+			t = getComputedStyle(e);
+		} catch {}
+		u.styleCache.set(e, t || getComputedStyle(document.documentElement));
+	}
+	let g = u.styleCache.get(e);
+	e.getAttribute?.("style") && h(e, n, g);
+	let _ = p(e, g, o.options), v = f(_), y = d.snapshotKeyCache.get(v);
+	y || (y = t(_, e.tagName?.toLowerCase() || "div"), d.snapshotKeyCache.set(v, y)), u.styleMap.set(n, y);
+}
+function _(e) {
+	return e instanceof HTMLImageElement || e instanceof HTMLCanvasElement || e instanceof HTMLVideoElement || e instanceof HTMLIFrameElement || e instanceof SVGElement || e instanceof HTMLObjectElement || e instanceof HTMLEmbedElement;
+}
+function v(e) {
+	return e.backgroundImage && e.backgroundImage !== "none" || e.backgroundColor && e.backgroundColor !== "rgba(0, 0, 0, 0)" && e.backgroundColor !== "transparent" || (parseFloat(e.borderTopWidth) || 0) > 0 || (parseFloat(e.borderBottomWidth) || 0) > 0 || (parseFloat(e.paddingTop) || 0) > 0 || (parseFloat(e.paddingBottom) || 0) > 0 ? !0 : (e.overflowBlock || e.overflowY || "visible") !== "visible";
+}
+function y(e) {
+	let t = e.parentElement;
+	if (!t) return !1;
+	let n = getComputedStyle(t).display || "";
+	return n.includes("flex") || n.includes("grid");
+}
+function b(e, t) {
+	if (e.textContent && /\S/.test(e.textContent)) return !0;
+	let n = e.firstElementChild, r = e.lastElementChild;
+	if (n && n.tagName === "BR" || r && r.tagName === "BR") return !0;
+	let i = e.scrollHeight;
+	return i === 0 ? !1 : i > (parseFloat(t.paddingTop) || 0) + (parseFloat(t.paddingBottom) || 0);
+}
+function x(e, t, n) {
+	if (e instanceof HTMLElement && e.style && e.style.height) return;
+	let r = e.tagName && e.tagName.toLowerCase();
+	if (!r || ![
+		"div",
+		"section",
+		"article",
+		"main",
+		"aside",
+		"header",
+		"footer",
+		"nav"
+	].includes(r)) return;
+	let i = parseFloat(t.height);
+	if (Number.isFinite(i) && e.scrollHeight > 0 && Math.abs(i - e.scrollHeight) > 2 || t.aspectRatio && t.aspectRatio !== "none" && t.aspectRatio !== "auto") return;
+	let a = t.display || "";
+	if (a.includes("flex") || a.includes("grid") || _(e)) return;
+	let o = t.position;
+	if (o === "absolute" || o === "fixed" || o === "sticky" || t.transform !== "none" || v(t) || y(e)) return;
+	let s = t.overflowX || t.overflow || "visible", c = t.overflowY || t.overflow || "visible";
+	if (s !== "visible" || c !== "visible") return;
+	let l = t.clip;
+	l && l !== "auto" && l !== "rect(auto, auto, auto, auto)" || t.visibility === "hidden" || t.opacity === "0" || b(e, t) && (delete n.height, delete n["block-size"]);
+}
+//#endregion
+export { g as inlineAllStyles };
+/* 独立思考，明辨是非 */

package/snapdom/modules/svgDefs.js

@@ -0,0 +1,98 @@
+/* 潘启宝 2026-04-03 14:06:50 星期五 */
+//#region utils/snapdom/modules/svgDefs.js
+function e(e, t) {
+	if (!e || !(e instanceof Element)) return;
+	let n = e.ownerDocument || document, r = t || n, i = e instanceof SVGSVGElement ? [e] : Array.from(e.querySelectorAll("svg"));
+	if (i.length === 0) return;
+	let a = /url\(\s*#([^)]+)\)/g, o = [
+		"fill",
+		"stroke",
+		"filter",
+		"clip-path",
+		"mask",
+		"marker",
+		"marker-start",
+		"marker-mid",
+		"marker-end"
+	], s = (e) => window.CSS && CSS.escape ? CSS.escape(e) : e.replace(/[^a-zA-Z0-9_-]/g, "\\$&"), c = (e) => {
+		if (!e || !e.getAttribute) return null;
+		let t = e.getAttribute("href") || e.getAttribute("xlink:href") || (typeof e.getAttributeNS == "function" ? e.getAttributeNS("http://www.w3.org/1999/xlink", "href") : null);
+		if (t) return t;
+		let n = e.attributes;
+		if (!n) return null;
+		for (let e = 0; e < n.length; e++) {
+			let t = n[e];
+			if (!t || !t.name) continue;
+			if (t.name === "href") return t.value;
+			let r = t.name.indexOf(":");
+			if (r !== -1 && t.name.slice(r + 1) === "href") return t.value;
+		}
+		return null;
+	}, l = new Set(Array.from(e.querySelectorAll("[id]")).map((e) => e.id)), u = /* @__PURE__ */ new Set(), d = !1, f = (e, t = null) => {
+		if (!e) return;
+		a.lastIndex = 0;
+		let n;
+		for (; n = a.exec(e);) {
+			d = !0;
+			let e = (n[1] || "").trim();
+			e && (l.has(e) || (u.add(e), t && !t.has(e) && t.add(e)));
+		}
+	}, p = (e) => {
+		let t = e.querySelectorAll("use");
+		for (let e of t) {
+			let t = c(e);
+			if (!t || !t.startsWith("#")) continue;
+			d = !0;
+			let n = t.slice(1).trim();
+			n && !l.has(n) && u.add(n);
+		}
+		let n = e.querySelectorAll("*[style*=\"url(\"],*[fill^=\"url(\"], *[stroke^=\"url(\"],*[filter^=\"url(\"],*[clip-path^=\"url(\"],*[mask^=\"url(\"],*[marker^=\"url(\"],*[marker-start^=\"url(\"],*[marker-mid^=\"url(\"],*[marker-end^=\"url(\"]");
+		for (let e of n) {
+			f(e.getAttribute("style") || "");
+			for (let t of o) f(e.getAttribute(t));
+		}
+	};
+	for (let e of i) p(e);
+	if (!d) return;
+	let m = e.querySelector("svg.inline-defs-container");
+	m || (m = n.createElementNS("http://www.w3.org/2000/svg", "svg"), m.classList.add("inline-defs-container"), m.setAttribute("aria-hidden", "true"), m.setAttribute("style", "position:absolute;width:0;height:0;overflow:hidden"), e.insertBefore(m, e.firstChild || null));
+	let h = m.querySelector("defs") || null, g = (t) => {
+		if (!t || l.has(t)) return null;
+		let n = s(t), i = (t) => {
+			let n = r.querySelector(t);
+			return n && !e.contains(n) ? n : null;
+		};
+		return i(`svg defs > *#${n}`) || i(`svg > symbol#${n}`) || i(`*#${n}`);
+	};
+	if (!u.size) return;
+	let _ = new Set(u), v = /* @__PURE__ */ new Set();
+	for (; _.size;) {
+		let e = _.values().next().value;
+		if (_.delete(e), !e || l.has(e) || v.has(e)) continue;
+		let t = g(e);
+		if (!t) {
+			v.add(e);
+			continue;
+		}
+		h || (h = n.createElementNS("http://www.w3.org/2000/svg", "defs"), m.appendChild(h));
+		let r = t.cloneNode(!0);
+		r.id || r.setAttribute("id", e), h.appendChild(r), v.add(e), l.add(e);
+		let i = [r, ...r.querySelectorAll("*")];
+		for (let e of i) {
+			let t = c(e);
+			if (t && t.startsWith("#")) {
+				let e = t.slice(1).trim();
+				e && !l.has(e) && !v.has(e) && _.add(e);
+			}
+			let n = e.getAttribute?.("style") || "";
+			n && f(n, _);
+			for (let t of o) {
+				let n = e.getAttribute?.(t);
+				n && f(n, _);
+			}
+		}
+	}
+}
+//#endregion
+export { e as inlineExternalDefsAndSymbols };
+/* 独立思考，明辨是非 */

package/snapdom/utils/browser.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Creates a promise that resolves after the specified delay
+ * @param {number} [ms=0] - Milliseconds to delay
+ * @returns {Promise<void>} Promise that resolves after the delay
+ */
+export function idle(fn: any, { fast }?: {
+    fast?: boolean | undefined;
+}): Promise<void>;
+export function isIOS(): boolean;
+export function isSafari(): boolean;
+export function isFirefox(): boolean;

package/snapdom/utils/browser.js

@@ -0,0 +1,25 @@
+/* 潘启宝 2026-04-03 14:06:50 星期五 */
+//#region utils/snapdom/utils/browser.js
+function e(e, { fast: t = !1 } = {}) {
+	if (t) return e();
+	"requestIdleCallback" in window ? requestIdleCallback(e, { timeout: 50 }) : setTimeout(e, 1);
+}
+function t() {
+	if (typeof navigator > "u") return !1;
+	if (navigator.userAgentData) return navigator.userAgentData.platform === "iOS";
+	let e = navigator.userAgent || "", t = /iPhone|iPad|iPod/.test(e), n = navigator.maxTouchPoints > 2 && /Macintosh/.test(e);
+	return t || n;
+}
+function n() {
+	if (typeof navigator > "u") return !1;
+	let e = navigator.userAgent || "", t = e.toLowerCase(), n = t.includes("safari") && !t.includes("chrome") && !t.includes("crios") && !t.includes("fxios") && !t.includes("android"), r = /applewebkit/i.test(e), i = /mobile/i.test(e), a = !/safari/i.test(e), o = r && i && a, s = /(micromessenger|wxwork|wecom|windowswechat|macwechat)/i.test(e), c = /(baiduboxapp|baidubrowser|baidusearch|baiduboxlite)/i.test(t), l = /ipad|iphone|ipod/.test(t) && r;
+	return n || o || s || c || l;
+}
+function r() {
+	if (typeof navigator > "u") return !1;
+	let e = (navigator.userAgent || "").toLowerCase();
+	return e.includes("firefox") || e.includes("fxios");
+}
+//#endregion
+export { e as idle, r as isFirefox, t as isIOS, n as isSafari };
+/* 独立思考，明辨是非 */

package/snapdom/utils/capture.helpers.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Strip shadow-like visuals on the CLONE ROOT ONLY (box/text-shadow, outline, blur()/drop-shadow()).
+ * Children remain intact.
+ * @param {Element} originalEl
+ * @param {HTMLElement} cloneRoot
+ * @param {Object} [opts] - optional { debug } for verbose logging
+ */
+export function stripRootShadows(originalEl: Element, cloneRoot: HTMLElement, opts?: Object): void;
+/** Remove all HTML comments (prevents invalid XML like "--") */
+export function removeAllComments(root: any): void;
+/**
+ * Sanitize attributes to produce valid XHTML inside foreignObject.
+ * - Drop "@", unknown ":" prefixes
+ * - Drop common framework directives (x-*, v-*, :*, on:*, bind:*, let:*, class:*)
+ */
+export function sanitizeAttributesForXHTML(root: any, opts?: {}): void;
+export function sanitizeCloneForXHTML(root: any, opts?: {}): void;
+/**
+ * Post-clone "shrink pass": for parents that lost children due to excludeMode:"remove",
+ * override snapshot sizes so they can collapse naturally.
+ *
+ * It writes inline overrides on the CLONE (never the real DOM):
+ *   - height/width: auto
+ *   - remove logical sizes (block-size/inline-size)
+ *   - relax min/max to allow collapse
+ *
+ * @param {Element} sourceRoot - original subtree root (for reading computed styles)
+ * @param {HTMLElement} cloneRoot - cloned subtree root (to write overrides)
+ * @param {Map<Element, CSSStyleDeclaration>} styleCache - optional cache you already build
+ */
+export function shrinkAutoSizeBoxes(sourceRoot: Element, cloneRoot: HTMLElement, styleCache?: Map<Element, CSSStyleDeclaration>): void;
+/**
+ * Compute the kept-children vertical span inside container's content box.
+ * We take the min(top) and max(bottom) of included, in-flow children,
+ * then add container paddings and borders to rebuild total height.
+ * This avoids double-counting collapsed margins.
+ * @param {Element} container
+ * @param {any} options
+ * @returns {number} estimated outerHeight (border+padding+content)
+ */
+export function estimateKeptHeight(container: Element, options: any): number;
+/**
+ * Extract ::-webkit-scrollbar rules from the document's stylesheets.
+ * Used so custom scrollbar styling appears in capture (#334).
+ * @param {Document} doc
+ * @returns {string}
+ */
+export function collectScrollbarCSS(doc: Document): string;
+export function limitDecimals(v: any, n?: number): any;