@zsviczian/excalidraw 0.18.0-19 → 0.18.0-20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zsviczian/excalidraw",
-  "version": "0.18.0-19",
+  "version": "0.18.0-20",
   "main": "main.js",
   "module": "./dist/prod/index.js",
   "types": "types/excalidraw/index.d.ts",

package/types/common/src/constants.d.ts

@@ -114,10 +114,19 @@ export declare const FONT_FAMILY: {
     "Liberation Sans": number;
     Assistant: number;
 };
+export declare const SANS_SERIF_GENERIC_FONT = "sans-serif";
+export declare const MONOSPACE_GENERIC_FONT = "monospace";
+export declare const FONT_FAMILY_GENERIC_FALLBACKS: {
+    "sans-serif": number;
+    monospace: number;
+};
 export declare const FONT_FAMILY_FALLBACKS: {
-    Xiaolai: number;
     "Segoe UI Emoji": number;
+    "sans-serif": number;
+    monospace: number;
+    Xiaolai: number;
 };
+export declare function getGenericFontFamilyFallback(fontFamily: number): keyof typeof FONT_FAMILY_GENERIC_FALLBACKS;
 export declare const getFontFamilyFallbacks: (fontFamily: number) => Array<keyof typeof FONT_FAMILY_FALLBACKS>;
 export declare const THEME: {
     readonly LIGHT: "light";

package/types/common/src/utils.d.ts

@@ -1,5 +1,5 @@
 import { type GlobalPoint } from "@excalidraw/math";
-import type { ExcalidrawBindableElement, FontFamilyValues, FontString, ExcalidrawElement } from "@excalidraw/element/types";
+import type { ExcalidrawBindableElement, FontFamilyValues, FontString, ExcalidrawElement, ElementsMap } from "@excalidraw/element/types";
 import type { ActiveTool, AppState, ToolType, UnsubscribeCallback, Zoom } from "@excalidraw/excalidraw/types";
 import type { MaybePromise } from "./utility-types";
 import type { EVENT } from "./constants";
@@ -261,7 +261,7 @@ export declare const safelyParseJSON: (json: string) => Record<string, any> | nu
  */
 export declare const escapeDoubleQuotes: (str: string) => string;
 export declare const castArray: <T>(value: T | T[]) => T[];
-export declare const elementCenterPoint: (element: ExcalidrawElement, xOffset?: number, yOffset?: number) => GlobalPoint;
+export declare const elementCenterPoint: (element: ExcalidrawElement, elementsMap: ElementsMap, xOffset?: number, yOffset?: number) => GlobalPoint;
 /** hack for Array.isArray type guard not working with readonly value[] */
 export declare const isReadonlyArray: (value?: any) => value is readonly any[];
 export declare const sizeOf: (value: readonly unknown[] | Readonly<Map<string, unknown>> | Readonly<Record<string, unknown>> | ReadonlySet<unknown>) => number;

package/types/element/src/Shape.d.ts

@@ -1,8 +1,12 @@
+import { RoughGenerator } from "roughjs/bin/generator";
 import type { EmbedsValidationStatus } from "@excalidraw/excalidraw/types";
-import type { ExcalidrawElement, NonDeletedExcalidrawElement, ExcalidrawSelectionElement } from "./types";
+import type { ExcalidrawElement, NonDeletedExcalidrawElement, ExcalidrawSelectionElement, ExcalidrawLinearElement, ExcalidrawFreeDrawElement, ElementsMap } from "./types";
 import type { Drawable, Options } from "roughjs/bin/core";
-import type { RoughGenerator } from "roughjs/bin/generator";
 export declare const generateRoughOptions: (element: ExcalidrawElement, continuousPath?: boolean) => Options;
+export declare const generateLinearCollisionShape: (element: ExcalidrawLinearElement | ExcalidrawFreeDrawElement, elementsMap: ElementsMap) => {
+    op: string;
+    data: number[];
+}[];
 /**
  * Generates the roughjs shape for given element.
  *

package/types/element/src/binding.d.ts

@@ -16,7 +16,6 @@ export declare const shouldEnableBindingForPointerEvent: (event: React.PointerEv
 export declare const isBindingEnabled: (appState: AppState) => boolean;
 export declare const FIXED_BINDING_DISTANCE = 5;
 export declare const BINDING_HIGHLIGHT_THICKNESS = 10;
-export declare const BINDING_HIGHLIGHT_OFFSET = 4;
 export declare const bindOrUnbindLinearElement: (linearElement: NonDeleted<ExcalidrawLinearElement>, startBindingElement: ExcalidrawBindableElement | null | "keep", endBindingElement: ExcalidrawBindableElement | null | "keep", scene: Scene) => void;
 export declare const bindOrUnbindLinearElements: (selectedElements: NonDeleted<ExcalidrawLinearElement>[], isBindingEnabled: boolean, draggingPoints: readonly number[] | null, scene: Scene, zoom?: AppState["zoom"]) => void;
 export declare const getSuggestedBindingsForArrows: (selectedElements: NonDeleted<ExcalidrawElement>[], elementsMap: NonDeletedSceneElementsMap, zoom: AppState["zoom"]) => SuggestedBinding[];
@@ -46,11 +45,11 @@ export declare const updateBindings: (latestElement: ExcalidrawElement, scene: S
     };
     zoom?: AppState["zoom"];
 }) => void;
-export declare const getHeadingForElbowArrowSnap: (p: Readonly<GlobalPoint>, otherPoint: Readonly<GlobalPoint>, bindableElement: ExcalidrawBindableElement | undefined | null, aabb: Bounds | undefined | null, origPoint: GlobalPoint, zoom?: AppState["zoom"]) => Heading;
-export declare const bindPointToSnapToElementOutline: (arrow: ExcalidrawElbowArrowElement, bindableElement: ExcalidrawBindableElement, startOrEnd: "start" | "end") => GlobalPoint;
-export declare const avoidRectangularCorner: (element: ExcalidrawBindableElement, p: GlobalPoint) => GlobalPoint;
-export declare const snapToMid: (element: ExcalidrawBindableElement, p: GlobalPoint, tolerance?: number) => GlobalPoint;
-export declare const calculateFixedPointForElbowArrowBinding: (linearElement: NonDeleted<ExcalidrawElbowArrowElement>, hoveredElement: ExcalidrawBindableElement, startOrEnd: "start" | "end") => {
+export declare const getHeadingForElbowArrowSnap: (p: Readonly<GlobalPoint>, otherPoint: Readonly<GlobalPoint>, bindableElement: ExcalidrawBindableElement | undefined | null, aabb: Bounds | undefined | null, origPoint: GlobalPoint, elementsMap: ElementsMap, zoom?: AppState["zoom"]) => Heading;
+export declare const bindPointToSnapToElementOutline: (arrow: ExcalidrawElbowArrowElement, bindableElement: ExcalidrawBindableElement, startOrEnd: "start" | "end", elementsMap: ElementsMap) => GlobalPoint;
+export declare const avoidRectangularCorner: (element: ExcalidrawBindableElement, elementsMap: ElementsMap, p: GlobalPoint) => GlobalPoint;
+export declare const snapToMid: (element: ExcalidrawBindableElement, elementsMap: ElementsMap, p: GlobalPoint, tolerance?: number) => GlobalPoint;
+export declare const calculateFixedPointForElbowArrowBinding: (linearElement: NonDeleted<ExcalidrawElbowArrowElement>, hoveredElement: ExcalidrawBindableElement, startOrEnd: "start" | "end", elementsMap: ElementsMap) => {
     fixedPoint: FixedPoint;
 };
 export declare const fixDuplicatedBindingsAfterDuplication: (duplicatedElements: ExcalidrawElement[], origIdToDuplicateId: Map<ExcalidrawElement["id"], ExcalidrawElement["id"]>, duplicateElementsMap: NonDeletedSceneElementsMap) => void;
@@ -60,7 +59,7 @@ export declare const bindingBorderTest: (element: NonDeleted<ExcalidrawBindableE
     y: number;
 }, elementsMap: NonDeletedSceneElementsMap, zoom?: AppState["zoom"], fullShape?: boolean) => boolean;
 export declare const maxBindingGap: (element: ExcalidrawElement, elementWidth: number, elementHeight: number, zoom?: AppState["zoom"]) => number;
-export declare const determineFocusDistance: (element: ExcalidrawBindableElement, a: GlobalPoint, b: GlobalPoint) => number;
+export declare const determineFocusDistance: (element: ExcalidrawBindableElement, elementsMap: ElementsMap, a: GlobalPoint, b: GlobalPoint) => number;
 export declare const bindingProperties: Set<BindableProp | BindingProp>;
 export type BindableProp = "boundElements";
 export type BindingProp = "frameId" | "containerId" | "startBinding" | "endBinding";
@@ -102,7 +101,7 @@ export declare class BindableElement {
      */
     static rebindAffected: (elements: ElementsMap, bindableElement: ExcalidrawElement | undefined, updateElementWith: (affected: ExcalidrawElement, updates: ElementUpdate<ExcalidrawElement>) => void) => void;
 }
-export declare const getGlobalFixedPointForBindableElement: (fixedPointRatio: [number, number], element: ExcalidrawBindableElement) => GlobalPoint;
+export declare const getGlobalFixedPointForBindableElement: (fixedPointRatio: [number, number], element: ExcalidrawBindableElement, elementsMap: ElementsMap) => GlobalPoint;
 export declare const getGlobalFixedPoints: (arrow: ExcalidrawElbowArrowElement, elementsMap: ElementsMap) => [GlobalPoint, GlobalPoint];
 export declare const getArrowLocalFixedPoints: (arrow: ExcalidrawElbowArrowElement, elementsMap: ElementsMap) => LocalPoint[];
 export declare const normalizeFixedPoint: <T extends FixedPoint | null>(fixedPoint: T) => T extends null ? null : FixedPoint;

package/types/element/src/bounds.d.ts

@@ -26,7 +26,8 @@ export type SceneBounds = readonly [
 ];
 export declare class ElementBounds {
     private static boundsCache;
-    static getBounds(element: ExcalidrawElement, elementsMap: ElementsMap): Bounds;
+    private static nonRotatedBoundsCache;
+    static getBounds(element: ExcalidrawElement, elementsMap: ElementsMap, nonRotated?: boolean): Bounds;
     private static calculateBounds;
 }
 export declare const getElementAbsoluteCoords: (element: ExcalidrawElement, elementsMap: ElementsMap, includeBoundText?: boolean) => [number, number, number, number, number, number];
@@ -50,7 +51,7 @@ export declare const getArrowheadSize: (arrowhead: Arrowhead) => number;
 /** @returns number in degrees */
 export declare const getArrowheadAngle: (arrowhead: Arrowhead) => Degrees;
 export declare const getArrowheadPoints: (element: ExcalidrawLinearElement, shape: Drawable[], position: "start" | "end", arrowhead: Arrowhead) => number[] | null;
-export declare const getElementBounds: (element: ExcalidrawElement, elementsMap: ElementsMap) => Bounds;
+export declare const getElementBounds: (element: ExcalidrawElement, elementsMap: ElementsMap, nonRotated?: boolean) => Bounds;
 export declare const getCommonBounds: (elements: ElementsMapOrArray, elementsMap?: ElementsMap) => Bounds;
 export declare const getDraggedElementsBounds: (elements: ExcalidrawElement[], dragOffset: {
     x: number;

package/types/element/src/collision.d.ts

@@ -1,20 +1,18 @@
-import { type GeometricShape } from "@excalidraw/utils/shape";
-import type { GlobalPoint, LineSegment, LocalPoint } from "@excalidraw/math";
+import type { GlobalPoint, LineSegment } from "@excalidraw/math";
 import type { FrameNameBounds } from "@excalidraw/excalidraw/types";
 import type { ElementsMap, ExcalidrawElement } from "./types";
 export declare const shouldTestInside: (element: ExcalidrawElement) => boolean;
-export type HitTestArgs<Point extends GlobalPoint | LocalPoint> = {
-    x: number;
-    y: number;
+export type HitTestArgs = {
+    point: GlobalPoint;
     element: ExcalidrawElement;
-    shape: GeometricShape<Point>;
-    threshold?: number;
+    threshold: number;
+    elementsMap: ElementsMap;
     frameNameBound?: FrameNameBounds | null;
 };
-export declare const hitElementItself: <Point extends GlobalPoint | LocalPoint>({ x, y, element, shape, threshold, frameNameBound, }: HitTestArgs<Point>) => boolean;
-export declare const hitElementBoundingBox: (x: number, y: number, element: ExcalidrawElement, elementsMap: ElementsMap, tolerance?: number) => boolean;
-export declare const hitElementBoundingBoxOnly: <Point extends GlobalPoint | LocalPoint>(hitArgs: HitTestArgs<Point>, elementsMap: ElementsMap) => boolean;
-export declare const hitElementBoundText: <Point extends GlobalPoint | LocalPoint>(x: number, y: number, textShape: GeometricShape<Point> | null) => boolean;
+export declare const hitElementItself: ({ point, element, threshold, elementsMap, frameNameBound, }: HitTestArgs) => boolean;
+export declare const hitElementBoundingBox: (point: GlobalPoint, element: ExcalidrawElement, elementsMap: ElementsMap, tolerance?: number) => boolean;
+export declare const hitElementBoundingBoxOnly: (hitArgs: HitTestArgs, elementsMap: ElementsMap) => boolean;
+export declare const hitElementBoundText: (point: GlobalPoint, element: ExcalidrawElement, elementsMap: ElementsMap) => boolean;
 /**
  * Intersect a line with an element for binding test
  *
@@ -23,4 +21,12 @@ export declare const hitElementBoundText: <Point extends GlobalPoint | LocalPoin
  * @param offset
  * @returns
  */
-export declare const intersectElementWithLineSegment: (element: ExcalidrawElement, line: LineSegment<GlobalPoint>, offset?: number) => GlobalPoint[];
+export declare const intersectElementWithLineSegment: (element: ExcalidrawElement, elementsMap: ElementsMap, line: LineSegment<GlobalPoint>, offset?: number, onlyFirst?: boolean) => GlobalPoint[];
+/**
+ * Check if the given point is considered inside the element's border
+ *
+ * @param point
+ * @param element
+ * @returns
+ */
+export declare const isPointInElement: (point: GlobalPoint, element: ExcalidrawElement, elementsMap: ElementsMap) => boolean;

package/types/element/src/cropElement.d.ts

@@ -1,7 +1,7 @@
 import type { TransformHandleType } from "./transformHandles";
 import type { ElementsMap, ExcalidrawImageElement, ImageCrop } from "./types";
 export declare const MINIMAL_CROP_SIZE = 10;
-export declare const cropElement: (element: ExcalidrawImageElement, transformHandle: TransformHandleType, naturalWidth: number, naturalHeight: number, pointerX: number, pointerY: number, widthAspectRatio?: number) => {
+export declare const cropElement: (element: ExcalidrawImageElement, elementsMap: ElementsMap, transformHandle: TransformHandleType, naturalWidth: number, naturalHeight: number, pointerX: number, pointerY: number, widthAspectRatio?: number) => {
     x: number;
     y: number;
     width: number;

package/types/element/src/delta.d.ts

@@ -1,7 +1,7 @@
 import type { ExcalidrawElement, Ordered, OrderedExcalidrawElement, SceneElementsMap } from "@excalidraw/element/types";
 import type { DTO, ValueOf } from "@excalidraw/common/utility-types";
 import type { AppState, ObservedAppState } from "@excalidraw/excalidraw/types";
-import type { ElementUpdate } from "./mutateElement";
+import { StoreSnapshot } from "./store";
 /**
  * Represents the difference between two objects of the same type.
  *
@@ -15,7 +15,7 @@ export declare class Delta<T> {
     readonly deleted: Partial<T>;
     readonly inserted: Partial<T>;
     private constructor();
-    static create<T>(deleted: Partial<T>, inserted: Partial<T>, modifier?: (delta: Partial<T>) => Partial<T>, modifierOptions?: "deleted" | "inserted"): Delta<T>;
+    static create<T>(deleted: Partial<T>, inserted: Partial<T>, modifier?: (delta: Partial<T>, partialType: "deleted" | "inserted") => Partial<T>, modifierOptions?: "deleted" | "inserted" | "both"): Delta<T>;
     /**
      * Calculates the delta between two objects.
      *
@@ -55,6 +55,14 @@ export declare class Delta<T> {
      * Compares if object2 contains any different value compared to the object1.
      */
     static isRightDifferent<T extends {}>(object1: T, object2: T, skipShallowCompare?: boolean): boolean;
+    /**
+     * Compares if shared properties of object1 and object2 contain any different value (aka inner join).
+     */
+    static isInnerDifferent<T extends {}>(object1: T, object2: T, skipShallowCompare?: boolean): boolean;
+    /**
+     * Compares if any properties of object1 and object2 contain any different value (aka full join).
+     */
+    static isDifferent<T extends {}>(object1: T, object2: T, skipShallowCompare?: boolean): boolean;
     /**
      * Returns sorted object1 keys that have distinct values.
      */
@@ -63,6 +71,14 @@ export declare class Delta<T> {
      * Returns sorted object2 keys that have distinct values.
      */
     static getRightDifferences<T extends {}>(object1: T, object2: T, skipShallowCompare?: boolean): string[];
+    /**
+     * Returns sorted keys of shared object1 and object2 properties that have distinct values (aka inner join).
+     */
+    static getInnerDifferences<T extends {}>(object1: T, object2: T, skipShallowCompare?: boolean): string[];
+    /**
+     * Returns sorted keys that have distinct values between object1 and object2 (aka full join).
+     */
+    static getDifferences<T extends {}>(object1: T, object2: T, skipShallowCompare?: boolean): string[];
     /**
      * Iterator comparing values of object properties based on the passed joining strategy.
      *
@@ -118,7 +134,10 @@ export declare class AppStateDelta implements DeltaContainer<AppState> {
     private static postProcess;
     private static orderAppStateKeys;
 }
-type ElementPartial<T extends ExcalidrawElement = ExcalidrawElement> = Omit<ElementUpdate<Ordered<T>>, "seed">;
+type ElementPartial<TElement extends ExcalidrawElement = ExcalidrawElement> = Omit<Partial<Ordered<TElement>>, "id" | "updated" | "seed">;
+export type ApplyToOptions = {
+    excludedProperties: Set<keyof ElementPartial>;
+};
 /**
  * Elements change is a low level primitive to capture a change between two sets of elements.
  * It does so by encapsulating forward and backward `Delta`s, allowing to time-travel in both directions.
@@ -135,6 +154,7 @@ export declare class ElementsDelta implements DeltaContainer<SceneElementsMap> {
     private static satisfiesAddition;
     private static satisfiesRemoval;
     private static satisfiesUpdate;
+    private static satisfiesCommmonInvariants;
     private static validate;
     /**
      * Calculates the `Delta`s between the previous and next set of elements.
@@ -151,12 +171,12 @@ export declare class ElementsDelta implements DeltaContainer<SceneElementsMap> {
     /**
      * Update delta/s based on the existing elements.
      *
-     * @param elements current elements
+     * @param nextElements current elements
      * @param modifierOptions defines which of the delta (`deleted` or `inserted`) will be updated
      * @returns new instance with modified delta/s
      */
-    applyLatestChanges(elements: SceneElementsMap, modifierOptions: "deleted" | "inserted"): ElementsDelta;
-    applyTo(elements: SceneElementsMap, elementsSnapshot: Map<string, OrderedExcalidrawElement>): [SceneElementsMap, boolean];
+    applyLatestChanges(prevElements: SceneElementsMap, nextElements: SceneElementsMap, modifierOptions?: "deleted" | "inserted"): ElementsDelta;
+    applyTo(elements: SceneElementsMap, snapshot?: StoreSnapshot["elements"], options?: ApplyToOptions): [SceneElementsMap, boolean];
     private static createApplier;
     private static createGetter;
     private static applyDelta;

package/types/element/src/distance.d.ts

@@ -1,3 +1,3 @@
 import type { GlobalPoint } from "@excalidraw/math";
-import type { ExcalidrawBindableElement } from "./types";
-export declare const distanceToBindableElement: (element: ExcalidrawBindableElement, p: GlobalPoint) => number;
+import type { ElementsMap, ExcalidrawElement } from "./types";
+export declare const distanceToElement: (element: ExcalidrawElement, elementsMap: ElementsMap, p: GlobalPoint) => number;

package/types/element/src/fractionalIndex.d.ts

@@ -1,4 +1,4 @@
-import type { ElementsMap, ExcalidrawElement, OrderedExcalidrawElement } from "./types";
+import type { ElementsMap, ExcalidrawElement, OrderedExcalidrawElement, SceneElementsMap } from "./types";
 export declare class InvalidFractionalIndexError extends Error {
     code: "ELEMENT_HAS_INVALID_INDEX";
 }
@@ -44,8 +44,14 @@ export declare const orderByFractionalIndex: (elements: OrderedExcalidrawElement
  */
 export declare const syncMovedIndices: (elements: readonly ExcalidrawElement[], movedElements: ElementsMap) => OrderedExcalidrawElement[];
 /**
- * Synchronizes all invalid fractional indices with the array order by mutating passed elements.
+ * Synchronizes all invalid fractional indices within the array order by mutating elements in the passed array.
  *
  * WARN: in edge cases it could modify the elements which were not moved, as it's impossible to guess the actually moved elements from the elements array itself.
  */
 export declare const syncInvalidIndices: (elements: readonly ExcalidrawElement[]) => OrderedExcalidrawElement[];
+/**
+ * Synchronizes all invalid fractional indices within the array order by creating new instances of elements with corrected indices.
+ *
+ * WARN: in edge cases it could modify the elements which were not moved, as it's impossible to guess the actually moved elements from the elements array itself.
+ */
+export declare const syncInvalidIndicesImmutable: (elements: readonly ExcalidrawElement[]) => SceneElementsMap | undefined;

package/types/element/src/linearElementEditor.d.ts

@@ -37,6 +37,7 @@ export declare class LinearElementEditor {
     readonly hoverPointIndex: number;
     readonly segmentMidPointHoveredCoords: GlobalPoint | null;
     readonly elbowed: boolean;
+    readonly customLineAngle: number | null;
     constructor(element: NonDeleted<ExcalidrawLinearElement>, elementsMap: ElementsMap);
     static POINT_HANDLE_SIZE: number;
     /**

package/types/element/src/mutateElement.d.ts

@@ -1,6 +1,6 @@
 import type { Mutable } from "@excalidraw/common/utility-types";
 import type { ElementsMap, ExcalidrawElement } from "./types";
-export type ElementUpdate<TElement extends ExcalidrawElement> = Omit<Partial<TElement>, "id" | "version" | "versionNonce" | "updated">;
+export type ElementUpdate<TElement extends ExcalidrawElement> = Omit<Partial<TElement>, "id" | "updated">;
 /**
  * This function tracks updates of text elements for the purposes for collaboration.
  * The version is used to compare updates when more than one user is working in

package/types/element/src/shapes.d.ts

@@ -16,7 +16,7 @@ export declare const mapIntervalToBezierT: <P extends GlobalPoint | LocalPoint>(
 /**
  * Get the axis-aligned bounding box for a given element
  */
-export declare const aabbForElement: (element: Readonly<ExcalidrawElement>, offset?: [number, number, number, number]) => Bounds;
+export declare const aabbForElement: (element: Readonly<ExcalidrawElement>, elementsMap: ElementsMap, offset?: [number, number, number, number]) => Bounds;
 export declare const pointInsideBounds: <P extends GlobalPoint | LocalPoint>(p: P, bounds: Bounds) => boolean;
 export declare const aabbsOverlapping: (a: Bounds, b: Bounds) => boolean;
 export declare const getCornerRadius: (x: number, element: ExcalidrawElement) => number;

package/types/element/src/sizeHelpers.d.ts

@@ -23,7 +23,7 @@ export declare const getPerfectElementSize: (elementType: AppState["activeTool"]
     width: number;
     height: number;
 };
-export declare const getLockedLinearCursorAlignSize: (originX: number, originY: number, x: number, y: number) => {
+export declare const getLockedLinearCursorAlignSize: (originX: number, originY: number, x: number, y: number, customAngle?: number) => {
     width: number;
     height: number;
 };

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

@@ -3,7 +3,7 @@ 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 { ExcalidrawElement, OrderedExcalidrawElement, SceneElementsMap } from "./types";
 export declare const CaptureUpdateAction: {
     /**
      * Immediately undoable.
@@ -60,7 +60,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 +157,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.
      */
@@ -170,13 +174,13 @@ export declare class 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): [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;
 }
 /**
@@ -224,4 +228,4 @@ export declare class StoreSnapshot {
      */
     private createElementsSnapshot;
 }
-export declare const getObservedAppState: (appState: AppState) => ObservedAppState;
+export declare const getObservedAppState: (appState: AppState | ObservedAppState) => ObservedAppState;

package/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/types/element/src/types.d.ts

@@ -153,7 +153,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/types/element/src/utils.d.ts

@@ -1,6 +1,7 @@
 import { type GlobalPoint } from "@excalidraw/math";
 import type { Curve, LineSegment } from "@excalidraw/math";
-import type { ExcalidrawDiamondElement, ExcalidrawRectanguloidElement } from "./types";
+import type { ElementsMap, ExcalidrawDiamondElement, ExcalidrawFreeDrawElement, ExcalidrawLinearElement, ExcalidrawRectanguloidElement } from "./types";
+export declare function deconstructLinearOrFreeDrawElement(element: ExcalidrawLinearElement | ExcalidrawFreeDrawElement, elementsMap: ElementsMap): [LineSegment<GlobalPoint>[], Curve<GlobalPoint>[]];
 /**
  * Get the building components of a rectanguloid element in the form of
  * line segments and curves.

package/types/excalidraw/actions/actionAddToLibrary.d.ts

@@ -153,7 +153,6 @@ export declare const actionAddToLibrary: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -363,7 +362,6 @@ export declare const actionAddToLibrary: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -573,7 +571,6 @@ export declare const actionAddToLibrary: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;

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

@@ -175,7 +175,6 @@ export declare const actionBindText: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -397,7 +396,6 @@ export declare const actionWrapTextInContainer: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;

package/types/excalidraw/actions/actionCanvas.d.ts

@@ -186,7 +186,6 @@ export declare const actionClearCanvas: {
                 isMuted?: boolean | undefined;
             }>>;
             currentChartType: import("@excalidraw/element/types").ChartType;
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             currentStrokeOptions?: any;
@@ -394,7 +393,6 @@ export declare const actionZoomIn: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -618,7 +616,6 @@ export declare const actionZoomOut: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -842,7 +839,6 @@ export declare const actionResetZoom: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -1072,7 +1068,6 @@ export declare const zoomToFitBounds: ({ bounds, appState, canvasOffsets, fitToV
             shown: true;
             data: import("../charts").Spreadsheet;
         };
-        pendingImageElementId: string | null;
         showHyperlinkPopup: false | "info" | "editor";
         linkOpacity: number;
         trayModeEnabled: boolean;
@@ -1298,7 +1293,6 @@ export declare const zoomToFit: ({ canvasOffsets, targetElements, appState, fitT
             shown: true;
             data: import("../charts").Spreadsheet;
         };
-        pendingImageElementId: string | null;
         showHyperlinkPopup: false | "info" | "editor";
         linkOpacity: number;
         trayModeEnabled: boolean;
@@ -1516,7 +1510,6 @@ export declare const actionZoomToFitSelectionInViewport: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -1738,7 +1731,6 @@ export declare const actionZoomToFitSelection: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -1961,7 +1953,6 @@ export declare const actionZoomToFit: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -2185,7 +2176,6 @@ export declare const actionToggleTheme: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -2400,7 +2390,6 @@ export declare const actionToggleEraserTool: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -2615,7 +2604,6 @@ export declare const actionToggleLassoTool: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -2830,7 +2818,6 @@ export declare const actionToggleHandTool: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -3044,7 +3031,6 @@ export declare const actionToggleLaserPointer: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -3261,7 +3247,6 @@ export declare const zoomToFitElements: (elements: readonly ExcalidrawElement[],
             shown: true;
             data: import("../charts").Spreadsheet;
         };
-        pendingImageElementId: string | null;
         showHyperlinkPopup: false | "info" | "editor";
         linkOpacity: number;
         trayModeEnabled: boolean;

package/types/excalidraw/actions/actionClipboard.d.ts

@@ -157,7 +157,6 @@ export declare const actionCopy: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -381,7 +380,6 @@ export declare const actionPaste: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -606,7 +604,6 @@ export declare const actionCut: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -698,6 +695,7 @@ export declare const actionCut: {
                 hoverPointIndex: number;
                 segmentMidPointHoveredCoords: import("@excalidraw/math").GlobalPoint | null;
                 elbowed: boolean;
+                customLineAngle: number | null;
             };
             contextMenu: {
                 items: import("../components/ContextMenu").ContextMenuItems;
@@ -847,7 +845,6 @@ export declare const actionCut: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -1056,7 +1053,6 @@ export declare const actionCut: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;
@@ -1310,7 +1306,6 @@ export declare const actionCopyAsPng: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            pendingImageElementId: string | null;
             showHyperlinkPopup: false | "info" | "editor";
             linkOpacity: number;
             trayModeEnabled: boolean;