@nextcloud/excalidraw-common 0.18.0-8fb6b24 → 0.18.0-nc.2

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

@@ -1,5 +1,6 @@
-import type { ExcalidrawElement } from "@nextcloud/excalidraw-element/types";
-import type { AppClassProperties, AppState } from "../types";
+import type { ElementsMap, ExcalidrawElement, ExcalidrawFrameLikeElement, NonDeletedExcalidrawElement } from "@nextcloud/excalidraw-element/types";
+import type { ActionResult } from "./types";
+import type { AppClassProperties, AppState, UIAppState } from "../types";
 export declare const actionSelectAllElementsInFrame: {
     name: "selectAllElementsInFrame";
     label: string;
@@ -19,30 +20,43 @@ export declare const actionSelectAllElementsInFrame: {
             isLoading: boolean;
             errorMessage: React.ReactNode;
             activeEmbeddable: {
-                element: import("@nextcloud/excalidraw-element/types").NonDeletedExcalidrawElement;
+                element: NonDeletedExcalidrawElement;
                 state: "hover" | "active";
             } | null;
             newElement: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawNonSelectionElement> | null;
-            resizingElement: import("@nextcloud/excalidraw-element/types").NonDeletedExcalidrawElement | null;
+            resizingElement: NonDeletedExcalidrawElement | null;
             multiElement: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawLinearElement> | null;
-            selectionElement: import("@nextcloud/excalidraw-element/types").NonDeletedExcalidrawElement | null;
+            selectionElement: NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
+            boxSelectionMode: import("../types").BoxSelectionMode;
             bindingPreference: "enabled" | "disabled";
             isMidpointSnappingEnabled: boolean;
-            startBoundElement: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawBindableElement> | null;
+            showHints: boolean;
+            inputDevice: import("../types").InputDevice;
             suggestedBinding: {
                 element: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawBindableElement>;
                 midPoint?: import("@nextcloud/excalidraw-math").GlobalPoint;
             } | null;
-            frameToHighlight: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawFrameLikeElement> | null;
+            textToolHover: {
+                type: "text";
+                elementId: ExcalidrawElement["id"];
+            } | {
+                type: "container";
+                elementId: ExcalidrawElement["id"];
+            } | {
+                type: "arrow";
+                elementId: import("@nextcloud/excalidraw-element/types").ExcalidrawArrowElement["id"];
+                anchor: "start" | "end" | "label";
+            } | null;
+            frameToHighlight: import("@nextcloud/excalidraw-element/types").NonDeleted<ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
                 name: boolean;
                 outline: boolean;
                 clip: boolean;
             };
-            editingFrame: string | null;
-            elementsToHighlight: import("@nextcloud/excalidraw-element/types").NonDeleted<ExcalidrawElement>[] | null;
+            editingFrame: ExcalidrawFrameLikeElement["id"] | null;
+            elementsToHighlight: readonly NonDeletedExcalidrawElement[] | null;
             editingTextElement: import("@nextcloud/excalidraw-element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
@@ -60,11 +74,14 @@ export declare const actionSelectAllElementsInFrame: {
             exportWithDarkMode: boolean;
             exportScale: number;
             currentItemStrokeColor: string;
+            currentItemStickynoteStrokeColor: string;
+            currentItemStickynoteBackgroundColor: string;
             currentItemBackgroundColor: string;
             currentItemFillStyle: ExcalidrawElement["fillStyle"];
-            currentItemStrokeWidth: number;
+            currentItemStrokeWidthKey: import("@nextcloud/excalidraw-common").StrokeWidthKey;
             currentItemStrokeStyle: ExcalidrawElement["strokeStyle"];
             currentItemRoughness: number;
+            currentItemStrokeVariability: import("@nextcloud/excalidraw-element/types").StrokeVariability;
             currentItemOpacity: number;
             currentItemFontFamily: import("@nextcloud/excalidraw-element/types").FontFamilyValues;
             currentItemFontSize: number;
@@ -77,6 +94,7 @@ export declare const actionSelectAllElementsInFrame: {
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
+            scrollConstraints: import("../types").ScrollConstraints | null;
             cursorButton: "up" | "down";
             scrolledOutside: boolean;
             name: string | null;
@@ -149,8 +167,6 @@ export declare const actionSelectAllElementsInFrame: {
                 y: number;
             } | null;
             objectsSnapModeEnabled: boolean;
-            userToFollow: import("../types").UserToFollow | null;
-            followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
             croppingElementId: ExcalidrawElement["id"] | null;
             searchMatches: Readonly<{
@@ -162,6 +178,14 @@ export declare const actionSelectAllElementsInFrame: {
                 [groupId: string]: true;
             };
             bindMode: import("@nextcloud/excalidraw-element/types").BindMode;
+            colorTopPicks: {
+                elementStroke: readonly string[] | null;
+                elementBackground: readonly string[] | null;
+                bucketFill: readonly string[] | null;
+                stickyNoteStroke: readonly string[] | null;
+                stickyNoteBackground: readonly string[] | null;
+            };
+            fontTopPicks: readonly import("@nextcloud/excalidraw-element/types").FontFamilyValues[] | null;
         };
         captureUpdate: "IMMEDIATELY";
     } | {
@@ -194,30 +218,43 @@ export declare const actionRemoveAllElementsFromFrame: {
             isLoading: boolean;
             errorMessage: React.ReactNode;
             activeEmbeddable: {
-                element: import("@nextcloud/excalidraw-element/types").NonDeletedExcalidrawElement;
+                element: NonDeletedExcalidrawElement;
                 state: "hover" | "active";
             } | null;
             newElement: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawNonSelectionElement> | null;
-            resizingElement: import("@nextcloud/excalidraw-element/types").NonDeletedExcalidrawElement | null;
+            resizingElement: NonDeletedExcalidrawElement | null;
             multiElement: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawLinearElement> | null;
-            selectionElement: import("@nextcloud/excalidraw-element/types").NonDeletedExcalidrawElement | null;
+            selectionElement: NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
+            boxSelectionMode: import("../types").BoxSelectionMode;
             bindingPreference: "enabled" | "disabled";
             isMidpointSnappingEnabled: boolean;
-            startBoundElement: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawBindableElement> | null;
+            showHints: boolean;
+            inputDevice: import("../types").InputDevice;
             suggestedBinding: {
                 element: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawBindableElement>;
                 midPoint?: import("@nextcloud/excalidraw-math").GlobalPoint;
             } | null;
-            frameToHighlight: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawFrameLikeElement> | null;
+            textToolHover: {
+                type: "text";
+                elementId: ExcalidrawElement["id"];
+            } | {
+                type: "container";
+                elementId: ExcalidrawElement["id"];
+            } | {
+                type: "arrow";
+                elementId: import("@nextcloud/excalidraw-element/types").ExcalidrawArrowElement["id"];
+                anchor: "start" | "end" | "label";
+            } | null;
+            frameToHighlight: import("@nextcloud/excalidraw-element/types").NonDeleted<ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
                 name: boolean;
                 outline: boolean;
                 clip: boolean;
             };
-            editingFrame: string | null;
-            elementsToHighlight: import("@nextcloud/excalidraw-element/types").NonDeleted<ExcalidrawElement>[] | null;
+            editingFrame: ExcalidrawFrameLikeElement["id"] | null;
+            elementsToHighlight: readonly NonDeletedExcalidrawElement[] | null;
             editingTextElement: import("@nextcloud/excalidraw-element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
@@ -235,11 +272,14 @@ export declare const actionRemoveAllElementsFromFrame: {
             exportWithDarkMode: boolean;
             exportScale: number;
             currentItemStrokeColor: string;
+            currentItemStickynoteStrokeColor: string;
+            currentItemStickynoteBackgroundColor: string;
             currentItemBackgroundColor: string;
             currentItemFillStyle: ExcalidrawElement["fillStyle"];
-            currentItemStrokeWidth: number;
+            currentItemStrokeWidthKey: import("@nextcloud/excalidraw-common").StrokeWidthKey;
             currentItemStrokeStyle: ExcalidrawElement["strokeStyle"];
             currentItemRoughness: number;
+            currentItemStrokeVariability: import("@nextcloud/excalidraw-element/types").StrokeVariability;
             currentItemOpacity: number;
             currentItemFontFamily: import("@nextcloud/excalidraw-element/types").FontFamilyValues;
             currentItemFontSize: number;
@@ -252,6 +292,7 @@ export declare const actionRemoveAllElementsFromFrame: {
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
+            scrollConstraints: import("../types").ScrollConstraints | null;
             cursorButton: "up" | "down";
             scrolledOutside: boolean;
             name: string | null;
@@ -324,8 +365,6 @@ export declare const actionRemoveAllElementsFromFrame: {
                 y: number;
             } | null;
             objectsSnapModeEnabled: boolean;
-            userToFollow: import("../types").UserToFollow | null;
-            followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
             croppingElementId: ExcalidrawElement["id"] | null;
             searchMatches: Readonly<{
@@ -337,6 +376,14 @@ export declare const actionRemoveAllElementsFromFrame: {
                 [groupId: string]: true;
             };
             bindMode: import("@nextcloud/excalidraw-element/types").BindMode;
+            colorTopPicks: {
+                elementStroke: readonly string[] | null;
+                elementBackground: readonly string[] | null;
+                bucketFill: readonly string[] | null;
+                stickyNoteStroke: readonly string[] | null;
+                stickyNoteBackground: readonly string[] | null;
+            };
+            fontTopPicks: readonly import("@nextcloud/excalidraw-element/types").FontFamilyValues[] | null;
         };
         captureUpdate: "IMMEDIATELY";
     } | {
@@ -373,203 +420,43 @@ export declare const actionupdateFrameRendering: {
             isLoading: boolean;
             errorMessage: React.ReactNode;
             activeEmbeddable: {
-                element: import("@nextcloud/excalidraw-element/types").NonDeletedExcalidrawElement;
+                element: NonDeletedExcalidrawElement;
                 state: "hover" | "active";
             } | null;
             newElement: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawNonSelectionElement> | null;
-            resizingElement: import("@nextcloud/excalidraw-element/types").NonDeletedExcalidrawElement | null;
+            resizingElement: NonDeletedExcalidrawElement | null;
             multiElement: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawLinearElement> | null;
-            selectionElement: import("@nextcloud/excalidraw-element/types").NonDeletedExcalidrawElement | null;
+            selectionElement: NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
+            boxSelectionMode: import("../types").BoxSelectionMode;
             bindingPreference: "enabled" | "disabled";
             isMidpointSnappingEnabled: boolean;
-            startBoundElement: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawBindableElement> | null;
+            showHints: boolean;
+            inputDevice: import("../types").InputDevice;
             suggestedBinding: {
                 element: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawBindableElement>;
                 midPoint?: import("@nextcloud/excalidraw-math").GlobalPoint;
             } | null;
-            frameToHighlight: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawFrameLikeElement> | null;
-            editingFrame: string | null;
-            elementsToHighlight: import("@nextcloud/excalidraw-element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@nextcloud/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;
-            exportEmbedScene: boolean;
-            exportWithDarkMode: boolean;
-            exportScale: number;
-            currentItemStrokeColor: string;
-            currentItemBackgroundColor: string;
-            currentItemFillStyle: ExcalidrawElement["fillStyle"];
-            currentItemStrokeWidth: number;
-            currentItemStrokeStyle: ExcalidrawElement["strokeStyle"];
-            currentItemRoughness: number;
-            currentItemOpacity: number;
-            currentItemFontFamily: import("@nextcloud/excalidraw-element/types").FontFamilyValues;
-            currentItemFontSize: number;
-            currentItemTextAlign: import("@nextcloud/excalidraw-element/types").TextAlign;
-            currentItemStartArrowhead: import("@nextcloud/excalidraw-element/types").Arrowhead | null;
-            currentItemEndArrowhead: import("@nextcloud/excalidraw-element/types").Arrowhead | null;
-            currentHoveredFontFamily: import("@nextcloud/excalidraw-element/types").FontFamilyValues | null;
-            currentItemRoundness: import("@nextcloud/excalidraw-element/types").StrokeRoundness;
-            currentItemArrowType: "sharp" | "round" | "elbow";
-            viewBackgroundColor: string;
-            scrollX: number;
-            scrollY: number;
-            cursorButton: "up" | "down";
-            scrolledOutside: boolean;
-            name: string | null;
-            isResizing: boolean;
-            isRotating: boolean;
-            zoom: import("../types").Zoom;
-            openMenu: "canvas" | null;
-            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | "fontFamily" | "compactTextProperties" | "compactStrokeStyles" | "compactOtherProperties" | "compactArrowProperties" | null;
-            openSidebar: {
-                name: import("../types").SidebarName;
-                tab?: import("../types").SidebarTabName;
-            } | null;
-            openDialog: null | {
-                name: "imageExport" | "help" | "jsonExport";
+            textToolHover: {
+                type: "text";
+                elementId: ExcalidrawElement["id"];
             } | {
-                name: "ttd";
-                tab: "text-to-diagram" | "mermaid";
-            } | {
-                name: "commandPalette";
-            } | {
-                name: "settings";
-            } | {
-                name: "elementLinkSelector";
-                sourceElementId: ExcalidrawElement["id"];
+                type: "container";
+                elementId: ExcalidrawElement["id"];
             } | {
-                name: "charts";
-                data: import("../charts").Spreadsheet;
-                rawText: string;
-            };
-            defaultSidebarDockedPreference: boolean;
-            lastPointerDownWith: import("@nextcloud/excalidraw-element/types").PointerType;
-            selectedElementIds: Readonly<{
-                [id: string]: true;
-            }>;
-            hoveredElementIds: Readonly<{
-                [id: string]: true;
-            }>;
-            previousSelectedElementIds: {
-                [id: string]: true;
-            };
-            selectedElementsAreBeingDragged: boolean;
-            shouldCacheIgnoreZoom: boolean;
-            toast: {
-                message: React.ReactNode;
-                closable?: boolean;
-                duration?: number;
-            } | null;
-            zenModeEnabled: boolean;
-            theme: import("@nextcloud/excalidraw-element/types").Theme;
-            gridSize: number;
-            gridStep: number;
-            gridModeEnabled: boolean;
-            viewModeEnabled: boolean;
-            selectedGroupIds: {
-                [groupId: string]: boolean;
-            };
-            editingGroupId: import("@nextcloud/excalidraw-element/types").GroupId | null;
-            width: number;
-            height: number;
-            offsetTop: number;
-            offsetLeft: number;
-            fileHandle: FileSystemFileHandle | null;
-            collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
-            stats: {
-                open: boolean;
-                panels: number;
-            };
-            showHyperlinkPopup: false | "info" | "editor";
-            selectedLinearElement: import("@nextcloud/excalidraw-element").LinearElementEditor | null;
-            snapLines: readonly import("../snapping").SnapLine[];
-            originSnapOffset: {
-                x: number;
-                y: number;
+                type: "arrow";
+                elementId: import("@nextcloud/excalidraw-element/types").ExcalidrawArrowElement["id"];
+                anchor: "start" | "end" | "label";
             } | null;
-            objectsSnapModeEnabled: boolean;
-            userToFollow: import("../types").UserToFollow | null;
-            followedBy: Set<import("../types").SocketId>;
-            isCropping: boolean;
-            croppingElementId: ExcalidrawElement["id"] | null;
-            searchMatches: Readonly<{
-                focusedId: ExcalidrawElement["id"] | null;
-                matches: readonly import("../types").SearchMatch[];
-            }> | null;
-            activeLockedId: string | null;
-            lockedMultiSelections: {
-                [groupId: string]: true;
-            };
-            bindMode: import("@nextcloud/excalidraw-element/types").BindMode;
-        };
-        captureUpdate: "EVENTUALLY";
-    };
-    checked: (appState: AppState) => boolean;
-} & {
-    keyTest?: undefined;
-};
-export declare const actionSetFrameAsActiveTool: {
-    name: "setFrameAsActiveTool";
-    label: string;
-    trackEvent: {
-        category: "toolbar";
-    };
-    icon: import("react/jsx-runtime").JSX.Element;
-    viewMode: false;
-    perform: (elements: readonly import("@nextcloud/excalidraw-element/types").OrderedExcalidrawElement[], appState: Readonly<AppState>, _: unknown, app: AppClassProperties) => {
-        elements: readonly import("@nextcloud/excalidraw-element/types").OrderedExcalidrawElement[];
-        appState: {
+            frameToHighlight: import("@nextcloud/excalidraw-element/types").NonDeleted<ExcalidrawFrameLikeElement> | null;
+            editingFrame: ExcalidrawFrameLikeElement["id"] | null;
+            elementsToHighlight: readonly NonDeletedExcalidrawElement[] | null;
+            editingTextElement: import("@nextcloud/excalidraw-element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
                 fromSelection: boolean;
             } & import("../types").ActiveTool;
-            contextMenu: {
-                items: import("../components/ContextMenu").ContextMenuItems;
-                top: number;
-                left: number;
-            } | null;
-            showWelcomeScreen: boolean;
-            isLoading: boolean;
-            errorMessage: React.ReactNode;
-            activeEmbeddable: {
-                element: import("@nextcloud/excalidraw-element/types").NonDeletedExcalidrawElement;
-                state: "hover" | "active";
-            } | null;
-            newElement: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawNonSelectionElement> | null;
-            resizingElement: import("@nextcloud/excalidraw-element/types").NonDeletedExcalidrawElement | null;
-            multiElement: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawLinearElement> | null;
-            selectionElement: import("@nextcloud/excalidraw-element/types").NonDeletedExcalidrawElement | null;
-            isBindingEnabled: boolean;
-            bindingPreference: "enabled" | "disabled";
-            isMidpointSnappingEnabled: boolean;
-            startBoundElement: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawBindableElement> | null;
-            suggestedBinding: {
-                element: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawBindableElement>;
-                midPoint?: import("@nextcloud/excalidraw-math").GlobalPoint;
-            } | null;
-            frameToHighlight: import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawFrameLikeElement> | null;
-            frameRendering: {
-                enabled: boolean;
-                name: boolean;
-                outline: boolean;
-                clip: boolean;
-            };
-            editingFrame: string | null;
-            elementsToHighlight: import("@nextcloud/excalidraw-element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@nextcloud/excalidraw-element/types").ExcalidrawTextElement | null;
             preferredSelectionTool: {
                 type: "selection" | "lasso";
                 initialized: boolean;
@@ -581,11 +468,14 @@ export declare const actionSetFrameAsActiveTool: {
             exportWithDarkMode: boolean;
             exportScale: number;
             currentItemStrokeColor: string;
+            currentItemStickynoteStrokeColor: string;
+            currentItemStickynoteBackgroundColor: string;
             currentItemBackgroundColor: string;
             currentItemFillStyle: ExcalidrawElement["fillStyle"];
-            currentItemStrokeWidth: number;
+            currentItemStrokeWidthKey: import("@nextcloud/excalidraw-common").StrokeWidthKey;
             currentItemStrokeStyle: ExcalidrawElement["strokeStyle"];
             currentItemRoughness: number;
+            currentItemStrokeVariability: import("@nextcloud/excalidraw-element/types").StrokeVariability;
             currentItemOpacity: number;
             currentItemFontFamily: import("@nextcloud/excalidraw-element/types").FontFamilyValues;
             currentItemFontSize: number;
@@ -598,6 +488,7 @@ export declare const actionSetFrameAsActiveTool: {
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
+            scrollConstraints: import("../types").ScrollConstraints | null;
             cursorButton: "up" | "down";
             scrolledOutside: boolean;
             name: string | null;
@@ -673,8 +564,6 @@ export declare const actionSetFrameAsActiveTool: {
                 y: number;
             } | null;
             objectsSnapModeEnabled: boolean;
-            userToFollow: import("../types").UserToFollow | null;
-            followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
             croppingElementId: ExcalidrawElement["id"] | null;
             searchMatches: Readonly<{
@@ -686,465 +575,39 @@ export declare const actionSetFrameAsActiveTool: {
                 [groupId: string]: true;
             };
             bindMode: import("@nextcloud/excalidraw-element/types").BindMode;
+            colorTopPicks: {
+                elementStroke: readonly string[] | null;
+                elementBackground: readonly string[] | null;
+                bucketFill: readonly string[] | null;
+                stickyNoteStroke: readonly string[] | null;
+                stickyNoteBackground: readonly string[] | null;
+            };
+            fontTopPicks: readonly import("@nextcloud/excalidraw-element/types").FontFamilyValues[] | null;
         };
         captureUpdate: "EVENTUALLY";
     };
-    keyTest: (event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean;
+    checked: (appState: Readonly<UIAppState>) => boolean;
 } & {
-    keyTest?: ((event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean) | undefined;
+    keyTest?: undefined;
 };
+/**
+ * The frame that wrapping the selection removes instead: the one frame the
+ * selection holds (along with any of its children), or, with no frame
+ * selected, the frame whose children are all selected.
+ */
+export declare const getFrameToUnwrap: (selectedElements: readonly ExcalidrawElement[], elementsMap: ElementsMap) => ExcalidrawFrameLikeElement | null;
+/** removes the frame, keeping its children selected in its place */
+export declare const unwrapFrame: (elements: readonly ExcalidrawElement[], appState: AppState, frame: ExcalidrawFrameLikeElement, app: AppClassProperties) => ActionResult;
+/** wraps the selection in a new frame — edge to edge when it's an image */
+export declare const wrapInFrame: (elements: readonly ExcalidrawElement[], appState: AppState, selectedElements: NonDeletedExcalidrawElement[], app: AppClassProperties) => ActionResult;
 export declare const actionWrapSelectionInFrame: {
     name: "wrapSelectionInFrame";
-    label: string;
+    label: (elements: readonly ExcalidrawElement[], appState: Readonly<UIAppState>, app: AppClassProperties) => "labels.removeFrame" | "labels.wrapSelectionInFrame";
     trackEvent: {
         category: "element";
     };
     predicate: (elements: readonly ExcalidrawElement[], appState: AppState, _: import("../types").ExcalidrawProps, app: AppClassProperties) => boolean;
-    perform: (elements: readonly import("@nextcloud/excalidraw-element/types").OrderedExcalidrawElement[], appState: Readonly<AppState>, _: unknown, app: AppClassProperties) => {
-        elements: ((Readonly<{
-            id: string;
-            x: number;
-            y: number;
-            strokeColor: string;
-            backgroundColor: string;
-            fillStyle: import("@nextcloud/excalidraw-element/types").FillStyle;
-            strokeWidth: number;
-            strokeStyle: import("@nextcloud/excalidraw-element/types").StrokeStyle;
-            roundness: null | {
-                type: import("@nextcloud/excalidraw-element/types").RoundnessType;
-                value?: number;
-            };
-            roughness: number;
-            opacity: number;
-            width: number;
-            height: number;
-            angle: import("@nextcloud/excalidraw-math").Radians;
-            seed: number;
-            version: number;
-            versionNonce: number;
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex | null;
-            isDeleted: boolean;
-            groupIds: readonly import("@nextcloud/excalidraw-element/types").GroupId[];
-            frameId: string | null;
-            boundElements: readonly import("@nextcloud/excalidraw-element/types").BoundElement[] | null;
-            updated: number;
-            link: string | null;
-            locked: boolean;
-            customData?: Record<string, any>;
-        }> & Readonly<{
-            type: "line" | "arrow";
-            points: readonly import("@nextcloud/excalidraw-math").LocalPoint[];
-            startBinding: import("@nextcloud/excalidraw-element/types").FixedPointBinding | null;
-            endBinding: import("@nextcloud/excalidraw-element/types").FixedPointBinding | null;
-            startArrowhead: import("@nextcloud/excalidraw-element/types").Arrowhead | null;
-            endArrowhead: import("@nextcloud/excalidraw-element/types").Arrowhead | null;
-        }> & {
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex;
-        }) | (Readonly<{
-            id: string;
-            x: number;
-            y: number;
-            strokeColor: string;
-            backgroundColor: string;
-            fillStyle: import("@nextcloud/excalidraw-element/types").FillStyle;
-            strokeWidth: number;
-            strokeStyle: import("@nextcloud/excalidraw-element/types").StrokeStyle;
-            roundness: null | {
-                type: import("@nextcloud/excalidraw-element/types").RoundnessType;
-                value?: number;
-            };
-            roughness: number;
-            opacity: number;
-            width: number;
-            height: number;
-            angle: import("@nextcloud/excalidraw-math").Radians;
-            seed: number;
-            version: number;
-            versionNonce: number;
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex | null;
-            isDeleted: boolean;
-            groupIds: readonly import("@nextcloud/excalidraw-element/types").GroupId[];
-            frameId: string | null;
-            boundElements: readonly import("@nextcloud/excalidraw-element/types").BoundElement[] | null;
-            updated: number;
-            link: string | null;
-            locked: boolean;
-            customData?: Record<string, any>;
-        }> & {
-            type: "selection";
-        } & {
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex;
-        }) | (Readonly<{
-            id: string;
-            x: number;
-            y: number;
-            strokeColor: string;
-            backgroundColor: string;
-            fillStyle: import("@nextcloud/excalidraw-element/types").FillStyle;
-            strokeWidth: number;
-            strokeStyle: import("@nextcloud/excalidraw-element/types").StrokeStyle;
-            roundness: null | {
-                type: import("@nextcloud/excalidraw-element/types").RoundnessType;
-                value?: number;
-            };
-            roughness: number;
-            opacity: number;
-            width: number;
-            height: number;
-            angle: import("@nextcloud/excalidraw-math").Radians;
-            seed: number;
-            version: number;
-            versionNonce: number;
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex | null;
-            isDeleted: boolean;
-            groupIds: readonly import("@nextcloud/excalidraw-element/types").GroupId[];
-            frameId: string | null;
-            boundElements: readonly import("@nextcloud/excalidraw-element/types").BoundElement[] | null;
-            updated: number;
-            link: string | null;
-            locked: boolean;
-            customData?: Record<string, any>;
-        }> & {
-            type: "rectangle";
-        } & {
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex;
-        }) | (Readonly<{
-            id: string;
-            x: number;
-            y: number;
-            strokeColor: string;
-            backgroundColor: string;
-            fillStyle: import("@nextcloud/excalidraw-element/types").FillStyle;
-            strokeWidth: number;
-            strokeStyle: import("@nextcloud/excalidraw-element/types").StrokeStyle;
-            roundness: null | {
-                type: import("@nextcloud/excalidraw-element/types").RoundnessType;
-                value?: number;
-            };
-            roughness: number;
-            opacity: number;
-            width: number;
-            height: number;
-            angle: import("@nextcloud/excalidraw-math").Radians;
-            seed: number;
-            version: number;
-            versionNonce: number;
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex | null;
-            isDeleted: boolean;
-            groupIds: readonly import("@nextcloud/excalidraw-element/types").GroupId[];
-            frameId: string | null;
-            boundElements: readonly import("@nextcloud/excalidraw-element/types").BoundElement[] | null;
-            updated: number;
-            link: string | null;
-            locked: boolean;
-            customData?: Record<string, any>;
-        }> & {
-            type: "diamond";
-        } & {
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex;
-        }) | (Readonly<{
-            id: string;
-            x: number;
-            y: number;
-            strokeColor: string;
-            backgroundColor: string;
-            fillStyle: import("@nextcloud/excalidraw-element/types").FillStyle;
-            strokeWidth: number;
-            strokeStyle: import("@nextcloud/excalidraw-element/types").StrokeStyle;
-            roundness: null | {
-                type: import("@nextcloud/excalidraw-element/types").RoundnessType;
-                value?: number;
-            };
-            roughness: number;
-            opacity: number;
-            width: number;
-            height: number;
-            angle: import("@nextcloud/excalidraw-math").Radians;
-            seed: number;
-            version: number;
-            versionNonce: number;
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex | null;
-            isDeleted: boolean;
-            groupIds: readonly import("@nextcloud/excalidraw-element/types").GroupId[];
-            frameId: string | null;
-            boundElements: readonly import("@nextcloud/excalidraw-element/types").BoundElement[] | null;
-            updated: number;
-            link: string | null;
-            locked: boolean;
-            customData?: Record<string, any>;
-        }> & {
-            type: "ellipse";
-        } & {
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex;
-        }) | (Readonly<{
-            id: string;
-            x: number;
-            y: number;
-            strokeColor: string;
-            backgroundColor: string;
-            fillStyle: import("@nextcloud/excalidraw-element/types").FillStyle;
-            strokeWidth: number;
-            strokeStyle: import("@nextcloud/excalidraw-element/types").StrokeStyle;
-            roundness: null | {
-                type: import("@nextcloud/excalidraw-element/types").RoundnessType;
-                value?: number;
-            };
-            roughness: number;
-            opacity: number;
-            width: number;
-            height: number;
-            angle: import("@nextcloud/excalidraw-math").Radians;
-            seed: number;
-            version: number;
-            versionNonce: number;
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex | null;
-            isDeleted: boolean;
-            groupIds: readonly import("@nextcloud/excalidraw-element/types").GroupId[];
-            frameId: string | null;
-            boundElements: readonly import("@nextcloud/excalidraw-element/types").BoundElement[] | null;
-            updated: number;
-            link: string | null;
-            locked: boolean;
-            customData?: Record<string, any>;
-        }> & Readonly<{
-            type: "embeddable";
-        }> & {
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex;
-        }) | (Readonly<{
-            id: string;
-            x: number;
-            y: number;
-            strokeColor: string;
-            backgroundColor: string;
-            fillStyle: import("@nextcloud/excalidraw-element/types").FillStyle;
-            strokeWidth: number;
-            strokeStyle: import("@nextcloud/excalidraw-element/types").StrokeStyle;
-            roundness: null | {
-                type: import("@nextcloud/excalidraw-element/types").RoundnessType;
-                value?: number;
-            };
-            roughness: number;
-            opacity: number;
-            width: number;
-            height: number;
-            angle: import("@nextcloud/excalidraw-math").Radians;
-            seed: number;
-            version: number;
-            versionNonce: number;
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex | null;
-            isDeleted: boolean;
-            groupIds: readonly import("@nextcloud/excalidraw-element/types").GroupId[];
-            frameId: string | null;
-            boundElements: readonly import("@nextcloud/excalidraw-element/types").BoundElement[] | null;
-            updated: number;
-            link: string | null;
-            locked: boolean;
-            customData?: Record<string, any>;
-        }> & Readonly<{
-            type: "iframe";
-            customData?: {
-                generationData?: import("@nextcloud/excalidraw-element/types").MagicGenerationData;
-            };
-        }> & {
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex;
-        }) | (Readonly<{
-            id: string;
-            x: number;
-            y: number;
-            strokeColor: string;
-            backgroundColor: string;
-            fillStyle: import("@nextcloud/excalidraw-element/types").FillStyle;
-            strokeWidth: number;
-            strokeStyle: import("@nextcloud/excalidraw-element/types").StrokeStyle;
-            roundness: null | {
-                type: import("@nextcloud/excalidraw-element/types").RoundnessType;
-                value?: number;
-            };
-            roughness: number;
-            opacity: number;
-            width: number;
-            height: number;
-            angle: import("@nextcloud/excalidraw-math").Radians;
-            seed: number;
-            version: number;
-            versionNonce: number;
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex | null;
-            isDeleted: boolean;
-            groupIds: readonly import("@nextcloud/excalidraw-element/types").GroupId[];
-            frameId: string | null;
-            boundElements: readonly import("@nextcloud/excalidraw-element/types").BoundElement[] | null;
-            updated: number;
-            link: string | null;
-            locked: boolean;
-            customData?: Record<string, any>;
-        }> & Readonly<{
-            type: "image";
-            fileId: import("@nextcloud/excalidraw-element/types").FileId | null;
-            status: "pending" | "saved" | "error";
-            scale: [number, number];
-            crop: import("@nextcloud/excalidraw-element/types").ImageCrop | null;
-        }> & {
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex;
-        }) | (Readonly<{
-            id: string;
-            x: number;
-            y: number;
-            strokeColor: string;
-            backgroundColor: string;
-            fillStyle: import("@nextcloud/excalidraw-element/types").FillStyle;
-            strokeWidth: number;
-            strokeStyle: import("@nextcloud/excalidraw-element/types").StrokeStyle;
-            roundness: null | {
-                type: import("@nextcloud/excalidraw-element/types").RoundnessType;
-                value?: number;
-            };
-            roughness: number;
-            opacity: number;
-            width: number;
-            height: number;
-            angle: import("@nextcloud/excalidraw-math").Radians;
-            seed: number;
-            version: number;
-            versionNonce: number;
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex | null;
-            isDeleted: boolean;
-            groupIds: readonly import("@nextcloud/excalidraw-element/types").GroupId[];
-            frameId: string | null;
-            boundElements: readonly import("@nextcloud/excalidraw-element/types").BoundElement[] | null;
-            updated: number;
-            link: string | null;
-            locked: boolean;
-            customData?: Record<string, any>;
-        }> & {
-            type: "frame";
-            name: string | null;
-        } & {
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex;
-        }) | (Readonly<{
-            id: string;
-            x: number;
-            y: number;
-            strokeColor: string;
-            backgroundColor: string;
-            fillStyle: import("@nextcloud/excalidraw-element/types").FillStyle;
-            strokeWidth: number;
-            strokeStyle: import("@nextcloud/excalidraw-element/types").StrokeStyle;
-            roundness: null | {
-                type: import("@nextcloud/excalidraw-element/types").RoundnessType;
-                value?: number;
-            };
-            roughness: number;
-            opacity: number;
-            width: number;
-            height: number;
-            angle: import("@nextcloud/excalidraw-math").Radians;
-            seed: number;
-            version: number;
-            versionNonce: number;
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex | null;
-            isDeleted: boolean;
-            groupIds: readonly import("@nextcloud/excalidraw-element/types").GroupId[];
-            frameId: string | null;
-            boundElements: readonly import("@nextcloud/excalidraw-element/types").BoundElement[] | null;
-            updated: number;
-            link: string | null;
-            locked: boolean;
-            customData?: Record<string, any>;
-        }> & {
-            type: "magicframe";
-            name: string | null;
-        } & {
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex;
-        }) | (Readonly<{
-            id: string;
-            x: number;
-            y: number;
-            strokeColor: string;
-            backgroundColor: string;
-            fillStyle: import("@nextcloud/excalidraw-element/types").FillStyle;
-            strokeWidth: number;
-            strokeStyle: import("@nextcloud/excalidraw-element/types").StrokeStyle;
-            roundness: null | {
-                type: import("@nextcloud/excalidraw-element/types").RoundnessType;
-                value?: number;
-            };
-            roughness: number;
-            opacity: number;
-            width: number;
-            height: number;
-            angle: import("@nextcloud/excalidraw-math").Radians;
-            seed: number;
-            version: number;
-            versionNonce: number;
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex | null;
-            isDeleted: boolean;
-            groupIds: readonly import("@nextcloud/excalidraw-element/types").GroupId[];
-            frameId: string | null;
-            boundElements: readonly import("@nextcloud/excalidraw-element/types").BoundElement[] | null;
-            updated: number;
-            link: string | null;
-            locked: boolean;
-            customData?: Record<string, any>;
-        }> & Readonly<{
-            type: "text";
-            fontSize: number;
-            fontFamily: import("@nextcloud/excalidraw-element/types").FontFamilyValues;
-            text: string;
-            textAlign: import("@nextcloud/excalidraw-element/types").TextAlign;
-            verticalAlign: import("@nextcloud/excalidraw-element/types").VerticalAlign;
-            containerId: import("@nextcloud/excalidraw-element/types").ExcalidrawGenericElement["id"] | null;
-            originalText: string;
-            autoResize: boolean;
-            lineHeight: number & {
-                _brand: "unitlessLineHeight";
-            };
-        }> & {
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex;
-        }) | (Readonly<{
-            id: string;
-            x: number;
-            y: number;
-            strokeColor: string;
-            backgroundColor: string;
-            fillStyle: import("@nextcloud/excalidraw-element/types").FillStyle;
-            strokeWidth: number;
-            strokeStyle: import("@nextcloud/excalidraw-element/types").StrokeStyle;
-            roundness: null | {
-                type: import("@nextcloud/excalidraw-element/types").RoundnessType;
-                value?: number;
-            };
-            roughness: number;
-            opacity: number;
-            width: number;
-            height: number;
-            angle: import("@nextcloud/excalidraw-math").Radians;
-            seed: number;
-            version: number;
-            versionNonce: number;
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex | null;
-            isDeleted: boolean;
-            groupIds: readonly import("@nextcloud/excalidraw-element/types").GroupId[];
-            frameId: string | null;
-            boundElements: readonly import("@nextcloud/excalidraw-element/types").BoundElement[] | null;
-            updated: number;
-            link: string | null;
-            locked: boolean;
-            customData?: Record<string, any>;
-        }> & Readonly<{
-            type: "freedraw";
-            points: readonly import("@nextcloud/excalidraw-math").LocalPoint[];
-            pressures: readonly number[];
-            simulatePressure: boolean;
-        }> & {
-            index: import("@nextcloud/excalidraw-element/types").FractionalIndex;
-        }) | import("@nextcloud/excalidraw-element/types").NonDeleted<import("@nextcloud/excalidraw-element/types").ExcalidrawFrameElement>)[];
-        appState: {
-            selectedElementIds: {
-                [x: string]: true;
-            };
-        };
-        captureUpdate: "IMMEDIATELY";
-    };
+    perform: (elements: readonly import("@nextcloud/excalidraw-element/types").OrderedExcalidrawElement[], appState: Readonly<AppState>, _: unknown, app: AppClassProperties) => ActionResult;
 } & {
     keyTest?: undefined;
 };