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

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

@@ -30,13 +30,26 @@ export declare const actionToggleStats: {
             multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
             selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
+            boxSelectionMode: import("../types").BoxSelectionMode;
             bindingPreference: "enabled" | "disabled";
             isMidpointSnappingEnabled: boolean;
-            startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
+            showHints: 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;
@@ -44,8 +57,8 @@ export declare const actionToggleStats: {
                 outline: boolean;
                 clip: boolean;
             };
-            editingFrame: string | null;
-            elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
+            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;
@@ -63,11 +76,14 @@ export declare const actionToggleStats: {
             exportWithDarkMode: boolean;
             exportScale: number;
             currentItemStrokeColor: string;
+            currentItemStickynoteStrokeColor: string;
+            currentItemStickynoteBackgroundColor: string;
             currentItemBackgroundColor: string;
             currentItemFillStyle: import("@excalidraw/element/types").ExcalidrawElement["fillStyle"];
-            currentItemStrokeWidth: number;
+            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;
@@ -80,6 +96,7 @@ export declare const actionToggleStats: {
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
+            scrollConstraints: import("../types").ScrollConstraints | null;
             cursorButton: "up" | "down";
             scrolledOutside: boolean;
             name: string | null;
@@ -151,8 +168,6 @@ export declare const actionToggleStats: {
                 y: number;
             } | null;
             objectsSnapModeEnabled: boolean;
-            userToFollow: import("../types").UserToFollow | null;
-            followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
             croppingElementId: import("@excalidraw/element/types").ExcalidrawElement["id"] | null;
             searchMatches: Readonly<{
@@ -164,10 +179,18 @@ 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";
     };
-    checked: (appState: Readonly<import("../types").AppState>) => boolean;
+    checked: (appState: Readonly<import("../types").UIAppState>) => boolean;
     keyTest: (event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean;
 } & {
     keyTest?: ((event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean) | undefined;

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

@@ -27,13 +27,26 @@ export declare const actionToggleViewMode: {
             multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
             selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
+            boxSelectionMode: import("../types").BoxSelectionMode;
             bindingPreference: "enabled" | "disabled";
             isMidpointSnappingEnabled: boolean;
-            startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
+            showHints: 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;
@@ -41,8 +54,8 @@ export declare const actionToggleViewMode: {
                 outline: boolean;
                 clip: boolean;
             };
-            editingFrame: string | null;
-            elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
+            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;
@@ -60,11 +73,14 @@ export declare const actionToggleViewMode: {
             exportWithDarkMode: boolean;
             exportScale: number;
             currentItemStrokeColor: string;
+            currentItemStickynoteStrokeColor: string;
+            currentItemStickynoteBackgroundColor: string;
             currentItemBackgroundColor: string;
             currentItemFillStyle: import("@excalidraw/element/types").ExcalidrawElement["fillStyle"];
-            currentItemStrokeWidth: number;
+            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;
@@ -77,6 +93,7 @@ export declare const actionToggleViewMode: {
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
+            scrollConstraints: import("../types").ScrollConstraints | null;
             cursorButton: "up" | "down";
             scrolledOutside: boolean;
             name: string | null;
@@ -151,8 +168,6 @@ export declare const actionToggleViewMode: {
                 y: number;
             } | null;
             objectsSnapModeEnabled: boolean;
-            userToFollow: import("../types").UserToFollow | null;
-            followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
             croppingElementId: import("@excalidraw/element/types").ExcalidrawElement["id"] | null;
             searchMatches: Readonly<{
@@ -164,11 +179,19 @@ 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";
     };
-    checked: (appState: Readonly<import("../types").AppState>) => boolean;
-    predicate: (elements: readonly import("@excalidraw/element/types").ExcalidrawElement[], appState: import("../types").AppState, appProps: import("../types").ExcalidrawProps) => boolean;
+    checked: (appState: Readonly<import("../types").UIAppState>) => boolean;
+    predicate: (elements: readonly import("@excalidraw/element/types").ExcalidrawElement[], appState: import("../types").AppState, appProps: import("../types").ExcalidrawProps, app: import("../types").AppClassProperties) => boolean;
     keyTest: (event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean;
 } & {
     keyTest?: ((event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean) | undefined;

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

@@ -27,13 +27,26 @@ export declare const actionToggleZenMode: {
             multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
             selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
+            boxSelectionMode: import("../types").BoxSelectionMode;
             bindingPreference: "enabled" | "disabled";
             isMidpointSnappingEnabled: boolean;
-            startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
+            showHints: 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;
@@ -41,8 +54,8 @@ export declare const actionToggleZenMode: {
                 outline: boolean;
                 clip: boolean;
             };
-            editingFrame: string | null;
-            elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
+            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;
@@ -60,11 +73,14 @@ export declare const actionToggleZenMode: {
             exportWithDarkMode: boolean;
             exportScale: number;
             currentItemStrokeColor: string;
+            currentItemStickynoteStrokeColor: string;
+            currentItemStickynoteBackgroundColor: string;
             currentItemBackgroundColor: string;
             currentItemFillStyle: import("@excalidraw/element/types").ExcalidrawElement["fillStyle"];
-            currentItemStrokeWidth: number;
+            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;
@@ -77,6 +93,7 @@ export declare const actionToggleZenMode: {
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
+            scrollConstraints: import("../types").ScrollConstraints | null;
             cursorButton: "up" | "down";
             scrolledOutside: boolean;
             name: string | null;
@@ -151,8 +168,6 @@ export declare const actionToggleZenMode: {
                 y: number;
             } | null;
             objectsSnapModeEnabled: boolean;
-            userToFollow: import("../types").UserToFollow | null;
-            followedBy: Set<import("../types").SocketId>;
             isCropping: boolean;
             croppingElementId: import("@excalidraw/element/types").ExcalidrawElement["id"] | null;
             searchMatches: Readonly<{
@@ -164,10 +179,18 @@ 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";
     };
-    checked: (appState: Readonly<import("../types").AppState>) => boolean;
+    checked: (appState: Readonly<import("../types").UIAppState>) => boolean;
     predicate: (elements: readonly import("@excalidraw/element/types").ExcalidrawElement[], appState: import("../types").AppState, appProps: import("../types").ExcalidrawProps, app: import("../types").AppClassProperties) => boolean;
     keyTest: (event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean;
 } & {

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

@@ -2,9 +2,8 @@ export { actionDeleteSelected } from "./actionDeleteSelected";
 export { actionBringForward, actionBringToFront, actionSendBackward, actionSendToBack, } from "./actionZindex";
 export { actionSelectAll } from "./actionSelectAll";
 export { actionDuplicateSelection } from "./actionDuplicateSelection";
-export { actionChangeStrokeColor, actionChangeBackgroundColor, actionChangeStrokeWidth, actionChangeFillStyle, actionChangeSloppiness, actionChangeOpacity, actionChangeFontSize, actionChangeFontFamily, actionChangeTextAlign, actionChangeVerticalAlign, actionChangeArrowProperties, } from "./actionProperties";
+export { actionChangeStrokeColor, actionChangeBackgroundColor, actionChangeBucketFillBackgroundColor, actionChangeStrokeWidth, actionChangeFillStyle, actionChangeSloppiness, actionChangeFreedrawMode, actionChangeOpacity, actionChangeFontSize, actionChangeFontFamily, actionChangeTextAlign, actionChangeVerticalAlign, actionChangeArrowProperties, } from "./actionProperties";
 export { actionChangeViewBackgroundColor, actionClearCanvas, actionZoomIn, actionZoomOut, actionResetZoom, actionZoomToFit, actionToggleTheme, } from "./actionCanvas";
-export { actionSetEmbeddableAsActiveTool } from "./actionEmbeddable";
 export { actionFinalize } from "./actionFinalize";
 export { actionDeselect } from "./actionDeselect";
 export { actionChangeProjectName, actionChangeExportBackground, actionSaveToActiveFile, actionSaveFileToDisk, actionLoadScene, } from "./actionExport";
@@ -22,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/manager.d.ts

@@ -11,6 +11,7 @@ export declare class ActionManager {
     constructor(updater: UpdaterFn, getAppState: () => AppState, getElementsIncludingDeleted: () => readonly OrderedExcalidrawElement[], app: AppClassProperties);
     registerAction(action: Action): void;
     registerAll(actions: readonly Action[]): void;
+    private isActionBlockedByViewportTransition;
     handleKeyDown(event: React.KeyboardEvent | KeyboardEvent): boolean;
     executeAction<T extends Action>(action: T, source?: ActionSource, value?: Parameters<T["perform"]>[2]): void;
     /**

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

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

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

@@ -14,10 +14,10 @@ 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" | "changeFillStyle" | "changeStrokeWidth" | "changeStrokeShape" | "changeSloppiness" | "changeStrokeStyle" | "changeArrowhead" | "changeArrowType" | "changeArrowProperties" | "changeOpacity" | "changeFontSize" | "undo" | "redo" | "finalize" | "changeProjectName" | "changeExportBackground" | "changeExportEmbedScene" | "changeExportScale" | "saveToActiveFile" | "saveFileToDisk" | "loadScene" | "duplicateSelection" | "deleteSelectedElements" | "changeViewBackgroundColor" | "clearCanvas" | "zoomIn" | "zoomOut" | "resetZoom" | "zoomToFit" | "zoomToFitSelection" | "zoomToFitSelectionInViewport" | "changeFontFamily" | "changeTextAlign" | "changeVerticalAlign" | "toggleFullScreen" | "toggleShortcuts" | "group" | "ungroup" | "goToCollaborator" | "addToLibrary" | "changeRoundness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "deselect" | "viewMode" | "exportWithDarkMode" | "toggleTheme" | "increaseFontSize" | "decreaseFontSize" | "unbindText" | "hyperlink" | "bindText" | "unlockAllElements" | "toggleElementLock" | "toggleLinearEditor" | "toggleEraserTool" | "toggleHandTool" | "selectAllElementsInFrame" | "removeAllElementsFromFrame" | "updateFrameRendering" | "setFrameAsActiveTool" | "setEmbeddableAsActiveTool" | "createContainerFromText" | "wrapTextInContainer" | "commandPalette" | "autoResize" | "elementStats" | "searchMenu" | "copyElementLink" | "linkToElement" | "cropEditor" | "wrapSelectionInFrame" | "toggleLassoTool" | "toggleShapeSwitch" | "togglePolygon";
+export type ActionName = "copy" | "cut" | "paste" | "copyAsPng" | "copyAsSvg" | "copyText" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyStyles" | "selectAll" | "pasteStyles" | "gridMode" | "zenMode" | "objectsSnapMode" | "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: AppState;
+    appState: UIAppState;
     updateData: <T = any>(formData?: T) => void;
     appProps: ExcalidrawProps;
     data?: Record<string, any>;
@@ -26,7 +26,7 @@ export type PanelComponentProps = {
 };
 export interface Action<TData = any> {
     name: ActionName;
-    label: string | ((elements: readonly ExcalidrawElement[], appState: Readonly<AppState>, app: AppClassProperties) => string);
+    label: string | ((elements: readonly ExcalidrawElement[], appState: Readonly<UIAppState>, app: AppClassProperties) => string);
     keywords?: string[];
     icon?: React.ReactNode | ((appState: UIAppState, elements: readonly ExcalidrawElement[]) => React.ReactNode);
     PanelComponent?: React.FC<PanelComponentProps>;
@@ -34,7 +34,7 @@ export interface Action<TData = any> {
     keyPriority?: number;
     keyTest?: (event: React.KeyboardEvent | KeyboardEvent, appState: AppState, elements: readonly ExcalidrawElement[], app: AppClassProperties) => boolean;
     predicate?: (elements: readonly ExcalidrawElement[], appState: AppState, appProps: ExcalidrawProps, app: AppClassProperties) => boolean;
-    checked?: (appState: Readonly<AppState>) => boolean;
+    checked?: (appState: Readonly<UIAppState>) => boolean;
     trackEvent: false | {
         category: "toolbar" | "element" | "canvas" | "export" | "history" | "menu" | "collab" | "hyperlink" | "search_menu" | "shape_switch";
         action?: string;
@@ -43,5 +43,9 @@ export interface Action<TData = any> {
     /** if set to `true`, allow action to be performed in viewMode.
      *  Defaults to `false` */
     viewMode?: boolean;
+    /** if set to `true`, the action counts as canvas navigation and remains
+     *  available in the non-interactive editor when
+     *  `interaction: { enabled: { navigation: true } }`. Defaults to `false` */
+    navigation?: boolean;
 }
 export {};

package/dist/types/excalidraw/{animated-trail.d.ts → animatedTrail.d.ts}

@@ -1,6 +1,5 @@
 import { LaserPointer } from "@excalidraw/laser-pointer";
 import type { LaserPointerOptions } from "@excalidraw/laser-pointer";
-import type { AnimationFrameHandler } from "./animation-frame-handler";
 import type App from "./components/App";
 export interface Trail {
     start(container: SVGSVGElement): void;
@@ -15,7 +14,6 @@ export interface AnimatedTrailOptions {
     animateTrail?: boolean;
 }
 export declare class AnimatedTrail implements Trail {
-    private animationFrameHandler;
     protected app: App;
     private options;
     private currentTrail?;
@@ -23,9 +21,12 @@ export declare class AnimatedTrail implements Trail {
     private container?;
     private trailElement;
     private trailAnimation?;
-    constructor(animationFrameHandler: AnimationFrameHandler, app: App, options: Partial<LaserPointerOptions> & Partial<AnimatedTrailOptions>);
+    private key;
+    private static counter;
+    constructor(app: App, options: Partial<LaserPointerOptions> & Partial<AnimatedTrailOptions>);
     get hasCurrentTrail(): boolean;
     hasLastPoint(x: number, y: number): boolean;
+    private cleanup;
     start(container?: SVGSVGElement): void;
     stop(): void;
     startPath(x: number, y: number): void;

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;
@@ -24,14 +24,18 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     selectedLinearElement?: import("@excalidraw/element").LinearElementEditor | null | undefined;
     isBindingEnabled?: boolean | undefined;
     isMidpointSnappingEnabled?: boolean | undefined;
+    gridModeEnabled?: boolean | undefined;
     zenModeEnabled?: boolean | undefined;
     shouldCacheIgnoreZoom?: boolean | undefined;
     exportScale?: number | undefined;
     currentItemArrowType?: "round" | "sharp" | "elbow" | undefined;
-    bindMode?: import("@excalidraw/element/types").BindMode | undefined;
     gridSize?: number | undefined;
+    bindMode?: import("@excalidraw/element/types").BindMode | undefined;
     showWelcomeScreen?: boolean | undefined;
+    boxSelectionMode?: import("./types").BoxSelectionMode | undefined;
     bindingPreference?: "enabled" | "disabled" | undefined;
+    showHints?: boolean | undefined;
+    inputDevice?: InputDevice | undefined;
     preferredSelectionTool?: {
         type: "selection" | "lasso";
         initialized: boolean;
@@ -42,11 +46,14 @@ 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;
-    currentItemStrokeWidth?: number | undefined;
+    currentItemStrokeWidthKey?: import("@excalidraw/common").StrokeWidthKey | undefined;
     currentItemStrokeStyle?: import("@excalidraw/element/types").StrokeStyle | undefined;
     currentItemRoughness?: number | undefined;
+    currentItemStrokeVariability?: import("@excalidraw/element/types").StrokeVariability | undefined;
     currentItemOpacity?: number | undefined;
     currentItemFontFamily?: number | undefined;
     currentItemFontSize?: number | undefined;
@@ -67,7 +74,6 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
         [id: string]: true;
     } | undefined;
     gridStep?: number | undefined;
-    gridModeEnabled?: boolean | undefined;
     stats?: {
         open: boolean;
         panels: number;
@@ -76,21 +82,29 @@ 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;
+    gridModeEnabled?: boolean | undefined;
     gridSize?: number | undefined;
     gridStep?: number | undefined;
-    gridModeEnabled?: boolean | undefined;
     lockedMultiSelections?: {
         [groupId: string]: true;
     } | undefined;
 };
 export declare const clearAppStateForDatabase: (appState: Partial<AppState>) => {
     viewBackgroundColor?: string | undefined;
+    gridModeEnabled?: boolean | undefined;
     gridSize?: number | undefined;
     gridStep?: number | undefined;
-    gridModeEnabled?: boolean | undefined;
     lockedMultiSelections?: {
         [groupId: string]: true;
     } | undefined;
@@ -101,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/Actions.d.ts

@@ -1,15 +1,22 @@
-import type { ExcalidrawElement, NonDeletedElementsMap, NonDeletedSceneElementsMap } from "@excalidraw/element/types";
+import type { NonDeletedElementsMap, NonDeletedSceneElementsMap } from "@excalidraw/element/types";
 import "./Actions.scss";
-import type { AppClassProperties, AppProps, UIAppState, Zoom, AppState } from "../types";
+import type { AppClassProperties, UIAppState, AppState } from "../types";
 import type { ActionManager } from "../actions/manager";
-export declare const canChangeStrokeColor: (appState: UIAppState, targetElements: ExcalidrawElement[]) => boolean;
-export declare const canChangeBackgroundColor: (appState: UIAppState, targetElements: ExcalidrawElement[]) => boolean;
+export { canChangeStrokeColor, canChangeBackgroundColor, } from "./shapeActionPredicates";
+/**
+ * Full styles panel: the wide, always-expanded layout used on desktop when the
+ * UI is in "full" mode.
+ */
 export declare const SelectedShapeActions: ({ appState, elementsMap, renderAction, app, }: {
     appState: UIAppState;
     elementsMap: NonDeletedElementsMap | NonDeletedSceneElementsMap;
     renderAction: ActionManager["renderAction"];
     app: AppClassProperties;
 }) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Compact styles panel — the collapsed, popover-driven layout used on tablets
+ * and on desktop when the UI is in "compact" mode.
+ */
 export declare const CompactShapeActions: ({ appState, elementsMap, renderAction, app, setAppState, }: {
     appState: UIAppState;
     elementsMap: NonDeletedElementsMap | NonDeletedSceneElementsMap;
@@ -17,6 +24,11 @@ export declare const CompactShapeActions: ({ appState, elementsMap, renderAction
     app: AppClassProperties;
     setAppState: React.Component<any, AppState>["setState"];
 }) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Mobile styles panel — the horizontal action bar used on phones, with an
+ * overflow measurement that promotes duplicate/delete out of the popover when
+ * there is room.
+ */
 export declare const MobileShapeActions: ({ appState, elementsMap, renderAction, app, setAppState, }: {
     appState: UIAppState;
     elementsMap: NonDeletedElementsMap | NonDeletedSceneElementsMap;
@@ -24,15 +36,8 @@ export declare const MobileShapeActions: ({ appState, elementsMap, renderAction,
     app: AppClassProperties;
     setAppState: React.Component<any, AppState>["setState"];
 }) => import("react/jsx-runtime").JSX.Element;
-export declare const ShapesSwitcher: ({ activeTool, setAppState, app, UIOptions, }: {
-    activeTool: UIAppState["activeTool"];
-    setAppState: React.Component<any, AppState>["setState"];
-    app: AppClassProperties;
-    UIOptions: AppProps["UIOptions"];
-}) => import("react/jsx-runtime").JSX.Element;
-export declare const ZoomActions: ({ renderAction, zoom, }: {
+export declare const ZoomActions: ({ renderAction, }: {
     renderAction: ActionManager["renderAction"];
-    zoom: Zoom;
 }) => import("react/jsx-runtime").JSX.Element;
 export declare const UndoRedoActions: ({ renderAction, className, }: {
     renderAction: ActionManager["renderAction"];

package/dist/types/excalidraw/components/ActiveConfirmDialog.d.ts

@@ -1,4 +1,4 @@
-export declare const activeConfirmDialogAtom: import("jotai/vanilla/atom").PrimitiveAtom<"clearCanvas" | null> & {
+export declare const activeConfirmDialogAtom: import("jotai").PrimitiveAtom<"clearCanvas" | null> & {
     init: "clearCanvas" | null;
 };
 export declare const ActiveConfirmDialog: () => import("react/jsx-runtime").JSX.Element | null;