@fulate/tools 1.0.6 → 1.0.8

package/README.md

@@ -5,8 +5,10 @@ gesture、Content session、Line/LineTree branch draft 与 semantic History 边
 surface，`LineTool` 只保留 command/preview surface。Transform 的每个已派发 pointer 输入都立即从
 frozen baseline 解析并提交一个 trusted batch；Point gesture 继续只在每个显示帧消费最后一个 intent。
 每个 owner 都把 world delta 交给同一个 Core reference-transform kernel；普通 transform 与显式
-reparent intent由该 intent决定写 pose、resize-owned geometry或preserve-owned geometry。Group手势只写
-Group，DirectChild手势只写该child；derived content bounds不形成command、History或补偿写入。
+reparent intent由该 intent决定写 pose、resize-owned geometry或preserve-owned geometry。移动/旋转
+Group时只写Group pose；Group或多选的尺寸调整、镜像会递归把同一个world仿射结果写回可编辑子元素
+的 authored geometry（anchor、cubic control、LineTree point），不会把尺寸变化留在Group scale上。
+DirectChild手势只写该child；derived content bounds不形成command、History或补偿写入。
 Line/LineTree固定world paint padding只属于自身visual/render coverage，不进入Group selection、resize或
 snap bounds。所有工作复用现有`RootFrameRuntime`，Tools 不创建 RAF、timer 或第二 scheduler。
 `Select`、`Snap`、`Rule` 与 `LineTool` 都使用 Core 生成的普通 Node key。工具间协作由应用组合时交付
@@ -26,7 +28,7 @@ DirectChild开始axis Snap时，手势排除集按候选使用的同一selection
 ancestor Group不会成为自身拖拽候选，Group外部元素仍正常参与对齐。
 
 LineTree Point改变一个anchor时，即使当前pose包含resize或反向scale，也在同一owner change内保持
-既有world matrix，未编辑points不发生位移；整树resize继续走O(1) pose路径。Group默认旋转中心与九点
+既有world matrix，未编辑points不发生位移；整树resize把拓扑点按完整仿射写回。Group默认旋转中心与九点
 pivot吸附按当前local visual/content selection bounds解析；稳定layout reference只拥有Group pose。
 
 Selection controls 是一份 immutable `SelectionOverlayProjection`。paint、control/body hit 与 cursor
@@ -143,8 +145,10 @@ select.resize({
 始终读取 authored/layout box，即使 `overflow="visible"` 且未换行的 glyph 超出该 box；`anchor` 省略等于
 `"top-left"`，支持九个 frame 固定点：`top-left`/`top`/`top-right`/`left`/`center`/`right`/
 `bottom-left`/`bottom`/`bottom-right`。这些值是 world logical 单位，不包含 Viewport 缩放；
-controller 会自动处理父级和多层 Group 变换，并通过同一个 trusted batch 和 History 记录。选中
-Group 时只改 Group pose/scale，不改写直接子元素的 authored width/height。
+controller 会自动处理父级和多层 Group 变换，并通过同一个 trusted batch 和 History 记录。Group resize
+会递归改写可编辑子元素的 authored geometry；Group 自身不再承载这次尺寸变化的 scale。移动/旋转
+Group 仍只改 Group pose。对 Rectangle/Text 等 frame-authored 子元素，尺寸变化写入它们自己的
+frame width/height；对 VectorPath/Polygon/Line/LineTree，则写入点、控制柄或拓扑。
 
 `Select.flip()` 是同一 Transform 命令链上的镜像操作：
 
@@ -155,8 +159,8 @@ select.flip("vertical");
 
 镜像轴经过当前 selection frame 中心。单选旋转元素沿其 frame 自身水平/垂直轴镜像；多选的
 aggregate frame 为 world 轴对齐，因此沿 world 水平/垂直轴镜像。命令遵守 selection 的 resize 轴
-策略，使用同一批 selected owner baseline、trusted batch 与 semantic History；选中 Group 时只写
-Group pose/scale，不 bake children authored geometry。空选择或被策略禁止的方向是普通 noop。
+策略，使用同一批 selected owner baseline、trusted batch 与 semantic History；Group 不承载这次镜像的
+scale，镜像会递归 bake children authored geometry。空选择或被策略禁止的方向是普通 noop。
 
 ## Keyboard、Clipboard 与应用命令 owner
 
@@ -214,10 +218,12 @@ const stopSelection = select.addEventListener("select:end", syncPanel);
 const stopGeometry = select.addEventListener("select:update", syncPanel);
 ```
 
-场景持久化只监听 configured 语义完成事件：
-
-```ts
-const stopPersistence = select.addEventListener(
+场景持久化只监听 configured 语义完成事件：
+
+```ts
+import { serializeScene } from "@fulate/import";
+
+const stopPersistence = select.addEventListener(
   "select:configured-change",
   () => saveToIndexedDB(serializeScene(root))
 );

package/dist/editor/interaction-controller/connection-intent.d.ts

@@ -0,0 +1,5 @@
+import { type ConnectionPortRef, type Root } from "@fulate/core";
+import { type EndpointRef } from "@fulate/ui";
+import type { HistoryManager } from "../../history";
+import type { ToolsConnectionIntent } from "../../select";
+export declare function createToolsConnectionIntent(root: Root, history: HistoryManager, source: EndpointRef, target: ConnectionPortRef): ToolsConnectionIntent;

package/dist/editor/interaction-controller/controller.d.ts

@@ -0,0 +1,166 @@
+import { Element, type ConnectionPortRef, type OwnerPropertyChange, type Root, type StructureChange } from "@fulate/core";
+import { LineTree, type LineTreeBranchTailSource, type LineDecoration } from "@fulate/ui";
+import { type PointView, type Rect } from "@fulate/share";
+import type { HistoryManager, HistoryScope } from "../../history";
+import type { LineTool } from "../../line";
+import type { Select, SelectedPropertyPatch } from "../../select";
+import { type SelectionOverlayProjection, type SelectionOverlayTarget } from "../../select/projection";
+import { type FlipDirection, type ResizeOptions } from "../../select/transform";
+import type { Snap } from "../../select/snap";
+import { type PointerIntent } from "./helpers";
+import { PointGesture, SelectionPressGesture, TransformGesture } from "./gestures";
+import type { ApplyCommandOptions, EditorInteractionState, LineDrawingSession, PointerGesture, SelectionIdentity } from "./types";
+export type { EditorInteractionState, SelectControllerState, SelectionIdentity } from "./types";
+export declare class EditorInteractionController {
+    readonly select: Select;
+    readonly root: Root;
+    readonly history: HistoryManager;
+    readonly frameFlush: any;
+    private readonly cleanups;
+    private selectionValue;
+    private owners;
+    private policy;
+    private rotationPivotPreview;
+    private selectionFrame;
+    private preserveSelectionFrame;
+    private projectionState;
+    private projectionOwners;
+    private projectionMembership;
+    private projectionTopology;
+    private overlayDirty;
+    private pendingSelectionUpdate;
+    private pendingSelectionRepair;
+    private rotationPivotDisplayOwner;
+    private hoveredTarget;
+    private hoveredContent;
+    private controllerState;
+    private pasteTask;
+    private pointerWorld;
+    marquee: Readonly<Rect> | null;
+    constructor(select: Select, root: Root, history: HistoryManager);
+    get selection(): readonly Element[];
+    get projection(): SelectionOverlayProjection;
+    publishConfiguredChange(changed: boolean | undefined): void;
+    /** 把纯外部通知排到当前同步命令、回放或 frame completion 返回之后。 */
+    private notifySelect;
+    get contentHover(): Element<import("@fulate/core").ElementProperties, import("@fulate/core").BaseElementOption<any>, Partial<Omit<import("@fulate/core").BaseElementOption<any>, "key" | "children">>>;
+    get overlayTarget(): SelectionOverlayTarget;
+    get editorElements(): readonly Element[];
+    get snapTool(): Snap | undefined;
+    get state(): EditorInteractionState;
+    /** @internal Captures the canonical selection and interaction identities. */
+    captureSelectionIdentity(): SelectionIdentity;
+    /** @internal Makes one concrete clipboard Promise the latest paste intent. */
+    beginPaste(task: Promise<void>): void;
+    /** @internal Tests whether one paste still owns the captured selection intent. */
+    ownsPasteSelection(identity: SelectionIdentity, task: Promise<void>): boolean;
+    /** @internal Releases the latest paste intent after its Promise settles. */
+    finishPaste(task: Promise<void>): void;
+    private get selectState();
+    private installSelectState;
+    private get activeGesture();
+    private set activeGesture(value);
+    private get activePointGesture();
+    private get pointState();
+    private set pointState(value);
+    private get activePointTarget();
+    private set activePointTarget(value);
+    private get contentSession();
+    private set contentSession(value);
+    private get contentHistory();
+    private set contentHistory(value);
+    private get lineSession();
+    private set lineSession(value);
+    private get lineTreeSession();
+    private set lineTreeSession(value);
+    private get rotationPivotState();
+    private installInput;
+    private readonly handleSceneChange;
+    private sceneChangeAffectsSelection;
+    private selectionGeometryIsDirty;
+    private invalidatePointTopology;
+    private resolvePolicy;
+    setSelection(elements: readonly Element[]): void;
+    private readonly pointProjectionOwnerIsCurrent;
+    private restoreSelectionForHistory;
+    private replaceSelection;
+    private requestSelectionEnd;
+    private pointContextIsCurrent;
+    private resolveCurrentPointContext;
+    private resolvePointGestureContext;
+    pointGestureOwnsCurrentContext(gesture: PointGesture): boolean;
+    private setPointState;
+    private exitPointState;
+    private setActivePointTarget;
+    private invalidateOverlay;
+    private shouldShowRotationPivot;
+    private showRotationPivotForCurrentOwner;
+    hasPendingOverlayWork(): boolean;
+    flushOverlayProjection(): void;
+    hasPendingCompletionWork(): boolean;
+    flushCompletionWork(): void;
+    resolveCursor(point: PointView | undefined, contentCursor: string): string;
+    private updateHover;
+    private applyAuthoredBatch;
+    private onPointerDown;
+    private onPointerMove;
+    private onPointerFinish;
+    private onDoubleClick;
+    private onKeyDown;
+    private captureTransformRecords;
+    private startTransform;
+    promoteSelectionPress(gesture: SelectionPressGesture): TransformGesture | null;
+    finishSelectionPress(gesture: SelectionPressGesture): void;
+    finishSelectionGesture(gesture: PointerGesture, selection?: readonly Element[]): void;
+    consumeTransform(gesture: TransformGesture, intent: PointerIntent): void;
+    private startPointGesture;
+    consumePoint(gesture: PointGesture, intent: PointerIntent, first: boolean): void;
+    deletePointTarget(): boolean;
+    nudge(dx: number, dy: number): void;
+    setProperties(patch: SelectedPropertyPatch): void;
+    private prepareTransformCommandFrame;
+    private applyTransformCommand;
+    resize(options?: Readonly<ResizeOptions>): void;
+    flip(direction: FlipDirection): void;
+    previewRotationPivot(owner: Element, point: PointView): void;
+    clearRotationPivotPreview(owner: Element): void;
+    commitRotationPivot(owner: Element, point: PointView): boolean;
+    private resolveRotationPivot;
+    setMarquee(rect: Readonly<Rect> | null): void;
+    finishPointerGesture(gesture: PointerGesture): void;
+    private pointConnectionCandidateIsCurrent;
+    finishPointConnectionGesture(gesture: PointGesture): void;
+    private beginContentEditing;
+    finishContentEditing(discard: boolean): void;
+    startLineDrawing(tool: LineTool): void;
+    private startLineTreeBranchDrawing;
+    private updateLineTreeSourceHover;
+    private confirmLineTreeSource;
+    private beginLineTreeBranchDraft;
+    private updateLineTreePreview;
+    private probeLineTreeTail;
+    private confirmLineTreePoint;
+    private confirmLineTreeBranchDrawing;
+    private updateLinePreview;
+    private probeLineAnchor;
+    private confirmLinePoint;
+    stopLineDrawing(): void;
+    cancelLineDrawing(): void;
+    private confirmLineDrawing;
+    getLineDrawingView(tool: LineTool): LineDrawingSession | {
+        readonly kind: "branch-draw";
+        readonly tool: LineTool;
+        readonly owner: LineTree;
+        readonly source: LineTreeBranchTailSource;
+        readonly tailDecoration: LineDecoration;
+        readonly confirmed: PointView[];
+        tailTarget: ConnectionPortRef | undefined;
+        preview: PointView | null;
+        snap: import("../../select/snap").PortSnapResult | null;
+    };
+    hasLineToolSession(tool: LineTool): boolean;
+    applyCommand(ownerEffects: readonly OwnerPropertyChange[], structureEffects: readonly StructureChange[], scope: HistoryScope | undefined, selectionAfter: readonly Element[], options?: ApplyCommandOptions): void;
+    finishCurrentInteraction(): void;
+    destroy(): void;
+}
+export declare function getEditorInteractionController(root: Root): EditorInteractionController;

package/dist/editor/interaction-controller/gestures.d.ts

@@ -0,0 +1,93 @@
+import type { ConnectionPortRef, Element, Node } from "@fulate/core";
+import type { EndpointConnectionRole, EndpointRef, EditorAuthoredGesture, PointEditTarget } from "@fulate/ui";
+import type { PointView } from "@fulate/share";
+import type { HistoryScope } from "../../history";
+import type { ResizeHandle, SelectionOverlayProjection } from "../../select/projection";
+import { type PointerIntent } from "./helpers";
+import type { EditorInteractionController } from "./controller";
+import type { PointerGesture, TransformOwnerRecord } from "./types";
+export declare class TransformGesture implements PointerGesture {
+    readonly controller: EditorInteractionController;
+    readonly kind: "move" | "resize" | "rotate";
+    readonly start: PointView;
+    readonly frame: NonNullable<SelectionOverlayProjection["frame"]>;
+    readonly records: readonly TransformOwnerRecord[];
+    readonly snapPoints: readonly PointView[];
+    readonly movableLineEndpoints: readonly PointView[];
+    readonly snapExcludes: readonly Element[];
+    readonly rotationPivotWorld: PointView;
+    readonly history: HistoryScope | undefined;
+    readonly resizeHandle?: ResizeHandle;
+    private lastIntent;
+    private previousRotationAngle;
+    private unwrappedRotationDelta;
+    constructor(controller: EditorInteractionController, kind: "move" | "resize" | "rotate", start: PointView, initialIntent: PointerIntent, frame: NonNullable<SelectionOverlayProjection["frame"]>, records: readonly TransformOwnerRecord[], snapPoints: readonly PointView[], movableLineEndpoints: readonly PointView[], snapExcludes: readonly Element[], rotationPivotWorld: PointView, history: HistoryScope | undefined, resizeHandle?: ResizeHandle);
+    consumeRotationDelta(point: PointView): number;
+    probeForbiddenPort(point: PointView): boolean;
+    update(intent: PointerIntent): void;
+    ownsCurrentContext(): boolean;
+    finishInvalidated(): void;
+    finish(intent?: PointerIntent): void;
+}
+export declare class PointGesture implements PointerGesture, EditorAuthoredGesture {
+    readonly controller: EditorInteractionController;
+    readonly ownerKey: string;
+    readonly startParent: Node | undefined;
+    readonly startTarget: PointEditTarget;
+    readonly insertT: number | undefined;
+    readonly role: "endpoint" | "vertex" | "segment" | "handle";
+    readonly connectionRole: EndpointConnectionRole | null;
+    readonly snapExcludes: readonly Element[];
+    readonly history: HistoryScope | undefined;
+    readonly startPointerWorld: PointView;
+    readonly startTargetWorld: PointView;
+    private latestIntent;
+    private consumedIntent;
+    connectionTarget: ConnectionPortRef | undefined;
+    connectionTargetOwner: Element | undefined;
+    connectionTargetParent: Node | undefined;
+    constructor(controller: EditorInteractionController, ownerKey: string, startParent: Node | undefined, startTarget: PointEditTarget, insertT: number | undefined, role: "endpoint" | "vertex" | "segment" | "handle", connectionRole: EndpointConnectionRole | null, snapExcludes: readonly Element[], history: HistoryScope | undefined, startPointerWorld: PointView, startTargetWorld: PointView);
+    currentTarget: PointEditTarget;
+    ownsCurrentContext(): boolean;
+    get connectionSource(): EndpointRef | undefined;
+    resolveWorldPoint(pointer: PointView): {
+        x: number;
+        y: number;
+    };
+    update(intent: PointerIntent): void;
+    consumeLatestIntent(): void;
+    finish(intent?: PointerIntent, cancelled?: boolean): void;
+    finishInvalidated(): void;
+}
+export declare class PivotGesture implements PointerGesture {
+    readonly controller: EditorInteractionController;
+    readonly owner: Element;
+    readonly startPointer: PointView;
+    readonly startPivot: PointView;
+    private finalPoint;
+    constructor(controller: EditorInteractionController, owner: Element, startPointer: PointView, startPivot: PointView);
+    update(intent: PointerIntent): void;
+    finish(intent?: PointerIntent): void;
+}
+export declare class SelectionPressGesture implements PointerGesture {
+    readonly controller: EditorInteractionController;
+    readonly start: PointerIntent;
+    readonly candidate: Element | undefined;
+    readonly contentTarget: Element | null;
+    readonly directDragOwner?: Element;
+    constructor(controller: EditorInteractionController, start: PointerIntent, candidate: Element | undefined, contentTarget: Element | null, directDragOwner?: Element);
+    update(intent: PointerIntent): void;
+    finish(intent?: PointerIntent, cancelled?: boolean): void;
+}
+export declare class MarqueeGesture implements PointerGesture {
+    readonly controller: EditorInteractionController;
+    readonly start: PointView;
+    readonly candidate: Element | undefined;
+    readonly additive: boolean;
+    readonly initialSelection: readonly Element[];
+    private current;
+    private moved;
+    constructor(controller: EditorInteractionController, start: PointView, candidate: Element | undefined, additive: boolean, initialSelection: readonly Element[]);
+    update(intent: PointerIntent): void;
+    finish(intent?: PointerIntent, cancelled?: boolean): void;
+}

package/dist/editor/interaction-controller/helpers.d.ts

@@ -0,0 +1,16 @@
+import { Element, type FulateEvent, type OriginX, type OriginY } from "@fulate/core";
+import { type PointView, type Rect } from "@fulate/share";
+import type { PointEditingScope } from "@fulate/ui";
+import type { PortSnapProbeResult } from "../../select/snap";
+import type { SelectionOverlayTarget } from "../../select/projection";
+export interface PointerIntent {
+    readonly point: PointView;
+    readonly shiftKey: boolean;
+}
+export declare function isBlockedPortProbe(probe: PortSnapProbeResult | null | undefined): boolean;
+export declare function resolvePortProbeCursor(probe: PortSnapProbeResult | undefined): "not-allowed" | "crosshair";
+export declare function pointIntent(event: FulateEvent): PointerIntent;
+export declare function matchesMarquee(element: Element, rect: Readonly<Rect>, requireContainment: boolean): boolean;
+export declare function sameTarget(left: SelectionOverlayTarget | null, right: SelectionOverlayTarget | null): boolean;
+export declare function samePointScope(left: PointEditingScope, right: PointEditingScope): boolean;
+export declare function resolveOriginPoint(bounds: Readonly<Rect>, x: OriginX, y: OriginY): PointView;

package/dist/editor/interaction-controller/index.d.ts

@@ -0,0 +1,2 @@
+export { EditorInteractionController, getEditorInteractionController } from "./controller";
+export type { EditorInteractionState, SelectControllerState, SelectionIdentity } from "./types";

package/dist/editor/interaction-controller/types.d.ts

@@ -0,0 +1,104 @@
+import type { ConnectionPortRef, Element, Node } from "@fulate/core";
+import type { ContentEditingSession, EndpointRef, LineDecoration, LineTree, LineTreeBranchTailSource, PointEditTarget, PointEditingScope, SelectionBehavior, TransformInteractionCapability } from "@fulate/ui";
+import type { PointView } from "@fulate/share";
+import type { HistoryScope } from "../../history";
+import type { LineTool } from "../../line";
+import type { ProjectionOwner, SelectionRotationPivot } from "../../select/projection";
+import type { PortSnapResult } from "../../select/snap";
+import type { PointerIntent } from "./helpers";
+import type { MarqueeGesture, PointGesture, PivotGesture, SelectionPressGesture, TransformGesture } from "./gestures";
+export interface SelectedOwner extends ProjectionOwner {
+    readonly behavior: SelectionBehavior;
+}
+export interface SelectionIdentity {
+    readonly owners: readonly SelectedOwner[];
+    readonly interaction: EditorInteractionState;
+}
+export interface TransformOwnerRecord {
+    readonly owner: Element;
+    readonly parent: Node | undefined;
+    readonly capability: TransformInteractionCapability;
+    readonly baseline: ReturnType<TransformInteractionCapability["captureTransformBaseline"]>;
+}
+export interface PointerGesture {
+    update(intent: PointerIntent): void;
+    finish(intent?: PointerIntent, cancelled?: boolean): void;
+}
+export interface ApplyCommandOptions {
+    readonly beforeDrain?: () => void;
+    readonly afterHistory?: () => void;
+    readonly installSelection?: () => boolean;
+}
+export type SelectNotification = "select:end" | "select:configured-change" | "select:undo" | "select:redo";
+export interface SelectNotificationData {
+    readonly elements: readonly Element[];
+}
+export interface LineDrawingSession {
+    readonly tool: LineTool;
+    readonly resultType: "line" | "lineTree";
+    readonly tailDecoration: LineDecoration;
+    readonly history: HistoryScope | undefined;
+    readonly confirmed: PointView[];
+    headTarget: ConnectionPortRef | undefined;
+    tailTarget: ConnectionPortRef | undefined;
+    preview: PointView | null;
+    snap: PortSnapResult | null;
+}
+export interface PointState {
+    readonly ownerKey: string;
+    readonly scope: PointEditingScope;
+}
+export interface ActivePointTarget {
+    readonly ownerKey: string;
+    readonly target: PointEditTarget;
+}
+export type SelectControllerState = {
+    readonly kind: "idle";
+    readonly gesture: MarqueeGesture | null;
+} | {
+    readonly kind: "transform";
+    readonly gesture: TransformGesture | PivotGesture | SelectionPressGesture | null;
+} | {
+    readonly kind: "point";
+    readonly ownerKey: string;
+    readonly scope: PointEditingScope;
+    readonly gesture: PointGesture | SelectionPressGesture | TransformGesture | null;
+    readonly activeTarget: ActivePointTarget | null;
+} | {
+    readonly kind: "port";
+    readonly ownerKey: string;
+    readonly scope: PointEditingScope;
+    readonly gesture: PointGesture;
+    readonly source: EndpointRef;
+    readonly activeTarget: ActivePointTarget | null;
+} | {
+    readonly kind: "content";
+    readonly session: ContentEditingSession;
+    readonly history: HistoryScope | undefined;
+};
+export type LineTreeDrawingSession = {
+    readonly kind: "source-pick";
+    readonly tool: LineTool;
+    readonly owner: LineTree;
+    readonly tailDecoration: LineDecoration;
+    hover: LineTreeBranchTailSource | null;
+} | {
+    readonly kind: "branch-draw";
+    readonly tool: LineTool;
+    readonly owner: LineTree;
+    readonly source: LineTreeBranchTailSource;
+    readonly tailDecoration: LineDecoration;
+    readonly confirmed: PointView[];
+    tailTarget: ConnectionPortRef | undefined;
+    preview: PointView | null;
+    snap: PortSnapResult | null;
+};
+export type EditorInteractionState = {
+    readonly kind: "select";
+    readonly interaction: SelectControllerState;
+    readonly selection: readonly Element[];
+    readonly pivot: SelectionRotationPivot;
+} | {
+    readonly kind: "line-draw";
+    readonly session: LineDrawingSession | LineTreeDrawingSession;
+};

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-export { checkElement } from "./select/checkElement";
 export { Select } from "./select/index";
 export type { ConnectionGesture, CopyContext, ClipboardDataProducer, DeleteContext, FlipDirection, PasteContext, PasteOptions, PasteParentResolver, ResizeAnchor, ResizeOptions, SelectedPropertyPatch, SelectKeyboardCommands, SelectOption, ToolsConnectionIntent } from "./select/index";
 export { Snap } from "./select/snap";
@@ -13,5 +12,3 @@ export { alignElements } from "./select/align";
 export type { AlignType } from "./select/align";
 export { ArrangeType } from "./select/arrange";
 export type { ClipboardPlugin } from "./select/clipboard";
-export { serializeScene, serializeSceneToJSON, deserializeElement, restoreScene, parseFileData, exportToFile, importFromFile } from "@fulate/import";
-export type { ElementFilter, FileData, DeserializeFactories, DeserializeFactory } from "@fulate/import";

package/dist/index.js

@@ -1,7 +1,7 @@
 import { Element, ElementProperties, ElementTransform, Layer, isFormControlTarget, projectConnectionPortPoint, resolveOrigin, resolveReferenceTransform } from "@fulate/core";
-import { BaseLine, ContentEditingCapabilityToken, DEFAULT_LINE_TREE_BRANCH_STYLE, Group, Line, LineTree, PointEditingCapabilityToken, SelectionBehaviorCapabilityToken, SelectionBehaviorMode, SelectionDiveMode, SelectionSnapMode, SnapSourceCapabilityToken, TransformInteractionCapabilityToken, addLineTreeBranchAtTail, applyLineTreeTopologyDelta, connectionPortAccepts, createLineTreeTopology, createLineTreeTopologyDelta, getEditorCapability, getEditorFrameFlush, getEndpointRelationIndex, hasConnectionPortCapacity, isEndpointRelationSource, moveLineTreePoint, remapLineTreeRelations, resolveConnectEndpointChange, resolveConnectionPortChanges, resolveDisconnectEndpointChanges, workspaceFocusInsetsKey } from "@fulate/ui";
-import { Bound, Intersection, makeBoundingBoxFromRects, qrDecompose, transformPoint } from "@fulate/share";
-import { deserializeElement, deserializeElement as deserializeElement$1, exportToFile, importFromFile, parseFileData, restoreScene, serializeScene, serializeSceneToJSON } from "@fulate/import";
+import { BaseLine, ContentEditingCapabilityToken, DEFAULT_LINE_TREE_BRANCH_STYLE, Group, Line, LineTree, PointEditingCapabilityToken, SelectionBehaviorCapabilityToken, SelectionBehaviorMode, SelectionDiveMode, SelectionSnapMode, SnapSourceCapabilityToken, TransformInteractionCapabilityToken, addLineTreeBranchAtTail, applyLineTreeTopologyDelta, connectionPortAccepts, createLineTreeTopology, createLineTreeTopologyDelta, getEditorCapability, getEditorFrameFlush, getEndpointRelationIndex, hasConnectionPortCapacity, isEndpointRelationSource, moveLineTreePoint, remapLineTreeRelations, resolveConnectEndpointChange, resolveConnectionPortChanges, resolveDisconnectEndpointChanges, resolveSelectionFrameBounds, workspaceFocusInsetsKey } from "@fulate/ui";
+import { Bound, Intersection, isIdentityMatrix, qrDecompose, transformPoint } from "@fulate/share";
+import { deserializeElement } from "@fulate/import";
 import { isNull, isString, isUndefined } from "lodash-es";
 import RBush from "rbush";
 //#region packages/tools/src/select/checkElement.ts
@@ -33,6 +33,12 @@ function checkElement(element, excludes = [], scopeRootKey) {
 	return getEditorCapability(resolved, SelectionBehaviorCapabilityToken) ? resolved : void 0;
 }
 //#endregion
+//#region packages/tools/src/select/identity.ts
+/** Compare stable point-edit targets without reading live geometry. */
+function samePointEditTarget(left, right) {
+	return left.kind === right.kind && (left.kind === "anchor" ? right.kind === "anchor" && left.anchorId === right.anchorId : left.kind === "segment" ? right.kind === "segment" && left.segmentId === right.segmentId : right.kind === "handle" && left.segmentId === right.segmentId && left.role === right.role);
+}
+//#endregion
 //#region packages/tools/src/select/projection.ts
 var ROTATE_CURSOR = `url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="black" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 2v6h-6"></path><path d="M21 13a9 9 0 1 1-3-7.7L21 8"></path></svg>') 9 9, crosshair`;
 var RESIZE_CURSORS = {
@@ -81,8 +87,37 @@ var RESIZE_TARGETS = {
 };
 var ROTATE_TARGET = { kind: "rotate" };
 var PIVOT_TARGET = { kind: "pivot" };
-function samePointEditTarget(left, right) {
-	return left.kind === right.kind && (left.kind === "anchor" ? right.kind === "anchor" && left.anchorId === right.anchorId : left.kind === "segment" ? right.kind === "segment" && left.segmentId === right.segmentId : right.kind === "handle" && left.segmentId === right.segmentId && left.role === right.role);
+function rectCorners$1(rect) {
+	const right = rect.left + rect.width;
+	const bottom = rect.top + rect.height;
+	return [
+		{
+			x: rect.left,
+			y: rect.top
+		},
+		{
+			x: right,
+			y: rect.top
+		},
+		{
+			x: right,
+			y: bottom
+		},
+		{
+			x: rect.left,
+			y: bottom
+		}
+	];
+}
+/**
+* Resolve the points that define an owner's world selection frame. A frame
+* capability is authoritative (for example Text/KeyValue authored bounds);
+* owners without one use the shared local visual/layout fallback.
+*/
+function worldSelectionFramePoints(owner) {
+	const localFrame = resolveSelectionFrameBounds(owner.element, owner.transform);
+	const matrix = owner.element.transform.getWorldMatrixView();
+	return rectCorners$1(localFrame).map((point) => transformPoint(matrix, point));
 }
 var ROTATED_RESIZE_CURSORS = [
 	"ns-resize",
@@ -135,20 +170,23 @@ function createSelectionFrameProjection({ left, top, width, height, angle }) {
 	};
 }
 /** @internal Build a command frame from the current owner bounds. */
-function createWorldVisualBoundsSelectionFrame(owners, fallback) {
+function createWorldSelectionFrame(owners, fallback) {
 	if (owners.length === 0) return fallback ?? null;
 	if (owners.length === 1) {
-		if (owners[0].transform?.getSelectionFrameBounds) {
+		const ownerFrame = owners[0].transform?.getSelectionFrameBounds?.();
+		if (ownerFrame) {
 			if (fallback) return fallback;
-			return frameFromSingleOwner(owners[0]);
+			return frameFromSingleOwner(owners[0], ownerFrame);
 		}
-		const bounds = owners[0].element.transform.getWorldVisualBoundsView();
-		if ((bounds.width === 0 || bounds.height === 0) && fallback) return fallback;
+		const bounds = resolveSelectionFrameBounds(owners[0].element, owners[0].transform);
+		const matrix = owners[0].element.transform.getWorldMatrixView();
+		const worldBounds = Bound.fromPoints(rectCorners$1(bounds).map((point) => transformPoint(matrix, point)));
+		if ((worldBounds.width === 0 || worldBounds.height === 0) && fallback) return fallback;
 		return createSelectionFrameProjection({
-			left: bounds.left,
-			top: bounds.top,
-			width: bounds.width,
-			height: bounds.height,
+			left: worldBounds.minX,
+			top: worldBounds.minY,
+			width: worldBounds.width,
+			height: worldBounds.height,
 			angle: 0
 		});
 	}
@@ -156,13 +194,13 @@ function createWorldVisualBoundsSelectionFrame(owners, fallback) {
 	let top = Infinity;
 	let right = -Infinity;
 	let bottom = -Infinity;
-	for (const { element } of owners) {
-		const bounds = element.transform.getWorldVisualBoundsView();
-		if (bounds.left < left) left = bounds.left;
-		if (bounds.top < top) top = bounds.top;
-		if (bounds.left + bounds.width > right) right = bounds.left + bounds.width;
-		if (bounds.top + bounds.height > bottom) bottom = bounds.top + bounds.height;
+	for (const owner of owners) for (const point of worldSelectionFramePoints(owner)) {
+		if (point.x < left) left = point.x;
+		if (point.y < top) top = point.y;
+		if (point.x > right) right = point.x;
+		if (point.y > bottom) bottom = point.y;
 	}
+	if (!Number.isFinite(left) || !Number.isFinite(top) || !Number.isFinite(right) || !Number.isFinite(bottom)) return fallback ?? null;
 	const width = right - left;
 	const height = bottom - top;
 	if ((width === 0 || height === 0) && fallback) return fallback;
@@ -212,10 +250,8 @@ function createSelectionRotationPivotSnapMarkers(frame) {
 		vertical
 	})));
 }
-function frameFromSingleOwner(owner) {
-	const geometry = owner.element.transform;
-	const bounds = owner.transform?.getSelectionFrameBounds?.() ?? geometry.getLocalVisualBoundsView() ?? geometry.getLayoutReferenceBoundsView();
-	const matrix = geometry.getWorldMatrixView();
+function frameFromSingleOwner(owner, bounds = resolveSelectionFrameBounds(owner.element, owner.transform)) {
+	const matrix = owner.element.transform.getWorldMatrixView();
 	const decomposition = qrDecompose(matrix);
 	const angleRadians = decomposition.angle * Math.PI / 180;
 	const skewScaleX = matrix.c * Math.cos(angleRadians) + matrix.d * Math.sin(angleRadians);
@@ -237,7 +273,7 @@ function frameFromSingleOwner(owner) {
 function frameFromOwners(owners) {
 	if (owners.length === 0) return null;
 	if (owners.length === 1) return frameFromSingleOwner(owners[0]);
-	return createWorldVisualBoundsSelectionFrame(owners);
+	return createWorldSelectionFrame(owners);
 }
 function resizeControls(frame, policy) {
 	const x = policy.resize === "x" || policy.resize === "both";
@@ -306,8 +342,7 @@ function rotationControls(frame) {
 		target: ROTATE_TARGET
 	}));
 }
-function pointControls(owner, topology, activePointTarget) {
-	const matrix = owner.element.transform.getWorldMatrixView();
+function pointControls(topology, activePointTarget, matrix) {
 	return topology.pointControls.map((control) => {
 		return {
 			world: transformPoint(matrix, control.local),
@@ -386,8 +421,12 @@ function createProjectionOwner(element, frameVisible = true, pointScope = null,
 function buildSelectionOverlayProjection({ owners, membership, topology, frame: frameOverride, policy, pivot, showPivot, pivotSnapMarkers = [], activePointTarget = null, marquee }) {
 	const frame = frameOverride ?? frameFromOwners(owners);
 	const controls = [];
-	if (owners.length === 1) controls.push(...pointControls(owners[0], topology, activePointTarget));
-	const rotationPivotWorld = frame && owners.length === 1 && pivot.kind === "custom-owner-local" && pivot.ownerKey === owners[0].element.key ? transformPoint(owners[0].element.transform.getWorldMatrixView(), pivot.local) : frame?.worldCenter ?? {
+	const singleOwner = owners.length === 1 ? owners[0] : void 0;
+	const singleOwnerMatrix = singleOwner !== void 0 && (topology.pointControls.length > 0 || frame !== null && pivot.kind === "custom-owner-local" && pivot.ownerKey === singleOwner.element.key) ? singleOwner.element.transform.getWorldMatrixView() : void 0;
+	if (owners.length === 1) {
+		if (topology.pointControls.length > 0) controls.push(...pointControls(topology, activePointTarget, singleOwnerMatrix));
+	}
+	const rotationPivotWorld = frame && owners.length === 1 && pivot.kind === "custom-owner-local" && pivot.ownerKey === owners[0].element.key ? transformPoint(singleOwnerMatrix, pivot.local) : frame?.worldCenter ?? {
 		x: 0,
 		y: 0
 	};
@@ -520,21 +559,13 @@ function resolveRotationTransform({ frameAngle, pivot, unwrappedDelta, snapAngle
 	};
 }
 //#endregion
-//#region packages/tools/src/editor/interaction-controller.ts
-var editorControllerKey = Symbol();
-var NO_PORT_SNAP$1 = {
-	snap: null,
-	state: null
-};
-var NO_ELEMENTS = [];
-var NO_POINTS = [];
+//#region packages/tools/src/editor/interaction-controller/helpers.ts
 function isBlockedPortProbe(probe) {
 	return probe?.state === "incompatible" || probe?.state === "forbidden";
 }
 function resolvePortProbeCursor(probe) {
 	return isBlockedPortProbe(probe) ? "not-allowed" : "crosshair";
 }
-var NO_PROJECTION_OWNERS = [];
 function pointIntent(event) {
 	return {
 		point: {
@@ -573,6 +604,8 @@ function resolveOriginPoint(bounds, x, y) {
 		y: bounds.top + (resolveOrigin(y) + .5) * bounds.height
 	};
 }
+//#endregion
+//#region packages/tools/src/editor/interaction-controller/gestures.ts
 var TransformGesture = class {
 	lastIntent;
 	previousRotationAngle;
@@ -704,23 +737,6 @@ var PointGesture = class {
 		}
 	}
 };
-function createToolsConnectionIntent(root, history, source, target) {
-	return {
-		source,
-		target,
-		connect() {
-			const change = resolveConnectEndpointChange(root, source, target);
-			if (!change) return;
-			const owner = root.getByKey(source.elementKey);
-			const selection = owner instanceof Element ? [owner] : [];
-			const scope = history.openScope(selection);
-			root.applyChangeBatch([change], [], scope);
-			root.frameRuntime.drain();
-			const current = root.getByKey(source.elementKey);
-			history.publishConfiguredChange(scope?.finish(current instanceof Element ? [current] : []));
-		}
-	};
-}
 var PivotGesture = class {
 	finalPoint;
 	constructor(controller, owner, startPointer, startPivot) {
@@ -826,6 +842,38 @@ var MarqueeGesture = class {
 		this.controller.finishSelectionGesture(this, selection);
 	}
 };
+//#endregion
+//#region packages/tools/src/editor/interaction-controller/connection-intent.ts
+function createToolsConnectionIntent(root, history, source, target) {
+	return {
+		source,
+		target,
+		connect() {
+			const change = resolveConnectEndpointChange(root, source, target);
+			if (!change) return;
+			const owner = root.getByKey(source.elementKey);
+			const selection = owner instanceof Element ? [owner] : [];
+			const scope = history.openScope(selection);
+			root.applyChangeBatch([change], [], scope);
+			root.frameRuntime.drain();
+			const current = root.getByKey(source.elementKey);
+			history.publishConfiguredChange(scope?.finish(current instanceof Element ? [current] : []));
+		}
+	};
+}
+//#endregion
+//#region packages/tools/src/editor/interaction-controller/controller.ts
+var editorControllerKey = Symbol();
+var NO_PORT_SNAP$1 = {
+	snap: null,
+	state: null
+};
+var NO_ELEMENTS = [];
+var NO_POINTS = [];
+var NO_PROJECTION_OWNERS = [];
+function getOwnerSelectionFrameBounds(owner) {
+	return resolveSelectionFrameBounds(owner, getEditorCapability(owner, TransformInteractionCapabilityToken));
+}
 var EditorInteractionController = class {
 	frameFlush;
 	cleanups = [];
@@ -1129,7 +1177,7 @@ var EditorInteractionController = class {
 			const owner = this.owners[0].element;
 			const preview = this.rotationPivotPreview?.owner === owner ? this.rotationPivotPreview.local : null;
 			if (!preview && owner.rotationPivotX === "center" && owner.rotationPivotY === "center") return { kind: "selection-center" };
-			const bounds = owner.transform.getLocalVisualBoundsView() ?? owner.transform.getLayoutReferenceBoundsView();
+			const bounds = getOwnerSelectionFrameBounds(owner);
 			return {
 				kind: "custom-owner-local",
 				ownerKey: owner.key,
@@ -1714,7 +1762,7 @@ var EditorInteractionController = class {
 		if (command && key === "a") {
 			event.preventDefault();
 			const elements = /* @__PURE__ */ new Set();
-			for (const element of this.root.queryArea(this.root.viewport.getWorldRect(), {
+			for (const element of this.root.queryArea(this.root.viewport.getWorldRectView(), {
 				bounds: "visual",
 				order: "none"
 			})) {
@@ -1852,9 +1900,10 @@ var EditorInteractionController = class {
 		}
 		const transformIntent = {
 			worldDelta,
+			...gesture.kind === "resize" ? { bakeGeometry: true } : {},
 			...unwrappedRotationDelta === void 0 ? {} : { unwrappedRotationDelta }
 		};
-		const changes = gesture.records.map((record) => record.capability.resolveTransformChange(record.baseline, transformIntent));
+		const changes = gesture.records.flatMap((record) => record.capability.resolveTransformChange(record.baseline, transformIntent));
 		this.selectionFrame = resolveSelectionFrameTransform(gesture.frame, worldDelta, gesture.kind);
 		this.invalidatePointTopology();
 		this.applyAuthoredBatch(changes, [], gesture.history);
@@ -2004,7 +2053,7 @@ var EditorInteractionController = class {
 		const scope = this.history.openScope(this.selection);
 		const worldDelta = new DOMMatrix().translate(dx, dy);
 		const intent = { worldDelta };
-		const changes = records.map((record) => record.capability.resolveTransformChange(record.baseline, intent));
+		const changes = records.flatMap((record) => record.capability.resolveTransformChange(record.baseline, intent));
 		if (changes.length > 0) {
 			if (frame) this.selectionFrame = resolveSelectionFrameTransform(frame, worldDelta, "move");
 			this.invalidatePointTopology();
@@ -2046,11 +2095,14 @@ var EditorInteractionController = class {
 		}
 		return this.projectionState.frame;
 	}
-	applyTransformCommand(worldDelta) {
+	applyTransformCommand(worldDelta, bakeGeometry = false) {
 		const records = this.captureTransformRecords();
 		if (records.length !== this.owners.length) return;
-		const intent = { worldDelta };
-		const changes = records.map((record) => record.capability.resolveTransformChange(record.baseline, intent));
+		const intent = {
+			worldDelta,
+			bakeGeometry
+		};
+		const changes = records.flatMap((record) => record.capability.resolveTransformChange(record.baseline, intent));
 		this.invalidatePointTopology();
 		const scope = this.history.openScope(this.selection);
 		this.applyCommand(changes, [], scope, this.selection);
@@ -2058,7 +2110,7 @@ var EditorInteractionController = class {
 	resize(options = {}) {
 		const projectionFrame = this.prepareTransformCommandFrame();
 		if (!projectionFrame) return;
-		const frame = this.owners.length === 1 ? createWorldVisualBoundsSelectionFrame(this.owners, projectionFrame) : projectionFrame;
+		const frame = this.owners.length === 1 ? createWorldSelectionFrame(this.owners, projectionFrame) : projectionFrame;
 		if (!frame) return;
 		const resizeX = this.policy.resize === "x" || this.policy.resize === "both";
 		const resizeY = this.policy.resize === "y" || this.policy.resize === "both";
@@ -2066,14 +2118,14 @@ var EditorInteractionController = class {
 		const height = resizeY && options.height !== void 0 ? options.height : frame.height;
 		if (width === frame.width && height === frame.height) return;
 		const worldDelta = resolveResizeWorldDeltaForSize(frame, width, height, options.anchor);
-		if (worldDelta.a === 1 && worldDelta.b === 0 && worldDelta.c === 0 && worldDelta.d === 1 && worldDelta.e === 0 && worldDelta.f === 0) return;
-		this.applyTransformCommand(worldDelta);
+		if (isIdentityMatrix(worldDelta)) return;
+		this.applyTransformCommand(worldDelta, true);
 	}
 	flip(direction) {
 		const frame = this.prepareTransformCommandFrame();
 		if (!frame) return;
 		if (!(direction === "horizontal" ? this.policy.resize === "x" || this.policy.resize === "both" : this.policy.resize === "y" || this.policy.resize === "both")) return;
-		this.applyTransformCommand(resolveFlipWorldDelta(frame, direction));
+		this.applyTransformCommand(resolveFlipWorldDelta(frame, direction), true);
 	}
 	previewRotationPivot(owner, point) {
 		const preview = this.resolveRotationPivot(owner, point, true);
@@ -2117,7 +2169,7 @@ var EditorInteractionController = class {
 		if (!local) return;
 		const frame = this.projectionState.frame;
 		if (!frame) return;
-		const bounds = owner.transform.getLocalVisualBoundsView() ?? owner.transform.getLayoutReferenceBoundsView();
+		const bounds = getOwnerSelectionFrameBounds(owner);
 		const markers = createSelectionRotationPivotSnapMarkers(frame);
 		if (snap) {
 			const threshold = 8 / this.root.viewport.scale;
@@ -2930,7 +2982,7 @@ function alignElements(select, type) {
 		const capability = getEditorCapability(rect.element, TransformInteractionCapabilityToken);
 		if (!capability) continue;
 		const baseline = capability.captureTransformBaseline();
-		changes.push(capability.resolveTransformChange(baseline, { worldDelta: new DOMMatrix().translate(rect.dx, rect.dy) }));
+		changes.push(...capability.resolveTransformChange(baseline, { worldDelta: new DOMMatrix().translate(rect.dx, rect.dy) }));
 	}
 	if (changes.length === 0) return;
 	const scope = select.history.openScope(elements);
@@ -3030,7 +3082,7 @@ function buildLayerMoves(select, selection, type) {
 		else children.push(...elements);
 	}
 	return {
-		changes: moves.map(({ change }) => change),
+		changes: moves.flatMap(({ change }) => change),
 		structure: [...finalChildren].map(([owner, children]) => ({
 			owner,
 			children
@@ -3235,7 +3287,7 @@ function deserializeClones(entries, deserializers) {
 		const json = structuredClone(entry);
 		removeKeys(json);
 		offsetTopLevel(json);
-		const element = deserializeElement$1(json, deserializers);
+		const element = deserializeElement(json, deserializers);
 		mapClonedKeys(entry, element, keyMap);
 		return element;
 	});
@@ -3404,6 +3456,47 @@ function hasSelectedAncestor(element, selected) {
 function parentWorld(parent) {
 	return parent instanceof Element ? parent.transform.getChildWorldInverseMatrixView().inverse() : new DOMMatrix();
 }
+function rectCorners(rect) {
+	const right = rect.left + rect.width;
+	const bottom = rect.top + rect.height;
+	return [
+		{
+			x: rect.left,
+			y: rect.top
+		},
+		{
+			x: right,
+			y: rect.top
+		},
+		{
+			x: right,
+			y: bottom
+		},
+		{
+			x: rect.left,
+			y: bottom
+		}
+	];
+}
+/**
+* Group creation uses the same owner frame that selection uses. Owners that
+* do not expose a frame retain their logical content-bound contract;
+* Text-like frame owners therefore cannot enlarge the new Group with visible
+* overflow.
+*/
+function groupBounds(children) {
+	let bounds = null;
+	for (const child of children) {
+		const frame = getEditorCapability(child, TransformInteractionCapabilityToken)?.getSelectionFrameBounds?.();
+		const childBounds = frame ? Bound.fromPoints(rectCorners(frame).map((point) => transformPoint(child.transform.getWorldMatrixView(), point))) : child.transform.getContentBounds();
+		if (!bounds) {
+			bounds = childBounds;
+			continue;
+		}
+		bounds = bounds.merge(childBounds);
+	}
+	return bounds ?? new Bound();
+}
 function captureChangesForParent(elements, targetParentWorldMatrix) {
 	const changes = [];
 	const intent = {
@@ -3413,7 +3506,7 @@ function captureChangesForParent(elements, targetParentWorldMatrix) {
 	for (const element of elements) {
 		const capability = getEditorCapability(element, TransformInteractionCapabilityToken);
 		const baseline = capability.captureTransformBaseline();
-		changes.push(capability.resolveTransformChange(baseline, intent));
+		changes.push(...capability.resolveTransformChange(baseline, intent));
 	}
 	return changes;
 }
@@ -3430,7 +3523,7 @@ function doGroup(select) {
 	if (children.length <= 1) return null;
 	const parent = children[0].parent;
 	if (!parent) return null;
-	const bounds = makeBoundingBoxFromRects(children.map((element) => element.transform.getContentBounds()));
+	const bounds = groupBounds(children);
 	const targetWorld = new DOMMatrix().translate(bounds.left, bounds.top);
 	const resolution = resolveReferenceTransform({
 		writeMode: "pose-authored",
@@ -4791,7 +4884,7 @@ var Rule = class extends Element {
 		ctx.clearRect(rulerSize, 0, w - rulerSize, rulerSize);
 		ctx.fillStyle = this.backgroundColor;
 		ctx.fillRect(rulerSize, 0, Math.max(0, w - rulerSize), rulerSize);
-		const vpRect = viewport.getWorldRect();
+		const vpRect = viewport.getWorldRectView();
 		const stepX = niceStep(pxPerTick, viewport.scale);
 		const startWorldX = vpRect.left;
 		const endWorldX = vpRect.left + vpRect.width;
@@ -4973,4 +5066,4 @@ var EditorLayer = class extends Layer {
 	}
 };
 //#endregion
-export { ArrangeType, EditorLayer, HistoryManager, LineTool, Rule, Select, Snap, alignElements, checkElement, deserializeElement, exportToFile, importFromFile, parseFileData, restoreScene, serializeScene, serializeSceneToJSON };
+export { ArrangeType, EditorLayer, HistoryManager, LineTool, Rule, Select, Snap, alignElements };

package/dist/select/identity.d.ts

@@ -0,0 +1,3 @@
+import type { PointEditTarget } from "@fulate/ui";
+/** Compare stable point-edit targets without reading live geometry. */
+export declare function samePointEditTarget(left: PointEditTarget, right: PointEditTarget): boolean;

package/dist/select/projection.d.ts

@@ -109,10 +109,9 @@ export interface SelectionProjectionTopology {
     readonly pointScopeOutline: readonly PointView[] | null;
     readonly pointScopeValid: boolean;
 }
-export declare function samePointEditTarget(left: PointEditTarget, right: PointEditTarget): boolean;
 export declare function createSelectionFrameProjection({ left, top, width, height, angle }: Pick<SelectionFrameProjection, "left" | "top" | "width" | "height" | "angle">): SelectionFrameProjection;
 /** @internal Build a command frame from the current owner bounds. */
-export declare function createWorldVisualBoundsSelectionFrame(owners: readonly ProjectionOwner[], fallback?: SelectionFrameProjection | null): SelectionFrameProjection;
+export declare function createWorldSelectionFrame(owners: readonly ProjectionOwner[], fallback?: SelectionFrameProjection | null): SelectionFrameProjection;
 export declare function createSelectionRotationPivotSnapMarkers(frame: SelectionFrameProjection): readonly SelectionRotationPivotSnapMarker[];
 export declare function createSelectionProjectionMembership(owners: readonly ProjectionOwner[], policy: ProjectionPolicy): SelectionProjectionMembership;
 export declare function createSelectionProjectionTopology(owners: readonly ProjectionOwner[], isCurrent?: (owner: ProjectionOwner) => boolean): SelectionProjectionTopology;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fulate/tools",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/dist/editor/interaction-controller.d.ts

@@ -1,339 +0,0 @@
-import { Element, Node, type ConnectionPortRef, type OwnerPropertyChange, type Root, type StructureChange } from "@fulate/core";
-import { LineTree, type EndpointConnectionRole, type EndpointRef, type ContentEditingSession, type EditorAuthoredGesture, type PointEditTarget, type PointEditingScope, type LineTreeBranchTailSource, type LineDecoration, type SelectionBehavior, type TransformInteractionCapability } from "@fulate/ui";
-import { type PointView, type Rect } from "@fulate/share";
-import type { HistoryManager, HistoryScope } from "../history";
-import type { LineTool } from "../line";
-import type { Select, SelectedPropertyPatch } from "../select";
-import { type ProjectionOwner, type ResizeHandle, type SelectionOverlayProjection, type SelectionOverlayTarget, type SelectionRotationPivot } from "../select/projection";
-import { type FlipDirection, type ResizeOptions } from "../select/transform";
-import type { PortSnapResult, Snap } from "../select/snap";
-interface SelectedOwner extends ProjectionOwner {
-    readonly behavior: SelectionBehavior;
-}
-export interface SelectionIdentity {
-    readonly owners: readonly SelectedOwner[];
-    readonly interaction: EditorInteractionState;
-}
-interface TransformOwnerRecord {
-    readonly owner: Element;
-    readonly parent: Node | undefined;
-    readonly capability: TransformInteractionCapability;
-    readonly baseline: ReturnType<TransformInteractionCapability["captureTransformBaseline"]>;
-}
-interface PointerIntent {
-    readonly point: PointView;
-    readonly shiftKey: boolean;
-}
-interface PointerGesture {
-    update(intent: PointerIntent): void;
-    finish(intent?: PointerIntent, cancelled?: boolean): void;
-}
-interface ApplyCommandOptions {
-    readonly beforeDrain?: () => void;
-    readonly afterHistory?: () => void;
-    readonly installSelection?: () => boolean;
-}
-interface LineDrawingSession {
-    readonly tool: LineTool;
-    readonly resultType: "line" | "lineTree";
-    readonly tailDecoration: LineDecoration;
-    readonly history: HistoryScope | undefined;
-    readonly confirmed: PointView[];
-    headTarget: ConnectionPortRef | undefined;
-    tailTarget: ConnectionPortRef | undefined;
-    preview: PointView | null;
-    snap: PortSnapResult | null;
-}
-interface ActivePointTarget {
-    readonly ownerKey: string;
-    readonly target: PointEditTarget;
-}
-export type SelectControllerState = {
-    readonly kind: "idle";
-    readonly gesture: MarqueeGesture | null;
-} | {
-    readonly kind: "transform";
-    readonly gesture: TransformGesture | PivotGesture | SelectionPressGesture | null;
-} | {
-    readonly kind: "point";
-    readonly ownerKey: string;
-    readonly scope: PointEditingScope;
-    readonly gesture: PointGesture | SelectionPressGesture | TransformGesture | null;
-    readonly activeTarget: ActivePointTarget | null;
-} | {
-    readonly kind: "port";
-    readonly ownerKey: string;
-    readonly scope: PointEditingScope;
-    readonly gesture: PointGesture;
-    readonly source: EndpointRef;
-    readonly activeTarget: ActivePointTarget | null;
-} | {
-    readonly kind: "content";
-    readonly session: ContentEditingSession;
-    readonly history: HistoryScope | undefined;
-};
-type LineTreeDrawingSession = {
-    readonly kind: "source-pick";
-    readonly tool: LineTool;
-    readonly owner: LineTree;
-    readonly tailDecoration: LineDecoration;
-    hover: LineTreeBranchTailSource | null;
-} | {
-    readonly kind: "branch-draw";
-    readonly tool: LineTool;
-    readonly owner: LineTree;
-    readonly source: LineTreeBranchTailSource;
-    readonly tailDecoration: LineDecoration;
-    readonly confirmed: PointView[];
-    tailTarget: ConnectionPortRef | undefined;
-    preview: PointView | null;
-    snap: PortSnapResult | null;
-};
-export type EditorInteractionState = {
-    readonly kind: "select";
-    readonly interaction: SelectControllerState;
-    readonly selection: readonly Element[];
-    readonly pivot: SelectionRotationPivot;
-} | {
-    readonly kind: "line-draw";
-    readonly session: LineDrawingSession | LineTreeDrawingSession;
-};
-declare class TransformGesture implements PointerGesture {
-    readonly controller: EditorInteractionController;
-    readonly kind: "move" | "resize" | "rotate";
-    readonly start: PointView;
-    readonly frame: NonNullable<SelectionOverlayProjection["frame"]>;
-    readonly records: readonly TransformOwnerRecord[];
-    readonly snapPoints: readonly PointView[];
-    readonly movableLineEndpoints: readonly PointView[];
-    readonly snapExcludes: readonly Element[];
-    readonly rotationPivotWorld: PointView;
-    readonly history: HistoryScope | undefined;
-    readonly resizeHandle?: ResizeHandle;
-    private lastIntent;
-    private previousRotationAngle;
-    private unwrappedRotationDelta;
-    constructor(controller: EditorInteractionController, kind: "move" | "resize" | "rotate", start: PointView, initialIntent: PointerIntent, frame: NonNullable<SelectionOverlayProjection["frame"]>, records: readonly TransformOwnerRecord[], snapPoints: readonly PointView[], movableLineEndpoints: readonly PointView[], snapExcludes: readonly Element[], rotationPivotWorld: PointView, history: HistoryScope | undefined, resizeHandle?: ResizeHandle);
-    consumeRotationDelta(point: PointView): number;
-    probeForbiddenPort(point: PointView): boolean;
-    update(intent: PointerIntent): void;
-    ownsCurrentContext(): boolean;
-    finishInvalidated(): void;
-    finish(intent?: PointerIntent): void;
-}
-declare class PointGesture implements PointerGesture, EditorAuthoredGesture {
-    readonly controller: EditorInteractionController;
-    readonly ownerKey: string;
-    readonly startParent: Node | undefined;
-    readonly startTarget: PointEditTarget;
-    readonly insertT: number | undefined;
-    readonly role: "endpoint" | "vertex" | "segment" | "handle";
-    readonly connectionRole: EndpointConnectionRole | null;
-    readonly snapExcludes: readonly Element[];
-    readonly history: HistoryScope | undefined;
-    readonly startPointerWorld: PointView;
-    readonly startTargetWorld: PointView;
-    private latestIntent;
-    private consumedIntent;
-    connectionTarget: ConnectionPortRef | undefined;
-    connectionTargetOwner: Element | undefined;
-    connectionTargetParent: Node | undefined;
-    constructor(controller: EditorInteractionController, ownerKey: string, startParent: Node | undefined, startTarget: PointEditTarget, insertT: number | undefined, role: "endpoint" | "vertex" | "segment" | "handle", connectionRole: EndpointConnectionRole | null, snapExcludes: readonly Element[], history: HistoryScope | undefined, startPointerWorld: PointView, startTargetWorld: PointView);
-    currentTarget: PointEditTarget;
-    ownsCurrentContext(): boolean;
-    get connectionSource(): EndpointRef | undefined;
-    resolveWorldPoint(pointer: PointView): {
-        x: number;
-        y: number;
-    };
-    update(intent: PointerIntent): void;
-    consumeLatestIntent(): void;
-    finish(intent?: PointerIntent, cancelled?: boolean): void;
-    finishInvalidated(): void;
-}
-declare class PivotGesture implements PointerGesture {
-    readonly controller: EditorInteractionController;
-    readonly owner: Element;
-    readonly startPointer: PointView;
-    readonly startPivot: PointView;
-    private finalPoint;
-    constructor(controller: EditorInteractionController, owner: Element, startPointer: PointView, startPivot: PointView);
-    update(intent: PointerIntent): void;
-    finish(intent?: PointerIntent): void;
-}
-declare class SelectionPressGesture implements PointerGesture {
-    readonly controller: EditorInteractionController;
-    readonly start: PointerIntent;
-    readonly candidate: Element | undefined;
-    readonly contentTarget: Element | null;
-    readonly directDragOwner?: Element;
-    constructor(controller: EditorInteractionController, start: PointerIntent, candidate: Element | undefined, contentTarget: Element | null, directDragOwner?: Element);
-    update(intent: PointerIntent): void;
-    finish(intent?: PointerIntent, cancelled?: boolean): void;
-}
-declare class MarqueeGesture implements PointerGesture {
-    readonly controller: EditorInteractionController;
-    readonly start: PointView;
-    readonly candidate: Element | undefined;
-    readonly additive: boolean;
-    readonly initialSelection: readonly Element[];
-    private current;
-    private moved;
-    constructor(controller: EditorInteractionController, start: PointView, candidate: Element | undefined, additive: boolean, initialSelection: readonly Element[]);
-    update(intent: PointerIntent): void;
-    finish(intent?: PointerIntent, cancelled?: boolean): void;
-}
-export declare class EditorInteractionController {
-    readonly select: Select;
-    readonly root: Root;
-    readonly history: HistoryManager;
-    readonly frameFlush: any;
-    private readonly cleanups;
-    private selectionValue;
-    private owners;
-    private policy;
-    private rotationPivotPreview;
-    private selectionFrame;
-    private preserveSelectionFrame;
-    private projectionState;
-    private projectionOwners;
-    private projectionMembership;
-    private projectionTopology;
-    private overlayDirty;
-    private pendingSelectionUpdate;
-    private pendingSelectionRepair;
-    private rotationPivotDisplayOwner;
-    private hoveredTarget;
-    private hoveredContent;
-    private controllerState;
-    private pasteTask;
-    private pointerWorld;
-    marquee: Readonly<Rect> | null;
-    constructor(select: Select, root: Root, history: HistoryManager);
-    get selection(): readonly Element[];
-    get projection(): SelectionOverlayProjection;
-    publishConfiguredChange(changed: boolean | undefined): void;
-    /** 把纯外部通知排到当前同步命令、回放或 frame completion 返回之后。 */
-    private notifySelect;
-    get contentHover(): Element<import("@fulate/core").ElementProperties, import("@fulate/core").BaseElementOption<any>, Partial<Omit<import("@fulate/core").BaseElementOption<any>, "key" | "children">>>;
-    get overlayTarget(): SelectionOverlayTarget;
-    get editorElements(): readonly Element[];
-    get snapTool(): Snap | undefined;
-    get state(): EditorInteractionState;
-    /** @internal Captures the canonical selection and interaction identities. */
-    captureSelectionIdentity(): SelectionIdentity;
-    /** @internal Makes one concrete clipboard Promise the latest paste intent. */
-    beginPaste(task: Promise<void>): void;
-    /** @internal Tests whether one paste still owns the captured selection intent. */
-    ownsPasteSelection(identity: SelectionIdentity, task: Promise<void>): boolean;
-    /** @internal Releases the latest paste intent after its Promise settles. */
-    finishPaste(task: Promise<void>): void;
-    private get selectState();
-    private installSelectState;
-    private get activeGesture();
-    private set activeGesture(value);
-    private get activePointGesture();
-    private get pointState();
-    private set pointState(value);
-    private get activePointTarget();
-    private set activePointTarget(value);
-    private get contentSession();
-    private set contentSession(value);
-    private get contentHistory();
-    private set contentHistory(value);
-    private get lineSession();
-    private set lineSession(value);
-    private get lineTreeSession();
-    private set lineTreeSession(value);
-    private get rotationPivotState();
-    private installInput;
-    private readonly handleSceneChange;
-    private sceneChangeAffectsSelection;
-    private selectionGeometryIsDirty;
-    private invalidatePointTopology;
-    private resolvePolicy;
-    setSelection(elements: readonly Element[]): void;
-    private readonly pointProjectionOwnerIsCurrent;
-    private restoreSelectionForHistory;
-    private replaceSelection;
-    private requestSelectionEnd;
-    private pointContextIsCurrent;
-    private resolveCurrentPointContext;
-    private resolvePointGestureContext;
-    pointGestureOwnsCurrentContext(gesture: PointGesture): boolean;
-    private setPointState;
-    private exitPointState;
-    private setActivePointTarget;
-    private invalidateOverlay;
-    private shouldShowRotationPivot;
-    private showRotationPivotForCurrentOwner;
-    hasPendingOverlayWork(): boolean;
-    flushOverlayProjection(): void;
-    hasPendingCompletionWork(): boolean;
-    flushCompletionWork(): void;
-    resolveCursor(point: PointView | undefined, contentCursor: string): string;
-    private updateHover;
-    private applyAuthoredBatch;
-    private onPointerDown;
-    private onPointerMove;
-    private onPointerFinish;
-    private onDoubleClick;
-    private onKeyDown;
-    private captureTransformRecords;
-    private startTransform;
-    promoteSelectionPress(gesture: SelectionPressGesture): TransformGesture | null;
-    finishSelectionPress(gesture: SelectionPressGesture): void;
-    finishSelectionGesture(gesture: PointerGesture, selection?: readonly Element[]): void;
-    consumeTransform(gesture: TransformGesture, intent: PointerIntent): void;
-    private startPointGesture;
-    consumePoint(gesture: PointGesture, intent: PointerIntent, first: boolean): void;
-    deletePointTarget(): boolean;
-    nudge(dx: number, dy: number): void;
-    setProperties(patch: SelectedPropertyPatch): void;
-    private prepareTransformCommandFrame;
-    private applyTransformCommand;
-    resize(options?: Readonly<ResizeOptions>): void;
-    flip(direction: FlipDirection): void;
-    previewRotationPivot(owner: Element, point: PointView): void;
-    clearRotationPivotPreview(owner: Element): void;
-    commitRotationPivot(owner: Element, point: PointView): boolean;
-    private resolveRotationPivot;
-    setMarquee(rect: Readonly<Rect> | null): void;
-    finishPointerGesture(gesture: PointerGesture): void;
-    private pointConnectionCandidateIsCurrent;
-    finishPointConnectionGesture(gesture: PointGesture): void;
-    private beginContentEditing;
-    finishContentEditing(discard: boolean): void;
-    startLineDrawing(tool: LineTool): void;
-    private startLineTreeBranchDrawing;
-    private updateLineTreeSourceHover;
-    private confirmLineTreeSource;
-    private beginLineTreeBranchDraft;
-    private updateLineTreePreview;
-    private probeLineTreeTail;
-    private confirmLineTreePoint;
-    private confirmLineTreeBranchDrawing;
-    private updateLinePreview;
-    private probeLineAnchor;
-    private confirmLinePoint;
-    stopLineDrawing(): void;
-    cancelLineDrawing(): void;
-    private confirmLineDrawing;
-    getLineDrawingView(tool: LineTool): LineDrawingSession | {
-        readonly kind: "branch-draw";
-        readonly tool: LineTool;
-        readonly owner: LineTree;
-        readonly source: LineTreeBranchTailSource;
-        readonly tailDecoration: LineDecoration;
-        readonly confirmed: PointView[];
-        tailTarget: ConnectionPortRef | undefined;
-        preview: PointView | null;
-        snap: PortSnapResult | null;
-    };
-    hasLineToolSession(tool: LineTool): boolean;
-    applyCommand(ownerEffects: readonly OwnerPropertyChange[], structureEffects: readonly StructureChange[], scope: HistoryScope | undefined, selectionAfter: readonly Element[], options?: ApplyCommandOptions): void;
-    finishCurrentInteraction(): void;
-    destroy(): void;
-}
-export declare function getEditorInteractionController(root: Root): EditorInteractionController;
-export {};