@unicom-cloud/ui 0.8.168 → 0.8.170

package/draw/element/frame.js

@@ -0,0 +1,194 @@
+/* 潘启宝 2026-06-25 17:54:57 星期四 山东省济南市 */
+import { isPointWithinBounds as e, pointFrom as t } from "../libs/math/point.js";
+import "../libs/math/index.js";
+import { arrayToMap as n } from "../common/utils.js";
+import "../common/index.js";
+import { doLineSegmentsIntersect as r } from "../utils/bbox.js";
+import { elementsOverlappingBBox as i } from "../utils/withinBounds.js";
+import { isFrameElement as a, isFrameLikeElement as o, isTextElement as s } from "./typeChecks.js";
+import { getElementsWithinSelection as c, getSelectedElements as l } from "./selection.js";
+import { getBoundTextElement as u, getContainerElement as d } from "./textElement.js";
+import { getElementsInGroup as f, selectGroupsFromGivenElements as p } from "./groups.js";
+import { mutateElement as m } from "./mutateElement.js";
+import { getCommonBounds as h, getElementAbsoluteCoords as g, getElementLineSegments as _ } from "./bounds.js";
+//#region components/pc/draw/element/frame.ts
+var v = (e, t, r) => {
+	let i = n(e);
+	for (let e of t) if (e.frameId) {
+		let t = r.get(e.id), n = r.get(e.frameId), a = t && i.get(t);
+		a && m(a, i, { frameId: n ?? null });
+	}
+};
+function y(e, t, n) {
+	let i = _(t, n), a = _(e, n);
+	return i.some((e) => a.some((t) => r(e, t)));
+}
+var b = (e, t, n) => z(c(e, t, n, !1)).filter((e) => !o(e) && !e.frameId || e.frameId === t.id), x = (e, t, n) => c([t], e, n).some((e) => e.id === t.id), S = (e, t, n) => {
+	let [r, i, a, o] = g(t, n), [s, c, l, u] = h(e);
+	return r <= s && i <= c && a >= l && o >= u;
+}, C = (e, t, n) => S([e], t, n) || y(e, t, n) || x(e, t, n), w = (n, r, i) => {
+	let [a, o, s, c] = g(r, i);
+	return e(t(a, o), t(n.x, n.y), t(s, c));
+}, T = (e) => {
+	let t = /* @__PURE__ */ new Map();
+	for (let n of e) {
+		let r = o(n) ? n.id : n.frameId;
+		r && !t.has(r) && t.set(r, E(e, r));
+	}
+	return t;
+}, E = (e, t) => {
+	let n = [];
+	for (let r of e.values()) r.frameId === t && n.push(r);
+	return n;
+}, D = (e) => e.filter((e) => o(e)), O = (e) => {
+	let t = n(D(e));
+	return e.filter((e) => t.has(e.id) || !e.frameId || !t.has(e.frameId));
+}, k = (e, t, n, r) => {
+	let i = E(e, t.id), a = new Set(i), o = /* @__PURE__ */ new Set([...b(e, t, r), ...i.filter((e) => x(e, t, r))]), c = i.filter((e) => !o.has(e)), l = new Set(Array.from(o).flatMap((e) => e.groupIds));
+	for (let e of c) if (!y(e, t, r)) e.groupIds.length === 0 && a.delete(e);
+	else if (e.groupIds.length > 0) for (let t of e.groupIds) l.add(t);
+	for (let e of c) if (e.groupIds.length > 0) {
+		let t = !0;
+		for (let n of e.groupIds) l.has(n) && (t = !1);
+		t && a.delete(e);
+	}
+	let u = Array.from(o).filter((e) => e.groupIds.length === 0);
+	for (let e of u) a.add(e);
+	let d = p(Array.from(o).filter((e) => e.groupIds.length > 0), n);
+	for (let [n, i] of Object.entries(d)) if (i) {
+		let i = f(e, n);
+		if (S(i, t, r)) for (let e of i) a.add(e);
+	}
+	return [...a].filter((e) => !(s(e) && e.containerId));
+}, A = (e, t, n) => j(z(e, b(e, t, n)), t, n), j = (e, t, n) => {
+	let r = [], i = /* @__PURE__ */ new Map();
+	for (let a of e) {
+		let e = !1;
+		if (a.groupIds.length > 0) {
+			if (a.groupIds.some((e) => i.get(e))) e = !0;
+			else {
+				let r = new Set(a.groupIds.flatMap((e) => f(n, e)));
+				e = !S(Array.from(r), t, n);
+			}
+			a.groupIds.forEach((t) => {
+				i.set(t, e);
+			});
+		}
+		e || r.push(a);
+	}
+	return r;
+}, M = (e, t) => e.frameId && t.get(e.frameId) || null, N = (e, t) => {
+	let r = /* @__PURE__ */ new Set(), i = n(e);
+	e = z(e);
+	for (let n of e) o(n) && n.id !== t.id && r.add(n.id);
+	let a = /* @__PURE__ */ new Set(), s = [];
+	for (let n of e) if (!(o(n) || n.frameId && r.has(n.frameId))) if (n.groupIds.length) {
+		let r = n.groupIds.at(-1);
+		if (!a.has(r)) {
+			a.add(r);
+			let n = f(e, r);
+			if (n.some((e) => C(e, t, i))) for (let e of n) s.push(e);
+		}
+	} else C(n, t, i) && s.push(n);
+	return s;
+}, P = (e, t, r, i) => {
+	let a = n(e), s = /* @__PURE__ */ new Map();
+	for (let t of e.values()) t.frameId === r.id && s.set(t.id, !0);
+	let c = new Set(t.map((e) => e.id)), l = [], d = /* @__PURE__ */ new Set();
+	for (let e of t) o(e) && e.id !== r.id && d.add(e.id);
+	for (let n of z(e, t)) {
+		if (o(n) || n.frameId && d.has(n.frameId) || n.frameId && i.selectedElementIds[n.id] && i.selectedElementIds[n.frameId]) continue;
+		s.has(n.id) || l.push(n);
+		let e = u(n, a);
+		e && !c.has(e.id) && !s.has(e.id) && l.push(e);
+	}
+	for (let e of l) m(e, a, { frameId: r.id });
+	return e;
+}, F = (e, t) => {
+	let n = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map();
+	for (let i of e) if (i.frameId) {
+		n.set(i.id, i);
+		let e = r.get(i.frameId) || [];
+		e.push(i);
+		let a = u(i, t);
+		a && (n.set(a.id, a), e.push(a)), r.set(i.frameId, e);
+	}
+	for (let [, e] of n) m(e, t, { frameId: null });
+}, I = (e, t) => (F(E(e, t.id), n(e)), e), L = (e, t, n, r) => P(I(e, n), t, n, r.state).slice(), R = (e, t, r) => {
+	let i = r.scene.getSelectedElements({
+		selectedElementIds: t.selectedElementIds,
+		elements: e
+	}), a = new Set(i);
+	if (t.editingGroupId) for (let t of i) t.groupIds.length === 0 ? a.add(t) : t.groupIds.flatMap((t) => f(e, t)).forEach((e) => a.add(e));
+	let s = /* @__PURE__ */ new Set(), c = n(e);
+	return a.forEach((e) => {
+		e.frameId && !o(e) && !V(e, c, t) && s.add(e);
+	}), s.size > 0 && F(s, c), e;
+}, z = (e, t) => {
+	let n = /* @__PURE__ */ new Set(), r = t || e;
+	for (let e of r.values()) {
+		let t = e.groupIds[e.groupIds.length - 1];
+		t && n.add(t);
+	}
+	let i = /* @__PURE__ */ new Set();
+	for (let t of n) f(e, t).some((e) => o(e)) && i.add(t);
+	let a = [];
+	for (let e of r.values()) i.has(e.groupIds[e.groupIds.length - 1]) || a.push(e);
+	return a;
+}, B = (e, t, n) => {
+	let r = s(e) && d(e, t) || e;
+	return r.frameId && n.selectedElementIds[r.id] && n.selectedElementIds[r.frameId] ? M(r, t) : n.selectedElementIds[r.id] && n.selectedElementsAreBeingDragged ? n.frameToHighlight : M(r, t);
+}, V = (e, t, n, r) => {
+	let i = r?.targetFrame ?? B(e, t, n);
+	if (!i) return !1;
+	let a = s(e) && d(e, t) || e, c = (e) => {
+		r?.checkedGroups && a.groupIds.forEach((t) => {
+			r.checkedGroups?.set?.(t, e);
+		});
+	};
+	if (!n.selectedElementIds[a.id] || !n.selectedElementsAreBeingDragged || n.selectedElementIds[a.id] && n.selectedElementIds[i.id]) return !0;
+	if (a.groupIds.length === 0) return C(a, i, t);
+	for (let e of a.groupIds) if (r?.checkedGroups?.has?.(e)) return r.checkedGroups.get(e);
+	let u = new Set(a.groupIds.filter((e) => r?.checkedGroups ? !r.checkedGroups.has(e) : !0).flatMap((e) => f(t, e)));
+	if (n.editingGroupId && n.selectedElementsAreBeingDragged) {
+		let e = new Set(l(t, n));
+		if (n.frameToHighlight !== null) return !0;
+		e.forEach((e) => {
+			u.delete(e);
+		});
+	}
+	for (let e of u) if (o(e)) return c(!1), !1;
+	for (let e of u) if (C(e, i, t)) return c(!0), !0;
+	return !1;
+}, H = (e, t, n, r, i) => {
+	if (!n.frameRendering || !n.frameRendering.clip) return !1;
+	let a = y(e, t, r) || x(e, t, r);
+	if (a) {
+		for (let t of e.groupIds) i?.set?.(t, !0);
+		return !0;
+	}
+	if (!a && e.groupIds.length > 0 && !S([e], t, r)) {
+		let a = !1;
+		if (n.selectedElementsAreBeingDragged) a = V(e, r, n, {
+			targetFrame: t,
+			checkedGroups: i
+		});
+		else {
+			a = e.frameId === t.id;
+			for (let t of e.groupIds) i?.set?.(t, a);
+		}
+		for (let t of e.groupIds) i?.set?.(t, a);
+		return a;
+	}
+	return !1;
+}, U = "Frame", W = "AI Frame", G = (e) => a(e) ? U : W, K = (e) => e.name === null ? G(e) : e.name, q = (e, t) => i({
+	elements: e,
+	bounds: t,
+	type: "overlap"
+}).filter((e) => !e.frameId || e.frameId === t.id), J = (e) => {
+	let t = n(e);
+	return e.length > 1 && e.some((e) => e.frameId && t.has(e.frameId));
+};
+//#endregion
+export { P as addElementsToFrame, v as bindElementsToFramesAfterDuplication, C as elementOverlapsWithFrame, S as elementsAreInFrameBounds, N as filterElementsEligibleAsFrameChildren, J as frameAndChildrenSelectedTogether, M as getContainingFrame, G as getDefaultFrameName, b as getElementsCompletelyInFrame, A as getElementsInNewFrame, k as getElementsInResizingFrame, q as getElementsOverlappingFrame, E as getFrameChildren, D as getFrameLikeElements, K as getFrameLikeTitle, O as getRootElements, B as getTargetFrame, T as groupByFrameLikes, w as isCursorInFrame, x as isElementContainingFrame, V as isElementInFrame, y as isElementIntersectingFrame, z as omitGroupsContainingFrameLikes, j as omitPartialGroups, I as removeAllElementsFromFrame, F as removeElementsFromFrame, L as replaceAllElementsInFrame, H as shouldApplyFrameClip, R as updateFrameMembershipOfSelectedElements };
+/* 独立思考，明辨是非 */

package/draw/element/groups.d.ts

@@ -0,0 +1,34 @@
+import type { Mutable } from '../common/utility-types';
+import type { AppClassProperties, AppState, InteractiveCanvasAppState } from '../interface';
+import type { DrawElement, ElementsMap, ElementsMapOrArray, GroupId, NonDeleted, NonDeletedDrawElement } from './types';
+export declare const selectGroup: (groupId: GroupId, appState: InteractiveCanvasAppState, elements: readonly NonDeleted<DrawElement>[]) => Pick<InteractiveCanvasAppState, "selectedGroupIds" | "selectedElementIds" | "editingGroupId">;
+export declare const selectGroupsForSelectedElements: {
+    (appState: Pick<AppState, "selectedElementIds" | "editingGroupId">, elements: readonly NonDeletedDrawElement[], prevAppState: InteractiveCanvasAppState, app: AppClassProperties | null): Mutable<Pick<InteractiveCanvasAppState, "selectedGroupIds" | "editingGroupId" | "selectedElementIds">>;
+    clearCache(): void;
+};
+/**
+ * If the element's group is selected, don't render an individual
+ * selection border around it.
+ */
+export declare const isSelectedViaGroup: (appState: InteractiveCanvasAppState, element: DrawElement) => boolean;
+export declare const getSelectedGroupForElement: (appState: Pick<InteractiveCanvasAppState, "editingGroupId" | "selectedGroupIds">, element: DrawElement) => string | undefined;
+export declare const getSelectedGroupIds: (appState: InteractiveCanvasAppState) => GroupId[];
+export declare const selectGroupsFromGivenElements: (elements: readonly NonDeleted<DrawElement>[], appState: InteractiveCanvasAppState) => {
+    [groupId: string]: boolean;
+};
+export declare const editGroupForSelectedElement: (appState: AppState, element: NonDeleted<DrawElement>) => AppState;
+export declare const isElementInGroup: (element: DrawElement, groupId: string) => boolean;
+export declare const getElementsInGroup: (elements: ElementsMapOrArray, groupId: string) => DrawElement[];
+export declare const getSelectedGroupIdForElement: (element: DrawElement, selectedGroupIds: {
+    [groupId: string]: boolean;
+}) => string | undefined;
+export declare const addToGroup: (prevGroupIds: DrawElement["groupIds"], newGroupId: GroupId, editingGroupId: AppState["editingGroupId"]) => string[];
+export declare const removeFromSelectedGroups: (groupIds: DrawElement["groupIds"], selectedGroupIds: {
+    [groupId: string]: boolean;
+}) => string[];
+export declare const getMaximumGroups: (elements: DrawElement[], elementsMap: ElementsMap) => DrawElement[][];
+export declare const getNonDeletedGroupIds: (elements: ElementsMap) => Set<string>;
+export declare const elementsAreInSameGroup: (elements: readonly DrawElement[]) => boolean;
+export declare const isInGroup: (element: NonDeletedDrawElement) => boolean;
+export declare const getNewGroupIdsForDuplication: (groupIds: DrawElement["groupIds"], editingGroupId: AppState["editingGroupId"], mapper: (groupId: GroupId) => GroupId) => string[];
+export declare const getSelectedElementsByGroup: (selectedElements: DrawElement[], elementsMap: ElementsMap, appState: Readonly<AppState>) => DrawElement[][];

package/draw/element/groups.js

@@ -0,0 +1,137 @@
+/* 潘启宝 2026-06-25 17:54:57 星期四 山东省济南市 */
+import { isBoundToContainer as e } from "./typeChecks.js";
+import { getSelectedElements as t, makeNextSelectedElementIds as n } from "./selection.js";
+import { getBoundTextElement as r } from "./textElement.js";
+//#region components/pc/draw/element/groups.ts
+var i = (e, t, n) => {
+	let r = n.reduce((t, n) => (n.groupIds.includes(e) && (t[n.id] = !0), t), {});
+	return Object.keys(r).length < 2 ? t.selectedGroupIds[e] || t.editingGroupId === e ? {
+		selectedElementIds: t.selectedElementIds,
+		selectedGroupIds: {
+			...t.selectedGroupIds,
+			[e]: !1
+		},
+		editingGroupId: null
+	} : t : {
+		editingGroupId: t.editingGroupId,
+		selectedGroupIds: {
+			...t.selectedGroupIds,
+			[e]: !0
+		},
+		selectedElementIds: {
+			...t.selectedElementIds,
+			...r
+		}
+	};
+}, a = (function() {
+	let e = null, r = null, i = null, a = (t, a, o, s) => {
+		if (i !== void 0 && a === r && t === e && o.editingGroupId === i?.editingGroupId) return i;
+		let c = {};
+		for (let e of t) {
+			let t = e.groupIds;
+			if (o.editingGroupId) {
+				let e = t.indexOf(o.editingGroupId);
+				e > -1 && (t = t.slice(0, e));
+			}
+			if (t.length > 0) {
+				let e = t[t.length - 1];
+				c[e] = !0;
+			}
+		}
+		let l = {}, u = a.reduce((e, t) => {
+			if (t.isDeleted) return e;
+			let n = t.groupIds.find((e) => c[e]);
+			return n && (e[t.id] = !0, Array.isArray(l[n]) ? l[n].push(t.id) : l[n] = [t.id]), e;
+		}, {});
+		for (let e of Object.keys(l)) l[e].length < 2 && c[e] && (c[e] = !1);
+		return r = a, e = t, i = {
+			editingGroupId: o.editingGroupId,
+			selectedGroupIds: c,
+			selectedElementIds: n({
+				...o.selectedElementIds,
+				...u
+			}, s)
+		}, i;
+	}, o = (e, r, i, o) => {
+		let s = o ? o.scene.getSelectedElements({
+			selectedElementIds: e.selectedElementIds,
+			elements: r
+		}) : t(r, e);
+		return s.length ? a(s, r, e, i) : {
+			selectedGroupIds: {},
+			editingGroupId: null,
+			selectedElementIds: n(e.selectedElementIds, i)
+		};
+	};
+	return o.clearCache = () => {
+		r = null, e = null, i = null;
+	}, o;
+})(), o = (e, t) => s(e, t) != null, s = (e, t) => t.groupIds.filter((t) => t !== e.editingGroupId).find((t) => e.selectedGroupIds[t]), c = (e) => Object.entries(e.selectedGroupIds).filter(([e, t]) => t).map(([e, t]) => e), l = (e, t) => {
+	let n = {
+		...t,
+		selectedGroupIds: {}
+	};
+	for (let r of e) {
+		let a = r.groupIds;
+		if (t.editingGroupId) {
+			let e = a.indexOf(t.editingGroupId);
+			e > -1 && (a = a.slice(0, e));
+		}
+		if (a.length > 0) {
+			let t = a[a.length - 1];
+			n = {
+				...n,
+				...i(t, n, e)
+			};
+		}
+	}
+	return n.selectedGroupIds;
+}, u = (e, t) => ({
+	...e,
+	editingGroupId: t.groupIds.length ? t.groupIds[0] : null,
+	selectedGroupIds: {},
+	selectedElementIds: { [t.id]: !0 }
+}), d = (e, t) => e.groupIds.includes(t), f = (e, t) => {
+	let n = [];
+	for (let r of e.values()) d(r, t) && n.push(r);
+	return n;
+}, p = (e, t) => e.groupIds.find((e) => t[e]), m = (e, t, n) => {
+	let r = [...e], i = n ? r.indexOf(n) : -1, a = i > -1 ? i : r.length;
+	return r.splice(a, 0, t), r;
+}, h = (e, t) => e.filter((e) => !t[e]), g = (e, t) => {
+	let n = /* @__PURE__ */ new Map();
+	return e.forEach((e) => {
+		let i = e.groupIds.length === 0 ? e.id : e.groupIds[e.groupIds.length - 1], a = n.get(i) || [], o = r(e, t);
+		o && a.push(o), n.set(i, [...a, e]);
+	}), Array.from(n.values());
+}, _ = (e) => {
+	let t = /* @__PURE__ */ new Set();
+	for (let [, n] of e) if (!n.isDeleted) for (let e of n.groupIds ?? []) t.add(e);
+	return t;
+}, v = (e) => {
+	let t = e.flatMap((e) => e.groupIds), n = /* @__PURE__ */ new Map(), r = 0;
+	for (let e of t) n.set(e, (n.get(e) ?? 0) + 1), n.get(e) > r && (r = n.get(e));
+	return r === e.length;
+}, y = (e) => e.groupIds.length > 0, b = (e, t, n) => {
+	let r = [...e], i = t ? e.indexOf(t) : -1, a = i > -1 ? i : e.length;
+	for (let e = 0; e < a; e++) r[e] = n(r[e]);
+	return r;
+}, x = (t, n, i) => {
+	let a = c(i), s = t.filter((t) => !e(t)), l = /* @__PURE__ */ new Map(), u = /* @__PURE__ */ new Map(), d = (e) => {
+		let t = u.get(e.id) || [], i = r(e, n);
+		i && t.push(i), u.set(e.id, [...t, e]);
+	}, f = (e, t) => {
+		let i = l.get(t) || [], a = r(e, n);
+		a && i.push(a), l.set(t, [...i, e]);
+	}, m = (e, t) => {
+		let n = e.groupIds.indexOf(t, 0);
+		return e.groupIds.slice(0, n).length > 0 ? f(e, e.groupIds[n - 1]) : d(e);
+	}, h = t.every((e) => o(i, e));
+	return s.forEach((e) => {
+		let t = p(e, i.selectedGroupIds);
+		t ? a.length === 1 && h ? m(e, t) : f(e, t) : d(e);
+	}), Array.from(l.values()).concat(Array.from(u.values()));
+};
+//#endregion
+export { m as addToGroup, u as editGroupForSelectedElement, v as elementsAreInSameGroup, f as getElementsInGroup, g as getMaximumGroups, b as getNewGroupIdsForDuplication, _ as getNonDeletedGroupIds, x as getSelectedElementsByGroup, s as getSelectedGroupForElement, p as getSelectedGroupIdForElement, c as getSelectedGroupIds, d as isElementInGroup, y as isInGroup, o as isSelectedViaGroup, h as removeFromSelectedGroups, i as selectGroup, a as selectGroupsForSelectedElements, l as selectGroupsFromGivenElements };
+/* 独立思考，明辨是非 */

package/draw/element/heading.d.ts

@@ -0,0 +1,16 @@
+import type { Bounds } from '../common';
+import type { GlobalPoint, LocalPoint, Vector } from '../libs/math';
+import type { DrawBindableElement } from './types';
+export declare const HEADING_RIGHT: Heading;
+export declare const HEADING_DOWN: Heading;
+export declare const HEADING_LEFT: Heading;
+export declare const HEADING_UP: Heading;
+export type Heading = [1, 0] | [0, 1] | [-1, 0] | [0, -1];
+export declare const vectorToHeading: (vec: Vector) => Heading;
+export declare const headingForPoint: <P extends GlobalPoint | LocalPoint>(p: P, o: P) => Heading;
+export declare const headingForPointIsHorizontal: <P extends GlobalPoint | LocalPoint>(p: P, o: P) => boolean;
+export declare const compareHeading: (a: Heading, b: Heading) => boolean;
+export declare const headingIsHorizontal: (a: Heading) => boolean;
+export declare const headingIsVertical: (a: Heading) => boolean;
+export declare const headingForPointFromElement: <Point extends GlobalPoint>(element: Readonly<DrawBindableElement>, aabb: Readonly<Bounds>, p: Readonly<Point>) => Heading;
+export declare const flipHeading: (h: Heading) => Heading;

package/draw/element/heading.js

@@ -0,0 +1,38 @@
+/* 潘启宝 2026-06-25 17:54:57 星期四 山东省济南市 */
+import { vectorCross as e, vectorFromPoint as t, vectorScale as n } from "../libs/math/vector.js";
+import { pointFrom as r, pointFromVector as i, pointRotateRads as a, pointScaleFromOrigin as o, pointsEqual as s } from "../libs/math/point.js";
+import { triangleIncludesPoint as c } from "../libs/math/triangle.js";
+import "../libs/math/index.js";
+import { invariant as l, isDevEnv as u, isTestEnv as d } from "../common/utils.js";
+import "../common/index.js";
+import { getCenterForBounds as f } from "./bounds.js";
+//#region components/pc/draw/element/heading.ts
+var p = [1, 0], m = [0, 1], h = [-1, 0], g = [0, -1], _ = (e) => {
+	let [t, n] = e, r = Math.abs(t), i = Math.abs(n);
+	return t > i ? p : t <= -i ? h : n > r ? m : g;
+}, v = (e, n) => _(t(e, n)), y = (e, t) => x(v(e, t)), b = (e, t) => e[0] === t[0] && e[1] === t[1], x = (e) => b(e, p) || b(e, h), S = (o, c, p) => {
+	let m = f(c);
+	(u() || d()) && (l(o.width > 0 && o.height > 0, "Diamond element has no width or height"), l(!s(m, p), "The point is too close to the element mid point to determine heading"));
+	let h = .95, g = i(n(t(a(r(o.x + o.width / 2, o.y), m, o.angle), m), h), m), _ = i(n(t(a(r(o.x + o.width, o.y + o.height / 2), m, o.angle), m), h), m), y = i(n(t(a(r(o.x + o.width / 2, o.y + o.height), m, o.angle), m), h), m), b = i(n(t(a(r(o.x, o.y + o.height / 2), m, o.angle), m), h), m);
+	return e(t(p, g), t(g, _)) <= 0 && e(t(p, g), t(g, b)) > 0 ? v(g, m) : e(t(p, _), t(_, y)) <= 0 && e(t(p, _), t(_, g)) > 0 ? v(_, m) : e(t(p, y), t(y, b)) <= 0 && e(t(p, y), t(y, _)) > 0 ? v(y, m) : e(t(p, b), t(b, g)) <= 0 && e(t(p, b), t(b, y)) > 0 ? v(b, m) : e(t(p, m), t(g, m)) <= 0 && e(t(p, m), t(_, m)) > 0 ? v(o.width > o.height ? g : _, m) : e(t(p, m), t(_, m)) <= 0 && e(t(p, m), t(y, m)) > 0 ? v(o.width > o.height ? y : _, m) : e(t(p, m), t(y, m)) <= 0 && e(t(p, m), t(b, m)) > 0 ? v(o.width > o.height ? y : b, m) : v(o.width > o.height ? g : b, m);
+}, C = (e, t, n) => {
+	let i = f(t);
+	if (e.type === "diamond") return S(e, t, n);
+	let a = o(r(t[0], t[1]), i, 2), s = o(r(t[2], t[1]), i, 2), l = o(r(t[0], t[3]), i, 2), u = o(r(t[2], t[3]), i, 2);
+	return c([
+		a,
+		s,
+		i
+	], n) ? g : c([
+		s,
+		u,
+		i
+	], n) ? p : c([
+		u,
+		l,
+		i
+	], n) ? m : h;
+}, w = (e) => [e[0] === 0 ? 0 : e[0] > 0 ? -1 : 1, e[1] === 0 ? 0 : e[1] > 0 ? -1 : 1];
+//#endregion
+export { m as HEADING_DOWN, h as HEADING_LEFT, p as HEADING_RIGHT, g as HEADING_UP, b as compareHeading, w as flipHeading, v as headingForPoint, C as headingForPointFromElement, y as headingForPointIsHorizontal, x as headingIsHorizontal, _ as vectorToHeading };
+/* 独立思考，明辨是非 */

package/draw/element/image.d.ts

@@ -0,0 +1,22 @@
+import type { AppClassProperties, BinaryFiles, DataURL } from '../interface';
+import type { DrawElement, FileId, InitializedDrawImageElement } from './types';
+export declare const loadHTMLImageElement: (dataURL: DataURL) => Promise<HTMLImageElement>;
+/** NOTE: updates cache even if already populated with given image. Thus,
+ * you should filter out the images upstream if you want to optimize this. */
+export declare const updateImageCache: ({ fileIds, files, imageCache, }: {
+    fileIds: FileId[];
+    files: BinaryFiles;
+    imageCache: AppClassProperties["imageCache"];
+}) => Promise<{
+    imageCache: Map<FileId, {
+        image: HTMLImageElement | Promise<HTMLImageElement>;
+        mimeType: import("../common/utility-types").ValueOf<typeof import("../common").IMAGE_MIME_TYPES>;
+    }>;
+    /** includes errored files because they cache was updated nonetheless */
+    updatedFiles: Map<FileId, true>;
+    /** files that failed when creating HTMLImageElement */
+    erroredFiles: Map<FileId, true>;
+}>;
+export declare const getInitializedImageElements: (elements: readonly DrawElement[]) => InitializedDrawImageElement[];
+export declare const isHTMLSVGElement: (node: Node | null) => node is SVGElement;
+export declare const normalizeSVG: (SVGString: string) => string;

package/draw/element/image.js

@@ -0,0 +1,59 @@
+/* 潘启宝 2026-06-25 17:54:57 星期四 山东省济南市 */
+import { MIME_TYPES as e, SVG_NS as t } from "../common/constants.js";
+import "../common/index.js";
+import { isInitializedImageElement as n } from "./typeChecks.js";
+//#region components/pc/draw/element/image.ts
+var r = (e) => new Promise((t, n) => {
+	let r = new Image();
+	r.onload = () => {
+		t(r);
+	}, r.onerror = (e) => {
+		n(e);
+	}, r.src = e;
+}), i = async ({ fileIds: t, files: n, imageCache: i }) => {
+	let a = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map();
+	return await Promise.all(t.reduce((t, s) => {
+		let c = n[s];
+		return c && !a.has(s) ? (a.set(s, !0), t.concat((async () => {
+			try {
+				if (c.mimeType === e.binary) throw Error("Only images can be added to ImageCache");
+				let t = r(c.dataURL), n = {
+					image: t,
+					mimeType: c.mimeType
+				};
+				i.set(s, n);
+				let a = await t;
+				i.set(s, {
+					...n,
+					image: a
+				});
+			} catch {
+				o.set(s, !0);
+			}
+		})())) : t;
+	}, [])), {
+		imageCache: i,
+		updatedFiles: a,
+		erroredFiles: o
+	};
+}, a = (e) => e.filter((e) => n(e)), o = (e) => e?.nodeName?.toLowerCase?.() === "svg", s = (n) => {
+	let r = new DOMParser().parseFromString(n, e.svg), i = r.querySelector("svg");
+	if (r.querySelector("parsererror") || !o(i)) throw Error("Invalid SVG");
+	{
+		i.hasAttribute("xmlns") || i.setAttribute("xmlns", t);
+		let e = i.getAttribute("width"), n = i.getAttribute("height");
+		(e?.includes?.("%") || e === "auto") && (e = null), (n?.includes?.("%") || n === "auto") && (n = null);
+		let r = i.getAttribute("viewBox");
+		if (!e || !n) {
+			if (e ||= "50", n ||= "50", r) {
+				let t = r.match(/\d+ +\d+ +(\d+(?:\.\d+)?) +(\d+(?:\.\d+)?)/);
+				t && ([, e, n] = t);
+			}
+			i.setAttribute("width", e), i.setAttribute("height", n);
+		}
+		return r || i.setAttribute("viewBox", `0 0 ${e} ${n}`), i.outerHTML;
+	}
+};
+//#endregion
+export { a as getInitializedImageElements, o as isHTMLSVGElement, r as loadHTMLImageElement, s as normalizeSVG, i as updateImageCache };
+/* 独立思考，明辨是非 */

package/draw/element/index.d.ts

@@ -0,0 +1,58 @@
+import type { DrawElement, ElementsMapOrArray, NonDeleted, NonDeletedDrawElement } from './types';
+/**
+ * @deprecated unsafe, use hashElementsVersion instead
+ */
+export declare const getSceneVersion: (elements: readonly DrawElement[]) => number;
+/**
+ * Hashes elements' versionNonce (using djb2 algo). Order of elements matters.
+ */
+export declare const hashElementsVersion: (elements: ElementsMapOrArray) => number;
+export declare const hashString: (s: string) => number;
+export declare const getVisibleElements: (elements: readonly DrawElement[]) => readonly NonDeletedDrawElement[];
+export declare const getNonDeletedElements: <T extends DrawElement>(elements: readonly T[]) => readonly NonDeleted<T>[];
+export * from './align';
+export * from './arrows/focus';
+export * from './arrows/helpers';
+export * from './binding';
+export * from './bounds';
+export * from './collision';
+export * from './comparisons';
+export * from './containerCache';
+export * from './cropElement';
+export * from './delta';
+export * from './distance';
+export * from './distribute';
+export * from './dragElements';
+export * from './duplicate';
+export * from './elbowArrow';
+export * from './elementLink';
+export * from './embeddable';
+export * from './flowchart';
+export * from './fractionalIndex';
+export * from './frame';
+export * from './groups';
+export * from './heading';
+export * from './image';
+export * from './is';
+export * from './linearElementEditor';
+export * from './mutateElement';
+export * from './newElement';
+export * from './positionElementsOnGrid';
+export * from './renderElement';
+export * from './resizeElements';
+export * from './resizeTest';
+export * from './Scene';
+export * from './selection';
+export * from './shape';
+export * from './showSelectedShapeActions';
+export * from './sizeHelpers';
+export * from './sortElements';
+export * from './store';
+export * from './textElement';
+export * from './textMeasurements';
+export * from './textWrapping';
+export * from './transform';
+export * from './transformHandles';
+export * from './typeChecks';
+export * from './utils';
+export * from './zindex';

package/draw/element/index.js

@@ -0,0 +1,65 @@
+/* 潘启宝 2026-06-25 17:54:57 星期四 山东省济南市 */
+import { toIterable as e } from "../common/utils.js";
+import "../common/index.js";
+import "./comparisons.js";
+import "./heading.js";
+import "./cropElement.js";
+import "./typeChecks.js";
+import "./selection.js";
+import "./containerCache.js";
+import "./textMeasurements.js";
+import "./textWrapping.js";
+import "./textElement.js";
+import "./groups.js";
+import "./elbowArrow.js";
+import "./mutateElement.js";
+import "./frame.js";
+import "./renderElement.js";
+import "./shape.js";
+import "./utils.js";
+import "./distance.js";
+import "./collision.js";
+import "./binding.js";
+import "./fractionalIndex.js";
+import "./zindex.js";
+import "./linearElementEditor.js";
+import "./bounds.js";
+import { isInvisiblySmallElement as t } from "./sizeHelpers.js";
+import "./align.js";
+import "./arrows/focus.js";
+import "./arrows/helpers.js";
+import "./is.js";
+import "./Scene.js";
+import "./sortElements.js";
+import "./duplicate.js";
+import "./store.js";
+import "./delta.js";
+import "./distribute.js";
+import "./dragElements.js";
+import "./elementLink.js";
+import "./newElement.js";
+import "./embeddable.js";
+import "./flowchart.js";
+import "./image.js";
+import "./positionElementsOnGrid.js";
+import "./resizeElements.js";
+import "./transformHandles.js";
+import "./resizeTest.js";
+import "./showSelectedShapeActions.js";
+import "./transform.js";
+//#region components/pc/draw/element/index.ts
+var n = (e) => e.reduce((e, t) => e + t.version, 0), r = (t) => {
+	let n = 5381;
+	for (let r of e(t)) n = (n << 5) + n + r.versionNonce;
+	return n >>> 0;
+}, i = (e) => {
+	let t = 5381;
+	for (let n = 0; n < e.length; n++) {
+		let r = e.charCodeAt(n);
+		t = (t << 5) + t + r;
+	}
+	return t >>> 0;
+}, a = (e) => e.filter((e) => !e.isDeleted && !t(e)), o = (e) => e.filter((e) => !e.isDeleted);
+//#endregion
+export { o as getNonDeletedElements, n as getSceneVersion, a as getVisibleElements, r as hashElementsVersion, i as hashString };
+/* 独立思考，明辨是非 */

package/draw/element/is.d.ts

@@ -0,0 +1,2 @@
+import type { DrawElement, NonDeleted } from './types';
+export declare const isNonDeletedElement: <T extends DrawElement>(element: T) => element is NonDeleted<T>;

package/draw/element/is.js

@@ -0,0 +1,6 @@
+/* 潘启宝 2026-06-25 17:54:57 星期四 山东省济南市 */
+//#region components/pc/draw/element/is.ts
+var e = (e) => !e.isDeleted;
+//#endregion
+export { e as isNonDeletedElement };
+/* 独立思考，明辨是非 */