@excalidraw/excalidraw 0.18.0-432a46e → 0.18.0-4e471c107

package/dist/types/element/src/store.d.ts

@@ -0,0 +1,232 @@
+import { Emitter } from "@excalidraw/common";
+import type App from "@excalidraw/excalidraw/components/App";
+import type { DTO, ValueOf } from "@excalidraw/common/utility-types";
+import type { AppState, ObservedAppState } from "@excalidraw/excalidraw/types";
+import { ElementsDelta, AppStateDelta } from "./delta";
+import type { ApplyToOptions } from "./delta";
+import type { ExcalidrawElement, OrderedExcalidrawElement, SceneElementsMap } from "./types";
+export declare const CaptureUpdateAction: {
+    /**
+     * Immediately undoable.
+     *
+     * Use for updates which should be captured.
+     * Should be used for most of the local updates, except ephemerals such as dragging or resizing.
+     *
+     * These updates will _immediately_ make it to the local undo / redo stacks.
+     */
+    readonly IMMEDIATELY: "IMMEDIATELY";
+    /**
+     * Never undoable.
+     *
+     * Use for updates which should never be recorded, such as remote updates
+     * or scene initialization.
+     *
+     * These updates will _never_ make it to the local undo / redo stacks.
+     */
+    readonly NEVER: "NEVER";
+    /**
+     * Eventually undoable.
+     *
+     * Use for updates which should not be captured immediately - likely
+     * exceptions which are part of some async multi-step process. Otherwise, all
+     * such updates would end up being captured with the next
+     * `CaptureUpdateAction.IMMEDIATELY` - triggered either by the next `updateScene`
+     * or internally by the editor.
+     *
+     * These updates will _eventually_ make it to the local undo / redo stacks.
+     */
+    readonly EVENTUALLY: "EVENTUALLY";
+};
+export type CaptureUpdateActionType = ValueOf<typeof CaptureUpdateAction>;
+/**
+ * Store which captures the observed changes and emits them as `StoreIncrement` events.
+ */
+export declare class Store {
+    private readonly app;
+    readonly onDurableIncrementEmitter: Emitter<[DurableIncrement]>;
+    readonly onStoreIncrementEmitter: Emitter<[DurableIncrement | EphemeralIncrement]>;
+    private scheduledMacroActions;
+    private scheduledMicroActions;
+    private _snapshot;
+    get snapshot(): StoreSnapshot;
+    set snapshot(snapshot: StoreSnapshot);
+    constructor(app: App);
+    scheduleAction(action: CaptureUpdateActionType): void;
+    /**
+     * Use to schedule a delta calculation, which will consquentially be emitted as `DurableStoreIncrement` and pushed in the undo stack.
+     */
+    scheduleCapture(): void;
+    /**
+     * Schedule special "micro" actions, to-be executed before the next commit, before it executes a scheduled "macro" action.
+     */
+    scheduleMicroAction(params: {
+        action: CaptureUpdateActionType;
+        elements: readonly ExcalidrawElement[] | undefined;
+        appState: AppState | ObservedAppState | undefined;
+    } | {
+        action: typeof CaptureUpdateAction.IMMEDIATELY;
+        change: StoreChange;
+        delta: StoreDelta;
+    } | {
+        action: typeof CaptureUpdateAction.NEVER | typeof CaptureUpdateAction.EVENTUALLY;
+        change: StoreChange;
+    }): void;
+    /**
+     * Performs the incoming `CaptureUpdateAction` and emits the corresponding `StoreIncrement`.
+     * Emits `DurableStoreIncrement` when action is "capture", emits `EphemeralStoreIncrement` otherwise.
+     *
+     * @emits StoreIncrement
+     */
+    commit(elements: SceneElementsMap | undefined, appState: AppState | ObservedAppState | undefined): void;
+    /**
+     * Clears the store instance.
+     */
+    clear(): void;
+    /**
+     * Performs delta & change calculation and emits a durable increment.
+     *
+     * @emits StoreIncrement.
+     */
+    private emitDurableIncrement;
+    /**
+     * Performs change calculation and emits an ephemeral increment.
+     *
+     * @emits EphemeralStoreIncrement
+     */
+    private emitEphemeralIncrement;
+    private applyChangeToSnapshot;
+    /**
+     * Clones the snapshot if there are changes detected.
+     */
+    private maybeCloneSnapshot;
+    private flushMicroActions;
+    private processAction;
+    /**
+     * Returns the scheduled macro action.
+     */
+    private getScheduledMacroAction;
+    /**
+     * Ensures that the scheduled actions invariant is satisfied.
+     */
+    private satisfiesScheduledActionsInvariant;
+}
+/**
+ * Repsents a change to the store containing changed elements and appState.
+ */
+export declare class StoreChange {
+    readonly elements: Record<string, OrderedExcalidrawElement>;
+    readonly appState: Partial<ObservedAppState>;
+    private constructor();
+    static create(prevSnapshot: StoreSnapshot, nextSnapshot: StoreSnapshot): StoreChange;
+}
+/**
+ * Encpasulates any change to the store (durable or ephemeral).
+ */
+export declare abstract class StoreIncrement {
+    readonly type: "durable" | "ephemeral";
+    readonly change: StoreChange;
+    protected constructor(type: "durable" | "ephemeral", change: StoreChange);
+    static isDurable(increment: StoreIncrement): increment is DurableIncrement;
+    static isEphemeral(increment: StoreIncrement): increment is EphemeralIncrement;
+}
+/**
+ * Represents a durable change to the store.
+ */
+export declare class DurableIncrement extends StoreIncrement {
+    readonly change: StoreChange;
+    readonly delta: StoreDelta;
+    constructor(change: StoreChange, delta: StoreDelta);
+}
+/**
+ * Represents an ephemeral change to the store.
+ */
+export declare class EphemeralIncrement extends StoreIncrement {
+    readonly change: StoreChange;
+    constructor(change: StoreChange);
+}
+/**
+ * Represents a captured delta by the Store.
+ */
+export declare class StoreDelta {
+    readonly id: string;
+    readonly elements: ElementsDelta;
+    readonly appState: AppStateDelta;
+    protected constructor(id: string, elements: ElementsDelta, appState: AppStateDelta);
+    /**
+     * Create a new instance of `StoreDelta`.
+     */
+    static create(elements: ElementsDelta, appState: AppStateDelta, opts?: {
+        id: string;
+    }): StoreDelta;
+    /**
+     * Calculate the delta between the previous and next snapshot.
+     */
+    static calculate(prevSnapshot: StoreSnapshot, nextSnapshot: StoreSnapshot): StoreDelta;
+    /**
+     * Restore a store delta instance from a DTO.
+     */
+    static restore(storeDeltaDTO: DTO<StoreDelta>): StoreDelta;
+    /**
+     * Parse and load the delta from the remote payload.
+     */
+    static load({ id, elements: { added, removed, updated }, }: DTO<StoreDelta>): StoreDelta;
+    /**
+     * Inverse store delta, creates new instance of `StoreDelta`.
+     */
+    static inverse(delta: StoreDelta): StoreDelta;
+    /**
+     * Apply the delta to the passed elements and appState, does not modify the snapshot.
+     */
+    static applyTo(delta: StoreDelta, elements: SceneElementsMap, appState: AppState, options?: ApplyToOptions): [SceneElementsMap, AppState, boolean];
+    /**
+     * Apply latest (remote) changes to the delta, creates new instance of `StoreDelta`.
+     */
+    static applyLatestChanges(delta: StoreDelta, prevElements: SceneElementsMap, nextElements: SceneElementsMap, modifierOptions?: "deleted" | "inserted"): StoreDelta;
+    isEmpty(): boolean;
+}
+/**
+ * Represents a snapshot of the captured or updated changes in the store,
+ * used for producing deltas and emitting `DurableStoreIncrement`s.
+ */
+export declare class StoreSnapshot {
+    readonly elements: SceneElementsMap;
+    readonly appState: ObservedAppState;
+    readonly metadata: {
+        didElementsChange: boolean;
+        didAppStateChange: boolean;
+        isEmpty?: boolean;
+    };
+    private _lastChangedElementsHash;
+    private _lastChangedAppStateHash;
+    private constructor();
+    static create(elements: SceneElementsMap, appState: AppState | ObservedAppState, metadata?: {
+        didElementsChange: boolean;
+        didAppStateChange: boolean;
+    }): StoreSnapshot;
+    static empty(): StoreSnapshot;
+    getChangedElements(prevSnapshot: StoreSnapshot): Record<string, OrderedExcalidrawElement>;
+    getChangedAppState(prevSnapshot: StoreSnapshot): Partial<ObservedAppState>;
+    isEmpty(): boolean | undefined;
+    /**
+     * Apply the change and return a new snapshot instance.
+     */
+    applyChange(change: StoreChange): StoreSnapshot;
+    /**
+     * Efficiently clone the existing snapshot, only if we detected changes.
+     *
+     * @returns same instance if there are no changes detected, new instance otherwise.
+     */
+    maybeClone(action: CaptureUpdateActionType, elements: SceneElementsMap | undefined, appState: AppState | ObservedAppState | undefined): StoreSnapshot;
+    private maybeCreateAppStateSnapshot;
+    private maybeCreateElementsSnapshot;
+    private detectChangedAppState;
+    /**
+     * Detect if there are any changed elements.
+     */
+    private detectChangedElements;
+    /**
+     * Perform structural clone, deep cloning only elements that changed.
+     */
+    private createElementsSnapshot;
+}
+export declare const getObservedAppState: (appState: AppState | ObservedAppState) => ObservedAppState;

package/dist/types/{packages/element → element}/src/textElement.d.ts

@@ -1,9 +1,11 @@
 import type { AppState } from "@excalidraw/excalidraw/types";
 import type { ExtractSetType } from "@excalidraw/common/utility-types";
+import type { Radians } from "@excalidraw/math";
+import type { Scene } from "./Scene";
 import type { MaybeTransformHandleType } from "./transformHandles";
 import type { ElementsMap, ExcalidrawElement, ExcalidrawElementType, ExcalidrawTextContainer, ExcalidrawTextElement, ExcalidrawTextElementWithContainer, NonDeletedExcalidrawElement } from "./types";
-export declare const redrawTextBoundingBox: (textElement: ExcalidrawTextElement, container: ExcalidrawElement | null, elementsMap: ElementsMap, informMutation?: boolean) => void;
-export declare const handleBindTextResize: (container: NonDeletedExcalidrawElement, elementsMap: ElementsMap, transformHandleType: MaybeTransformHandleType, shouldMaintainAspectRatio?: boolean) => void;
+export declare const redrawTextBoundingBox: (textElement: ExcalidrawTextElement, container: ExcalidrawElement | null, scene: Scene) => void;
+export declare const handleBindTextResize: (container: NonDeletedExcalidrawElement, scene: Scene, transformHandleType: MaybeTransformHandleType, shouldMaintainAspectRatio?: boolean) => void;
 export declare const computeBoundTextPosition: (container: ExcalidrawElement, boundTextElement: ExcalidrawTextElementWithContainer, elementsMap: ElementsMap) => {
     x: number;
     y: number;
@@ -19,7 +21,7 @@ export declare const getContainerCoords: (container: NonDeletedExcalidrawElement
     x: number;
     y: number;
 };
-export declare const getTextElementAngle: (textElement: ExcalidrawTextElement, container: ExcalidrawTextContainer | null) => import("../../math/src").Radians;
+export declare const getTextElementAngle: (textElement: ExcalidrawTextElement, container: ExcalidrawTextContainer | null) => 0 | Radians;
 export declare const getBoundTextElementPosition: (container: ExcalidrawElement, boundTextElement: ExcalidrawTextElementWithContainer, elementsMap: ElementsMap) => {
     x: number;
     y: number;

package/dist/types/{packages/element → element}/src/typeChecks.d.ts

@@ -1,7 +1,7 @@
 import type { ElementOrToolType } from "@excalidraw/excalidraw/types";
 import type { MarkNonNullable } from "@excalidraw/common/utility-types";
 import type { Bounds } from "./bounds";
-import type { ExcalidrawElement, ExcalidrawTextElement, ExcalidrawEmbeddableElement, ExcalidrawLinearElement, ExcalidrawBindableElement, ExcalidrawFreeDrawElement, InitializedExcalidrawImageElement, ExcalidrawImageElement, ExcalidrawTextElementWithContainer, ExcalidrawTextContainer, ExcalidrawFrameElement, RoundnessType, ExcalidrawFrameLikeElement, ExcalidrawElementType, ExcalidrawIframeElement, ExcalidrawIframeLikeElement, ExcalidrawMagicFrameElement, ExcalidrawArrowElement, ExcalidrawElbowArrowElement, PointBinding, FixedPointBinding, ExcalidrawFlowchartNodeElement } from "./types";
+import type { ExcalidrawElement, ExcalidrawTextElement, ExcalidrawEmbeddableElement, ExcalidrawLinearElement, ExcalidrawBindableElement, ExcalidrawFreeDrawElement, InitializedExcalidrawImageElement, ExcalidrawImageElement, ExcalidrawTextElementWithContainer, ExcalidrawTextContainer, ExcalidrawFrameElement, RoundnessType, ExcalidrawFrameLikeElement, ExcalidrawElementType, ExcalidrawIframeElement, ExcalidrawIframeLikeElement, ExcalidrawMagicFrameElement, ExcalidrawArrowElement, ExcalidrawElbowArrowElement, ExcalidrawLineElement, PointBinding, FixedPointBinding, ExcalidrawFlowchartNodeElement, ExcalidrawLinearElementSubType } from "./types";
 export declare const isInitializedImageElement: (element: ExcalidrawElement | null) => element is InitializedExcalidrawImageElement;
 export declare const isImageElement: (element: ExcalidrawElement | null) => element is ExcalidrawImageElement;
 export declare const isEmbeddableElement: (element: ExcalidrawElement | null | undefined) => element is ExcalidrawEmbeddableElement;
@@ -14,8 +14,15 @@ export declare const isFrameLikeElement: (element: ExcalidrawElement | null) =>
 export declare const isFreeDrawElement: (element?: ExcalidrawElement | null) => element is ExcalidrawFreeDrawElement;
 export declare const isFreeDrawElementType: (elementType: ExcalidrawElementType) => boolean;
 export declare const isLinearElement: (element?: ExcalidrawElement | null) => element is ExcalidrawLinearElement;
+export declare const isLineElement: (element?: ExcalidrawElement | null) => element is ExcalidrawLineElement;
 export declare const isArrowElement: (element?: ExcalidrawElement | null) => element is ExcalidrawArrowElement;
 export declare const isElbowArrow: (element?: ExcalidrawElement) => element is ExcalidrawElbowArrowElement;
+/**
+ * sharp or curved arrow, but not elbow
+ */
+export declare const isSimpleArrow: (element?: ExcalidrawElement) => element is ExcalidrawArrowElement;
+export declare const isSharpArrow: (element?: ExcalidrawElement) => element is ExcalidrawArrowElement;
+export declare const isCurvedArrow: (element?: ExcalidrawElement) => element is ExcalidrawArrowElement;
 export declare const isLinearElementType: (elementType: ElementOrToolType) => boolean;
 export declare const isBindingElement: (element?: ExcalidrawElement | null, includeLocked?: boolean) => element is ExcalidrawLinearElement;
 export declare const isBindingElementType: (elementType: ElementOrToolType) => boolean;
@@ -27,6 +34,7 @@ export declare const isExcalidrawElement: (element: any) => element is Excalidra
 export declare const isFlowchartNodeElement: (element: ExcalidrawElement) => element is ExcalidrawFlowchartNodeElement;
 export declare const hasBoundTextElement: (element: ExcalidrawElement | null) => element is MarkNonNullable<ExcalidrawBindableElement, "boundElements">;
 export declare const isBoundToContainer: (element: ExcalidrawElement | null) => element is ExcalidrawTextElementWithContainer;
+export declare const isArrowBoundToElement: (element: ExcalidrawArrowElement) => boolean;
 export declare const isUsingAdaptiveRadius: (type: string) => boolean;
 export declare const isUsingProportionalRadius: (type: string) => boolean;
 export declare const canApplyRoundnessTypeToElement: (roundnessType: RoundnessType, element: ExcalidrawElement) => boolean;
@@ -37,3 +45,13 @@ export declare const getDefaultRoundnessTypeForElement: (element: ExcalidrawElem
 } | null;
 export declare const isFixedPointBinding: (binding: PointBinding | FixedPointBinding) => binding is FixedPointBinding;
 export declare const isBounds: (box: unknown) => box is Bounds;
+export declare const getLinearElementSubType: (element: ExcalidrawLinearElement) => ExcalidrawLinearElementSubType;
+/**
+ * Checks if current element points meet all the conditions for polygon=true
+ * (this isn't a element type check, for that use isLineElement).
+ *
+ * If you want to check if points *can* be turned into a polygon, use
+ *  canBecomePolygon(points).
+ */
+export declare const isValidPolygon: (points: ExcalidrawLineElement["points"]) => boolean;
+export declare const canBecomePolygon: (points: ExcalidrawLineElement["points"]) => boolean;

package/dist/types/{packages/element → element}/src/types.d.ts

@@ -151,7 +151,7 @@ export type ExcalidrawFrameLikeElement = ExcalidrawFrameElement | ExcalidrawMagi
  */
 export type ExcalidrawGenericElement = ExcalidrawSelectionElement | ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawEllipseElement;
 export type ExcalidrawFlowchartNodeElement = ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawEllipseElement;
-export type ExcalidrawRectanguloidElement = ExcalidrawRectangleElement | ExcalidrawImageElement | ExcalidrawTextElement | ExcalidrawFreeDrawElement | ExcalidrawIframeLikeElement | ExcalidrawFrameLikeElement | ExcalidrawEmbeddableElement;
+export type ExcalidrawRectanguloidElement = ExcalidrawRectangleElement | ExcalidrawImageElement | ExcalidrawTextElement | ExcalidrawFreeDrawElement | ExcalidrawIframeLikeElement | ExcalidrawFrameLikeElement | ExcalidrawEmbeddableElement | ExcalidrawSelectionElement;
 /**
  * ExcalidrawElement should be JSON serializable and (eventually) contain
  * no computed data. The list of all ExcalidrawElements should be shareable
@@ -205,6 +205,11 @@ export type PointBinding = {
 export type FixedPointBinding = Merge<PointBinding, {
     fixedPoint: FixedPoint;
 }>;
+type Index = number;
+export type PointsPositionUpdates = Map<Index, {
+    point: LocalPoint;
+    isDragging?: boolean;
+}>;
 export type Arrowhead = "arrow" | "bar" | "dot" | "circle" | "circle_outline" | "triangle" | "triangle_outline" | "diamond" | "diamond_outline" | "crowfoot_one" | "crowfoot_many" | "crowfoot_one_or_many";
 export type ExcalidrawLinearElement = _ExcalidrawElementBase & Readonly<{
     type: "line" | "arrow";
@@ -215,10 +220,14 @@ export type ExcalidrawLinearElement = _ExcalidrawElementBase & Readonly<{
     startArrowhead: Arrowhead | null;
     endArrowhead: Arrowhead | null;
 }>;
+export type ExcalidrawLineElement = ExcalidrawLinearElement & Readonly<{
+    type: "line";
+    polygon: boolean;
+}>;
 export type FixedSegment = {
     start: LocalPoint;
     end: LocalPoint;
-    index: number;
+    index: Index;
 };
 export type ExcalidrawArrowElement = ExcalidrawLinearElement & Readonly<{
     type: "arrow";
@@ -279,4 +288,8 @@ export type SceneElementsMap = Map<ExcalidrawElement["id"], Ordered<ExcalidrawEl
  */
 export type NonDeletedSceneElementsMap = Map<ExcalidrawElement["id"], Ordered<NonDeletedExcalidrawElement>> & MakeBrand<"NonDeletedSceneElementsMap">;
 export type ElementsMapOrArray = readonly ExcalidrawElement[] | Readonly<ElementsMap>;
+export type ExcalidrawLinearElementSubType = "line" | "sharpArrow" | "curvedArrow" | "elbowArrow";
+export type ConvertibleGenericTypes = "rectangle" | "diamond" | "ellipse";
+export type ConvertibleLinearTypes = ExcalidrawLinearElementSubType;
+export type ConvertibleTypes = ConvertibleGenericTypes | ConvertibleLinearTypes;
 export {};

package/dist/types/element/src/utils.d.ts

@@ -0,0 +1,31 @@
+import { type GlobalPoint } from "@excalidraw/math";
+import type { Curve, LineSegment } from "@excalidraw/math";
+import type { Zoom } from "@excalidraw/excalidraw/types";
+import type { ExcalidrawDiamondElement, ExcalidrawElement, ExcalidrawFreeDrawElement, ExcalidrawLinearElement, ExcalidrawRectanguloidElement } from "./types";
+/**
+ * Returns the **rotated** components of freedraw, line or arrow elements.
+ *
+ * @param element The linear element to deconstruct
+ * @returns The rotated in components.
+ */
+export declare function deconstructLinearOrFreeDrawElement(element: ExcalidrawLinearElement | ExcalidrawFreeDrawElement): [LineSegment<GlobalPoint>[], Curve<GlobalPoint>[]];
+/**
+ * Get the building components of a rectanguloid element in the form of
+ * line segments and curves **unrotated**.
+ *
+ * @param element Target rectanguloid element
+ * @param offset Optional offset to expand the rectanguloid shape
+ * @returns Tuple of **unrotated** line segments (0) and curves (1)
+ */
+export declare function deconstructRectanguloidElement(element: ExcalidrawRectanguloidElement, offset?: number): [LineSegment<GlobalPoint>[], Curve<GlobalPoint>[]];
+/**
+ * Get the **unrotated** building components of a diamond element
+ * in the form of line segments and curves as a tuple, in this order.
+ *
+ * @param element The element to deconstruct
+ * @param offset An optional offset
+ * @returns Tuple of line **unrotated** segments (0) and curves (1)
+ */
+export declare function deconstructDiamondElement(element: ExcalidrawDiamondElement, offset?: number): [LineSegment<GlobalPoint>[], Curve<GlobalPoint>[]];
+export declare const isPathALoop: (points: ExcalidrawLinearElement["points"], zoomValue?: Zoom["value"]) => boolean;
+export declare const getCornerRadius: (x: number, element: ExcalidrawElement) => number;

package/dist/types/{packages/element → element}/src/zindex.d.ts

@@ -1,5 +1,5 @@
 import type { AppState } from "@excalidraw/excalidraw/types";
-import type Scene from "@excalidraw/excalidraw/scene/Scene";
+import type { Scene } from "./Scene";
 import type { ExcalidrawElement } from "./types";
 export declare const moveOneLeft: (allElements: readonly ExcalidrawElement[], appState: AppState, scene: Scene) => readonly ExcalidrawElement[];
 export declare const moveOneRight: (allElements: readonly ExcalidrawElement[], appState: AppState, scene: Scene) => readonly ExcalidrawElement[];

package/dist/types/{packages/excalidraw → excalidraw}/actions/actionAddToLibrary.d.ts

@@ -20,7 +20,7 @@ export declare const actionAddToLibrary: {
             errorMessage: import("react").ReactNode;
             activeEmbeddable: {
                 element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
-                state: "hover" | "active";
+                state: "active" | "hover";
             } | null;
             newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
             resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
@@ -28,7 +28,7 @@ export declare const actionAddToLibrary: {
             selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
             startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
-            suggestedBindings: import("@excalidraw/element/binding").SuggestedBinding[];
+            suggestedBindings: import("@excalidraw/element").SuggestedBinding[];
             frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
@@ -39,10 +39,11 @@ export declare const actionAddToLibrary: {
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
             editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
-            editingLinearElement: import("@excalidraw/element/linearElementEditor").LinearElementEditor | null;
+            editingLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
+                fromSelection: boolean;
             } & import("../types").ActiveTool;
             penMode: boolean;
             penDetected: boolean;
@@ -76,7 +77,7 @@ export declare const actionAddToLibrary: {
             zoom: Readonly<{
                 value: import("../types").NormalizedZoomValue;
             }>;
-            openMenu: "shape" | "canvas" | null;
+            openMenu: "canvas" | "shape" | null;
             openPopup: "fontFamily" | "canvasBackground" | "elementBackground" | "elementStroke" | null;
             openSidebar: {
                 name: string;
@@ -86,7 +87,7 @@ export declare const actionAddToLibrary: {
                 name: "imageExport" | "help" | "jsonExport";
             } | {
                 name: "ttd";
-                tab: "text-to-diagram" | "mermaid";
+                tab: "mermaid" | "text-to-diagram";
             } | {
                 name: "commandPalette";
             } | {
@@ -153,9 +154,8 @@ export declare const actionAddToLibrary: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "editor" | "info";
-            selectedLinearElement: import("@excalidraw/element/linearElementEditor").LinearElementEditor | null;
+            selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             snapLines: readonly import("../snapping").SnapLine[];
             originSnapOffset: {
                 x: number;
@@ -166,16 +166,14 @@ export declare const actionAddToLibrary: {
             followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
             croppingElementId: string | null;
-            searchMatches: readonly {
-                id: string;
-                focus: boolean;
-                matchedLines: {
-                    offsetX: number;
-                    offsetY: number;
-                    width: number;
-                    height: number;
-                }[];
-            }[];
+            searchMatches: Readonly<{
+                focusedId: string | null;
+                matches: readonly import("../types").SearchMatch[];
+            }> | null;
+            activeLockedId: string | null;
+            lockedMultiSelections: {
+                [groupId: string]: true;
+            };
         };
     } | {
         captureUpdate: "EVENTUALLY";
@@ -190,7 +188,7 @@ export declare const actionAddToLibrary: {
             isLoading: boolean;
             activeEmbeddable: {
                 element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
-                state: "hover" | "active";
+                state: "active" | "hover";
             } | null;
             newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
             resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
@@ -198,7 +196,7 @@ export declare const actionAddToLibrary: {
             selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
             startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
-            suggestedBindings: import("@excalidraw/element/binding").SuggestedBinding[];
+            suggestedBindings: import("@excalidraw/element").SuggestedBinding[];
             frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
@@ -209,10 +207,11 @@ export declare const actionAddToLibrary: {
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
             editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
-            editingLinearElement: import("@excalidraw/element/linearElementEditor").LinearElementEditor | null;
+            editingLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
+                fromSelection: boolean;
             } & import("../types").ActiveTool;
             penMode: boolean;
             penDetected: boolean;
@@ -246,7 +245,7 @@ export declare const actionAddToLibrary: {
             zoom: Readonly<{
                 value: import("../types").NormalizedZoomValue;
             }>;
-            openMenu: "shape" | "canvas" | null;
+            openMenu: "canvas" | "shape" | null;
             openPopup: "fontFamily" | "canvasBackground" | "elementBackground" | "elementStroke" | null;
             openSidebar: {
                 name: string;
@@ -256,7 +255,7 @@ export declare const actionAddToLibrary: {
                 name: "imageExport" | "help" | "jsonExport";
             } | {
                 name: "ttd";
-                tab: "text-to-diagram" | "mermaid";
+                tab: "mermaid" | "text-to-diagram";
             } | {
                 name: "commandPalette";
             } | {
@@ -328,9 +327,8 @@ export declare const actionAddToLibrary: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "editor" | "info";
-            selectedLinearElement: import("@excalidraw/element/linearElementEditor").LinearElementEditor | null;
+            selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             snapLines: readonly import("../snapping").SnapLine[];
             originSnapOffset: {
                 x: number;
@@ -341,16 +339,14 @@ export declare const actionAddToLibrary: {
             followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
             croppingElementId: string | null;
-            searchMatches: readonly {
-                id: string;
-                focus: boolean;
-                matchedLines: {
-                    offsetX: number;
-                    offsetY: number;
-                    width: number;
-                    height: number;
-                }[];
-            }[];
+            searchMatches: Readonly<{
+                focusedId: string | null;
+                matches: readonly import("../types").SearchMatch[];
+            }> | null;
+            activeLockedId: string | null;
+            lockedMultiSelections: {
+                [groupId: string]: true;
+            };
         };
     }> | {
         captureUpdate: "EVENTUALLY";
@@ -365,7 +361,7 @@ export declare const actionAddToLibrary: {
             isLoading: boolean;
             activeEmbeddable: {
                 element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
-                state: "hover" | "active";
+                state: "active" | "hover";
             } | null;
             newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
             resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
@@ -373,7 +369,7 @@ export declare const actionAddToLibrary: {
             selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
             startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
-            suggestedBindings: import("@excalidraw/element/binding").SuggestedBinding[];
+            suggestedBindings: import("@excalidraw/element").SuggestedBinding[];
             frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
@@ -384,10 +380,11 @@ export declare const actionAddToLibrary: {
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
             editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
-            editingLinearElement: import("@excalidraw/element/linearElementEditor").LinearElementEditor | null;
+            editingLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
+                fromSelection: boolean;
             } & import("../types").ActiveTool;
             penMode: boolean;
             penDetected: boolean;
@@ -421,7 +418,7 @@ export declare const actionAddToLibrary: {
             zoom: Readonly<{
                 value: import("../types").NormalizedZoomValue;
             }>;
-            openMenu: "shape" | "canvas" | null;
+            openMenu: "canvas" | "shape" | null;
             openPopup: "fontFamily" | "canvasBackground" | "elementBackground" | "elementStroke" | null;
             openSidebar: {
                 name: string;
@@ -431,7 +428,7 @@ export declare const actionAddToLibrary: {
                 name: "imageExport" | "help" | "jsonExport";
             } | {
                 name: "ttd";
-                tab: "text-to-diagram" | "mermaid";
+                tab: "mermaid" | "text-to-diagram";
             } | {
                 name: "commandPalette";
             } | {
@@ -503,9 +500,8 @@ export declare const actionAddToLibrary: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "editor" | "info";
-            selectedLinearElement: import("@excalidraw/element/linearElementEditor").LinearElementEditor | null;
+            selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             snapLines: readonly import("../snapping").SnapLine[];
             originSnapOffset: {
                 x: number;
@@ -516,16 +512,14 @@ export declare const actionAddToLibrary: {
             followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
             croppingElementId: string | null;
-            searchMatches: readonly {
-                id: string;
-                focus: boolean;
-                matchedLines: {
-                    offsetX: number;
-                    offsetY: number;
-                    width: number;
-                    height: number;
-                }[];
-            }[];
+            searchMatches: Readonly<{
+                focusedId: string | null;
+                matches: readonly import("../types").SearchMatch[];
+            }> | null;
+            activeLockedId: string | null;
+            lockedMultiSelections: {
+                [groupId: string]: true;
+            };
         };
     };
     label: string;