@excalidraw/math 0.18.0-a8acc82 → 0.18.0-a9ca16e

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

@@ -1,5 +1,4 @@
-/// <reference types="react" />
-import type { ExcalidrawElement, OrderedExcalidrawElement } from "@excalidraw/element/types";
+import type { ExcalidrawElement, ExcalidrawTextElement, OrderedExcalidrawElement } from "@excalidraw/element/types";
 import type { AppClassProperties, AppState } from "../types";
 export declare const actionGroup: {
     name: "group";
@@ -8,19 +7,15 @@ export declare const actionGroup: {
     trackEvent: {
         category: "element";
     };
-    perform: (elements: readonly OrderedExcalidrawElement[], appState: Readonly<AppState>, _: any, app: AppClassProperties) => {
+    perform: (elements: readonly OrderedExcalidrawElement[], appState: Readonly<AppState>, _: unknown, app: AppClassProperties) => {
         appState: Readonly<AppState>;
         elements: readonly OrderedExcalidrawElement[];
         captureUpdate: "EVENTUALLY";
     } | {
         appState: {
-            editingGroupId: string | null;
-            selectedElementIds: Readonly<{
-                [id: string]: true;
-            }>;
-            selectedGroupIds: {
-                [groupId: string]: boolean;
-            };
+            editingGroupId: AppState["editingGroupId"];
+            selectedElementIds: AppState["selectedElementIds"];
+            selectedGroupIds: AppState["selectedGroupIds"];
             contextMenu: {
                 items: import("../components/ContextMenu").ContextMenuItems;
                 top: number;
@@ -28,18 +23,23 @@ export declare const actionGroup: {
             } | 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;
+            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;
@@ -49,12 +49,16 @@ export declare const actionGroup: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: 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;
@@ -63,19 +67,19 @@ export declare const actionGroup: {
             exportScale: number;
             currentItemStrokeColor: string;
             currentItemBackgroundColor: string;
-            currentItemFillStyle: import("@excalidraw/element/types").FillStyle;
+            currentItemFillStyle: ExcalidrawElement["fillStyle"];
             currentItemStrokeWidth: number;
-            currentItemStrokeStyle: import("@excalidraw/element/types").StrokeStyle;
+            currentItemStrokeStyle: 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;
@@ -84,26 +88,30 @@ export declare const actionGroup: {
             name: string | null;
             isResizing: boolean;
             isRotating: boolean;
-            zoom: Readonly<{
-                value: import("../types").NormalizedZoomValue;
-            }>;
-            openMenu: "canvas" | "shape" | null;
-            openPopup: "fontFamily" | "canvasBackground" | "elementBackground" | "elementStroke" | "compactTextProperties" | "compactStrokeStyles" | "compactOtherProperties" | "compactArrowProperties" | 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: ExcalidrawElement["id"];
+            } | {
+                name: "charts";
+                data: import("../charts").Spreadsheet;
+                rawText: string;
+            };
             defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("@excalidraw/element/types").PointerType;
             hoveredElementIds: Readonly<{
@@ -115,9 +123,9 @@ export declare const actionGroup: {
             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;
@@ -129,40 +137,13 @@ export declare const actionGroup: {
             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: {
@@ -173,16 +154,16 @@ export declare const actionGroup: {
             userToFollow: import("../types").UserToFollow | null;
             followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
-            croppingElementId: string | null;
+            croppingElementId: ExcalidrawElement["id"] | null;
             searchMatches: Readonly<{
-                focusedId: string | null;
+                focusedId: ExcalidrawElement["id"] | null;
                 matches: readonly import("../types").SearchMatch[];
             }> | null;
             activeLockedId: string | null;
             lockedMultiSelections: {
                 [groupId: string]: true;
             };
-            stylesPanelMode: "compact" | "full";
+            bindMode: import("@excalidraw/element/types").BindMode;
         };
         elements: OrderedExcalidrawElement[];
         captureUpdate: "IMMEDIATELY";
@@ -200,19 +181,15 @@ export declare const actionUngroup: {
     trackEvent: {
         category: "element";
     };
-    perform: (elements: readonly OrderedExcalidrawElement[], appState: Readonly<AppState>, _: any, app: AppClassProperties) => {
+    perform: (elements: readonly OrderedExcalidrawElement[], appState: Readonly<AppState>, _: unknown, app: AppClassProperties) => {
         appState: Readonly<AppState>;
         elements: readonly OrderedExcalidrawElement[];
         captureUpdate: "EVENTUALLY";
     } | {
         appState: {
-            editingGroupId: string | null;
-            selectedElementIds: Readonly<{
-                [id: string]: true;
-            }>;
-            selectedGroupIds: {
-                [groupId: string]: boolean;
-            };
+            editingGroupId: AppState["editingGroupId"];
+            selectedElementIds: AppState["selectedElementIds"];
+            selectedGroupIds: AppState["selectedGroupIds"];
             contextMenu: {
                 items: import("../components/ContextMenu").ContextMenuItems;
                 top: number;
@@ -220,18 +197,23 @@ export declare const actionUngroup: {
             } | 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;
+            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;
@@ -241,12 +223,16 @@ export declare const actionUngroup: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: 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;
@@ -255,19 +241,19 @@ export declare const actionUngroup: {
             exportScale: number;
             currentItemStrokeColor: string;
             currentItemBackgroundColor: string;
-            currentItemFillStyle: import("@excalidraw/element/types").FillStyle;
+            currentItemFillStyle: ExcalidrawElement["fillStyle"];
             currentItemStrokeWidth: number;
-            currentItemStrokeStyle: import("@excalidraw/element/types").StrokeStyle;
+            currentItemStrokeStyle: 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;
@@ -276,26 +262,30 @@ export declare const actionUngroup: {
             name: string | null;
             isResizing: boolean;
             isRotating: boolean;
-            zoom: Readonly<{
-                value: import("../types").NormalizedZoomValue;
-            }>;
-            openMenu: "canvas" | "shape" | null;
-            openPopup: "fontFamily" | "canvasBackground" | "elementBackground" | "elementStroke" | "compactTextProperties" | "compactStrokeStyles" | "compactOtherProperties" | "compactArrowProperties" | 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: ExcalidrawElement["id"];
+            } | {
+                name: "charts";
+                data: import("../charts").Spreadsheet;
+                rawText: string;
+            };
             defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("@excalidraw/element/types").PointerType;
             hoveredElementIds: Readonly<{
@@ -307,9 +297,9 @@ export declare const actionUngroup: {
             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;
@@ -321,40 +311,13 @@ export declare const actionUngroup: {
             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: {
@@ -365,16 +328,16 @@ export declare const actionUngroup: {
             userToFollow: import("../types").UserToFollow | null;
             followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
-            croppingElementId: string | null;
+            croppingElementId: ExcalidrawElement["id"] | null;
             searchMatches: Readonly<{
-                focusedId: string | null;
+                focusedId: ExcalidrawElement["id"] | null;
                 matches: readonly import("../types").SearchMatch[];
             }> | null;
             activeLockedId: string | null;
             lockedMultiSelections: {
                 [groupId: string]: true;
             };
-            stylesPanelMode: "compact" | "full";
+            bindMode: import("@excalidraw/element/types").BindMode;
         };
         elements: OrderedExcalidrawElement[];
         captureUpdate: "IMMEDIATELY";