docs(canvas): explain legacy resources and geometry ownership

This commit is contained in:
2026-11-12 16:04:32 +08:00
parent b995e659a6
commit 9b24319747
6 changed files with 18 additions and 2 deletions
+3
View File
@@ -11,6 +11,7 @@ import { nodeCenter, nodeSize } from "./canvas-geometry.ts";
/** 非frame节点按中心点找包含它的分区,多个重叠候选选面积最小者;frame本身不成为另一frame成员。 */
export function containingFrame(node: CanvasNode, nodes: CanvasNode[]) {
if (node.data.kind === "frame") return undefined;
// 以未旋转布局矩形判包含,边界算内部;不是对旋转后的可见形状做精确命中。
const center = nodeCenter(node);
return nodes.filter((frame) => {
if (frame.data.kind !== "frame") return false;
@@ -44,8 +45,10 @@ export function assignFrameMembership(nodes: CanvasNode[], droppedIds: string[])
export function applyFrameNodeChanges(changes: NodeChange<CanvasNode>[], previous: CanvasNode[]) {
const nodes = applyNodeChanges(changes, previous);
const before = new Map(previous.map((node) => [node.id, node]));
// 仅带实际 position 值的变更计入显式移动;dragging 标记变化本身不触发成员平移。
const positioned = new Set(changes.flatMap((change) => change.type === "position" && change.position ? [change.id] : []));
const frames = new Map(nodes.filter((node) => node.data.kind === "frame").map((node) => [node.id, node]));
// 单次 map 按原 frameId 计算直接父位移,不递归累积嵌套分区;合法旧数据约定 frame 不归另一 frame。
return nodes.map((node) => {
const frameId = node.data.frameId;
if (!frameId) return node;