@excalidraw/element 0.18.0-d2463f87d → 0.18.0-d9e8a33

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

@@ -1,372 +1,3 @@
-/// <reference types="react" />
-export declare const actionToggleCanvasMenu: {
-    name: "toggleCanvasMenu";
-    label: string;
-    trackEvent: {
-        category: "menu";
-    };
-    perform: (_: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<import("../types").AppState>) => {
-        appState: {
-            openMenu: "canvas" | null;
-            contextMenu: {
-                items: import("../components/ContextMenu").ContextMenuItems;
-                top: number;
-                left: number;
-            } | null;
-            showWelcomeScreen: boolean;
-            isLoading: boolean;
-            errorMessage: import("react").ReactNode;
-            activeEmbeddable: {
-                element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
-                state: "active" | "hover";
-            } | null;
-            newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
-            resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
-            multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
-            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[];
-            frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
-            frameRendering: {
-                enabled: boolean;
-                name: boolean;
-                outline: boolean;
-                clip: boolean;
-            };
-            editingFrame: string | null;
-            elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
-            editingLinearElement: import("@excalidraw/element").LinearElementEditor | null;
-            activeTool: {
-                lastActiveTool: import("../types").ActiveTool | null;
-                locked: boolean;
-                fromSelection: boolean;
-            } & import("../types").ActiveTool;
-            penMode: boolean;
-            penDetected: boolean;
-            exportBackground: boolean;
-            exportEmbedScene: boolean;
-            exportWithDarkMode: boolean;
-            exportScale: number;
-            currentItemStrokeColor: string;
-            currentItemBackgroundColor: string;
-            currentItemFillStyle: import("@excalidraw/element/types").FillStyle;
-            currentItemStrokeWidth: number;
-            currentItemStrokeStyle: import("@excalidraw/element/types").StrokeStyle;
-            currentItemRoughness: number;
-            currentItemOpacity: number;
-            currentItemFontFamily: number;
-            currentItemFontSize: number;
-            currentItemTextAlign: string;
-            currentItemStartArrowhead: import("@excalidraw/element/types").Arrowhead | null;
-            currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
-            currentHoveredFontFamily: number | null;
-            currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
-            currentItemArrowType: "round" | "sharp" | "elbow";
-            viewBackgroundColor: string;
-            scrollX: number;
-            scrollY: number;
-            cursorButton: "up" | "down";
-            scrolledOutside: boolean;
-            name: string | null;
-            isResizing: boolean;
-            isRotating: boolean;
-            zoom: Readonly<{
-                value: import("../types").NormalizedZoomValue;
-            }>;
-            openPopup: "fontFamily" | "canvasBackground" | "elementBackground" | "elementStroke" | null;
-            openSidebar: {
-                name: string;
-                tab?: string | undefined;
-            } | null;
-            openDialog: {
-                name: "imageExport" | "help" | "jsonExport";
-            } | {
-                name: "ttd";
-                tab: "mermaid" | "text-to-diagram";
-            } | {
-                name: "commandPalette";
-            } | {
-                name: "elementLinkSelector";
-                sourceElementId: string;
-            } | null;
-            defaultSidebarDockedPreference: boolean;
-            lastPointerDownWith: import("@excalidraw/element/types").PointerType;
-            selectedElementIds: Readonly<{
-                [id: string]: true;
-            }>;
-            hoveredElementIds: Readonly<{
-                [id: string]: true;
-            }>;
-            previousSelectedElementIds: {
-                [id: string]: true;
-            };
-            selectedElementsAreBeingDragged: boolean;
-            shouldCacheIgnoreZoom: boolean;
-            toast: {
-                message: string;
-                closable?: boolean | undefined;
-                duration?: number | undefined;
-            } | null;
-            zenModeEnabled: boolean;
-            theme: import("@excalidraw/element/types").Theme;
-            gridSize: number;
-            gridStep: number;
-            gridModeEnabled: boolean;
-            viewModeEnabled: boolean;
-            selectedGroupIds: {
-                [groupId: string]: boolean;
-            };
-            editingGroupId: string | 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;
-            }>>;
-            stats: {
-                open: boolean;
-                panels: number;
-            };
-            currentChartType: import("@excalidraw/element/types").ChartType;
-            pasteDialog: {
-                shown: false;
-                data: null;
-            } | {
-                shown: true;
-                data: import("../charts").Spreadsheet;
-            };
-            showHyperlinkPopup: false | "editor" | "info";
-            selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
-            snapLines: readonly import("../snapping").SnapLine[];
-            originSnapOffset: {
-                x: number;
-                y: number;
-            } | null;
-            objectsSnapModeEnabled: boolean;
-            userToFollow: import("../types").UserToFollow | null;
-            followedBy: Set<import("../types").SocketId>;
-            isCropping: boolean;
-            croppingElementId: string | null;
-            searchMatches: Readonly<{
-                focusedId: string | null;
-                matches: readonly import("../types").SearchMatch[];
-            }> | null;
-            activeLockedId: string | null;
-            lockedMultiSelections: {
-                [groupId: string]: true;
-            };
-        };
-        captureUpdate: "EVENTUALLY";
-    };
-    PanelComponent: ({ appState, updateData }: import("./types").PanelComponentProps) => import("react/jsx-runtime").JSX.Element;
-} & {
-    keyTest?: undefined;
-};
-export declare const actionToggleEditMenu: {
-    name: "toggleEditMenu";
-    label: string;
-    trackEvent: {
-        category: "menu";
-    };
-    perform: (_elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<import("../types").AppState>) => {
-        appState: {
-            openMenu: "shape" | null;
-            contextMenu: {
-                items: import("../components/ContextMenu").ContextMenuItems;
-                top: number;
-                left: number;
-            } | null;
-            showWelcomeScreen: boolean;
-            isLoading: boolean;
-            errorMessage: import("react").ReactNode;
-            activeEmbeddable: {
-                element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
-                state: "active" | "hover";
-            } | null;
-            newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
-            resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
-            multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
-            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[];
-            frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
-            frameRendering: {
-                enabled: boolean;
-                name: boolean;
-                outline: boolean;
-                clip: boolean;
-            };
-            editingFrame: string | null;
-            elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
-            editingLinearElement: import("@excalidraw/element").LinearElementEditor | null;
-            activeTool: {
-                lastActiveTool: import("../types").ActiveTool | null;
-                locked: boolean;
-                fromSelection: boolean;
-            } & import("../types").ActiveTool;
-            penMode: boolean;
-            penDetected: boolean;
-            exportBackground: boolean;
-            exportEmbedScene: boolean;
-            exportWithDarkMode: boolean;
-            exportScale: number;
-            currentItemStrokeColor: string;
-            currentItemBackgroundColor: string;
-            currentItemFillStyle: import("@excalidraw/element/types").FillStyle;
-            currentItemStrokeWidth: number;
-            currentItemStrokeStyle: import("@excalidraw/element/types").StrokeStyle;
-            currentItemRoughness: number;
-            currentItemOpacity: number;
-            currentItemFontFamily: number;
-            currentItemFontSize: number;
-            currentItemTextAlign: string;
-            currentItemStartArrowhead: import("@excalidraw/element/types").Arrowhead | null;
-            currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
-            currentHoveredFontFamily: number | null;
-            currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
-            currentItemArrowType: "round" | "sharp" | "elbow";
-            viewBackgroundColor: string;
-            scrollX: number;
-            scrollY: number;
-            cursorButton: "up" | "down";
-            scrolledOutside: boolean;
-            name: string | null;
-            isResizing: boolean;
-            isRotating: boolean;
-            zoom: Readonly<{
-                value: import("../types").NormalizedZoomValue;
-            }>;
-            openPopup: "fontFamily" | "canvasBackground" | "elementBackground" | "elementStroke" | null;
-            openSidebar: {
-                name: string;
-                tab?: string | undefined;
-            } | null;
-            openDialog: {
-                name: "imageExport" | "help" | "jsonExport";
-            } | {
-                name: "ttd";
-                tab: "mermaid" | "text-to-diagram";
-            } | {
-                name: "commandPalette";
-            } | {
-                name: "elementLinkSelector";
-                sourceElementId: string;
-            } | null;
-            defaultSidebarDockedPreference: boolean;
-            lastPointerDownWith: import("@excalidraw/element/types").PointerType;
-            selectedElementIds: Readonly<{
-                [id: string]: true;
-            }>;
-            hoveredElementIds: Readonly<{
-                [id: string]: true;
-            }>;
-            previousSelectedElementIds: {
-                [id: string]: true;
-            };
-            selectedElementsAreBeingDragged: boolean;
-            shouldCacheIgnoreZoom: boolean;
-            toast: {
-                message: string;
-                closable?: boolean | undefined;
-                duration?: number | undefined;
-            } | null;
-            zenModeEnabled: boolean;
-            theme: import("@excalidraw/element/types").Theme;
-            gridSize: number;
-            gridStep: number;
-            gridModeEnabled: boolean;
-            viewModeEnabled: boolean;
-            selectedGroupIds: {
-                [groupId: string]: boolean;
-            };
-            editingGroupId: string | 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;
-            }>>;
-            stats: {
-                open: boolean;
-                panels: number;
-            };
-            currentChartType: import("@excalidraw/element/types").ChartType;
-            pasteDialog: {
-                shown: false;
-                data: null;
-            } | {
-                shown: true;
-                data: import("../charts").Spreadsheet;
-            };
-            showHyperlinkPopup: false | "editor" | "info";
-            selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
-            snapLines: readonly import("../snapping").SnapLine[];
-            originSnapOffset: {
-                x: number;
-                y: number;
-            } | null;
-            objectsSnapModeEnabled: boolean;
-            userToFollow: import("../types").UserToFollow | null;
-            followedBy: Set<import("../types").SocketId>;
-            isCropping: boolean;
-            croppingElementId: string | null;
-            searchMatches: Readonly<{
-                focusedId: string | null;
-                matches: readonly import("../types").SearchMatch[];
-            }> | null;
-            activeLockedId: string | null;
-            lockedMultiSelections: {
-                [groupId: string]: true;
-            };
-        };
-        captureUpdate: "EVENTUALLY";
-    };
-    PanelComponent: ({ elements, appState, updateData }: import("./types").PanelComponentProps) => import("react/jsx-runtime").JSX.Element;
-} & {
-    keyTest?: undefined;
-};
 export declare const actionShortcuts: {
     name: "toggleShortcuts";
     label: string;
@@ -376,11 +7,13 @@ export declare const actionShortcuts: {
         category: "menu";
         action: string;
     };
-    perform: (_elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<import("../types").AppState>, _: any, { focusContainer }: import("../types").AppClassProperties) => {
+    perform: (_elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<import("../types").AppState>, _: unknown, { focusContainer }: import("../types").AppClassProperties) => {
         appState: {
             openDialog: {
                 name: "help";
             } | null;
+            openMenu: null;
+            openPopup: null;
             contextMenu: {
                 items: import("../components/ContextMenu").ContextMenuItems;
                 top: number;
@@ -388,18 +21,24 @@ export declare const actionShortcuts: {
             } | 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;
             multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
             selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
+            boxSelectionMode: import("../types").BoxSelectionMode;
+            bindingPreference: "enabled" | "disabled";
+            isMidpointSnappingEnabled: 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;
@@ -409,13 +48,16 @@ export declare const actionShortcuts: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
-            editingLinearElement: import("@excalidraw/element").LinearElementEditor | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
                 fromSelection: boolean;
             } & import("../types").ActiveTool;
+            preferredSelectionTool: {
+                type: "selection" | "lasso";
+                initialized: boolean;
+            };
             penMode: boolean;
             penDetected: boolean;
             exportBackground: boolean;
@@ -424,19 +66,19 @@ export declare const actionShortcuts: {
             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;
@@ -445,14 +87,10 @@ export declare const actionShortcuts: {
             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;
             openSidebar: {
-                name: string;
-                tab?: string | undefined;
+                name: import("../types").SidebarName;
+                tab?: import("../types").SidebarTabName;
             } | null;
             defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("@excalidraw/element/types").PointerType;
@@ -468,9 +106,9 @@ export declare const actionShortcuts: {
             selectedElementsAreBeingDragged: boolean;
             shouldCacheIgnoreZoom: boolean;
             toast: {
-                message: string;
-                closable?: boolean | undefined;
-                duration?: number | undefined;
+                message: React.ReactNode;
+                closable?: boolean;
+                duration?: number;
             } | null;
             zenModeEnabled: boolean;
             theme: import("@excalidraw/element/types").Theme;
@@ -481,45 +119,18 @@ export declare const actionShortcuts: {
             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;
-            }>>;
+            fileHandle: FileSystemFileHandle | null;
+            collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
             stats: {
                 open: boolean;
                 panels: number;
             };
-            currentChartType: import("@excalidraw/element/types").ChartType;
-            pasteDialog: {
-                shown: false;
-                data: null;
-            } | {
-                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: {
@@ -530,15 +141,16 @@ export declare const actionShortcuts: {
             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";
     };