@unicom-cloud/utils 0.1.39 → 0.1.41

package/snapdom/src/core/capture.js

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

package/snapdom/src/exporters/download.js

@@ -1,47 +0,0 @@
-/* 潘启宝 2026-03-24 15:26:16 星期二 */
-import { isIOS as e } from "../utils/browser.js";
-import { toCanvas as t } from "./toCanvas.js";
-import { toBlob as n } from "./toBlob.js";
-//#region utils/snapdom/src/exporters/download.js
-async function r(e, t) {
-	let n = new File([e], t, { type: e.type });
-	if (!navigator.canShare?.({ files: [n] })) return !1;
-	try {
-		await navigator.share({
-			files: [n],
-			title: t
-		});
-	} catch (e) {
-		if (e.name !== "AbortError") return !1;
-	}
-	return !0;
-}
-async function i(i, a) {
-	let o = (a?.format || a?.type || "").toLowerCase(), s = o === "jpg" ? "jpeg" : o || "png", c = a?.filename || `snapdom.${s}`, l = {
-		...a || {},
-		format: s,
-		type: s
-	};
-	l.dpr = 1;
-	let u = e();
-	if (s === "svg") {
-		let e = await n(i, {
-			...l,
-			type: "svg"
-		});
-		if (u && await r(e, c)) return;
-		let t = URL.createObjectURL(e), a = document.createElement("a");
-		a.href = t, a.download = c, document.body.appendChild(a), a.click(), URL.revokeObjectURL(t), a.remove();
-		return;
-	}
-	let d = await t(i, l);
-	if (u) {
-		let e = `image/${s}`, t = await new Promise((t) => d.toBlob(t, e, a?.quality));
-		if (t && await r(t, c)) return;
-	}
-	let f = document.createElement("a");
-	f.href = d.toDataURL(`image/${s}`, a?.quality), f.download = c, document.body.appendChild(f), f.click(), f.remove();
-}
-//#endregion
-export { i as download };
-/* 独立思考，明辨是非 */

package/snapdom/src/index.d.ts

@@ -1,2 +0,0 @@
-export { preCache } from "./api/preCache.js";
-export { snapdom } from "./api/snapdom.js";

package/snapdom/src/index.js

@@ -1,4 +0,0 @@
-/* 潘启宝 2026-03-24 15:26:16 星期二 */
-import "./api/preCache.js";
-import "./api/snapdom.js";
-/* 独立思考，明辨是非 */

package/snapdom/src/utils/prepare.helpers.d.ts

@@ -1,9 +0,0 @@
-/**
- * Helper utilities for preparing DOM clones
- * @module utils/prepare.helpers
- */
-/**
- * Stabilize layout by adding transparent border if element has outline but no border
- * @param {Element} element
- */
-export function stabilizeLayout(element: Element): void;

package/snapdom/src/utils/prepare.helpers.js

@@ -1,9 +0,0 @@
-/* 潘启宝 2026-03-24 15:26:16 星期二 */
-//#region utils/snapdom/src/utils/prepare.helpers.js
-function e(e) {
-	let t = getComputedStyle(e), n = t.outlineStyle, r = t.outlineWidth, i = t.borderStyle, a = t.borderWidth;
-	n !== "none" && parseFloat(r) > 0 && (i === "none" || parseFloat(a) === 0) && (e.style.border = `${r} solid transparent`);
-}
-//#endregion
-export { e as stabilizeLayout };
-/* 独立思考，明辨是非 */

package/tinycolor/src/index.d.ts

@@ -1,214 +0,0 @@
-import type { CMYK, HSL, HSLA, HSV, HSVA, Numberify, RGB, RGBA } from './interfaces.js';
-export interface TinyColorOptions {
-    format: string;
-    gradientType: string;
-}
-export type ColorInput = string | number | RGB | RGBA | HSL | HSLA | HSV | HSVA | CMYK | TinyColor | unknown;
-export type ColorFormats = 'rgb' | 'prgb' | 'hex' | 'hex3' | 'hex4' | 'hex6' | 'hex8' | 'name' | 'hsl' | 'hsv' | 'cmyk';
-export declare class TinyColor {
-    /** red */
-    r: number;
-    /** green */
-    g: number;
-    /** blue */
-    b: number;
-    /** alpha */
-    a: number;
-    /** the format used to create the tinycolor instance */
-    format: ColorFormats;
-    /** input passed into the constructer used to create the tinycolor instance */
-    originalInput: ColorInput;
-    /** the color was successfully parsed */
-    isValid: boolean;
-    gradientType?: string;
-    /** rounded alpha */
-    roundA: number;
-    constructor(color?: ColorInput, opts?: Partial<TinyColorOptions>);
-    get ok(): boolean;
-    isDark(): boolean;
-    isLight(): boolean;
-    /**
-     * Returns the perceived brightness of the color, from 0-255.
-     */
-    getBrightness(): number;
-    /**
-     * Returns the perceived luminance of a color, from 0-1.
-     */
-    getLuminance(): number;
-    /**
-     * Returns the alpha value of a color, from 0-1.
-     */
-    getAlpha(): number;
-    /**
-     * Sets the alpha value on the current color.
-     *
-     * @param alpha - The new alpha value. The accepted range is 0-1.
-     */
-    setAlpha(alpha?: string | number): this;
-    /**
-     * Returns whether the color is monochrome.
-     */
-    isMonochrome(): boolean;
-    /**
-     * Returns the object as a HSVA object.
-     */
-    toHsv(): Numberify<HSVA>;
-    toHsv_(): Numberify<HSVA>;
-    /**
-     * Returns the hsva values interpolated into a string with the following format:
-     * "hsva(xxx, xxx, xxx, xx)".
-     */
-    toHsvString(): string;
-    /**
-     * Returns the object as a HSLA object.
-     */
-    toHsl(): Numberify<HSLA>;
-    /**
-     * Returns the hsla values interpolated into a string with the following format:
-     * "hsla(xxx, xxx, xxx, xx)".
-     */
-    toHslString(): string;
-    /**
-     * Returns the hex value of the color.
-     * @param allow3Char will shorten hex value to 3 char if possible
-     */
-    toHex(allow3Char?: boolean): string;
-    /**
-     * Returns the hex value of the color -with a # prefixed.
-     * @param allow3Char will shorten hex value to 3 char if possible
-     */
-    toHexString(allow3Char?: boolean): string;
-    /**
-     * Returns the hex 8 value of the color.
-     * @param allow4Char will shorten hex value to 4 char if possible
-     */
-    toHex8(allow4Char?: boolean): string;
-    /**
-     * Returns the hex 8 value of the color -with a # prefixed.
-     * @param allow4Char will shorten hex value to 4 char if possible
-     */
-    toHex8String(allow4Char?: boolean): string;
-    /**
-     * Returns the shorter hex value of the color depends on its alpha -with a # prefixed.
-     * @param allowShortChar will shorten hex value to 3 or 4 char if possible
-     */
-    toHexShortString(allowShortChar?: boolean): string;
-    /**
-     * Returns the object as a RGBA object.
-     */
-    toRgb(): Numberify<RGBA>;
-    toRgba(): Numberify<RGBA>;
-    toRgbArray(): number[];
-    toRgbArrayString(): string;
-    /**
-     * Returns the RGBA values interpolated into a string with the following format:
-     * "RGBA(xxx, xxx, xxx, xx)".
-     */
-    toRgbString(): string;
-    toRgbaString(): string;
-    /**
-     * Returns the object as a RGBA object.
-     */
-    toPercentageRgb(): RGBA;
-    /**
-     * Returns the RGBA relative values interpolated into a string
-     */
-    toPercentageRgbString(): string;
-    toCmyk(): Numberify<CMYK>;
-    toCmykString(): string;
-    /**
-     * The 'real' name of the color -if there is one.
-     */
-    toName(): string | false;
-    /**
-     * String representation of the color.
-     *
-     * @param format - The format to be used when displaying the string representation.
-     */
-    toString<T extends 'name'>(format: T): boolean | string;
-    toString<T extends ColorFormats>(format?: T): string;
-    toNumber(): number;
-    clone(): TinyColor;
-    /**
-     * Lighten the color a given amount. Providing 100 will always return white.
-     * @param amount - valid between 1-100
-     */
-    lighten(amount?: number): TinyColor;
-    /**
-     * Brighten the color a given amount, from 0 to 100.
-     * @param amount - valid between 1-100
-     */
-    brighten(amount?: number): TinyColor;
-    /**
-     * Darken the color a given amount, from 0 to 100.
-     * Providing 100 will always return black.
-     * @param amount - valid between 1-100
-     */
-    darken(amount?: number): TinyColor;
-    /**
-     * Mix the color with pure white, from 0 to 100.
-     * Providing 0 will do nothing, providing 100 will always return white.
-     * @param amount - valid between 1-100
-     */
-    tint(amount?: number): TinyColor;
-    /**
-     * Mix the color with pure black, from 0 to 100.
-     * Providing 0 will do nothing, providing 100 will always return black.
-     * @param amount - valid between 1-100
-     */
-    shade(amount?: number): TinyColor;
-    /**
-     * Desaturate the color a given amount, from 0 to 100.
-     * Providing 100 will is the same as calling greyscale
-     * @param amount - valid between 1-100
-     */
-    desaturate(amount?: number): TinyColor;
-    /**
-     * Saturate the color a given amount, from 0 to 100.
-     * @param amount - valid between 1-100
-     */
-    saturate(amount?: number): TinyColor;
-    /**
-     * Completely desaturates a color into greyscale.
-     * Same as calling `desaturate(100)`
-     */
-    greyscale(): TinyColor;
-    /**
-     * Spin takes a positive or negative amount within [-360, 360] indicating the change of hue.
-     * Values outside of this range will be wrapped into this range.
-     */
-    spin(amount: number): TinyColor;
-    /**
-     * Mix the current color a given amount with another color, from 0 to 100.
-     * 0 means no mixing (return current color).
-     */
-    mix(color: ColorInput, amount?: number): TinyColor;
-    analogous(results?: number, slices?: number): TinyColor[];
-    /**
-     * taken from https://github.com/infusion/jQuery-xcolor/blob/master/jquery.xcolor.js
-     */
-    complement(): TinyColor;
-    monochromatic(results?: number): TinyColor[];
-    splitcomplement(): TinyColor[];
-    /**
-     * Compute how the color would appear on a background
-     */
-    onBackground(background: ColorInput): TinyColor;
-    /**
-     * Alias for `polyad(3)`
-     */
-    triad(): TinyColor[];
-    /**
-     * Alias for `polyad(4)`
-     */
-    tetrad(): TinyColor[];
-    /**
-     * Get polyad colors, like (for 1, 2, 3, 4, 5, 6, 7, 8, etc...)
-     * monad, dyad, triad, tetrad, pentad, hexad, heptad, octad, etc...
-     */
-    polyad(n: number): TinyColor[];
-    /**
-     * compare color vs current color
-     */
-    equals(color?: ColorInput): boolean;
-}