@excalidraw/excalidraw 0.18.0-817d8c5 → 0.18.0-8608d7b

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

@@ -1,7 +1,7 @@
-import type React from "react";
-import type { ExcalidrawElement, OrderedExcalidrawElement } from "../element/types";
+import type { ExcalidrawElement, OrderedExcalidrawElement } from "@excalidraw/element/types";
+import type { CaptureUpdateActionType } from "@excalidraw/element";
 import type { AppClassProperties, AppState, ExcalidrawProps, BinaryFiles, UIAppState } from "../types";
-import type { CaptureUpdateActionType } from "../store";
+import type React from "react";
 export type ActionSource = "ui" | "keyboard" | "contextMenu" | "api" | "commandPalette";
 /** if false, the action should be prevented */
 export type ActionResult = {
@@ -14,7 +14,7 @@ export type ActionResult = {
 type ActionFn = (elements: readonly OrderedExcalidrawElement[], appState: Readonly<AppState>, formData: any, app: AppClassProperties) => ActionResult | Promise<ActionResult>;
 export type UpdaterFn = (res: ActionResult) => void;
 export type ActionFilterFn = (action: Action) => void;
-export type ActionName = "copy" | "cut" | "paste" | "copyAsPng" | "copyAsSvg" | "copyText" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyStyles" | "selectAll" | "pasteStyles" | "gridMode" | "zenMode" | "objectsSnapMode" | "stats" | "changeStrokeColor" | "changeBackgroundColor" | "changeFillStyle" | "changeStrokeWidth" | "changeStrokeShape" | "changeSloppiness" | "changeStrokeStyle" | "changeArrowhead" | "changeArrowType" | "changeOpacity" | "changeFontSize" | "toggleCanvasMenu" | "toggleEditMenu" | "undo" | "redo" | "finalize" | "changeProjectName" | "changeExportBackground" | "changeExportEmbedScene" | "changeExportScale" | "saveToActiveFile" | "saveFileToDisk" | "loadScene" | "duplicateSelection" | "deleteSelectedElements" | "changeViewBackgroundColor" | "clearCanvas" | "zoomIn" | "zoomOut" | "resetZoom" | "zoomToFit" | "zoomToFitSelection" | "zoomToFitSelectionInViewport" | "changeFontFamily" | "changeTextAlign" | "changeVerticalAlign" | "toggleFullScreen" | "toggleShortcuts" | "group" | "ungroup" | "goToCollaborator" | "addToLibrary" | "changeRoundness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "viewMode" | "exportWithDarkMode" | "toggleTheme" | "increaseFontSize" | "decreaseFontSize" | "unbindText" | "hyperlink" | "bindText" | "unlockAllElements" | "toggleElementLock" | "toggleLinearEditor" | "toggleEraserTool" | "toggleHandTool" | "selectAllElementsInFrame" | "removeAllElementsFromFrame" | "updateFrameRendering" | "setFrameAsActiveTool" | "setEmbeddableAsActiveTool" | "createContainerFromText" | "wrapTextInContainer" | "commandPalette" | "autoResize" | "elementStats" | "searchMenu" | "copyElementLink" | "linkToElement" | "cropEditor" | "wrapSelectionInFrame";
+export type ActionName = "copy" | "cut" | "paste" | "copyAsPng" | "copyAsSvg" | "copyText" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyStyles" | "selectAll" | "pasteStyles" | "gridMode" | "zenMode" | "objectsSnapMode" | "stats" | "changeStrokeColor" | "changeBackgroundColor" | "changeFillStyle" | "changeStrokeWidth" | "changeStrokeShape" | "changeSloppiness" | "changeStrokeStyle" | "changeArrowhead" | "changeArrowType" | "changeArrowProperties" | "changeOpacity" | "changeFontSize" | "toggleCanvasMenu" | "toggleEditMenu" | "undo" | "redo" | "finalize" | "changeProjectName" | "changeExportBackground" | "changeExportEmbedScene" | "changeExportScale" | "saveToActiveFile" | "saveFileToDisk" | "loadScene" | "duplicateSelection" | "deleteSelectedElements" | "changeViewBackgroundColor" | "clearCanvas" | "zoomIn" | "zoomOut" | "resetZoom" | "zoomToFit" | "zoomToFitSelection" | "zoomToFitSelectionInViewport" | "changeFontFamily" | "changeTextAlign" | "changeVerticalAlign" | "toggleFullScreen" | "toggleShortcuts" | "group" | "ungroup" | "goToCollaborator" | "addToLibrary" | "changeRoundness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "viewMode" | "exportWithDarkMode" | "toggleTheme" | "increaseFontSize" | "decreaseFontSize" | "unbindText" | "hyperlink" | "bindText" | "unlockAllElements" | "toggleElementLock" | "toggleLinearEditor" | "toggleEraserTool" | "toggleHandTool" | "selectAllElementsInFrame" | "removeAllElementsFromFrame" | "updateFrameRendering" | "setFrameAsActiveTool" | "setEmbeddableAsActiveTool" | "createContainerFromText" | "wrapTextInContainer" | "commandPalette" | "autoResize" | "elementStats" | "searchMenu" | "copyElementLink" | "linkToElement" | "cropEditor" | "wrapSelectionInFrame" | "toggleLassoTool" | "toggleShapeSwitch" | "togglePolygon";
 export type PanelComponentProps = {
     elements: readonly ExcalidrawElement[];
     appState: AppState;
@@ -22,6 +22,7 @@ export type PanelComponentProps = {
     appProps: ExcalidrawProps;
     data?: Record<string, any>;
     app: AppClassProperties;
+    renderAction: (name: ActionName, data?: PanelComponentProps["data"]) => React.JSX.Element | null;
 };
 export interface Action {
     name: ActionName;
@@ -35,7 +36,7 @@ export interface Action {
     predicate?: (elements: readonly ExcalidrawElement[], appState: AppState, appProps: ExcalidrawProps, app: AppClassProperties) => boolean;
     checked?: (appState: Readonly<AppState>) => boolean;
     trackEvent: false | {
-        category: "toolbar" | "element" | "canvas" | "export" | "history" | "menu" | "collab" | "hyperlink" | "search_menu";
+        category: "toolbar" | "element" | "canvas" | "export" | "history" | "menu" | "collab" | "hyperlink" | "search_menu" | "shape_switch";
         action?: string;
         predicate?: (appState: Readonly<AppState>, elements: readonly ExcalidrawElement[], value: any) => boolean;
     };

package/dist/types/excalidraw/animated-trail.d.ts

@@ -1,3 +1,4 @@
+import { LaserPointer } from "@excalidraw/laser-pointer";
 import type { LaserPointerOptions } from "@excalidraw/laser-pointer";
 import type { AnimationFrameHandler } from "./animation-frame-handler";
 import type App from "./components/App";
@@ -10,15 +11,18 @@ export interface Trail {
 }
 export interface AnimatedTrailOptions {
     fill: (trail: AnimatedTrail) => string;
+    stroke?: (trail: AnimatedTrail) => string;
+    animateTrail?: boolean;
 }
 export declare class AnimatedTrail implements Trail {
     private animationFrameHandler;
-    private app;
+    protected app: App;
     private options;
     private currentTrail?;
     private pastTrails;
     private container?;
     private trailElement;
+    private trailAnimation?;
     constructor(animationFrameHandler: AnimationFrameHandler, app: App, options: Partial<LaserPointerOptions> & Partial<AnimatedTrailOptions>);
     get hasCurrentTrail(): boolean;
     hasLastPoint(x: number, y: number): boolean;
@@ -27,6 +31,8 @@ export declare class AnimatedTrail implements Trail {
     startPath(x: number, y: number): void;
     addPointToPath(x: number, y: number): void;
     endPath(): void;
+    getCurrentTrail(): LaserPointer | undefined;
+    clearTrails(): void;
     private update;
     private onFrame;
     private drawTrail;

package/dist/types/excalidraw/appState.d.ts

@@ -1,17 +1,33 @@
 import type { AppState, NormalizedZoomValue } from "./types";
 export declare const getDefaultAppState: () => Omit<AppState, "offsetTop" | "offsetLeft" | "width" | "height">;
 export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>) => {
-    zenModeEnabled?: boolean | undefined;
-    gridModeEnabled?: boolean | undefined;
-    objectsSnapModeEnabled?: boolean | undefined;
-    theme?: import("./element/types").Theme | undefined;
+    viewBackgroundColor?: string | undefined;
     name?: string | null | undefined;
-    currentItemArrowType?: "round" | "sharp" | "elbow" | undefined;
+    zoom?: Readonly<{
+        value: NormalizedZoomValue;
+    }> | undefined;
+    scrollX?: number | undefined;
+    scrollY?: number | undefined;
+    editingGroupId?: string | null | undefined;
+    selectedElementIds?: Readonly<{
+        [id: string]: true;
+    }> | undefined;
+    theme?: import("@excalidraw/element/types").Theme | undefined;
+    selectedGroupIds?: {
+        [groupId: string]: boolean;
+    } | undefined;
+    selectedLinearElement?: import("@excalidraw/element").LinearElementEditor | null | undefined;
+    zenModeEnabled?: boolean | undefined;
     showWelcomeScreen?: boolean | undefined;
     activeTool?: ({
         lastActiveTool: import("./types").ActiveTool | null;
         locked: boolean;
+        fromSelection: boolean;
     } & import("./types").ActiveTool) | undefined;
+    preferredSelectionTool?: {
+        type: "selection" | "lasso";
+        initialized: boolean;
+    } | undefined;
     penMode?: boolean | undefined;
     penDetected?: boolean | undefined;
     exportBackground?: boolean | undefined;
@@ -20,63 +36,61 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     exportScale?: number | undefined;
     currentItemStrokeColor?: string | undefined;
     currentItemBackgroundColor?: string | undefined;
-    currentItemFillStyle?: import("./element/types").FillStyle | undefined;
+    currentItemFillStyle?: import("@excalidraw/element/types").FillStyle | undefined;
     currentItemStrokeWidth?: number | undefined;
-    currentItemStrokeStyle?: import("./element/types").StrokeStyle | undefined;
+    currentItemStrokeStyle?: import("@excalidraw/element/types").StrokeStyle | undefined;
     currentItemRoughness?: number | undefined;
     currentItemOpacity?: number | undefined;
     currentItemFontFamily?: number | undefined;
     currentItemFontSize?: number | undefined;
     currentItemTextAlign?: string | undefined;
-    currentItemStartArrowhead?: import("./element/types").Arrowhead | null | undefined;
-    currentItemEndArrowhead?: import("./element/types").Arrowhead | null | undefined;
-    currentItemRoundness?: import("./element/types").StrokeRoundness | undefined;
-    viewBackgroundColor?: string | undefined;
-    scrollX?: number | undefined;
-    scrollY?: number | undefined;
+    currentItemStartArrowhead?: import("@excalidraw/element/types").Arrowhead | null | undefined;
+    currentItemEndArrowhead?: import("@excalidraw/element/types").Arrowhead | null | undefined;
+    currentItemRoundness?: import("@excalidraw/element/types").StrokeRoundness | undefined;
+    currentItemArrowType?: "round" | "sharp" | "elbow" | undefined;
     cursorButton?: "up" | "down" | undefined;
     scrolledOutside?: boolean | undefined;
-    zoom?: Readonly<{
-        value: NormalizedZoomValue;
-    }> | undefined;
     openMenu?: "canvas" | "shape" | null | undefined;
     openSidebar?: {
         name: string;
         tab?: string | undefined;
     } | null | undefined;
     defaultSidebarDockedPreference?: boolean | undefined;
-    lastPointerDownWith?: import("./element/types").PointerType | undefined;
-    selectedElementIds?: Readonly<{
-        [id: string]: true;
-    }> | undefined;
+    lastPointerDownWith?: import("@excalidraw/element/types").PointerType | undefined;
     previousSelectedElementIds?: {
         [id: string]: true;
     } | undefined;
     shouldCacheIgnoreZoom?: boolean | undefined;
     gridSize?: number | undefined;
     gridStep?: number | undefined;
-    selectedGroupIds?: {
-        [groupId: string]: boolean;
-    } | undefined;
-    editingGroupId?: string | null | undefined;
+    gridModeEnabled?: boolean | undefined;
     stats?: {
         open: boolean;
         panels: number;
     } | undefined;
-    currentChartType?: import("./element/types").ChartType | undefined;
-    selectedLinearElement?: import("./element/linearElementEditor").LinearElementEditor | null | undefined;
+    currentChartType?: import("@excalidraw/element/types").ChartType | undefined;
+    objectsSnapModeEnabled?: boolean | undefined;
+    lockedMultiSelections?: {
+        [groupId: string]: true;
+    } | undefined;
 };
 export declare const cleanAppStateForExport: (appState: Partial<AppState>) => {
-    gridModeEnabled?: boolean | undefined;
     viewBackgroundColor?: string | undefined;
     gridSize?: number | undefined;
     gridStep?: number | undefined;
+    gridModeEnabled?: boolean | undefined;
+    lockedMultiSelections?: {
+        [groupId: string]: true;
+    } | undefined;
 };
 export declare const clearAppStateForDatabase: (appState: Partial<AppState>) => {
-    gridModeEnabled?: boolean | undefined;
     viewBackgroundColor?: string | undefined;
     gridSize?: number | undefined;
     gridStep?: number | undefined;
+    gridModeEnabled?: boolean | undefined;
+    lockedMultiSelections?: {
+        [groupId: string]: true;
+    } | undefined;
 };
 export declare const isEraserActive: ({ activeTool, }: {
     activeTool: AppState["activeTool"];

package/dist/types/excalidraw/charts.d.ts

@@ -1,4 +1,4 @@
-import type { NonDeletedExcalidrawElement } from "./element/types";
+import type { NonDeletedExcalidrawElement } from "@excalidraw/element/types";
 export type ChartElements = readonly NonDeletedExcalidrawElement[];
 export interface Spreadsheet {
     title: string | null;

package/dist/types/excalidraw/clipboard.d.ts

@@ -1,7 +1,10 @@
-import type { ExcalidrawElement, NonDeletedExcalidrawElement } from "./element/types";
-import type { BinaryFiles } from "./types";
+import { ALLOWED_PASTE_MIME_TYPES } from "@excalidraw/common";
+import type { ValueOf } from "@excalidraw/common/utility-types";
+import type { IMAGE_MIME_TYPES, STRING_MIME_TYPES } from "@excalidraw/common";
+import type { ExcalidrawElement, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
+import type { FileSystemHandle } from "./data/filesystem";
 import type { Spreadsheet } from "./charts";
-import { ALLOWED_PASTE_MIME_TYPES } from "./constants";
+import type { BinaryFiles } from "./types";
 export type PastedMixedContent = {
     type: "text" | "imageUrl";
     value: string;
@@ -21,6 +24,8 @@ export declare const probablySupportsClipboardWriteText: boolean;
 export declare const probablySupportsClipboardBlob: boolean;
 export declare const createPasteEvent: ({ types, files, }: {
     types?: {
+        "text/plain"?: string | File | undefined;
+        "text/html"?: string | File | undefined;
         "image/svg+xml"?: string | File | undefined;
         "image/png"?: string | File | undefined;
         "image/jpeg"?: string | File | undefined;
@@ -30,8 +35,6 @@ export declare const createPasteEvent: ({ types, files, }: {
         "image/x-icon"?: string | File | undefined;
         "image/avif"?: string | File | undefined;
         "image/jfif"?: string | File | undefined;
-        "text/plain"?: string | File | undefined;
-        "text/html"?: string | File | undefined;
     } | undefined;
     files?: File[] | undefined;
 }) => ClipboardEvent;
@@ -45,6 +48,8 @@ export declare const copyToClipboard: (elements: readonly NonDeletedExcalidrawEl
  * Will prompt user for permission if not granted.
  */
 export declare const readSystemClipboard: () => Promise<{
+    "text/plain"?: string | File | undefined;
+    "text/html"?: string | File | undefined;
     "image/svg+xml"?: string | File | undefined;
     "image/png"?: string | File | undefined;
     "image/jpeg"?: string | File | undefined;
@@ -54,13 +59,71 @@ export declare const readSystemClipboard: () => Promise<{
     "image/x-icon"?: string | File | undefined;
     "image/avif"?: string | File | undefined;
     "image/jfif"?: string | File | undefined;
-    "text/plain"?: string | File | undefined;
-    "text/html"?: string | File | undefined;
 }>;
+type AllowedParsedDataTransferItem = {
+    type: ValueOf<typeof IMAGE_MIME_TYPES>;
+    kind: "file";
+    file: File;
+    fileHandle: FileSystemHandle | null;
+} | {
+    type: ValueOf<typeof STRING_MIME_TYPES>;
+    kind: "string";
+    value: string;
+};
+type ParsedDataTransferItem = {
+    type: string;
+    kind: "file";
+    file: File;
+    fileHandle: FileSystemHandle | null;
+} | {
+    type: string;
+    kind: "string";
+    value: string;
+};
+type ParsedDataTransferItemType<T extends AllowedParsedDataTransferItem["type"]> = AllowedParsedDataTransferItem & {
+    type: T;
+};
+export type ParsedDataTransferFile = Extract<AllowedParsedDataTransferItem, {
+    kind: "file";
+}>;
+type ParsedDataTranferList = ParsedDataTransferItem[] & {
+    /**
+     * Only allows filtering by known `string` data types, since `file`
+     * types can have multiple items of the same type (e.g. multiple image files)
+     * unlike `string` data transfer items.
+     */
+    findByType: typeof findDataTransferItemType;
+    /**
+     * Only allows filtering by known `string` data types, since `file`
+     * types can have multiple items of the same type (e.g. multiple image files)
+     * unlike `string` data transfer items.
+     */
+    getData: typeof getDataTransferItemData;
+    getFiles: typeof getDataTransferFiles;
+};
+declare const findDataTransferItemType: <T extends ValueOf<{
+    readonly text: "text/plain";
+    readonly html: "text/html";
+    readonly json: "application/json";
+    readonly excalidraw: "application/vnd.excalidraw+json";
+    readonly excalidrawlib: "application/vnd.excalidrawlib+json";
+    readonly excalidrawlibIds: "application/vnd.excalidrawlib.ids+json";
+}>>(this: ParsedDataTranferList, type: T) => ParsedDataTransferItemType<T> | null;
+declare const getDataTransferItemData: <T extends ValueOf<{
+    readonly text: "text/plain";
+    readonly html: "text/html";
+    readonly json: "application/json";
+    readonly excalidraw: "application/vnd.excalidraw+json";
+    readonly excalidrawlib: "application/vnd.excalidrawlib+json";
+    readonly excalidrawlibIds: "application/vnd.excalidrawlib.ids+json";
+}>>(this: ParsedDataTranferList, type: T) => ParsedDataTransferItemType<ValueOf<typeof STRING_MIME_TYPES>>["value"] | null;
+declare const getDataTransferFiles: (this: ParsedDataTranferList) => ParsedDataTransferFile[];
+export declare const parseDataTransferEvent: (event: ClipboardEvent | DragEvent | React.DragEvent<HTMLDivElement>) => Promise<ParsedDataTranferList>;
 /**
  * Attempts to parse clipboard event.
  */
-export declare const parseClipboard: (event: ClipboardEvent, isPlainPaste?: boolean) => Promise<ClipboardData>;
+export declare const parseClipboard: (dataList: ParsedDataTranferList, isPlainPaste?: boolean) => Promise<ClipboardData>;
 export declare const copyBlobToClipboardAsPng: (blob: Blob | Promise<Blob>) => Promise<void>;
 export declare const copyTextToSystemClipboard: (text: string | null, clipboardEvent?: ClipboardEvent | null) => Promise<void>;
+export declare const isClipboardEvent: (event: React.SyntheticEvent | Event) => event is ClipboardEvent;
 export {};

package/dist/types/excalidraw/components/Actions.d.ts

@@ -1,7 +1,7 @@
-import type { ActionManager } from "../actions/manager";
-import type { ExcalidrawElement, NonDeletedElementsMap, NonDeletedSceneElementsMap } from "../element/types";
-import type { AppClassProperties, AppProps, UIAppState, Zoom } from "../types";
+import type { ExcalidrawElement, NonDeletedElementsMap, NonDeletedSceneElementsMap } from "@excalidraw/element/types";
 import "./Actions.scss";
+import type { AppClassProperties, AppProps, UIAppState, Zoom, AppState } from "../types";
+import type { ActionManager } from "../actions/manager";
 export declare const canChangeStrokeColor: (appState: UIAppState, targetElements: ExcalidrawElement[]) => boolean;
 export declare const canChangeBackgroundColor: (appState: UIAppState, targetElements: ExcalidrawElement[]) => boolean;
 export declare const SelectedShapeActions: ({ appState, elementsMap, renderAction, app, }: {
@@ -10,9 +10,23 @@ export declare const SelectedShapeActions: ({ appState, elementsMap, renderActio
     renderAction: ActionManager["renderAction"];
     app: AppClassProperties;
 }) => import("react/jsx-runtime").JSX.Element;
-export declare const ShapesSwitcher: ({ activeTool, appState, app, UIOptions, }: {
-    activeTool: UIAppState["activeTool"];
+export declare const CompactShapeActions: ({ appState, elementsMap, renderAction, app, setAppState, }: {
+    appState: UIAppState;
+    elementsMap: NonDeletedElementsMap | NonDeletedSceneElementsMap;
+    renderAction: ActionManager["renderAction"];
+    app: AppClassProperties;
+    setAppState: React.Component<any, AppState>["setState"];
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const MobileShapeActions: ({ appState, elementsMap, renderAction, app, setAppState, }: {
     appState: UIAppState;
+    elementsMap: NonDeletedElementsMap | NonDeletedSceneElementsMap;
+    renderAction: ActionManager["renderAction"];
+    app: AppClassProperties;
+    setAppState: React.Component<any, AppState>["setState"];
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const ShapesSwitcher: ({ activeTool, setAppState, app, UIOptions, }: {
+    activeTool: UIAppState["activeTool"];
+    setAppState: React.Component<any, AppState>["setState"];
     app: AppClassProperties;
     UIOptions: AppProps["UIOptions"];
 }) => import("react/jsx-runtime").JSX.Element;
@@ -28,7 +42,3 @@ export declare const ExitZenModeAction: ({ actionManager, showExitZenModeBtn, }:
     actionManager: ActionManager;
     showExitZenModeBtn: boolean;
 }) => import("react/jsx-runtime").JSX.Element;
-export declare const FinalizeAction: ({ renderAction, className, }: {
-    renderAction: ActionManager["renderAction"];
-    className?: string | undefined;
-}) => import("react/jsx-runtime").JSX.Element;

package/dist/types/excalidraw/components/App.d.ts

@@ -1,23 +1,22 @@
 import React from "react";
-import type { RoughCanvas } from "roughjs/bin/canvas";
+import { type EXPORT_IMAGE_TYPES, Emitter } from "@excalidraw/common";
+import { LinearElementEditor, FlowChartCreator, Scene, Store, type ElementUpdate, StoreDelta, type ApplyToOptions } from "@excalidraw/element";
+import type { ExcalidrawElement, NonDeleted, NonDeletedExcalidrawElement, ExcalidrawFrameLikeElement, ExcalidrawIframeElement, ExcalidrawEmbeddableElement, Ordered, SceneElementsMap } from "@excalidraw/element/types";
+import type { Mutable } from "@excalidraw/common/utility-types";
 import { ActionManager } from "../actions/manager";
-import type { ActionResult } from "../actions/types";
-import { type EXPORT_IMAGE_TYPES } from "../constants";
-import type { ExportedElements } from "../data";
-import { LinearElementEditor } from "../element/linearElementEditor";
-import type { ExcalidrawElement, NonDeleted, InitializedExcalidrawImageElement, ExcalidrawImageElement, NonDeletedExcalidrawElement, ExcalidrawFrameLikeElement, ExcalidrawIframeElement, ExcalidrawEmbeddableElement, Ordered } from "../element/types";
+import { AnimationFrameHandler } from "../animation-frame-handler";
 import { History } from "../history";
-import Scene from "../scene/Scene";
-import type { AppClassProperties, AppProps, AppState, ExcalidrawImperativeAPI, BinaryFiles, LibraryItems, SceneData, Device, FrameNameBoundsCache, SidebarName, SidebarTabName, ToolType, OnUserFollowedPayload, GenerateDiagramToCode, NullableGridSize, Offsets } from "../types";
-import type { FileSystemHandle } from "../data/filesystem";
 import { Fonts } from "../fonts";
+import { type WritableAtom } from "../editor-jotai";
 import { Renderer } from "../scene/Renderer";
-import { Emitter } from "../emitter";
-import { Store } from "../store";
-import { AnimationFrameHandler } from "../animation-frame-handler";
-import { AnimatedTrail } from "../animated-trail";
 import { LaserTrails } from "../laser-trails";
-import { FlowChartCreator } from "../element/flowchart";
+import { LassoTrail } from "../lasso";
+import { EraserTrail } from "../eraser";
+import type { ExportedElements } from "../data";
+import type { FileSystemHandle } from "../data/filesystem";
+import type { AppClassProperties, AppProps, AppState, ExcalidrawImperativeAPI, BinaryFiles, LibraryItems, SceneData, Device, FrameNameBoundsCache, SidebarName, SidebarTabName, ToolType, OnUserFollowedPayload, GenerateDiagramToCode, NullableGridSize, Offsets } from "../types";
+import type { RoughCanvas } from "roughjs/bin/canvas";
+import type { ActionResult } from "../actions/types";
 export declare const ExcalidrawContainerContext: React.Context<{
     container: HTMLDivElement | null;
     id: string | null;
@@ -79,6 +78,7 @@ declare class App extends React.Component<AppProps, AppState> {
     /** embeds that have been inserted to DOM (as a perf optim, we don't want to
      * insert to DOM before user initially scrolls to them) */
     private initializedEmbeds;
+    private handleToastClose;
     private elementsPendingErasure;
     flowChartCreator: FlowChartCreator;
     private flowChartNavigator;
@@ -96,11 +96,13 @@ declare class App extends React.Component<AppProps, AppState> {
     };
     animationFrameHandler: AnimationFrameHandler;
     laserTrails: LaserTrails;
-    eraserTrail: AnimatedTrail;
+    eraserTrail: EraserTrail;
+    lassoTrail: LassoTrail;
     onChangeEmitter: Emitter<[elements: readonly ExcalidrawElement[], appState: AppState, files: BinaryFiles]>;
     onPointerDownEmitter: Emitter<[activeTool: {
         lastActiveTool: import("../types").ActiveTool | null;
         locked: boolean;
+        fromSelection: boolean;
     } & import("../types").ActiveTool, pointerDownState: Readonly<{
         origin: Readonly<{
             x: number;
@@ -121,7 +123,7 @@ declare class App extends React.Component<AppProps, AppState> {
         };
         originalElements: Map<string, NonDeleted<ExcalidrawElement>>;
         resize: {
-            handleType: import("../element/transformHandles").MaybeTransformHandleType;
+            handleType: import("@excalidraw/element").MaybeTransformHandleType;
             isResizing: boolean;
             offset: {
                 x: number;
@@ -134,7 +136,10 @@ declare class App extends React.Component<AppProps, AppState> {
             };
         };
         hit: {
-            element: NonDeleted<ExcalidrawElement> | null;
+            element: NonDeleted<ExcalidrawElement> | null; /**
+             * Returns gridSize taking into account `gridModeEnabled`.
+             * If disabled, returns null.
+             */
             allHitElements: NonDeleted<ExcalidrawElement>[];
             wasAddedToSelection: boolean;
             hasBeenDuplicated: boolean;
@@ -147,6 +152,11 @@ declare class App extends React.Component<AppProps, AppState> {
                 x: number;
                 y: number;
             } | null;
+            origin: {
+                x: number;
+                y: number;
+            };
+            blockDragging: boolean;
         };
         eventListeners: {
             onMove: {
@@ -165,6 +175,7 @@ declare class App extends React.Component<AppProps, AppState> {
     onPointerUpEmitter: Emitter<[activeTool: {
         lastActiveTool: import("../types").ActiveTool | null;
         locked: boolean;
+        fromSelection: boolean;
     } & import("../types").ActiveTool, pointerDownState: Readonly<{
         origin: Readonly<{
             x: number;
@@ -185,7 +196,7 @@ declare class App extends React.Component<AppProps, AppState> {
         };
         originalElements: Map<string, NonDeleted<ExcalidrawElement>>;
         resize: {
-            handleType: import("../element/transformHandles").MaybeTransformHandleType;
+            handleType: import("@excalidraw/element").MaybeTransformHandleType;
             isResizing: boolean;
             offset: {
                 x: number;
@@ -198,7 +209,10 @@ declare class App extends React.Component<AppProps, AppState> {
             };
         };
         hit: {
-            element: NonDeleted<ExcalidrawElement> | null;
+            element: NonDeleted<ExcalidrawElement> | null; /**
+             * Returns gridSize taking into account `gridModeEnabled`.
+             * If disabled, returns null.
+             */
             allHitElements: NonDeleted<ExcalidrawElement>[];
             wasAddedToSelection: boolean;
             hasBeenDuplicated: boolean;
@@ -211,6 +225,11 @@ declare class App extends React.Component<AppProps, AppState> {
                 x: number;
                 y: number;
             } | null;
+            origin: {
+                x: number;
+                y: number;
+            };
+            blockDragging: boolean;
         };
         eventListeners: {
             onMove: {
@@ -233,6 +252,7 @@ declare class App extends React.Component<AppProps, AppState> {
     missingPointerEventCleanupEmitter: Emitter<[event: PointerEvent | null]>;
     onRemoveEventListenersEmitter: Emitter<[]>;
     constructor(props: AppProps);
+    updateEditorAtom: <Value, Args extends unknown[], Result>(atom: WritableAtom<Value, Args, Result>, ...args: Args) => Result;
     private onWindowMessage;
     private cacheEmbeddableRef;
     /**
@@ -253,7 +273,8 @@ declare class App extends React.Component<AppProps, AppState> {
     private toggleOverscrollBehavior;
     render(): import("react/jsx-runtime").JSX.Element;
     focusContainer: AppClassProperties["focusContainer"];
-    getSceneElementsIncludingDeleted: () => readonly import("../element/types").OrderedExcalidrawElement[];
+    getSceneElementsIncludingDeleted: () => readonly import("@excalidraw/element/types").OrderedExcalidrawElement[];
+    getSceneElementsMapIncludingDeleted: () => Map<string, Ordered<ExcalidrawElement>> & import("@excalidraw/common/utility-types").MakeBrand<"SceneElementsMap">;
     getSceneElements: () => readonly Ordered<NonDeletedExcalidrawElement>[];
     onInsertElements: (elements: readonly ExcalidrawElement[]) => void;
     onExportImage: (type: keyof typeof EXPORT_IMAGE_TYPES, elements: ExportedElements, opts: {
@@ -285,6 +306,7 @@ declare class App extends React.Component<AppProps, AppState> {
     private resetScene;
     private initializeScene;
     private isMobileBreakpoint;
+    private isTabletBreakpoint;
     private refreshViewportBreakpoints;
     private refreshEditorBreakpoints;
     private clearImageShapeCache;
@@ -303,6 +325,7 @@ declare class App extends React.Component<AppProps, AppState> {
     private static resetTapTwice;
     private onTouchStart;
     private onTouchEnd;
+    private insertClipboardContent;
     pasteFromClipboard: (event: ClipboardEvent) => Promise<void>;
     addElementsFromPasteOrLibrary: (opts: {
         elements: readonly ExcalidrawElement[];
@@ -384,6 +407,8 @@ declare class App extends React.Component<AppProps, AppState> {
          */
         captureUpdate?: SceneData["captureUpdate"];
     }) => void;
+    applyDeltas: (deltas: StoreDelta[], options?: ApplyToOptions) => [SceneElementsMap, AppState, boolean];
+    mutateElement: <TElement extends Mutable<ExcalidrawElement>>(element: TElement, updates: ElementUpdate<TElement>, informMutation?: boolean) => TElement;
     private triggerRender;
     /**
      * @returns whether the menu was toggled on or off
@@ -398,17 +423,15 @@ declare class App extends React.Component<AppProps, AppState> {
     private onKeyDown;
     private onKeyUp;
     private isToolSupported;
-    setActiveTool: (tool: (({
-        type: Exclude<ToolType, "image">;
+    setActiveTool: (tool: ({
+        type: ToolType;
     } | {
-        type: Extract<ToolType, "image">;
-        insertOnCanvasDirectly?: boolean;
-    }) | {
         type: "custom";
         customType: string;
     }) & {
         locked?: boolean;
-    }) => void;
+        fromSelection?: boolean;
+    }, keepSelection?: boolean) => void;
     setOpenDialog: (dialogType: AppState["openDialog"]) => void;
     private setCursor;
     private resetCursor;
@@ -428,7 +451,7 @@ declare class App extends React.Component<AppProps, AppState> {
     private getTextElementAtPosition;
     private getElementAtPosition;
     private getElementsAtPosition;
-    private getElementHitThreshold;
+    getElementHitThreshold(element: ExcalidrawElement): number;
     private hitElement;
     private getTextBindableContainerAtPosition;
     private startTextEditing;
@@ -476,7 +499,7 @@ declare class App extends React.Component<AppProps, AppState> {
         sceneY: number;
         link: string;
     }) => NonDeleted<ExcalidrawEmbeddableElement> | undefined;
-    private createImageElement;
+    private newImagePlaceholder;
     private handleLinearElementOnPointerDown;
     private getCurrentItemRoundness;
     private createGenericElementOnPointerDown;
@@ -492,12 +515,13 @@ declare class App extends React.Component<AppProps, AppState> {
     private eraseElements;
     private initializeImage;
     /**
-     * inserts image into elements array and rerenders
+     * use during async image initialization,
+     * when the placeholder image could have been modified in the meantime,
+     * and when you don't want to loose those modifications
      */
-    insertImageElement: (imageElement: ExcalidrawImageElement, imageFile: File, showCursorImagePreview?: boolean) => Promise<NonDeleted<InitializedExcalidrawImageElement> | null | undefined>;
-    private setImagePreviewCursor;
-    private onImageAction;
-    initializeImageDimensions: (imageElement: ExcalidrawImageElement, forceNaturalSize?: boolean) => void;
+    private getLatestInitializedImageElement;
+    private onImageToolbarButtonClick;
+    private getImageNaturalDimensions;
     /** updates image cache, refreshing updated elements and/or setting status
         to error for images that fail during <img> element creation */
     private updateImageCache;
@@ -508,9 +532,9 @@ declare class App extends React.Component<AppProps, AppState> {
     private scheduleImageRefresh;
     private updateBindingEnabledOnPointerMove;
     private maybeSuggestBindingAtCursor;
-    private maybeSuggestBindingsForLinearElementAtCoords;
     private clearSelection;
     private handleInteractiveCanvasRef;
+    private insertImages;
     private handleAppOnDrop;
     loadFileToCanvas: (file: File, fileHandle: FileSystemHandle | null) => Promise<void>;
     private handleCanvasContextMenu;

package/dist/types/excalidraw/components/Avatar.d.ts

@@ -1,5 +1,5 @@
-import "./Avatar.scss";
 import React from "react";
+import "./Avatar.scss";
 type AvatarProps = {
     onClick: (e: React.MouseEvent<HTMLDivElement, MouseEvent>) => void;
     color: string;

package/dist/types/excalidraw/components/ButtonIcon.d.ts

@@ -1,5 +1,5 @@
-import type { JSX } from "react";
 import "./ButtonIcon.scss";
+import type { JSX } from "react";
 interface ButtonIconProps {
     icon: JSX.Element;
     title: string;
@@ -10,6 +10,7 @@ interface ButtonIconProps {
     /** include standalone style (could interfere with parent styles) */
     standalone?: boolean;
     onClick: (event: React.MouseEvent<HTMLButtonElement, MouseEvent>) => void;
+    style?: React.CSSProperties;
 }
 export declare const ButtonIcon: import("react").ForwardRefExoticComponent<ButtonIconProps & import("react").RefAttributes<HTMLButtonElement>>;
 export {};

package/dist/types/excalidraw/components/ColorPicker/ColorInput.d.ts

@@ -4,6 +4,7 @@ interface ColorInputProps {
     onChange: (color: string) => void;
     label: string;
     colorPickerType: ColorPickerType;
+    placeholder?: string;
 }
-export declare const ColorInput: ({ color, onChange, label, colorPickerType, }: ColorInputProps) => import("react/jsx-runtime").JSX.Element;
+export declare const ColorInput: ({ color, onChange, label, colorPickerType, placeholder, }: ColorInputProps) => import("react/jsx-runtime").JSX.Element;
 export {};