@excalidraw/element 0.18.0-4872083 → 0.18.0-4ce38fb

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

@@ -0,0 +1,197 @@
+export declare const actionToggleShowHints: {
+    name: "showHints";
+    label: string;
+    icon: import("react/jsx-runtime").JSX.Element;
+    keywords: string[];
+    viewMode: false;
+    trackEvent: {
+        category: "canvas";
+        predicate: (appState: Readonly<import("../types").AppState>) => boolean;
+    };
+    perform(elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<import("../types").AppState>): {
+        appState: {
+            showHints: boolean;
+            contextMenu: {
+                items: import("../components/ContextMenu").ContextMenuItems;
+                top: number;
+                left: number;
+            } | null;
+            showWelcomeScreen: boolean;
+            isLoading: boolean;
+            errorMessage: React.ReactNode;
+            activeEmbeddable: {
+                element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
+                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;
+            inputDevice: import("../types").InputDevice;
+            suggestedBinding: {
+                element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
+                midPoint?: import("@excalidraw/math").GlobalPoint;
+            } | null;
+            textToolHover: {
+                type: "text";
+                elementId: import("@excalidraw/element/types").ExcalidrawElement["id"];
+            } | {
+                type: "container";
+                elementId: import("@excalidraw/element/types").ExcalidrawElement["id"];
+            } | {
+                type: "arrow";
+                elementId: import("@excalidraw/element/types").ExcalidrawArrowElement["id"];
+                anchor: "start" | "end" | "label";
+            } | null;
+            frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
+            frameRendering: {
+                enabled: boolean;
+                name: boolean;
+                outline: boolean;
+                clip: boolean;
+            };
+            editingFrame: import("@excalidraw/element/types").ExcalidrawFrameLikeElement["id"] | null;
+            elementsToHighlight: readonly import("@excalidraw/element/types").NonDeletedExcalidrawElement[] | 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;
+            exportEmbedScene: boolean;
+            exportWithDarkMode: boolean;
+            exportScale: number;
+            currentItemStrokeColor: string;
+            currentItemStickynoteStrokeColor: string;
+            currentItemStickynoteBackgroundColor: string;
+            currentItemBackgroundColor: string;
+            currentItemFillStyle: import("@excalidraw/element/types").ExcalidrawElement["fillStyle"];
+            currentItemStrokeWidthKey: import("@excalidraw/common").StrokeWidthKey;
+            currentItemStrokeStyle: import("@excalidraw/element/types").ExcalidrawElement["strokeStyle"];
+            currentItemRoughness: number;
+            currentItemStrokeVariability: import("@excalidraw/element/types").StrokeVariability;
+            currentItemOpacity: number;
+            currentItemFontFamily: import("@excalidraw/element/types").FontFamilyValues;
+            currentItemFontSize: number;
+            currentItemTextAlign: import("@excalidraw/element/types").TextAlign;
+            currentItemStartArrowhead: import("@excalidraw/element/types").Arrowhead | null;
+            currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
+            currentHoveredFontFamily: import("@excalidraw/element/types").FontFamilyValues | null;
+            currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
+            currentItemArrowType: "sharp" | "round" | "elbow";
+            viewBackgroundColor: string;
+            scrollX: number;
+            scrollY: number;
+            scrollConstraints: import("../types").ScrollConstraints | null;
+            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";
+            } | {
+                name: "ttd";
+                tab: "text-to-diagram" | "mermaid";
+            } | {
+                name: "commandPalette";
+            } | {
+                name: "settings";
+            } | {
+                name: "elementLinkSelector";
+                sourceElementId: import("@excalidraw/element/types").ExcalidrawElement["id"];
+            } | {
+                name: "charts";
+                data: import("../charts").Spreadsheet;
+                rawText: string;
+            };
+            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: React.ReactNode;
+                closable?: boolean;
+                duration?: number;
+            } | null;
+            zenModeEnabled: boolean;
+            theme: import("@excalidraw/element/types").Theme;
+            gridSize: number;
+            gridStep: number;
+            gridModeEnabled: boolean;
+            viewModeEnabled: boolean;
+            selectedGroupIds: {
+                [groupId: string]: boolean;
+            };
+            editingGroupId: import("@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("@excalidraw/element").LinearElementEditor | null;
+            snapLines: readonly import("../snapping").SnapLine[];
+            originSnapOffset: {
+                x: number;
+                y: number;
+            } | null;
+            objectsSnapModeEnabled: boolean;
+            isCropping: boolean;
+            croppingElementId: import("@excalidraw/element/types").ExcalidrawElement["id"] | null;
+            searchMatches: Readonly<{
+                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;
+            colorTopPicks: {
+                elementStroke: readonly string[] | null;
+                elementBackground: readonly string[] | null;
+                bucketFill: readonly string[] | null;
+                stickyNoteStroke: readonly string[] | null;
+                stickyNoteBackground: readonly string[] | null;
+            };
+            fontTopPicks: readonly import("@excalidraw/element/types").FontFamilyValues[] | null;
+        };
+        captureUpdate: "NEVER";
+    };
+    checked: (appState: Readonly<import("../types").UIAppState>) => boolean;
+} & {
+    keyTest?: undefined;
+};

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

@@ -33,11 +33,20 @@ export declare const actionToggleStats: {
             boxSelectionMode: import("../types").BoxSelectionMode;
             bindingPreference: "enabled" | "disabled";
             isMidpointSnappingEnabled: boolean;
+            showHints: boolean;
+            inputDevice: import("../types").InputDevice;
             suggestedBinding: {
                 element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
                 midPoint?: import("@excalidraw/math").GlobalPoint;
             } | null;
-            hoveredArrowTextAnchor: {
+            textToolHover: {
+                type: "text";
+                elementId: import("@excalidraw/element/types").ExcalidrawElement["id"];
+            } | {
+                type: "container";
+                elementId: import("@excalidraw/element/types").ExcalidrawElement["id"];
+            } | {
+                type: "arrow";
                 elementId: import("@excalidraw/element/types").ExcalidrawArrowElement["id"];
                 anchor: "start" | "end" | "label";
             } | null;
@@ -67,6 +76,8 @@ export declare const actionToggleStats: {
             exportWithDarkMode: boolean;
             exportScale: number;
             currentItemStrokeColor: string;
+            currentItemStickynoteStrokeColor: string;
+            currentItemStickynoteBackgroundColor: string;
             currentItemBackgroundColor: string;
             currentItemFillStyle: import("@excalidraw/element/types").ExcalidrawElement["fillStyle"];
             currentItemStrokeWidthKey: import("@excalidraw/common").StrokeWidthKey;
@@ -168,6 +179,14 @@ export declare const actionToggleStats: {
                 [groupId: string]: true;
             };
             bindMode: import("@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("@excalidraw/element/types").FontFamilyValues[] | null;
         };
         captureUpdate: "EVENTUALLY";
     };

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

@@ -30,11 +30,20 @@ export declare const actionToggleViewMode: {
             boxSelectionMode: import("../types").BoxSelectionMode;
             bindingPreference: "enabled" | "disabled";
             isMidpointSnappingEnabled: boolean;
+            showHints: boolean;
+            inputDevice: import("../types").InputDevice;
             suggestedBinding: {
                 element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
                 midPoint?: import("@excalidraw/math").GlobalPoint;
             } | null;
-            hoveredArrowTextAnchor: {
+            textToolHover: {
+                type: "text";
+                elementId: import("@excalidraw/element/types").ExcalidrawElement["id"];
+            } | {
+                type: "container";
+                elementId: import("@excalidraw/element/types").ExcalidrawElement["id"];
+            } | {
+                type: "arrow";
                 elementId: import("@excalidraw/element/types").ExcalidrawArrowElement["id"];
                 anchor: "start" | "end" | "label";
             } | null;
@@ -64,6 +73,8 @@ export declare const actionToggleViewMode: {
             exportWithDarkMode: boolean;
             exportScale: number;
             currentItemStrokeColor: string;
+            currentItemStickynoteStrokeColor: string;
+            currentItemStickynoteBackgroundColor: string;
             currentItemBackgroundColor: string;
             currentItemFillStyle: import("@excalidraw/element/types").ExcalidrawElement["fillStyle"];
             currentItemStrokeWidthKey: import("@excalidraw/common").StrokeWidthKey;
@@ -168,6 +179,14 @@ export declare const actionToggleViewMode: {
                 [groupId: string]: true;
             };
             bindMode: import("@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("@excalidraw/element/types").FontFamilyValues[] | null;
         };
         captureUpdate: "EVENTUALLY";
     };

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

@@ -30,11 +30,20 @@ export declare const actionToggleZenMode: {
             boxSelectionMode: import("../types").BoxSelectionMode;
             bindingPreference: "enabled" | "disabled";
             isMidpointSnappingEnabled: boolean;
+            showHints: boolean;
+            inputDevice: import("../types").InputDevice;
             suggestedBinding: {
                 element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
                 midPoint?: import("@excalidraw/math").GlobalPoint;
             } | null;
-            hoveredArrowTextAnchor: {
+            textToolHover: {
+                type: "text";
+                elementId: import("@excalidraw/element/types").ExcalidrawElement["id"];
+            } | {
+                type: "container";
+                elementId: import("@excalidraw/element/types").ExcalidrawElement["id"];
+            } | {
+                type: "arrow";
                 elementId: import("@excalidraw/element/types").ExcalidrawArrowElement["id"];
                 anchor: "start" | "end" | "label";
             } | null;
@@ -64,6 +73,8 @@ export declare const actionToggleZenMode: {
             exportWithDarkMode: boolean;
             exportScale: number;
             currentItemStrokeColor: string;
+            currentItemStickynoteStrokeColor: string;
+            currentItemStickynoteBackgroundColor: string;
             currentItemBackgroundColor: string;
             currentItemFillStyle: import("@excalidraw/element/types").ExcalidrawElement["fillStyle"];
             currentItemStrokeWidthKey: import("@excalidraw/common").StrokeWidthKey;
@@ -168,6 +179,14 @@ export declare const actionToggleZenMode: {
                 [groupId: string]: true;
             };
             bindMode: import("@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("@excalidraw/element/types").FontFamilyValues[] | null;
         };
         captureUpdate: "EVENTUALLY";
     };

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

@@ -0,0 +1,39 @@
+import type { ColorPaletteCustom, ColorTuple } from "@excalidraw/common";
+import type { ExcalidrawElement } from "@excalidraw/element/types";
+import type { AppState } from "../types";
+export type ColorProperty = "strokeColor" | "backgroundColor";
+/**
+ * Sticky notes are their own color domain: own defaults, own top picks, no
+ * transparent. A pick targets the regular domain, the sticky domain, or both
+ * ("mixed" selections write both defaults and use the regular picker).
+ */
+export type ColorTargetKind = "regular" | "sticky" | "mixed";
+export type ColorDefaultKey = "currentItemStrokeColor" | "currentItemBackgroundColor" | "currentItemStickynoteStrokeColor" | "currentItemStickynoteBackgroundColor";
+export type ColorTargetAppState = Pick<AppState, "selectedElementIds" | "editingTextElement" | "activeTool" | ColorDefaultKey>;
+export type ColorTarget = {
+    kind: ColorTargetKind;
+    property: ColorProperty;
+    /** the current-item defaults a pick is written to (normalized per domain) */
+    appStateKeys: readonly ColorDefaultKey[];
+    /** the default shown when no element is targeted */
+    currentValue: string;
+    palette: ColorPaletteCustom;
+    topPicks: ColorTuple;
+    customizableTopPicks: keyof AppState["colorTopPicks"];
+    excludedColors: readonly string[] | undefined;
+};
+/**
+ * Who a stroke/background pick targets. Resolve it from the state an action
+ * runs against, at execution time — never capture it in a render closure:
+ * the memoized picker keeps a stale `onChange`, and the always-visible top
+ * picks fire it without a re-render.
+ *
+ * Targets are the selected color-capable elements (for stroke incl. bound
+ * labels, since a note's visible text is its label) plus the text being
+ * edited (`handleTextWysiwyg` deselects while editing) — or, for a
+ * background pick on a note's label, the note (see `getColorTargetElement`).
+ * With no target, the active tool decides the domain.
+ */
+export declare const resolveColorTarget: (appState: ColorTargetAppState, elements: readonly ExcalidrawElement[], property: ColorProperty) => ColorTarget;
+/** the current-item default updates for a picked color */
+export declare const getColorTargetAppStateUpdates: (target: ColorTarget, color: string) => Partial<AppState>;

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

@@ -21,6 +21,7 @@ export { actionToggleZenMode } from "./actionToggleZenMode";
 export { actionToggleObjectsSnapMode } from "./actionToggleObjectsSnapMode";
 export { actionToggleArrowBinding } from "./actionToggleArrowBinding";
 export { actionToggleMidpointSnapping } from "./actionToggleMidpointSnapping";
+export { actionToggleShowHints } from "./actionToggleShowHints";
 export { actionToggleStats } from "./actionToggleStats";
 export { actionUnbindText, actionBindText } from "./actionBoundText";
 export { actionLink } from "./actionLink";

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

@@ -14,7 +14,7 @@ export type ActionResult = {
 type ActionFn<TData = any> = (elements: readonly OrderedExcalidrawElement[], appState: Readonly<AppState>, formData: TData | undefined, app: AppClassProperties) => ActionResult | Promise<ActionResult>;
 export type UpdaterFn = (res: ActionResult) => void;
 export type ActionFilterFn = (action: Action) => void;
-export type ActionName = "copy" | "cut" | "paste" | "copyAsPng" | "copyAsSvg" | "copyText" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyStyles" | "selectAll" | "pasteStyles" | "gridMode" | "zenMode" | "objectsSnapMode" | "arrowBinding" | "midpointSnapping" | "stats" | "changeStrokeColor" | "changeBackgroundColor" | "changeBucketFillBackgroundColor" | "changeFillStyle" | "changeStrokeWidth" | "changeSloppiness" | "changeFreedrawMode" | "changeStrokeStyle" | "changeArrowhead" | "changeArrowType" | "changeArrowProperties" | "changeOpacity" | "changeFontSize" | "undo" | "redo" | "finalize" | "changeProjectName" | "changeExportBackground" | "changeExportEmbedScene" | "changeExportScale" | "saveToActiveFile" | "saveFileToDisk" | "loadScene" | "duplicateSelection" | "deleteSelectedElements" | "changeViewBackgroundColor" | "clearCanvas" | "zoomIn" | "zoomOut" | "resetZoom" | "zoomToFit" | "zoomToFitSelection" | "zoomToFitSelectionInViewport" | "changeFontFamily" | "changeTextAlign" | "changeVerticalAlign" | "toggleFullScreen" | "toggleShortcuts" | "group" | "ungroup" | "goToCollaborator" | "addToLibrary" | "changeRoundness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "deselect" | "viewMode" | "exportWithDarkMode" | "toggleTheme" | "increaseFontSize" | "decreaseFontSize" | "unbindText" | "hyperlink" | "bindText" | "unlockAllElements" | "toggleElementLock" | "toggleLinearEditor" | "selectAllElementsInFrame" | "removeAllElementsFromFrame" | "updateFrameRendering" | "createContainerFromText" | "wrapTextInContainer" | "commandPalette" | "autoResize" | "elementStats" | "searchMenu" | "copyElementLink" | "linkToElement" | "cropEditor" | "wrapSelectionInFrame" | "toggleShapeSwitch" | "togglePolygon";
+export type ActionName = "copy" | "cut" | "paste" | "copyAsPng" | "copyAsSvg" | "copyText" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyStyles" | "selectAll" | "pasteStyles" | "gridMode" | "zenMode" | "objectsSnapMode" | "arrowBinding" | "midpointSnapping" | "showHints" | "stats" | "changeStrokeColor" | "changeBackgroundColor" | "changeBucketFillBackgroundColor" | "changeFillStyle" | "changeStrokeWidth" | "changeSloppiness" | "changeFreedrawMode" | "changeStrokeStyle" | "changeArrowhead" | "changeArrowType" | "changeArrowProperties" | "changeOpacity" | "changeFontSize" | "undo" | "redo" | "finalize" | "changeProjectName" | "changeExportBackground" | "changeExportEmbedScene" | "changeExportScale" | "saveToActiveFile" | "saveFileToDisk" | "loadScene" | "duplicateSelection" | "deleteSelectedElements" | "changeViewBackgroundColor" | "clearCanvas" | "zoomIn" | "zoomOut" | "resetZoom" | "zoomToFit" | "zoomToFitSelection" | "zoomToFitSelectionInViewport" | "changeFontFamily" | "changeTextAlign" | "changeVerticalAlign" | "toggleFullScreen" | "toggleShortcuts" | "group" | "ungroup" | "goToCollaborator" | "addToLibrary" | "changeRoundness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "deselect" | "viewMode" | "exportWithDarkMode" | "toggleTheme" | "increaseFontSize" | "decreaseFontSize" | "unbindText" | "hyperlink" | "bindText" | "unlockAllElements" | "toggleElementLock" | "toggleLinearEditor" | "selectAllElementsInFrame" | "removeAllElementsFromFrame" | "updateFrameRendering" | "createContainerFromText" | "wrapTextInContainer" | "commandPalette" | "autoResize" | "elementStats" | "searchMenu" | "copyElementLink" | "linkToElement" | "cropEditor" | "wrapSelectionInFrame" | "toggleShapeSwitch" | "togglePolygon";
 export type PanelComponentProps = {
     elements: readonly ExcalidrawElement[];
     appState: UIAppState;

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

@@ -1,4 +1,4 @@
-import type { AppState, NormalizedZoomValue } from "./types";
+import type { AppState, InputDevice, NormalizedZoomValue } from "./types";
 export declare const getDefaultAppState: () => Omit<AppState, "offsetTop" | "offsetLeft" | "width" | "height">;
 export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>) => {
     viewBackgroundColor?: string | undefined;
@@ -34,6 +34,8 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     showWelcomeScreen?: boolean | undefined;
     boxSelectionMode?: import("./types").BoxSelectionMode | undefined;
     bindingPreference?: "enabled" | "disabled" | undefined;
+    showHints?: boolean | undefined;
+    inputDevice?: InputDevice | undefined;
     preferredSelectionTool?: {
         type: "selection" | "lasso";
         initialized: boolean;
@@ -44,6 +46,8 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     exportEmbedScene?: boolean | undefined;
     exportWithDarkMode?: boolean | undefined;
     currentItemStrokeColor?: string | undefined;
+    currentItemStickynoteStrokeColor?: string | undefined;
+    currentItemStickynoteBackgroundColor?: string | undefined;
     currentItemBackgroundColor?: string | undefined;
     currentItemFillStyle?: import("@excalidraw/element/types").FillStyle | undefined;
     currentItemStrokeWidthKey?: import("@excalidraw/common").StrokeWidthKey | undefined;
@@ -78,6 +82,14 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     lockedMultiSelections?: {
         [groupId: string]: true;
     } | undefined;
+    colorTopPicks?: {
+        elementStroke: readonly string[] | null;
+        elementBackground: readonly string[] | null;
+        bucketFill: readonly string[] | null;
+        stickyNoteStroke: readonly string[] | null;
+        stickyNoteBackground: readonly string[] | null;
+    } | undefined;
+    fontTopPicks?: readonly number[] | null | undefined;
 };
 export declare const cleanAppStateForExport: (appState: Partial<AppState>) => {
     viewBackgroundColor?: string | undefined;
@@ -103,3 +115,13 @@ export declare const isEraserActive: ({ activeTool, }: {
 export declare const isHandToolActive: ({ activeTool, }: {
     activeTool: AppState["activeTool"];
 }) => boolean;
+/**
+ * The device the wheel mappings follow for the given preference.
+ *
+ * `auto` is meant to detect the device from the wheel events themselves
+ * (line vs. pixel delta modes, whole vs. fractional deltas, one vs. two axes
+ * moving, event cadence and momentum tails). That is not implemented yet, so
+ * it resolves to `trackpad` — the mapping the editor has always had, and the
+ * default to keep until detection exists.
+ */
+export declare const resolveInputDevice: (inputDevice: InputDevice) => Exclude<InputDevice, "auto">;

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

@@ -1,47 +1,30 @@
+import { LinearElementEditor } from "@excalidraw/element";
 import type { ArrowEndpoint } from "@excalidraw/element";
-import type { ExcalidrawElement, ExcalidrawTextElement, FixedPoint, NonDeleted } from "@excalidraw/element/types";
+import type { ExcalidrawElement, ExcalidrawTextElement, FixedPoint, NonDeleted, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
 import type App from "./App";
-import type { AppState } from "../types";
+import type { PointerDownState } from "../types";
 /**
- * The text tool's interaction with arrows: the hover affordance showing where
- * a click would attach text to an arrow — a free endpoint (binds the arrow to
- * a new text element positioned against that endpoint) or the arrow's midpoint
- * (adds a label bound to the arrow) — and the endpoint-bound flavor of
- * drag-sizing a new text.
+ * Text ↔ arrow interactions.
  *
- * The scene-level logic lives in `@excalidraw/element`'s `arrowEndpointText.ts`.
+ * With the text tool: the free endpoint a click would bind a new text to
+ * (`AppTextTool` resolves and shows it), the binding itself, and the
+ * endpoint-bound flavor of drag-sizing a new text.
+ *
+ * With the selection tool: dragging an arrow's existing label along the arrow
+ * — the grab affordance and the drag itself.
+ *
+ * The scene-level logic lives in `@excalidraw/element`'s
+ * `arrowEndpointText.ts` and `linearElementEditor.ts`.
  */
 export declare class AppArrowText {
     private app;
     constructor(app: App);
-    /**
-     * With the text tool active, an arrow under the cursor is a target for
-     * attaching text. Returns where the text would land (if anywhere), and keeps
-     * `appState.hoveredArrowTextAnchor` — which drives the highlight — in sync.
-     */
-    updateHoveredAnchor: (scenePointer: {
-        x: number;
-        y: number;
-    }) => AppState["hoveredArrowTextAnchor"];
-    /**
-     * Re-evaluates the hovered anchor at the last known pointer position — for
-     * events that change what a click would do without the pointer moving,
-     * i.e. the ctrl/cmd binding toggle. (Events that invalidate the anchor
-     * wholesale — tool switches, finalize, deselect — clear it directly
-     * instead.)
-     */
-    refresh: () => void;
     /**
      * A free arrow endpoint a new text could be bound to. Binding an endpoint is
      * an arrow binding, so it follows the binding toggle (ctrl/cmd) like every
      * other one — holding it makes the text tool drop plain text instead.
      */
     getBindableEndpointAtPosition(x: number, y: number): ArrowEndpoint | null;
-    /**
-     * Mirrors what `handleTextOnPointerDown` would do at this position, so the
-     * highlight can't promise something the click won't deliver.
-     */
-    private getAnchorAtPosition;
     /**
      * How a text should be created to read as a label for this endpoint — the
      * side midpoint to bind, the alignment that pins it, and the scene position
@@ -69,4 +52,19 @@ export declare class AppArrowText {
         x: number;
         y: number;
     }): boolean;
+    /**
+     * Whether the arrow's label is what a grab at this position would pick up:
+     * the pointer is over the label, and no element stacked above the arrow
+     * owns the hit instead.
+     */
+    isBoundTextGrabbable(element: NonDeletedExcalidrawElement, x: number, y: number): boolean;
+    /**
+     * The pointer-move half of dragging a label along its arrow. Owns the move
+     * whenever the gesture started on the label (`pointerDownState.hit.arrowLabel`),
+     * dragging only once past the threshold. Returns whether it owned it.
+     */
+    maybeDragLabel(linearElementEditor: LinearElementEditor, pointerDownState: PointerDownState, pointerCoords: {
+        x: number;
+        y: number;
+    }): boolean;
 }

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

@@ -1,3 +1,4 @@
+import type { Theme } from "@excalidraw/element/types";
 import type App from "./App";
 type ScenePoint = {
     x: number;
@@ -34,5 +35,14 @@ export declare class AppBucketFill {
      */
     private restyle;
     private fill;
+    /**
+     * The color the bucket fill tool actually fills with: the shared
+     * `currentItemBackgroundColor`, falling back to green when that is
+     * transparent (the tool's picker doesn't offer transparent, but the shared
+     * state can hold it from the generic shape picker).
+     */
+    getBucketFillBackgroundColor: (backgroundColor: string, 
+    /** supply only for display purposes such as when applying to the cursor */
+    theme?: Theme) => string;
 }
 export {};

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

@@ -0,0 +1,31 @@
+import type React from "react";
+import type App from "./App";
+type AppClipboardDependencies = {
+    getContainer: () => HTMLDivElement | null;
+};
+/**
+ * The clipboard: cut and copy (through their actions), and paste — the
+ * pasted data parsed (`pasteFromClipboard`) and inserted as whatever it is
+ * (`insertClipboardContent`): images or SVG code, elements, a Mermaid
+ * definition, embeddable URLs, a spreadsheet (as a chart), mixed content,
+ * or text. Pasted elements go in through `app.addElementsFromPasteOrLibrary`,
+ * as a library item or a drop does.
+ */
+export declare class AppClipboard {
+    private app;
+    private dependencies;
+    constructor(app: App, dependencies: AppClipboardDependencies);
+    onCut: (event: ClipboardEvent) => void;
+    onCopy: (event: ClipboardEvent) => void;
+    private insertClipboardContent;
+    /**
+     * Ctrl/Cmd+V: whether the paste event that follows is a plain one (with
+     * Shift)
+     */
+    onPasteShortcut: (event: React.KeyboardEvent | KeyboardEvent) => void;
+    clearPlainPaste: () => void;
+    pasteFromClipboard: (event: ClipboardEvent) => Promise<void>;
+    private addElementsFromMixedContentPaste;
+    private addTextFromPaste;
+}
+export {};

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

@@ -24,6 +24,14 @@ export declare class AppCursor {
     reset: () => void;
     /** applies the given tool's cursor (defaults to the active tool) */
     applyForTool: (activeTool?: AppState["activeTool"]) => void;
+    /**
+     * Re-runs the hover cursor logic at the last known pointer position by
+     * re-dispatching a synthetic pointermove — for state changes that alter
+     * what hovering means without the pointer moving (e.g. the tool reverting
+     * to selection after an element is created). Mouse only: touch and pen
+     * have no resting hover to restore.
+     */
+    refreshHover: () => void;
     /** clears the inline cursor so the environment default (CSS) applies */
     private clear;
     private applyEraser;