@excalidraw/excalidraw 0.18.0-864353b → 0.18.0-8fc71066d

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

@@ -3,7 +3,8 @@ 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 { OrderedExcalidrawElement, SceneElementsMap } from "./types";
+import type { ApplyToOptions } from "./delta";
+import type { ExcalidrawElement, OrderedExcalidrawElement, SceneElementsMap } from "./types";
 export declare const CaptureUpdateAction: {
     /**
      * Immediately undoable.
@@ -60,7 +61,7 @@ export declare class Store {
      */
     scheduleMicroAction(params: {
         action: CaptureUpdateActionType;
-        elements: SceneElementsMap | undefined;
+        elements: readonly ExcalidrawElement[] | undefined;
         appState: AppState | ObservedAppState | undefined;
     } | {
         action: typeof CaptureUpdateAction.IMMEDIATELY;
@@ -157,6 +158,10 @@ export declare class 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.
      */
@@ -164,19 +169,19 @@ export declare class StoreDelta {
     /**
      * Parse and load the delta from the remote payload.
      */
-    static load({ id, elements: { added, removed, updated }, }: DTO<StoreDelta>): StoreDelta;
+    static load({ id, elements: { added, removed, updated }, appState: { delta: appStateDelta }, }: DTO<StoreDelta>): StoreDelta;
     /**
      * Inverse store delta, creates new instance of `StoreDelta`.
      */
     static inverse(delta: StoreDelta): StoreDelta;
     /**
-     * Apply latest (remote) changes to the delta, creates new instance of `StoreDelta`.
+     * Apply the delta to the passed elements and appState, does not modify the snapshot.
      */
-    static applyLatestChanges(delta: StoreDelta, elements: SceneElementsMap, modifierOptions: "deleted" | "inserted"): StoreDelta;
+    static applyTo(delta: StoreDelta, elements: SceneElementsMap, appState: AppState, options?: ApplyToOptions): [SceneElementsMap, AppState, boolean];
     /**
-     * Apply the delta to the passed elements and appState, does not modify the snapshot.
+     * Apply latest (remote) changes to the delta, creates new instance of `StoreDelta`.
      */
-    static applyTo(delta: StoreDelta, elements: SceneElementsMap, appState: AppState, prevSnapshot?: StoreSnapshot): [SceneElementsMap, AppState, boolean];
+    static applyLatestChanges(delta: StoreDelta, prevElements: SceneElementsMap, nextElements: SceneElementsMap, modifierOptions?: "deleted" | "inserted"): StoreDelta;
     isEmpty(): boolean;
 }
 /**
@@ -216,7 +221,7 @@ export declare class StoreSnapshot {
     private maybeCreateElementsSnapshot;
     private detectChangedAppState;
     /**
-     * Detect if there any changed elements.
+     * Detect if there are any changed elements.
      */
     private detectChangedElements;
     /**
@@ -224,4 +229,4 @@ export declare class StoreSnapshot {
      */
     private createElementsSnapshot;
 }
-export declare const getObservedAppState: (appState: AppState) => ObservedAppState;
+export declare const getObservedAppState: (appState: AppState | ObservedAppState) => ObservedAppState;

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

@@ -32,9 +32,9 @@ export declare const canResizeFromSides: (device: Device) => boolean;
 export declare const getOmitSidesForDevice: (device: Device) => {};
 export declare const getTransformHandlesFromCoords: ([x1, y1, x2, y2, cx, cy]: [number, number, number, number, number, number], angle: Radians, zoom: Zoom, pointerType: PointerType, omitSides?: {
     s?: boolean | undefined;
-    e?: boolean | undefined;
-    w?: boolean | undefined;
     n?: boolean | undefined;
+    w?: boolean | undefined;
+    e?: boolean | undefined;
     nw?: boolean | undefined;
     ne?: boolean | undefined;
     sw?: boolean | undefined;
@@ -43,9 +43,9 @@ export declare const getTransformHandlesFromCoords: ([x1, y1, x2, y2, cx, cy]: [
 }, margin?: number, spacing?: number) => TransformHandles;
 export declare const getTransformHandles: (element: ExcalidrawElement, zoom: Zoom, elementsMap: ElementsMap, pointerType?: PointerType, omitSides?: {
     s?: boolean | undefined;
-    e?: boolean | undefined;
-    w?: boolean | undefined;
     n?: boolean | undefined;
+    w?: boolean | undefined;
+    e?: boolean | undefined;
     nw?: boolean | undefined;
     ne?: boolean | undefined;
     sw?: boolean | undefined;

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

@@ -17,6 +17,10 @@ export declare const isLinearElement: (element?: ExcalidrawElement | null) => el
 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;

package/dist/types/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

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

@@ -1,21 +1,31 @@
 import { type GlobalPoint } from "@excalidraw/math";
 import type { Curve, LineSegment } from "@excalidraw/math";
-import type { ExcalidrawDiamondElement, ExcalidrawRectanguloidElement } from "./types";
+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.
+ * line segments and curves **unrotated**.
  *
  * @param element Target rectanguloid element
  * @param offset Optional offset to expand the rectanguloid shape
- * @returns Tuple of line segments (0) and curves (1)
+ * @returns Tuple of **unrotated** line segments (0) and curves (1)
  */
 export declare function deconstructRectanguloidElement(element: ExcalidrawRectanguloidElement, offset?: number): [LineSegment<GlobalPoint>[], Curve<GlobalPoint>[]];
 /**
- * Get the building components of a diamond element in the form of
- * line segments and curves as a tuple, in this order.
+ * 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 segments (0) and curves (1)
+ * @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/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;
@@ -39,7 +39,6 @@ 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 | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -87,7 +86,7 @@ export declare const actionAddToLibrary: {
                 name: "imageExport" | "help" | "jsonExport";
             } | {
                 name: "ttd";
-                tab: "text-to-diagram" | "mermaid";
+                tab: "mermaid" | "text-to-diagram";
             } | {
                 name: "commandPalette";
             } | {
@@ -154,8 +153,7 @@ export declare const actionAddToLibrary: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
-            showHyperlinkPopup: false | "info" | "editor";
+            showHyperlinkPopup: false | "editor" | "info";
             selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             snapLines: readonly import("../snapping").SnapLine[];
             originSnapOffset: {
@@ -189,7 +187,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;
@@ -208,7 +206,6 @@ 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 | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -256,7 +253,7 @@ export declare const actionAddToLibrary: {
                 name: "imageExport" | "help" | "jsonExport";
             } | {
                 name: "ttd";
-                tab: "text-to-diagram" | "mermaid";
+                tab: "mermaid" | "text-to-diagram";
             } | {
                 name: "commandPalette";
             } | {
@@ -328,8 +325,7 @@ export declare const actionAddToLibrary: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
-            showHyperlinkPopup: false | "info" | "editor";
+            showHyperlinkPopup: false | "editor" | "info";
             selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             snapLines: readonly import("../snapping").SnapLine[];
             originSnapOffset: {
@@ -363,7 +359,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;
@@ -382,7 +378,6 @@ 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 | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -430,7 +425,7 @@ export declare const actionAddToLibrary: {
                 name: "imageExport" | "help" | "jsonExport";
             } | {
                 name: "ttd";
-                tab: "text-to-diagram" | "mermaid";
+                tab: "mermaid" | "text-to-diagram";
             } | {
                 name: "commandPalette";
             } | {
@@ -502,8 +497,7 @@ export declare const actionAddToLibrary: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
-            showHyperlinkPopup: false | "info" | "editor";
+            showHyperlinkPopup: false | "editor" | "info";
             selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             snapLines: readonly import("../snapping").SnapLine[];
             originSnapOffset: {

package/dist/types/excalidraw/actions/actionAlign.d.ts

@@ -15,10 +15,10 @@ export declare const actionAlignTop: {
         elements: ExcalidrawElement[];
         captureUpdate: "IMMEDIATELY";
     };
-    keyTest: (event: import("react").KeyboardEvent<Element> | KeyboardEvent) => boolean;
+    keyTest: (event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean;
     PanelComponent: ({ elements, appState, updateData, app }: import("./types").PanelComponentProps) => import("react/jsx-runtime").JSX.Element;
 } & {
-    keyTest?: ((event: import("react").KeyboardEvent<Element> | KeyboardEvent) => boolean) | undefined;
+    keyTest?: ((event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean) | undefined;
 };
 export declare const actionAlignBottom: {
     name: "alignBottom";
@@ -33,10 +33,10 @@ export declare const actionAlignBottom: {
         elements: ExcalidrawElement[];
         captureUpdate: "IMMEDIATELY";
     };
-    keyTest: (event: import("react").KeyboardEvent<Element> | KeyboardEvent) => boolean;
+    keyTest: (event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean;
     PanelComponent: ({ elements, appState, updateData, app }: import("./types").PanelComponentProps) => import("react/jsx-runtime").JSX.Element;
 } & {
-    keyTest?: ((event: import("react").KeyboardEvent<Element> | KeyboardEvent) => boolean) | undefined;
+    keyTest?: ((event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean) | undefined;
 };
 export declare const actionAlignLeft: {
     name: "alignLeft";
@@ -51,10 +51,10 @@ export declare const actionAlignLeft: {
         elements: ExcalidrawElement[];
         captureUpdate: "IMMEDIATELY";
     };
-    keyTest: (event: import("react").KeyboardEvent<Element> | KeyboardEvent) => boolean;
+    keyTest: (event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean;
     PanelComponent: ({ elements, appState, updateData, app }: import("./types").PanelComponentProps) => import("react/jsx-runtime").JSX.Element;
 } & {
-    keyTest?: ((event: import("react").KeyboardEvent<Element> | KeyboardEvent) => boolean) | undefined;
+    keyTest?: ((event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean) | undefined;
 };
 export declare const actionAlignRight: {
     name: "alignRight";
@@ -69,10 +69,10 @@ export declare const actionAlignRight: {
         elements: ExcalidrawElement[];
         captureUpdate: "IMMEDIATELY";
     };
-    keyTest: (event: import("react").KeyboardEvent<Element> | KeyboardEvent) => boolean;
+    keyTest: (event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean;
     PanelComponent: ({ elements, appState, updateData, app }: import("./types").PanelComponentProps) => import("react/jsx-runtime").JSX.Element;
 } & {
-    keyTest?: ((event: import("react").KeyboardEvent<Element> | KeyboardEvent) => boolean) | undefined;
+    keyTest?: ((event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean) | undefined;
 };
 export declare const actionAlignVerticallyCentered: {
     name: "alignVerticallyCentered";

package/dist/types/excalidraw/actions/actionBoundText.d.ts

@@ -40,7 +40,7 @@ export declare const actionBindText: {
             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;
@@ -59,7 +59,6 @@ export declare const actionBindText: {
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
             editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
-            editingLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -107,7 +106,7 @@ export declare const actionBindText: {
                 name: "imageExport" | "help" | "jsonExport";
             } | {
                 name: "ttd";
-                tab: "text-to-diagram" | "mermaid";
+                tab: "mermaid" | "text-to-diagram";
             } | {
                 name: "commandPalette";
             } | {
@@ -176,8 +175,7 @@ export declare const actionBindText: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
-            showHyperlinkPopup: false | "info" | "editor";
+            showHyperlinkPopup: false | "editor" | "info";
             selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             snapLines: readonly import("../snapping").SnapLine[];
             originSnapOffset: {
@@ -226,7 +224,7 @@ export declare const actionWrapTextInContainer: {
             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;
@@ -245,7 +243,6 @@ export declare const actionWrapTextInContainer: {
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
             editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
-            editingLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -293,7 +290,7 @@ export declare const actionWrapTextInContainer: {
                 name: "imageExport" | "help" | "jsonExport";
             } | {
                 name: "ttd";
-                tab: "text-to-diagram" | "mermaid";
+                tab: "mermaid" | "text-to-diagram";
             } | {
                 name: "commandPalette";
             } | {
@@ -362,8 +359,7 @@ export declare const actionWrapTextInContainer: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
-            showHyperlinkPopup: false | "info" | "editor";
+            showHyperlinkPopup: false | "editor" | "info";
             selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             snapLines: readonly import("../snapping").SnapLine[];
             originSnapOffset: {