@excalidraw/element 0.18.0-7b8a5f54c → 0.18.0-7ea3229

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 export declare const actionToggleViewMode: {
     name: "viewMode";
     label: string;
@@ -18,10 +17,10 @@ export declare const actionToggleViewMode: {
             } | null;
             showWelcomeScreen: boolean;
             isLoading: boolean;
-            errorMessage: import("react").ReactNode;
+            errorMessage: React.ReactNode;
             activeEmbeddable: {
                 element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
-                state: "active" | "hover";
+                state: "hover" | "active";
             } | null;
             newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
             resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
@@ -29,7 +28,10 @@ export declare const actionToggleViewMode: {
             selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
             startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
-            suggestedBindings: import("@excalidraw/element").SuggestedBinding[];
+            suggestedBinding: {
+                element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
+                midPoint?: import("@excalidraw/math").GlobalPoint;
+            } | null;
             frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
@@ -45,6 +47,10 @@ export declare const actionToggleViewMode: {
                 locked: boolean;
                 fromSelection: boolean;
             } & import("../types").ActiveTool;
+            preferredSelectionTool: {
+                type: "selection" | "lasso";
+                initialized: boolean;
+            };
             penMode: boolean;
             penDetected: boolean;
             exportBackground: boolean;
@@ -53,19 +59,19 @@ export declare const actionToggleViewMode: {
             exportScale: number;
             currentItemStrokeColor: string;
             currentItemBackgroundColor: string;
-            currentItemFillStyle: import("@excalidraw/element/types").FillStyle;
+            currentItemFillStyle: import("@excalidraw/element/types").ExcalidrawElement["fillStyle"];
             currentItemStrokeWidth: number;
-            currentItemStrokeStyle: import("@excalidraw/element/types").StrokeStyle;
+            currentItemStrokeStyle: import("@excalidraw/element/types").ExcalidrawElement["strokeStyle"];
             currentItemRoughness: number;
             currentItemOpacity: number;
-            currentItemFontFamily: number;
+            currentItemFontFamily: import("@excalidraw/element/types").FontFamilyValues;
             currentItemFontSize: number;
-            currentItemTextAlign: string;
+            currentItemTextAlign: import("@excalidraw/element/types").TextAlign;
             currentItemStartArrowhead: import("@excalidraw/element/types").Arrowhead | null;
             currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
-            currentHoveredFontFamily: number | null;
+            currentHoveredFontFamily: import("@excalidraw/element/types").FontFamilyValues | null;
             currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
-            currentItemArrowType: "round" | "sharp" | "elbow";
+            currentItemArrowType: "sharp" | "round" | "elbow";
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
@@ -74,26 +80,26 @@ export declare const actionToggleViewMode: {
             name: string | null;
             isResizing: boolean;
             isRotating: boolean;
-            zoom: Readonly<{
-                value: import("../types").NormalizedZoomValue;
-            }>;
-            openMenu: "canvas" | "shape" | null;
-            openPopup: "fontFamily" | "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            zoom: import("../types").Zoom;
+            openMenu: "canvas" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | "fontFamily" | "compactTextProperties" | "compactStrokeStyles" | "compactOtherProperties" | "compactArrowProperties" | null;
             openSidebar: {
-                name: string;
-                tab?: string | undefined;
+                name: import("../types").SidebarName;
+                tab?: import("../types").SidebarTabName;
             } | null;
-            openDialog: {
+            openDialog: null | {
                 name: "imageExport" | "help" | "jsonExport";
             } | {
                 name: "ttd";
-                tab: "mermaid" | "text-to-diagram";
+                tab: "text-to-diagram" | "mermaid";
             } | {
                 name: "commandPalette";
+            } | {
+                name: "settings";
             } | {
                 name: "elementLinkSelector";
-                sourceElementId: string;
-            } | null;
+                sourceElementId: import("@excalidraw/element/types").ExcalidrawElement["id"];
+            };
             defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("@excalidraw/element/types").PointerType;
             selectedElementIds: Readonly<{
@@ -109,8 +115,8 @@ export declare const actionToggleViewMode: {
             shouldCacheIgnoreZoom: boolean;
             toast: {
                 message: string;
-                closable?: boolean | undefined;
-                duration?: number | undefined;
+                closable?: boolean;
+                duration?: number;
             } | null;
             zenModeEnabled: boolean;
             theme: import("@excalidraw/element/types").Theme;
@@ -120,32 +126,13 @@ export declare const actionToggleViewMode: {
             selectedGroupIds: {
                 [groupId: string]: boolean;
             };
-            editingGroupId: string | null;
+            editingGroupId: import("@excalidraw/element/types").GroupId | null;
             width: number;
             height: number;
             offsetTop: number;
             offsetLeft: number;
             fileHandle: import("browser-fs-access").FileSystemHandle | null;
-            collaborators: Map<import("../types").SocketId, Readonly<{
-                pointer?: import("../types").CollaboratorPointer | undefined;
-                button?: "up" | "down" | undefined;
-                selectedElementIds?: Readonly<{
-                    [id: string]: true;
-                }> | undefined;
-                username?: string | null | undefined;
-                userState?: import("@excalidraw/common").UserIdleState | undefined;
-                color?: {
-                    background: string;
-                    stroke: string;
-                } | undefined;
-                avatarUrl?: string | undefined;
-                id?: string | undefined;
-                socketId?: import("../types").SocketId | undefined;
-                isCurrentUser?: boolean | undefined;
-                isInCall?: boolean | undefined;
-                isSpeaking?: boolean | undefined;
-                isMuted?: boolean | undefined;
-            }>>;
+            collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
             stats: {
                 open: boolean;
                 panels: number;
@@ -158,7 +145,7 @@ export declare const actionToggleViewMode: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            showHyperlinkPopup: false | "editor" | "info";
+            showHyperlinkPopup: false | "info" | "editor";
             selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             snapLines: readonly import("../snapping").SnapLine[];
             originSnapOffset: {
@@ -169,15 +156,16 @@ export declare const actionToggleViewMode: {
             userToFollow: import("../types").UserToFollow | null;
             followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
-            croppingElementId: string | null;
+            croppingElementId: import("@excalidraw/element/types").ExcalidrawElement["id"] | null;
             searchMatches: Readonly<{
-                focusedId: string | null;
+                focusedId: import("@excalidraw/element/types").ExcalidrawElement["id"] | null;
                 matches: readonly import("../types").SearchMatch[];
             }> | null;
             activeLockedId: string | null;
             lockedMultiSelections: {
                 [groupId: string]: true;
             };
+            bindMode: import("@excalidraw/element/types").BindMode;
         };
         captureUpdate: "EVENTUALLY";
     };

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 export declare const actionToggleZenMode: {
     name: "zenMode";
     label: string;
@@ -18,10 +17,10 @@ export declare const actionToggleZenMode: {
             } | null;
             showWelcomeScreen: boolean;
             isLoading: boolean;
-            errorMessage: import("react").ReactNode;
+            errorMessage: React.ReactNode;
             activeEmbeddable: {
                 element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
-                state: "active" | "hover";
+                state: "hover" | "active";
             } | null;
             newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
             resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
@@ -29,7 +28,10 @@ export declare const actionToggleZenMode: {
             selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
             startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
-            suggestedBindings: import("@excalidraw/element").SuggestedBinding[];
+            suggestedBinding: {
+                element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
+                midPoint?: import("@excalidraw/math").GlobalPoint;
+            } | null;
             frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
@@ -45,6 +47,10 @@ export declare const actionToggleZenMode: {
                 locked: boolean;
                 fromSelection: boolean;
             } & import("../types").ActiveTool;
+            preferredSelectionTool: {
+                type: "selection" | "lasso";
+                initialized: boolean;
+            };
             penMode: boolean;
             penDetected: boolean;
             exportBackground: boolean;
@@ -53,19 +59,19 @@ export declare const actionToggleZenMode: {
             exportScale: number;
             currentItemStrokeColor: string;
             currentItemBackgroundColor: string;
-            currentItemFillStyle: import("@excalidraw/element/types").FillStyle;
+            currentItemFillStyle: import("@excalidraw/element/types").ExcalidrawElement["fillStyle"];
             currentItemStrokeWidth: number;
-            currentItemStrokeStyle: import("@excalidraw/element/types").StrokeStyle;
+            currentItemStrokeStyle: import("@excalidraw/element/types").ExcalidrawElement["strokeStyle"];
             currentItemRoughness: number;
             currentItemOpacity: number;
-            currentItemFontFamily: number;
+            currentItemFontFamily: import("@excalidraw/element/types").FontFamilyValues;
             currentItemFontSize: number;
-            currentItemTextAlign: string;
+            currentItemTextAlign: import("@excalidraw/element/types").TextAlign;
             currentItemStartArrowhead: import("@excalidraw/element/types").Arrowhead | null;
             currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
-            currentHoveredFontFamily: number | null;
+            currentHoveredFontFamily: import("@excalidraw/element/types").FontFamilyValues | null;
             currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
-            currentItemArrowType: "round" | "sharp" | "elbow";
+            currentItemArrowType: "sharp" | "round" | "elbow";
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
@@ -74,26 +80,26 @@ export declare const actionToggleZenMode: {
             name: string | null;
             isResizing: boolean;
             isRotating: boolean;
-            zoom: Readonly<{
-                value: import("../types").NormalizedZoomValue;
-            }>;
-            openMenu: "canvas" | "shape" | null;
-            openPopup: "fontFamily" | "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            zoom: import("../types").Zoom;
+            openMenu: "canvas" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | "fontFamily" | "compactTextProperties" | "compactStrokeStyles" | "compactOtherProperties" | "compactArrowProperties" | null;
             openSidebar: {
-                name: string;
-                tab?: string | undefined;
+                name: import("../types").SidebarName;
+                tab?: import("../types").SidebarTabName;
             } | null;
-            openDialog: {
+            openDialog: null | {
                 name: "imageExport" | "help" | "jsonExport";
             } | {
                 name: "ttd";
-                tab: "mermaid" | "text-to-diagram";
+                tab: "text-to-diagram" | "mermaid";
             } | {
                 name: "commandPalette";
+            } | {
+                name: "settings";
             } | {
                 name: "elementLinkSelector";
-                sourceElementId: string;
-            } | null;
+                sourceElementId: import("@excalidraw/element/types").ExcalidrawElement["id"];
+            };
             defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("@excalidraw/element/types").PointerType;
             selectedElementIds: Readonly<{
@@ -109,8 +115,8 @@ export declare const actionToggleZenMode: {
             shouldCacheIgnoreZoom: boolean;
             toast: {
                 message: string;
-                closable?: boolean | undefined;
-                duration?: number | undefined;
+                closable?: boolean;
+                duration?: number;
             } | null;
             theme: import("@excalidraw/element/types").Theme;
             gridSize: number;
@@ -120,32 +126,13 @@ export declare const actionToggleZenMode: {
             selectedGroupIds: {
                 [groupId: string]: boolean;
             };
-            editingGroupId: string | null;
+            editingGroupId: import("@excalidraw/element/types").GroupId | null;
             width: number;
             height: number;
             offsetTop: number;
             offsetLeft: number;
             fileHandle: import("browser-fs-access").FileSystemHandle | null;
-            collaborators: Map<import("../types").SocketId, Readonly<{
-                pointer?: import("../types").CollaboratorPointer | undefined;
-                button?: "up" | "down" | undefined;
-                selectedElementIds?: Readonly<{
-                    [id: string]: true;
-                }> | undefined;
-                username?: string | null | undefined;
-                userState?: import("@excalidraw/common").UserIdleState | undefined;
-                color?: {
-                    background: string;
-                    stroke: string;
-                } | undefined;
-                avatarUrl?: string | undefined;
-                id?: string | undefined;
-                socketId?: import("../types").SocketId | undefined;
-                isCurrentUser?: boolean | undefined;
-                isInCall?: boolean | undefined;
-                isSpeaking?: boolean | undefined;
-                isMuted?: boolean | undefined;
-            }>>;
+            collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
             stats: {
                 open: boolean;
                 panels: number;
@@ -158,7 +145,7 @@ export declare const actionToggleZenMode: {
                 shown: true;
                 data: import("../charts").Spreadsheet;
             };
-            showHyperlinkPopup: false | "editor" | "info";
+            showHyperlinkPopup: false | "info" | "editor";
             selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             snapLines: readonly import("../snapping").SnapLine[];
             originSnapOffset: {
@@ -169,20 +156,21 @@ export declare const actionToggleZenMode: {
             userToFollow: import("../types").UserToFollow | null;
             followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
-            croppingElementId: string | null;
+            croppingElementId: import("@excalidraw/element/types").ExcalidrawElement["id"] | null;
             searchMatches: Readonly<{
-                focusedId: string | null;
+                focusedId: import("@excalidraw/element/types").ExcalidrawElement["id"] | null;
                 matches: readonly import("../types").SearchMatch[];
             }> | null;
             activeLockedId: string | null;
             lockedMultiSelections: {
                 [groupId: string]: true;
             };
+            bindMode: import("@excalidraw/element/types").BindMode;
         };
         captureUpdate: "EVENTUALLY";
     };
     checked: (appState: Readonly<import("../types").AppState>) => boolean;
-    predicate: (elements: readonly import("@excalidraw/element/types").ExcalidrawElement[], appState: import("../types").AppState, appProps: import("../types").ExcalidrawProps) => boolean;
+    predicate: (elements: readonly import("@excalidraw/element/types").ExcalidrawElement[], appState: import("../types").AppState, appProps: import("../types").ExcalidrawProps, app: import("../types").AppClassProperties) => boolean;
     keyTest: (event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean;
 } & {
     keyTest?: ((event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean) | undefined;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 export declare const actionSendBackward: {
     name: "sendBackward";
     label: string;
@@ -7,7 +6,7 @@ export declare const actionSendBackward: {
     trackEvent: {
         category: "element";
     };
-    perform: (elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<import("../types").AppState>, value: any, app: import("../types").AppClassProperties) => {
+    perform: (elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<import("../types").AppState>, value: unknown, app: import("../types").AppClassProperties) => {
         elements: readonly import("@excalidraw/element/types").ExcalidrawElement[];
         appState: Readonly<import("../types").AppState>;
         captureUpdate: "IMMEDIATELY";
@@ -26,7 +25,7 @@ export declare const actionBringForward: {
     trackEvent: {
         category: "element";
     };
-    perform: (elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<import("../types").AppState>, value: any, app: import("../types").AppClassProperties) => {
+    perform: (elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<import("../types").AppState>, value: unknown, app: import("../types").AppClassProperties) => {
         elements: readonly import("@excalidraw/element/types").ExcalidrawElement[];
         appState: Readonly<import("../types").AppState>;
         captureUpdate: "IMMEDIATELY";

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

@@ -2,13 +2,13 @@ export { actionDeleteSelected } from "./actionDeleteSelected";
 export { actionBringForward, actionBringToFront, actionSendBackward, actionSendToBack, } from "./actionZindex";
 export { actionSelectAll } from "./actionSelectAll";
 export { actionDuplicateSelection } from "./actionDuplicateSelection";
-export { actionChangeStrokeColor, actionChangeBackgroundColor, actionChangeStrokeWidth, actionChangeFillStyle, actionChangeSloppiness, actionChangeOpacity, actionChangeFontSize, actionChangeFontFamily, actionChangeTextAlign, actionChangeVerticalAlign, } from "./actionProperties";
+export { actionChangeStrokeColor, actionChangeBackgroundColor, actionChangeStrokeWidth, actionChangeFillStyle, actionChangeSloppiness, actionChangeOpacity, actionChangeFontSize, actionChangeFontFamily, actionChangeTextAlign, actionChangeVerticalAlign, actionChangeArrowProperties, } from "./actionProperties";
 export { actionChangeViewBackgroundColor, actionClearCanvas, actionZoomIn, actionZoomOut, actionResetZoom, actionZoomToFit, actionToggleTheme, } from "./actionCanvas";
 export { actionSetEmbeddableAsActiveTool } from "./actionEmbeddable";
 export { actionFinalize } from "./actionFinalize";
 export { actionChangeProjectName, actionChangeExportBackground, actionSaveToActiveFile, actionSaveFileToDisk, actionLoadScene, } from "./actionExport";
 export { actionCopyStyles, actionPasteStyles } from "./actionStyles";
-export { actionToggleCanvasMenu, actionToggleEditMenu, actionShortcuts, } from "./actionMenu";
+export { actionShortcuts } from "./actionMenu";
 export { actionGroup, actionUngroup } from "./actionGroup";
 export { actionGoToCollaborator } from "./actionNavigate";
 export { actionAddToLibrary } from "./actionAddToLibrary";

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

@@ -1,5 +1,5 @@
 import type { Action } from "./types";
 export declare let actions: readonly Action[];
-export declare const register: <T extends Action>(action: T) => T & {
-    keyTest?: (unknown extends T["keyTest"] ? never : T["keyTest"]) | undefined;
+export declare const register: <TData extends any, T extends Action<TData> = Action<TData>>(action: T) => T & {
+    keyTest?: unknown extends T["keyTest"] ? never : T["keyTest"];
 };

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

@@ -1,4 +1,4 @@
 import type { SubtypeOf } from "@excalidraw/common/utility-types";
 import type { ActionName } from "./types";
-export type ShortcutName = SubtypeOf<ActionName, "toggleTheme" | "loadScene" | "clearCanvas" | "cut" | "copy" | "paste" | "copyStyles" | "pasteStyles" | "selectAll" | "deleteSelectedElements" | "duplicateSelection" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyAsPng" | "group" | "ungroup" | "gridMode" | "zenMode" | "objectsSnapMode" | "stats" | "addToLibrary" | "viewMode" | "flipHorizontal" | "flipVertical" | "hyperlink" | "toggleElementLock" | "resetZoom" | "zoomOut" | "zoomIn" | "zoomToFit" | "zoomToFitSelectionInViewport" | "zoomToFitSelection" | "toggleEraserTool" | "toggleHandTool" | "setFrameAsActiveTool" | "saveFileToDisk" | "saveToActiveFile" | "toggleShortcuts" | "wrapSelectionInFrame"> | "saveScene" | "imageExport" | "commandPalette" | "searchMenu";
+export type ShortcutName = SubtypeOf<ActionName, "toggleTheme" | "loadScene" | "clearCanvas" | "cut" | "copy" | "paste" | "copyStyles" | "pasteStyles" | "selectAll" | "deleteSelectedElements" | "duplicateSelection" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyAsPng" | "group" | "ungroup" | "gridMode" | "zenMode" | "objectsSnapMode" | "stats" | "addToLibrary" | "viewMode" | "flipHorizontal" | "flipVertical" | "hyperlink" | "toggleElementLock" | "resetZoom" | "zoomOut" | "zoomIn" | "zoomToFit" | "zoomToFitSelectionInViewport" | "zoomToFitSelection" | "toggleEraserTool" | "toggleHandTool" | "setFrameAsActiveTool" | "saveFileToDisk" | "saveToActiveFile" | "toggleShortcuts" | "wrapSelectionInFrame"> | "saveScene" | "imageExport" | "commandPalette" | "searchMenu" | "toolLock";
 export declare const getShortcutFromShortcutName: (name: ShortcutName, idx?: number) => string;

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

@@ -11,10 +11,10 @@ export type ActionResult = {
     captureUpdate: CaptureUpdateActionType;
     replaceFiles?: boolean;
 } | false;
-type ActionFn = (elements: readonly OrderedExcalidrawElement[], appState: Readonly<AppState>, formData: any, app: AppClassProperties) => ActionResult | Promise<ActionResult>;
+type ActionFn<TData = any> = (elements: readonly OrderedExcalidrawElement[], appState: Readonly<AppState>, formData: TData | undefined, 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" | "toggleLassoTool" | "toggleShapeSwitch" | "togglePolygon";
+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" | "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;
@@ -24,13 +24,13 @@ export type PanelComponentProps = {
     app: AppClassProperties;
     renderAction: (name: ActionName, data?: PanelComponentProps["data"]) => React.JSX.Element | null;
 };
-export interface Action {
+export interface Action<TData = any> {
     name: ActionName;
     label: string | ((elements: readonly ExcalidrawElement[], appState: Readonly<AppState>, app: AppClassProperties) => string);
     keywords?: string[];
     icon?: React.ReactNode | ((appState: UIAppState, elements: readonly ExcalidrawElement[]) => React.ReactNode);
     PanelComponent?: React.FC<PanelComponentProps>;
-    perform: ActionFn;
+    perform: ActionFn<TData>;
     keyPriority?: number;
     keyTest?: (event: React.KeyboardEvent | KeyboardEvent, appState: AppState, elements: readonly ExcalidrawElement[], app: AppClassProperties) => boolean;
     predicate?: (elements: readonly ExcalidrawElement[], appState: AppState, appProps: ExcalidrawProps, app: AppClassProperties) => boolean;

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

@@ -2,6 +2,7 @@ import type { AppState, NormalizedZoomValue } from "./types";
 export declare const getDefaultAppState: () => Omit<AppState, "offsetTop" | "offsetLeft" | "width" | "height">;
 export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>) => {
     viewBackgroundColor?: string | undefined;
+    theme?: import("@excalidraw/element/types").Theme | undefined;
     name?: string | null | undefined;
     zoom?: Readonly<{
         value: NormalizedZoomValue;
@@ -12,24 +13,30 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     selectedElementIds?: Readonly<{
         [id: string]: true;
     }> | undefined;
-    theme?: import("@excalidraw/element/types").Theme | undefined;
+    activeTool?: ({
+        lastActiveTool: import("./types").ActiveTool | null;
+        locked: boolean;
+        fromSelection: boolean;
+    } & import("./types").ActiveTool) | undefined;
     selectedGroupIds?: {
         [groupId: string]: boolean;
     } | undefined;
     selectedLinearElement?: import("@excalidraw/element").LinearElementEditor | null | undefined;
     zenModeEnabled?: boolean | undefined;
+    shouldCacheIgnoreZoom?: boolean | undefined;
+    exportScale?: number | undefined;
+    bindMode?: import("@excalidraw/element/types").BindMode | undefined;
+    gridSize?: number | 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;
     exportEmbedScene?: boolean | undefined;
     exportWithDarkMode?: boolean | undefined;
-    exportScale?: number | undefined;
     currentItemStrokeColor?: string | undefined;
     currentItemBackgroundColor?: string | undefined;
     currentItemFillStyle?: import("@excalidraw/element/types").FillStyle | undefined;
@@ -46,18 +53,16 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     currentItemArrowType?: "round" | "sharp" | "elbow" | undefined;
     cursorButton?: "up" | "down" | undefined;
     scrolledOutside?: boolean | undefined;
-    openMenu?: "canvas" | "shape" | null | undefined;
+    openMenu?: "canvas" | null | undefined;
     openSidebar?: {
-        name: string;
-        tab?: string | undefined;
+        name: import("./types").SidebarName;
+        tab?: import("./types").SidebarTabName;
     } | null | undefined;
     defaultSidebarDockedPreference?: boolean | undefined;
     lastPointerDownWith?: import("@excalidraw/element/types").PointerType | undefined;
     previousSelectedElementIds?: {
         [id: string]: true;
     } | undefined;
-    shouldCacheIgnoreZoom?: boolean | undefined;
-    gridSize?: number | undefined;
     gridStep?: number | undefined;
     gridModeEnabled?: boolean | undefined;
     stats?: {

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

@@ -1,5 +1,8 @@
 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 type { BinaryFiles } from "./types";
 export type PastedMixedContent = {
@@ -20,26 +23,16 @@ export declare const probablySupportsClipboardReadText: boolean;
 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;
-        "image/gif"?: string | File | undefined;
-        "image/webp"?: string | File | undefined;
-        "image/bmp"?: string | File | undefined;
-        "image/x-icon"?: string | File | undefined;
-        "image/avif"?: string | File | undefined;
-        "image/jfif"?: string | File | undefined;
-    } | undefined;
-    files?: File[] | undefined;
+    types?: { [key in AllowedPasteMimeTypes]?: string | File; };
+    files?: File[];
 }) => ClipboardEvent;
 export declare const serializeAsClipboardJSON: ({ elements, files, }: {
     elements: readonly NonDeletedExcalidrawElement[];
     files: BinaryFiles | null;
 }) => string;
-export declare const copyToClipboard: (elements: readonly NonDeletedExcalidrawElement[], files: BinaryFiles | null, clipboardEvent?: ClipboardEvent | null) => Promise<void>;
+export declare const copyToClipboard: (elements: readonly NonDeletedExcalidrawElement[], files: BinaryFiles | null, 
+/** supply if available to make the operation more certain to succeed */
+clipboardEvent?: ClipboardEvent | null) => Promise<void>;
 /**
  * Reads OS clipboard programmatically. May not work on all browsers.
  * Will prompt user for permission if not granted.
@@ -57,10 +50,58 @@ export declare const readSystemClipboard: () => Promise<{
     "image/avif"?: string | File | undefined;
     "image/jfif"?: 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";
+}>;
+export 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<typeof STRING_MIME_TYPES>>(this: ParsedDataTranferList, type: T) => ParsedDataTransferItemType<T> | null;
+declare const getDataTransferItemData: <T extends ValueOf<typeof STRING_MIME_TYPES>>(this: ParsedDataTranferList, type: T) => ParsedDataTransferItemType<ValueOf<typeof STRING_MIME_TYPES>>["value"] | null;
+declare const getDataTransferFiles: (this: ParsedDataTranferList) => ParsedDataTransferFile[];
+/** @returns list of MIME types, synchronously */
+export declare const parseDataTransferEventMimeTypes: (event: ClipboardEvent | DragEvent | React.DragEvent<HTMLDivElement>) => Set<string>;
+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 copyTextToSystemClipboard: <MimeType extends ValueOf<typeof STRING_MIME_TYPES>>(text: string | { [K in MimeType]: string; } | null, clipboardEvent?: ClipboardEvent | null) => Promise<void>;
+export declare const isClipboardEvent: (event: React.SyntheticEvent | Event) => event is ClipboardEvent;
 export {};