@unicom-cloud/utils 0.1.39 → 0.1.41

package/snapdom/{src/api → api}/preCache.js

@@ -1,4 +1,4 @@
-/* 潘启宝 2026-03-24 15:26:16 星期二 */
+/* 潘启宝 2026-04-14 16:53:57 星期二 */
 import { EvictingMap as e, applyCachePolicy as t, cache as n } from "../core/cache.js";
 import { isSafari as r } from "../utils/browser.js";
 import { getStyle as i, precacheCommonTags as a } from "../utils/css.js";
@@ -7,7 +7,7 @@ import { inlineSingleBackgroundEntry as s } from "../utils/image.js";
 import "../utils/index.js";
 import { inlineBackgroundImages as c } from "../modules/background.js";
 import { collectUsedCodepoints as l, collectUsedFontVariants as u, embedCustomFonts as d, ensureFontsReady as f } from "../modules/fonts.js";
-//#region utils/snapdom/src/api/preCache.js
+//#region utils/snapdom/api/preCache.js
 async function p(p = document, m = {}) {
 	let { embedFonts: h = !0, useProxy: g = "" } = m;
 	t(m.cache ?? m.cacheOpt ?? "full");

package/snapdom/{src/api → api}/snapdom.js

@@ -1,4 +1,4 @@
-/* 潘启宝 2026-03-24 15:26:16 星期二 */
+/* 潘启宝 2026-04-14 16:53:57 星期二 */
 import { isSafari as e } from "../utils/browser.js";
 import { debugWarn as t } from "../utils/debug.js";
 import { extendIconFonts as n } from "../modules/iconFonts.js";
@@ -7,91 +7,72 @@ import "./preCache.js";
 import { attachSessionPlugins as a, registerPlugins as o, runAll as s, runHook as c } from "../core/plugins.js";
 import { captureDOM as l } from "../core/capture.js";
 import { createContext as u } from "../core/context.js";
-//#region utils/snapdom/src/api/snapdom.js
-function d(...e) {
-	return o(...e), f;
+import { toCanvas as d } from "../exporters/toCanvas.js";
+import { toBlob as f } from "../exporters/toBlob.js";
+import { download as p } from "../exporters/download.js";
+import { rasterize as m } from "../modules/rasterize.js";
+import { toImg as h } from "../exporters/toImg.js";
+//#region utils/snapdom/api/snapdom.js
+function g(...e) {
+	return o(...e), _;
 }
-var f = Object.assign(g, { plugins: d }), p = Symbol("snapdom.internal"), m = Symbol("snapdom.internal.silent"), h = !1;
-async function g(t, o) {
+var _ = Object.assign(x, { plugins: g }), v = Symbol("snapdom.internal"), y = Symbol("snapdom.internal.silent"), b = !1;
+async function x(t, o) {
 	if (!t) throw Error("Element cannot be null or undefined");
 	let s = u(o);
-	if (a(s, o && o.plugins), e() && (s.embedFonts === !0 || v(t))) {
+	if (a(s, o && o.plugins), e() && (s.embedFonts === !0 || C(t))) {
 		if (s.embedFonts) try {
 			let e = r(t);
 			await i(new Set([...e].map((e) => String(e).split("__")[0]).filter(Boolean)), 1);
 		} catch {}
 		let e = s.safariWarmupAttempts ?? 3;
 		for (let n = 0; n < e; n++) try {
-			await _(t, o);
+			await S(t, o);
 		} catch {}
 	}
 	return s.iconFonts && s.iconFonts.length > 0 && n(s.iconFonts), s.snap ||= {
-		toPng: (e, t) => f.toPng(e, t),
-		toSvg: (e, t) => f.toSvg(e, t)
-	}, f.capture(t, s, p);
+		toPng: (e, t) => _.toPng(e, t),
+		toSvg: (e, t) => _.toSvg(e, t)
+	}, _.capture(t, s, v);
 }
-f.capture = async (e, t, n) => {
-	if (n !== p) throw Error("[snapdom.capture] is internal. Use snapdom(...) instead.");
+_.capture = async (e, t, n) => {
+	if (n !== v) throw Error("[snapdom.capture] is internal. Use snapdom(...) instead.");
 	let r = await l(e, t), i = {
-		img: async (e, t) => {
-			let { toImg: n } = await import("../exporters/toImg.js");
-			return n(r, {
-				...e,
-				...t || {}
-			});
-		},
-		svg: async (e, t) => {
-			let { toSvg: n } = await import("../exporters/toImg.js");
-			return n(r, {
-				...e,
-				...t || {}
-			});
-		},
-		canvas: async (e, t) => {
-			let { toCanvas: n } = await import("../exporters/toCanvas.js");
-			return n(r, {
-				...e,
-				...t || {}
-			});
-		},
-		blob: async (e, t) => {
-			let { toBlob: n } = await import("../exporters/toBlob.js");
-			return n(r, {
-				...e,
-				...t || {}
-			});
-		},
-		png: async (e, t) => {
-			let { rasterize: n } = await import("../modules/rasterize.js");
-			return n(r, {
-				...e,
-				...t || {},
-				format: "png"
-			});
-		},
-		jpeg: async (e, t) => {
-			let { rasterize: n } = await import("../modules/rasterize.js");
-			return n(r, {
-				...e,
-				...t || {},
-				format: "jpeg"
-			});
-		},
-		webp: async (e, t) => {
-			let { rasterize: n } = await import("../modules/rasterize.js");
-			return n(r, {
-				...e,
-				...t || {},
-				format: "webp"
-			});
-		},
-		download: async (e, t) => {
-			let { download: n } = await import("../exporters/download.js");
-			return n(r, {
-				...e,
-				...t || {}
-			});
-		}
+		img: async (e, t) => h(r, {
+			...e,
+			...t || {}
+		}),
+		svg: async (e, t) => h(r, {
+			...e,
+			...t || {}
+		}),
+		canvas: async (e, t) => d(r, {
+			...e,
+			...t || {}
+		}),
+		blob: async (e, t) => f(r, {
+			...e,
+			...t || {}
+		}),
+		png: async (e, t) => m(r, {
+			...e,
+			...t || {},
+			format: "png"
+		}),
+		jpeg: async (e, t) => m(r, {
+			...e,
+			...t || {},
+			format: "jpeg"
+		}),
+		webp: async (e, t) => m(r, {
+			...e,
+			...t || {},
+			format: "webp"
+		}),
+		download: async (e, t) => p(r, {
+			...e,
+			...t || {}
+		})
 	}, a = {};
 	for (let e of [
 		"img",
@@ -103,31 +84,31 @@ f.capture = async (e, t, n) => {
 		"webp"
 	]) a[e] = async (n) => i[e](t, {
 		...n || {},
-		[m]: !0
+		[y]: !0
 	});
 	a.jpg = a.jpeg;
 	let o = await s("defineExports", {
 		...t,
 		export: { url: r },
 		exports: a
-	}), u = Object.assign({}, ...o.filter((e) => e && typeof e == "object")), d = {
+	}), u = Object.assign({}, ...o.filter((e) => e && typeof e == "object")), g = {
 		...i,
 		...u
 	};
-	d.jpeg && !d.jpg && (d.jpg = (e, t) => d.jpeg(e, t));
-	function f(e, n) {
+	g.jpeg && !g.jpg && (g.jpg = (e, t) => g.jpeg(e, t));
+	function _(e, n) {
 		let r = {
 			...t,
 			...n || {}
 		};
 		return (e === "jpeg" || e === "jpg") && (r.backgroundColor == null || r.backgroundColor === "transparent") && (r.backgroundColor = "#ffffff"), r;
 	}
-	let h = !1, g = Promise.resolve();
-	async function _(e, n) {
-		return g = g.then(async () => {
-			let i = d[e];
+	let b = !1, x = Promise.resolve();
+	async function S(e, n) {
+		return x = x.then(async () => {
+			let i = g[e];
 			if (!i) throw Error(`[snapdom] Unknown export type: ${e}`);
-			let a = f(e, n), o = {
+			let a = _(e, n), o = {
 				...t,
 				export: {
 					type: e,
@@ -137,39 +118,39 @@ f.capture = async (e, t, n) => {
 			};
 			await c("beforeExport", o);
 			let s = await i(o, a);
-			return await c("afterExport", o, s), h || (h = !0, await c("afterSnap", t)), s;
+			return await c("afterExport", o, s), b || (b = !0, await c("afterSnap", t)), s;
 		});
 	}
-	let v = {
+	let C = {
 		url: r,
 		toRaw: () => r,
-		to: (e, t) => _(e, t),
-		toImg: (e) => _("img", e),
-		toSvg: (e) => _("svg", e),
-		toCanvas: (e) => _("canvas", e),
-		toBlob: (e) => _("blob", e),
-		toPng: (e) => _("png", e),
-		toJpg: (e) => _("jpg", e),
-		toWebp: (e) => _("webp", e),
-		download: (e) => _("download", e)
+		to: (e, t) => S(e, t),
+		toImg: (e) => S("img", e),
+		toSvg: (e) => S("svg", e),
+		toCanvas: (e) => S("canvas", e),
+		toBlob: (e) => S("blob", e),
+		toPng: (e) => S("png", e),
+		toJpg: (e) => S("jpg", e),
+		toWebp: (e) => S("webp", e),
+		download: (e) => S("download", e)
 	};
-	for (let e of Object.keys(d)) {
+	for (let e of Object.keys(g)) {
 		let t = "to" + e.charAt(0).toUpperCase() + e.slice(1);
-		v[t] || (v[t] = (t) => _(e, t));
+		C[t] || (C[t] = (t) => S(e, t));
 	}
-	return v;
-}, f.toRaw = (e, t) => f(e, t).then((e) => e.toRaw()), f.toImg = (e, t) => f(e, t).then((e) => e.toImg()), f.toSvg = (e, t) => f(e, t).then((e) => e.toSvg()), f.toCanvas = (e, t) => f(e, t).then((e) => e.toCanvas()), f.toBlob = (e, t) => f(e, t).then((e) => e.toBlob()), f.toPng = (e, t) => f(e, {
+	return C;
+}, _.toRaw = (e, t) => _(e, t).then((e) => e.toRaw()), _.toImg = (e, t) => _(e, t).then((e) => e.toImg()), _.toSvg = (e, t) => _(e, t).then((e) => e.toSvg()), _.toCanvas = (e, t) => _(e, t).then((e) => e.toCanvas()), _.toBlob = (e, t) => _(e, t).then((e) => e.toBlob()), _.toPng = (e, t) => _(e, {
 	...t,
 	format: "png"
-}).then((e) => e.toPng()), f.toJpg = (e, t) => f(e, {
+}).then((e) => e.toPng()), _.toJpg = (e, t) => _(e, {
 	...t,
 	format: "jpeg"
-}).then((e) => e.toJpg()), f.toWebp = (e, t) => f(e, {
+}).then((e) => e.toJpg()), _.toWebp = (e, t) => _(e, {
 	...t,
 	format: "webp"
-}).then((e) => e.toWebp()), f.download = (e, t) => f(e, t).then((e) => e.download());
-async function _(e, n) {
-	if (h) return;
+}).then((e) => e.toWebp()), _.download = (e, t) => _(e, t).then((e) => e.download());
+async function S(e, n) {
+	if (b) return;
 	let r = {
 		...n,
 		fast: !0,
@@ -218,9 +199,9 @@ async function _(e, n) {
 		} catch (e) {
 			t(n, "safariWarmup canvas poke failed", e);
 		}
-	}), h = !0;
+	}), b = !0;
 }
-function v(e) {
+function C(e) {
 	let t = document.createTreeWalker(e, NodeFilter.SHOW_ELEMENT);
 	for (; t.nextNode();) {
 		let e = t.currentNode, n = getComputedStyle(e), r = n.backgroundImage && n.backgroundImage !== "none", i = n.maskImage && n.maskImage !== "none" || n.webkitMaskImage && n.webkitMaskImage !== "none";
@@ -229,5 +210,5 @@ function v(e) {
 	return !1;
 }
 //#endregion
-export { f as default };
+export { _ as default };
 /* 独立思考，明辨是非 */

package/snapdom/{src/core → core}/cache.d.ts

@@ -20,6 +20,7 @@ export namespace cache {
     let defaultStyle: EvictingMap;
     let baseStyle: EvictingMap;
     let computedStyle: WeakMap<WeakKey, any>;
+    let measureHints: WeakMap<WeakKey, any>;
     let font: Set<any>;
     namespace session {
         let styleMap: Map<any, any>;

package/snapdom/{src/core → core}/cache.js

@@ -1,5 +1,5 @@
-/* 潘启宝 2026-03-24 15:26:16 星期二 */
-//#region utils/snapdom/src/core/cache.js
+/* 潘启宝 2026-04-14 16:53:57 星期二 */
+//#region utils/snapdom/core/cache.js
 var e = 100, t = 100, n = 150, r = 50, i = 30, a = class extends Map {
 	constructor(e = 100, ...t) {
 		super(...t), this._maxSize = e;
@@ -18,6 +18,7 @@ var e = 100, t = 100, n = 150, r = 50, i = 30, a = class extends Map {
 	defaultStyle: new a(i),
 	baseStyle: new a(r),
 	computedStyle: /* @__PURE__ */ new WeakMap(),
+	measureHints: /* @__PURE__ */ new WeakMap(),
 	font: /* @__PURE__ */ new Set(),
 	session: {
 		styleMap: /* @__PURE__ */ new Map(),

package/snapdom/core/capture.js

@@ -0,0 +1,180 @@
+/* 潘启宝 2026-04-14 16:53:57 星期二 */
+import { applyCachePolicy as e, cache as t } from "./cache.js";
+import { idle as n, isSafari as r } from "../utils/browser.js";
+import { collectUsedTagNames as i, generateDedupedBaseCSS as a, getStyle as o } from "../utils/css.js";
+import "../utils/index.js";
+import { inlineBackgroundImages as s } from "../modules/background.js";
+import { ligatureIconToImage as c } from "../modules/iconFonts.js";
+import { collectUsedCodepoints as l, collectUsedFontVariants as u, embedCustomFonts as d, ensureFontsReady as f } from "../modules/fonts.js";
+import { inlineImages as p } from "../modules/images.js";
+import { lineClampTree as m } from "../modules/lineClamp.js";
+import { runPictureResolverBeforeClone as h } from "../modules/pictureResolver.js";
+import { collectScrollbarCSS as g, estimateKeptHeight as _, limitDecimals as v, sanitizeCloneForXHTML as y, shrinkAutoSizeBoxes as b, stripRootShadows as x } from "../utils/capture.helpers.js";
+import { bboxWithOriginFull as S, hasBBoxAffectingTransform as C, normalizeRootTransforms as w, parseBoxShadow as T, parseFilterBlur as ee, parseFilterDropShadows as te, parseOutline as ne, parseTransformOriginPx as re, readIndividualTransforms as ie, readTotalTransformMatrix as ae } from "../utils/transforms.helpers.js";
+import { getGlobalPlugins as E, normalizePlugin as D, runHook as O } from "./plugins.js";
+import { prepareClone as k } from "./prepare.js";
+//#region utils/snapdom/core/capture.js
+function A(e) {
+	if (Array.isArray(e.plugins)) {
+		for (let t of e.plugins) if (D(t)?.name === "picture-resolver") return !0;
+	}
+	return E().some((e) => e?.name === "picture-resolver");
+}
+async function j(C, E) {
+	if (!C) throw Error("Element cannot be null or undefined");
+	e(E.cache);
+	let D = E.fast, j = E.outerTransforms !== !1, N = !!E.outerShadows, P = {
+		element: C,
+		options: E,
+		plugins: E.plugins
+	}, F, I, L, R = "", z = "", B, V, H = null;
+	await O("beforeSnap", P);
+	let U = null;
+	E.resolvePicturePlaceholders !== !1 && !A(E) && (U = await h(P.element, P.options)), await O("beforeClone", P);
+	let W = m(P.element);
+	try {
+		({clone: F, classCSS: I, styleCache: L} = await k(P.element, P.options)), !j && F && (H = w(P.element, F)), !N && F && x(P.element, F, P.options);
+	} finally {
+		W();
+	}
+	if (P = {
+		clone: F,
+		classCSS: I,
+		styleCache: L,
+		...P
+	}, await O("afterClone", P), U && await U(), y(P.clone), P.options?.excludeMode === "remove") try {
+		b(P.element, P.clone, P.styleCache);
+	} catch (e) {
+		console.warn("[snapdom] shrink pass failed:", e);
+	}
+	try {
+		await c(P.clone, P.element);
+	} catch {}
+	await new Promise((e) => {
+		n(async () => {
+			await p(P.clone, P.options), e();
+		}, { fast: D });
+	}), await new Promise((e) => {
+		n(async () => {
+			await s(P.element, P.clone, P.styleCache, P.options), e();
+		}, { fast: D });
+	}), E.embedFonts && await new Promise((e) => {
+		n(async () => {
+			let t = u(P.element), n = l(P.element);
+			r() && await f(new Set(Array.from(t).map((e) => String(e).split("__")[0]).filter(Boolean)), 1), R = await d({
+				required: t,
+				usedCodepoints: n,
+				preCached: !1,
+				exclude: P.options.excludeFonts,
+				useProxy: P.options.useProxy,
+				fontStylesheetDomains: P.options.fontStylesheetDomains
+			}), e();
+		}, { fast: D });
+	});
+	let G = i(P.clone).sort(), K = G.join(",");
+	t.baseStyle.has(K) ? z = t.baseStyle.get(K) : await new Promise((e) => {
+		n(() => {
+			z = a(G), t.baseStyle.set(K, z), e();
+		}, { fast: D });
+	});
+	let q = g(P.element?.ownerDocument || document);
+	P = {
+		fontsCSS: R,
+		baseCSS: z,
+		scrollbarCSS: q,
+		...P
+	}, await O("beforeRender", P), await new Promise((e) => {
+		n(() => {
+			let n = o(P.element), i = P.element.getBoundingClientRect(), a = Math.max(1, v(P.element.offsetWidth || parseFloat(n.width) || i.width || 1)), s = Math.max(1, v(P.element.offsetHeight || parseFloat(n.height) || i.height || 1)), c = P.element.ownerDocument || document;
+			if (P.element === c.body || P.element === c.documentElement) {
+				let e = Math.max(P.element.scrollHeight || 0, c.documentElement?.scrollHeight || 0, c.body?.scrollHeight || 0), n = Math.max(P.element.scrollWidth || 0, c.documentElement?.scrollWidth || 0, c.body?.scrollWidth || 0);
+				e > 0 && (s = Math.max(s, v(e))), n > 0 && (a = Math.max(a, v(n)));
+				try {
+					let e = (P.scrollbarCSS || "").length + (P.baseCSS || "").length + (P.fontsCSS || "").length + (P.classCSS || "").length, n = t.measureHints.get(P.element);
+					if (n && n.cssLen === e && n.w0 === a) n.csh > 0 && (s = Math.max(s, v(n.csh))), n.csw > 0 && (a = Math.max(a, v(n.csw)));
+					else {
+						let n = c.createElement("div");
+						n.style.cssText = "position:absolute!important;left:-9999px!important;top:0!important;width:" + a + "px!important;overflow:visible!important;visibility:hidden!important;";
+						let r = c.createElement("style");
+						r.textContent = (P.scrollbarCSS || "") + P.baseCSS + P.fontsCSS + "svg{overflow:visible;} foreignObject{overflow:visible;}" + P.classCSS, n.appendChild(r), n.appendChild(P.clone.cloneNode(!0)), c.body.appendChild(n);
+						let i = n.scrollHeight, o = n.scrollWidth;
+						c.body.removeChild(n), t.measureHints.set(P.element, {
+							cssLen: e,
+							w0: a,
+							csh: i,
+							csw: o
+						}), i > 0 && (s = Math.max(s, v(i))), o > 0 && (a = Math.max(a, v(o)));
+					}
+				} catch {}
+			}
+			if (P.options?.excludeMode === "remove") {
+				let e = _(P.element, P.options);
+				Number.isFinite(e) && e > 0 && (s = Math.max(1, Math.min(s, v(e + 1))));
+			}
+			let l = (e, t = NaN) => {
+				let n = typeof e == "string" ? parseFloat(e) : e;
+				return Number.isFinite(n) ? n : t;
+			}, u = l(P.options.width), d = l(P.options.height), f = a, p = s, m = Number.isFinite(u), h = Number.isFinite(d), g = s > 0 ? a / s : 1;
+			m && h ? (f = Math.max(1, v(u)), p = Math.max(1, v(d))) : m ? (f = Math.max(1, v(u)), p = Math.max(1, v(f / (g || 1)))) : h ? (p = Math.max(1, v(d)), f = Math.max(1, v(p * (g || 1)))) : (f = a, p = s);
+			let y = 0, b = 0, x = a, C = s;
+			if (!j && H && Number.isFinite(H.a)) {
+				let e = {
+					a: H.a,
+					b: H.b || 0,
+					c: H.c || 0,
+					d: H.d || 1,
+					e: 0,
+					f: 0
+				}, t = S(a, s, e, 0, 0);
+				y = v(t.minX), b = v(t.minY), x = v(t.maxX), C = v(t.maxY);
+			} else if (j && M(P.element)) {
+				let e = n.transform && n.transform !== "none" ? n.transform : "", t = ie(P.element), r = ae({
+					baseTransform: e,
+					rotate: t.rotate || "0deg",
+					scale: t.scale,
+					translate: t.translate
+				}), { ox: i, oy: o } = re(n, a, s), c = r.is2D ? r : new DOMMatrix(r.toString()), l = S(a, s, c, i, o);
+				y = v(l.minX), b = v(l.minY), x = v(l.maxX), C = v(l.maxY);
+			}
+			let w = T(n), D = ee(n), O = ne(n), k = te(n), A = N ? {
+				top: v(w.top + D.top + O.top + k.bleed.top),
+				right: v(w.right + D.right + O.right + k.bleed.right),
+				bottom: v(w.bottom + D.bottom + O.bottom + k.bleed.bottom),
+				left: v(w.left + D.left + O.left + k.bleed.left)
+			} : {
+				top: 0,
+				right: 0,
+				bottom: 0,
+				left: 0
+			};
+			y = v(y - A.left), b = v(b - A.top), x = v(x + A.right), C = v(C + A.bottom);
+			let F = Math.max(1, v(x - y)), I = Math.max(1, v(C - b)), L = m || h ? v(f / a) : 1, R = h || m ? v(p / s) : 1, z = Math.max(1, v(F * L)), U = Math.max(1, v(I * R)), W = "http://www.w3.org/2000/svg", G = v((r() && M(P.element) ? 1 : 0) + +!j), K = document.createElementNS(W, "foreignObject"), q = v(y), J = v(b);
+			K.setAttribute("x", String(v(-(q - G)))), K.setAttribute("y", String(v(-(J - G)))), K.setAttribute("width", String(v(a + G * 2))), K.setAttribute("height", String(v(s + G * 2))), K.style.overflow = "visible";
+			let Y = document.createElement("style");
+			Y.textContent = (P.scrollbarCSS || "") + P.baseCSS + P.fontsCSS + "svg{overflow:visible;} foreignObject{overflow:visible;} foreignObject *{min-width:0;} foreignObject pre,foreignObject [style*=\"white-space\"]{white-space:inherit;}" + P.classCSS, K.appendChild(Y);
+			let X = document.createElement("div");
+			X.setAttribute("xmlns", "http://www.w3.org/1999/xhtml"), X.style.cssText = `all:initial;box-sizing:border-box;display:block;overflow:visible;width:${v(a)}px;height:${v(s)}px`, X.appendChild(P.clone), K.appendChild(X);
+			let oe = new XMLSerializer().serializeToString(K), Z = v(F + G * 2), Q = v(I + G * 2), $ = m || h;
+			E.meta = {
+				w0: a,
+				h0: s,
+				vbW: Z,
+				vbH: Q,
+				targetW: f,
+				targetH: p
+			}, V = `<svg xmlns="${W}" width="${r() && $ ? Z : v(z + G * 2)}" height="${r() && $ ? Q : v(U + G * 2)}" viewBox="0 0 ${Z} ${Q}" font-size="${parseFloat(o(c.documentElement)?.fontSize) || 16}px">` + oe + "</svg>", B = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(V)}`, P = {
+				svgString: V,
+				dataURL: B,
+				...P
+			}, e();
+		}, { fast: D });
+	}), await O("afterRender", P);
+	let J = document.getElementById("snapdom-sandbox");
+	return J && J.style.position === "absolute" && J.remove(), P.dataURL;
+}
+function M(e) {
+	return C(e);
+}
+//#endregion
+export { j as captureDOM };
+/* 独立思考，明辨是非 */

package/snapdom/{src/core → core}/clone.js

@@ -1,4 +1,4 @@
-/* 潘启宝 2026-03-24 15:26:16 星期二 */
+/* 潘启宝 2026-04-14 16:53:57 星期二 */
 import { isFirefox as e } from "../utils/browser.js";
 import { NO_CAPTURE_TAGS as t } from "../utils/css.js";
 import { debugWarn as n } from "../utils/debug.js";
@@ -6,13 +6,14 @@ import "../utils/index.js";
 import { inlineAllStyles as r } from "../modules/styles.js";
 import { buildSeedCustomPropsRule as i, collectCustomPropsFromCSS as a, createCheckboxRadioReplacement as o, extractShadowCSS as s, freezeImgSrcset as c, getUnscaledDimensions as l, idleCallback as u, injectScopedStyle as d, markSlottedSubtree as f, nextShadowScopeId as p, rasterizeIframe as m, rewriteShadowCSS as h } from "../utils/clone.helpers.js";
 import { resolveCSSVars as g } from "../modules/CSSVar.js";
-//#region utils/snapdom/src/core/clone.js
+//#region utils/snapdom/core/clone.js
 async function _(v, y, b) {
 	if (!v) throw Error("Invalid node");
 	let x = /* @__PURE__ */ new Set(), S = null, C = null;
 	if (v.nodeType === Node.ELEMENT_NODE) {
 		let e = (v.localName || v.tagName || "").toLowerCase();
 		if (v.id === "snapdom-sandbox" || v.hasAttribute("data-snapdom-sandbox") || t.has(e)) return null;
+		if (e === "foreignobject" && v.parentElement?.closest?.("foreignObject")) return n(y, "Nested <foreignObject> skipped (SVG spec limitation — not rendered by browsers)"), null;
 	}
 	if (v.nodeType === Node.TEXT_NODE || v.nodeType !== Node.ELEMENT_NODE) return v.cloneNode(!0);
 	if (v.getAttribute("data-capture") === "exclude") {
@@ -53,7 +54,7 @@ async function _(v, y, b) {
 		} catch (e) {
 			console.warn("[SnapDOM] iframe rasterization failed, fallback:", e);
 		}
-		if (b.placeholders) {
+		if (e || console.warn("[snapdom] cross-origin <iframe> skipped (cannot access content). Use options.placeholders to show a placeholder instead.", v), b.placeholders) {
 			let { width: e, height: t } = l(v), n = document.createElement("div");
 			return n.style.cssText = `width:${e}px;height:${t}px;background-image:repeating-linear-gradient(45deg,#ddd,#ddd 5px,#f9f9f9 5px,#f9f9f9 10px);display:flex;align-items:center;justify-content:center;font-size:12px;color:#555;border:1px solid #aaa;`, r(v, n, y, b), n;
 		} else {
@@ -98,9 +99,30 @@ async function _(v, y, b) {
 		let { width: i, height: a } = l(v);
 		return i > 0 && (t.style.width = `${i}px`), a > 0 && (t.style.height = `${a}px`), y.nodeMap.set(t, v), r(v, t, y, b), t;
 	}
+	if (v.tagName === "VIDEO") {
+		let e = "";
+		try {
+			let t = document.createElement("canvas");
+			t.width = v.videoWidth || v.offsetWidth || 320, t.height = v.videoHeight || v.offsetHeight || 240;
+			let n = t.getContext("2d");
+			n && (n.drawImage(v, 0, 0, t.width, t.height), e = t.toDataURL("image/png"), (!e || e === "data:,") && (e = ""));
+		} catch (e) {
+			n(y, "Video frame capture failed, using poster fallback", e);
+		}
+		let t = document.createElement("img");
+		try {
+			t.decoding = "sync", t.loading = "eager";
+		} catch {}
+		e ? t.src = e : v.poster && (t.src = v.poster), t.width = v.videoWidth || v.offsetWidth || 0, t.height = v.videoHeight || v.offsetHeight || 0;
+		let { width: i, height: a } = l(v);
+		return i > 0 && (t.style.width = `${i}px`), a > 0 && (t.style.height = `${a}px`), t.style.objectFit = "contain", y.nodeMap.set(t, v), r(v, t, y, b), t;
+	}
 	let w;
 	try {
-		if (w = v.cloneNode(!1), g(v, w), y.nodeMap.set(w, v), v.tagName === "IMG") {
+		if (w = v.cloneNode(!1), w.attributes?.length) try {
+			for (let e of w.attributes) /[\x00-\x08\x0B\x0C\x0E-\x1F\uFFFE\uFFFF]/.test(e.value) && w.setAttribute(e.name, e.value.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\uFFFE\uFFFF]/g, ""));
+		} catch {}
+		if (g(v, w), y.nodeMap.set(w, v), v.tagName === "IMG") {
 			c(v, w);
 			try {
 				let { width: e, height: t } = l(v), n = Math.round(e || 0), r = Math.round(t || 0);
@@ -113,7 +135,9 @@ async function _(v, y, b) {
 					let r = e.match(RegExp(`${n}\\s*:\\s*([^;]+)`, "i")), i = r ? r[1].trim() : t.getPropertyValue(n);
 					return /%|auto/i.test(String(i || ""));
 				}, r = parseInt(w.dataset.snapdomWidth || "0", 10), i = parseInt(w.dataset.snapdomHeight || "0", 10), a = n("width") || !r, o = n("height") || !i;
-				a && r && (w.style.width = `${r}px`), o && i && (w.style.height = `${i}px`), r && (w.style.minWidth = `${r}px`), i && (w.style.minHeight = `${i}px`);
+				a && r && (w.style.width = `${r}px`), o && i && (w.style.height = `${i}px`);
+				let s = t.getPropertyValue("object-fit"), c = t.getPropertyValue("object-position");
+				s && s !== "fill" ? (w.style.objectFit = s, c && (w.style.objectPosition = c)) : (r && (w.style.minWidth = `${r}px`), i && (w.style.minHeight = `${i}px`));
 			} catch (e) {
 				n(y, "IMG dimension freeze failed", e);
 			}
@@ -133,7 +157,53 @@ async function _(v, y, b) {
 			y.nodeMap.set(e, v), T = t, w = e;
 		} else w.value = v.value, w.setAttribute("value", v.value), v.checked !== void 0 && (w.checked = v.checked, v.checked && w.setAttribute("checked", ""), v.indeterminate && (w.indeterminate = v.indeterminate));
 	}
-	if (v instanceof HTMLSelectElement && (S = v.value), v instanceof HTMLTextAreaElement && (C = v.value), r(v, w, y, b), T && T(), v.shadowRoot) {
+	if ((v instanceof HTMLInputElement || v instanceof HTMLTextAreaElement) && !v.value && v.placeholder) try {
+		let e = window.getComputedStyle(v, "::placeholder"), t = e && e.color;
+		if (t && t !== "rgba(0, 0, 0, 0)") {
+			let n = "snapdom-ph-" + (Math.random() * 1e6 | 0);
+			w.classList.add(n);
+			let r = document.createElement("style");
+			r.textContent = `.${n}::placeholder{color:${t}!important;opacity:${e.opacity || "1"}!important;}`, w.prepend(r);
+		}
+	} catch {}
+	if (v instanceof HTMLSelectElement && (S = v.value), v instanceof HTMLTextAreaElement && (C = v.value), v instanceof HTMLInputElement || v instanceof HTMLTextAreaElement || v instanceof HTMLSelectElement) {
+		v.disabled && w.setAttribute("disabled", ""), v.required && w.setAttribute("required", ""), v.readOnly && w.setAttribute("readonly", "");
+		let e = v;
+		e.min !== void 0 && e.min !== "" && w.setAttribute("min", e.min), e.max !== void 0 && e.max !== "" && w.setAttribute("max", e.max), e.pattern !== void 0 && e.pattern !== "" && w.setAttribute("pattern", e.pattern);
+		let t = v.getAttribute("aria-invalid");
+		t !== null && w.setAttribute("aria-invalid", t);
+	}
+	if (r(v, w, y, b), T && T(), v instanceof SVGElement) {
+		let e = [
+			"fill",
+			"stroke",
+			"stroke-width",
+			"stroke-dasharray",
+			"stroke-dashoffset",
+			"stroke-linecap",
+			"stroke-linejoin",
+			"stroke-miterlimit",
+			"opacity",
+			"fill-opacity",
+			"stroke-opacity",
+			"fill-rule",
+			"clip-rule",
+			"marker",
+			"marker-start",
+			"marker-mid",
+			"marker-end",
+			"visibility",
+			"display"
+		];
+		try {
+			let t = window.getComputedStyle(v);
+			for (let n of e) {
+				let e = t.getPropertyValue(n);
+				e && w.style.setProperty(n, e);
+			}
+		} catch {}
+	}
+	if (v.shadowRoot) {
 		try {
 			let e = v.shadowRoot.querySelectorAll("slot");
 			for (let t of e) {

package/snapdom/{src/core → core}/context.d.ts

@@ -27,6 +27,8 @@
  * @param {boolean} [options.outerTransforms] // NEW
  * @param {boolean} [options.outerShadows]      // NEW
  * @param {RegExp|((prop: string) => boolean)} [options.excludeStyleProps] - Skip props when snapshotting (#348). e.g. /^--/ to exclude CSS vars
+ * @param {boolean} [options.resolvePicturePlaceholders] - Resolve <picture> placeholders / lazy data-src before clone (default true)
+ * @param {{ timeout?: number, concurrency?: number, resolveLazySrc?: boolean, silent?: boolean }} [options.pictureResolver] - Fine-tune built-in picture resolver
  * @returns {Object}
  */
 export function createContext(options?: {
@@ -56,5 +58,12 @@ export function createContext(options?: {
     outerTransforms?: boolean | undefined;
     outerShadows?: boolean | undefined;
     excludeStyleProps?: RegExp | ((prop: string) => boolean) | undefined;
+    resolvePicturePlaceholders?: boolean | undefined;
+    pictureResolver?: {
+        timeout?: number;
+        concurrency?: number;
+        resolveLazySrc?: boolean;
+        silent?: boolean;
+    } | undefined;
 }): Object;
 export type CachePolicy = "disabled" | "full" | "auto" | "soft";

package/snapdom/{src/core → core}/context.js

@@ -1,6 +1,6 @@
-/* 潘启宝 2026-03-24 15:26:16 星期二 */
+/* 潘启宝 2026-04-14 16:53:57 星期二 */
 import { normalizeCachePolicy as e } from "./cache.js";
-//#region utils/snapdom/src/core/context.js
+//#region utils/snapdom/core/context.js
 function t(t = {}) {
 	let n = t.format ?? "png";
 	n === "jpg" && (n = "jpeg");
@@ -33,7 +33,9 @@ function t(t = {}) {
 		outerTransforms: t.outerTransforms ?? !0,
 		outerShadows: t.outerShadows ?? !1,
 		safariWarmupAttempts: Math.min(3, Math.max(1, (t.safariWarmupAttempts ?? 3) | 0)),
-		excludeStyleProps: t.excludeStyleProps ?? null
+		excludeStyleProps: t.excludeStyleProps ?? null,
+		resolvePicturePlaceholders: t.resolvePicturePlaceholders !== !1,
+		pictureResolver: t.pictureResolver && typeof t.pictureResolver == "object" ? t.pictureResolver : {}
 	};
 }
 //#endregion