@excalidraw/excalidraw 0.13.0-f5379d1 → 0.14.0-6121-fc3ad52

package/types/actions/actionStyles.d.ts

@@ -10,6 +10,12 @@ export declare const actionCopyStyles: {
             toast: {
                 message: string;
             };
+            contextMenu: {
+                items: import("../components/ContextMenu").ContextMenuItems;
+                top: number;
+                left: number;
+            } | null;
+            showWelcomeScreen: boolean;
             isLoading: boolean;
             errorMessage: string | null;
             draggingElement: import("../element/types").NonDeletedExcalidrawElement | null;
@@ -48,10 +54,9 @@ export declare const actionCopyStyles: {
             currentItemFontFamily: number;
             currentItemFontSize: number;
             currentItemTextAlign: string;
-            currentItemStrokeSharpness: import("../element/types").StrokeSharpness;
             currentItemStartArrowhead: import("../element/types").Arrowhead | null;
             currentItemEndArrowhead: import("../element/types").Arrowhead | null;
-            currentItemLinearStrokeSharpness: import("../element/types").StrokeSharpness;
+            currentItemRoundness: import("../element/types").StrokeRoundness;
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
@@ -66,6 +71,7 @@ export declare const actionCopyStyles: {
             openMenu: "canvas" | "shape" | null;
             openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
             openSidebar: "library" | "customSidebar" | null;
+            openDialog: "imageExport" | "help" | "jsonExport" | null;
             isSidebarDocked: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
@@ -75,7 +81,6 @@ export declare const actionCopyStyles: {
                 [id: string]: boolean;
             };
             shouldCacheIgnoreZoom: boolean;
-            showHelpDialog: boolean;
             zenModeEnabled: boolean;
             theme: string;
             gridSize: number | null;

package/types/actions/actionToggleGridMode.d.ts

@@ -2,6 +2,7 @@
 import { AppState } from "../types";
 export declare const actionToggleGridMode: {
     name: "gridMode";
+    viewMode: true;
     trackEvent: {
         category: "canvas";
         predicate: (appState: Readonly<AppState>) => boolean;
@@ -9,6 +10,12 @@ export declare const actionToggleGridMode: {
     perform(elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<AppState>): {
         appState: {
             gridSize: number | null;
+            contextMenu: {
+                items: import("../components/ContextMenu").ContextMenuItems;
+                top: number;
+                left: number;
+            } | null;
+            showWelcomeScreen: boolean;
             isLoading: boolean;
             errorMessage: string | null;
             draggingElement: import("../element/types").NonDeletedExcalidrawElement | null;
@@ -47,10 +54,9 @@ export declare const actionToggleGridMode: {
             currentItemFontFamily: number;
             currentItemFontSize: number;
             currentItemTextAlign: string;
-            currentItemStrokeSharpness: import("../element/types").StrokeSharpness;
             currentItemStartArrowhead: import("../element/types").Arrowhead | null;
             currentItemEndArrowhead: import("../element/types").Arrowhead | null;
-            currentItemLinearStrokeSharpness: import("../element/types").StrokeSharpness;
+            currentItemRoundness: import("../element/types").StrokeRoundness;
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
@@ -65,6 +71,7 @@ export declare const actionToggleGridMode: {
             openMenu: "canvas" | "shape" | null;
             openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
             openSidebar: "library" | "customSidebar" | null;
+            openDialog: "imageExport" | "help" | "jsonExport" | null;
             isSidebarDocked: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
@@ -74,7 +81,6 @@ export declare const actionToggleGridMode: {
                 [id: string]: boolean;
             };
             shouldCacheIgnoreZoom: boolean;
-            showHelpDialog: boolean;
             toast: {
                 message: string;
                 closable?: boolean | undefined;
@@ -109,6 +115,7 @@ export declare const actionToggleGridMode: {
         commitToHistory: false;
     };
     checked: (appState: AppState) => boolean;
+    predicate: (element: readonly import("../element/types").ExcalidrawElement[], appState: AppState, props: import("../types").ExcalidrawProps) => boolean;
     contextItemLabel: string;
     keyTest: (event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean;
 } & {

package/types/actions/actionToggleLock.d.ts

@@ -9,6 +9,12 @@ export declare const actionToggleLock: {
         elements: ExcalidrawElement[];
         appState: {
             selectedLinearElement: import("../element/linearElementEditor").LinearElementEditor | null;
+            contextMenu: {
+                items: import("../components/ContextMenu").ContextMenuItems;
+                top: number;
+                left: number;
+            } | null;
+            showWelcomeScreen: boolean;
             isLoading: boolean;
             errorMessage: string | null;
             draggingElement: import("../element/types").NonDeletedExcalidrawElement | null;
@@ -47,10 +53,9 @@ export declare const actionToggleLock: {
             currentItemFontFamily: number;
             currentItemFontSize: number;
             currentItemTextAlign: string;
-            currentItemStrokeSharpness: import("../element/types").StrokeSharpness;
             currentItemStartArrowhead: import("../element/types").Arrowhead | null;
             currentItemEndArrowhead: import("../element/types").Arrowhead | null;
-            currentItemLinearStrokeSharpness: import("../element/types").StrokeSharpness;
+            currentItemRoundness: import("../element/types").StrokeRoundness;
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
@@ -65,6 +70,7 @@ export declare const actionToggleLock: {
             openMenu: "canvas" | "shape" | null;
             openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
             openSidebar: "library" | "customSidebar" | null;
+            openDialog: "imageExport" | "help" | "jsonExport" | null;
             isSidebarDocked: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
@@ -74,7 +80,6 @@ export declare const actionToggleLock: {
                 [id: string]: boolean;
             };
             shouldCacheIgnoreZoom: boolean;
-            showHelpDialog: boolean;
             toast: {
                 message: string;
                 closable?: boolean | undefined;

package/types/actions/actionToggleStats.d.ts

@@ -1,12 +1,19 @@
 /// <reference types="react" />
 export declare const actionToggleStats: {
     name: "stats";
+    viewMode: true;
     trackEvent: {
         category: "menu";
     };
     perform(elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<import("../types").AppState>): {
         appState: {
             showStats: boolean;
+            contextMenu: {
+                items: import("../components/ContextMenu").ContextMenuItems;
+                top: number;
+                left: number;
+            } | null;
+            showWelcomeScreen: boolean;
             isLoading: boolean;
             errorMessage: string | null;
             draggingElement: import("../element/types").NonDeletedExcalidrawElement | null;
@@ -45,10 +52,9 @@ export declare const actionToggleStats: {
             currentItemFontFamily: number;
             currentItemFontSize: number;
             currentItemTextAlign: string;
-            currentItemStrokeSharpness: import("../element/types").StrokeSharpness;
             currentItemStartArrowhead: import("../element/types").Arrowhead | null;
             currentItemEndArrowhead: import("../element/types").Arrowhead | null;
-            currentItemLinearStrokeSharpness: import("../element/types").StrokeSharpness;
+            currentItemRoundness: import("../element/types").StrokeRoundness;
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
@@ -63,6 +69,7 @@ export declare const actionToggleStats: {
             openMenu: "canvas" | "shape" | null;
             openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
             openSidebar: "library" | "customSidebar" | null;
+            openDialog: "imageExport" | "help" | "jsonExport" | null;
             isSidebarDocked: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
@@ -72,7 +79,6 @@ export declare const actionToggleStats: {
                 [id: string]: boolean;
             };
             shouldCacheIgnoreZoom: boolean;
-            showHelpDialog: boolean;
             toast: {
                 message: string;
                 closable?: boolean | undefined;

package/types/actions/actionToggleViewMode.d.ts

@@ -1,6 +1,7 @@
 /// <reference types="react" />
 export declare const actionToggleViewMode: {
     name: "viewMode";
+    viewMode: true;
     trackEvent: {
         category: "canvas";
         predicate: (appState: Readonly<import("../types").AppState>) => boolean;
@@ -8,6 +9,12 @@ export declare const actionToggleViewMode: {
     perform(elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<import("../types").AppState>): {
         appState: {
             viewModeEnabled: boolean;
+            contextMenu: {
+                items: import("../components/ContextMenu").ContextMenuItems;
+                top: number;
+                left: number;
+            } | null;
+            showWelcomeScreen: boolean;
             isLoading: boolean;
             errorMessage: string | null;
             draggingElement: import("../element/types").NonDeletedExcalidrawElement | null;
@@ -46,10 +53,9 @@ export declare const actionToggleViewMode: {
             currentItemFontFamily: number;
             currentItemFontSize: number;
             currentItemTextAlign: string;
-            currentItemStrokeSharpness: import("../element/types").StrokeSharpness;
             currentItemStartArrowhead: import("../element/types").Arrowhead | null;
             currentItemEndArrowhead: import("../element/types").Arrowhead | null;
-            currentItemLinearStrokeSharpness: import("../element/types").StrokeSharpness;
+            currentItemRoundness: import("../element/types").StrokeRoundness;
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
@@ -64,6 +70,7 @@ export declare const actionToggleViewMode: {
             openMenu: "canvas" | "shape" | null;
             openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
             openSidebar: "library" | "customSidebar" | null;
+            openDialog: "imageExport" | "help" | "jsonExport" | null;
             isSidebarDocked: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
@@ -73,7 +80,6 @@ export declare const actionToggleViewMode: {
                 [id: string]: boolean;
             };
             shouldCacheIgnoreZoom: boolean;
-            showHelpDialog: boolean;
             toast: {
                 message: string;
                 closable?: boolean | undefined;
@@ -108,6 +114,7 @@ export declare const actionToggleViewMode: {
         commitToHistory: false;
     };
     checked: (appState: Readonly<import("../types").AppState>) => boolean;
+    predicate: (elements: readonly import("../element/types").ExcalidrawElement[], appState: import("../types").AppState, appProps: import("../types").ExcalidrawProps) => boolean;
     contextItemLabel: string;
     keyTest: (event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean;
 } & {

package/types/actions/actionToggleZenMode.d.ts

@@ -1,6 +1,7 @@
 /// <reference types="react" />
 export declare const actionToggleZenMode: {
     name: "zenMode";
+    viewMode: true;
     trackEvent: {
         category: "canvas";
         predicate: (appState: Readonly<import("../types").AppState>) => boolean;
@@ -8,6 +9,12 @@ export declare const actionToggleZenMode: {
     perform(elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<import("../types").AppState>): {
         appState: {
             zenModeEnabled: boolean;
+            contextMenu: {
+                items: import("../components/ContextMenu").ContextMenuItems;
+                top: number;
+                left: number;
+            } | null;
+            showWelcomeScreen: boolean;
             isLoading: boolean;
             errorMessage: string | null;
             draggingElement: import("../element/types").NonDeletedExcalidrawElement | null;
@@ -46,10 +53,9 @@ export declare const actionToggleZenMode: {
             currentItemFontFamily: number;
             currentItemFontSize: number;
             currentItemTextAlign: string;
-            currentItemStrokeSharpness: import("../element/types").StrokeSharpness;
             currentItemStartArrowhead: import("../element/types").Arrowhead | null;
             currentItemEndArrowhead: import("../element/types").Arrowhead | null;
-            currentItemLinearStrokeSharpness: import("../element/types").StrokeSharpness;
+            currentItemRoundness: import("../element/types").StrokeRoundness;
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
@@ -64,6 +70,7 @@ export declare const actionToggleZenMode: {
             openMenu: "canvas" | "shape" | null;
             openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
             openSidebar: "library" | "customSidebar" | null;
+            openDialog: "imageExport" | "help" | "jsonExport" | null;
             isSidebarDocked: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
@@ -73,7 +80,6 @@ export declare const actionToggleZenMode: {
                 [id: string]: boolean;
             };
             shouldCacheIgnoreZoom: boolean;
-            showHelpDialog: boolean;
             toast: {
                 message: string;
                 closable?: boolean | undefined;
@@ -108,6 +114,7 @@ export declare const actionToggleZenMode: {
         commitToHistory: false;
     };
     checked: (appState: Readonly<import("../types").AppState>) => boolean;
+    predicate: (elements: readonly import("../element/types").ExcalidrawElement[], appState: import("../types").AppState, appProps: import("../types").ExcalidrawProps) => boolean;
     contextItemLabel: string;
     keyTest: (event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean;
 } & {

package/types/actions/manager.d.ts

@@ -17,4 +17,5 @@ export declare class ActionManager {
      * @param data additional data sent to the PanelComponent
      */
     renderAction: (name: ActionName, data?: PanelComponentProps["data"]) => JSX.Element | null;
+    isActionEnabled: (action: Action) => boolean;
 }

package/types/actions/shortcuts.d.ts

@@ -1,3 +1,3 @@
 import { ActionName } from "./types";
-export declare type ShortcutName = SubtypeOf<ActionName, "cut" | "copy" | "paste" | "copyStyles" | "pasteStyles" | "selectAll" | "deleteSelectedElements" | "duplicateSelection" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyAsPng" | "copyAsSvg" | "group" | "ungroup" | "gridMode" | "zenMode" | "stats" | "addToLibrary" | "viewMode" | "flipHorizontal" | "flipVertical" | "hyperlink" | "toggleLock">;
+export declare type ShortcutName = SubtypeOf<ActionName, "toggleTheme" | "loadScene" | "cut" | "copy" | "paste" | "copyStyles" | "pasteStyles" | "selectAll" | "deleteSelectedElements" | "duplicateSelection" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyAsPng" | "copyAsSvg" | "group" | "ungroup" | "gridMode" | "zenMode" | "stats" | "addToLibrary" | "viewMode" | "flipHorizontal" | "flipVertical" | "hyperlink" | "toggleLock"> | "saveScene" | "imageExport";
 export declare const getShortcutFromShortcutName: (name: ShortcutName) => string;

package/types/actions/types.d.ts

@@ -14,7 +14,7 @@ export declare type ActionResult = {
 declare type ActionFn = (elements: readonly ExcalidrawElement[], appState: Readonly<AppState>, formData: any, app: AppClassProperties) => ActionResult | Promise<ActionResult>;
 export declare type UpdaterFn = (res: ActionResult) => void;
 export declare type ActionFilterFn = (action: Action) => void;
-export declare type ActionName = "copy" | "cut" | "paste" | "copyAsPng" | "copyAsSvg" | "copyText" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyStyles" | "selectAll" | "pasteStyles" | "gridMode" | "zenMode" | "stats" | "changeStrokeColor" | "changeBackgroundColor" | "changeFillStyle" | "changeStrokeWidth" | "changeStrokeShape" | "changeSloppiness" | "changeStrokeStyle" | "changeArrowhead" | "changeOpacity" | "changeFontSize" | "toggleCanvasMenu" | "toggleEditMenu" | "undo" | "redo" | "finalize" | "changeProjectName" | "changeExportBackground" | "changeExportEmbedScene" | "changeExportScale" | "saveToActiveFile" | "saveFileToDisk" | "loadScene" | "duplicateSelection" | "deleteSelectedElements" | "changeViewBackgroundColor" | "clearCanvas" | "zoomIn" | "zoomOut" | "resetZoom" | "zoomToFit" | "zoomToSelection" | "changeFontFamily" | "changeTextAlign" | "changeVerticalAlign" | "toggleFullScreen" | "toggleShortcuts" | "group" | "ungroup" | "goToCollaborator" | "addToLibrary" | "changeSharpness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "viewMode" | "exportWithDarkMode" | "toggleTheme" | "increaseFontSize" | "decreaseFontSize" | "unbindText" | "hyperlink" | "eraser" | "bindText" | "toggleLock" | "toggleLinearEditor";
+export declare type ActionName = "copy" | "cut" | "paste" | "copyAsPng" | "copyAsSvg" | "copyText" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyStyles" | "selectAll" | "pasteStyles" | "gridMode" | "zenMode" | "stats" | "changeStrokeColor" | "changeBackgroundColor" | "changeFillStyle" | "changeStrokeWidth" | "changeStrokeShape" | "changeSloppiness" | "changeStrokeStyle" | "changeArrowhead" | "changeOpacity" | "changeFontSize" | "toggleCanvasMenu" | "toggleEditMenu" | "undo" | "redo" | "finalize" | "changeProjectName" | "changeExportBackground" | "changeExportEmbedScene" | "changeExportScale" | "saveToActiveFile" | "saveFileToDisk" | "loadScene" | "duplicateSelection" | "deleteSelectedElements" | "changeViewBackgroundColor" | "clearCanvas" | "zoomIn" | "zoomOut" | "resetZoom" | "zoomToFit" | "zoomToSelection" | "changeFontFamily" | "changeTextAlign" | "changeVerticalAlign" | "toggleFullScreen" | "toggleShortcuts" | "group" | "ungroup" | "goToCollaborator" | "addToLibrary" | "changeRoundness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "viewMode" | "exportWithDarkMode" | "toggleTheme" | "increaseFontSize" | "decreaseFontSize" | "unbindText" | "hyperlink" | "eraser" | "bindText" | "toggleLock" | "toggleLinearEditor";
 export declare type PanelComponentProps = {
     elements: readonly ExcalidrawElement[];
     appState: AppState;
@@ -29,12 +29,15 @@ export interface Action {
     keyPriority?: number;
     keyTest?: (event: React.KeyboardEvent | KeyboardEvent, appState: AppState, elements: readonly ExcalidrawElement[]) => boolean;
     contextItemLabel?: string | ((elements: readonly ExcalidrawElement[], appState: Readonly<AppState>) => string);
-    contextItemPredicate?: (elements: readonly ExcalidrawElement[], appState: AppState) => boolean;
+    predicate?: (elements: readonly ExcalidrawElement[], appState: AppState, appProps: ExcalidrawProps, app: AppClassProperties) => boolean;
     checked?: (appState: Readonly<AppState>) => boolean;
     trackEvent: false | {
         category: "toolbar" | "element" | "canvas" | "export" | "history" | "menu" | "collab" | "hyperlink";
         action?: string;
         predicate?: (appState: Readonly<AppState>, elements: readonly ExcalidrawElement[], value: any) => boolean;
     };
+    /** if set to `true`, allow action to be performed in viewMode.
+     *  Defaults to `false` */
+    viewMode?: boolean;
 }
 export {};

package/types/appState.d.ts

@@ -1,6 +1,8 @@
 import { AppState, NormalizedZoomValue } from "./types";
 export declare const getDefaultAppState: () => Omit<AppState, "offsetTop" | "offsetLeft" | "width" | "height">;
 export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>) => {
+    theme?: string | undefined;
+    name?: string | undefined;
     activeTool?: {
         type: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | "eraser";
         lastActiveToolBeforeEraser: import("./types").LastActiveToolBeforeEraser;
@@ -12,14 +14,7 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
         lastActiveToolBeforeEraser: import("./types").LastActiveToolBeforeEraser;
         locked: boolean;
     } | undefined;
-    scrollX?: number | undefined;
-    scrollY?: number | undefined;
-    viewBackgroundColor?: string | undefined;
-    zoom?: Readonly<{
-        value: NormalizedZoomValue;
-    }> | undefined;
-    shouldCacheIgnoreZoom?: boolean | undefined;
-    theme?: string | undefined;
+    showWelcomeScreen?: boolean | undefined;
     penMode?: boolean | undefined;
     penDetected?: boolean | undefined;
     exportBackground?: boolean | undefined;
@@ -36,13 +31,17 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     currentItemFontFamily?: number | undefined;
     currentItemFontSize?: number | undefined;
     currentItemTextAlign?: string | undefined;
-    currentItemStrokeSharpness?: import("./element/types").StrokeSharpness | undefined;
     currentItemStartArrowhead?: import("./element/types").Arrowhead | null | undefined;
     currentItemEndArrowhead?: import("./element/types").Arrowhead | null | undefined;
-    currentItemLinearStrokeSharpness?: import("./element/types").StrokeSharpness | undefined;
+    currentItemRoundness?: import("./element/types").StrokeRoundness | undefined;
+    viewBackgroundColor?: string | undefined;
+    scrollX?: number | undefined;
+    scrollY?: number | undefined;
     cursorButton?: "up" | "down" | undefined;
     scrolledOutside?: boolean | undefined;
-    name?: string | undefined;
+    zoom?: Readonly<{
+        value: NormalizedZoomValue;
+    }> | undefined;
     openMenu?: "canvas" | "shape" | null | undefined;
     openSidebar?: "library" | "customSidebar" | null | undefined;
     isSidebarDocked?: boolean | undefined;
@@ -53,6 +52,7 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     previousSelectedElementIds?: {
         [id: string]: boolean;
     } | undefined;
+    shouldCacheIgnoreZoom?: boolean | undefined;
     zenModeEnabled?: boolean | undefined;
     gridSize?: number | null | undefined;
     selectedGroupIds?: {

package/types/clients.d.ts

@@ -3,4 +3,4 @@ export declare const getClientColors: (clientId: string, appState: AppState) =>
     background: string;
     stroke: string;
 };
-export declare const getClientInitials: (username?: string | null) => string;
+export declare const getClientInitials: (userName?: string | null) => string;

package/types/clipboard.d.ts

@@ -12,9 +12,14 @@ export declare const probablySupportsClipboardReadText: boolean;
 export declare const probablySupportsClipboardWriteText: boolean;
 export declare const probablySupportsClipboardBlob: boolean;
 export declare const copyToClipboard: (elements: readonly NonDeletedExcalidrawElement[], appState: AppState, files: BinaryFiles | null) => Promise<void>;
+/**
+ * Retrieves content from system clipboard (either from ClipboardEvent or
+ *  via async clipboard API if supported)
+ */
+export declare const getSystemClipboard: (event: ClipboardEvent | null) => Promise<string>;
 /**
  * Attempts to parse clipboard. Prefers system clipboard.
  */
-export declare const parseClipboard: (event: ClipboardEvent | null) => Promise<ClipboardData>;
+export declare const parseClipboard: (event: ClipboardEvent | null, isPlainPaste?: boolean) => Promise<ClipboardData>;
 export declare const copyBlobToClipboardAsPng: (blob: Blob | Promise<Blob>) => Promise<void>;
 export declare const copyTextToSystemClipboard: (text: string | null) => Promise<void>;

package/types/components/Actions.d.ts

@@ -2,6 +2,7 @@ import React from "react";
 import { ActionManager } from "../actions/manager";
 import { ExcalidrawElement, PointerType } from "../element/types";
 import { AppState, Zoom } from "../types";
+import "./Actions.scss";
 export declare const SelectedShapeActions: ({ appState, elements, renderAction, }: {
     appState: AppState;
     elements: readonly ExcalidrawElement[];

package/types/components/App.d.ts

@@ -7,6 +7,10 @@ import History from "../history";
 import Scene from "../scene/Scene";
 import { AppClassProperties, AppProps, AppState, ExcalidrawImperativeAPI, BinaryFiles, LibraryItems, SceneData, Device } from "../types";
 import { FileSystemHandle } from "../data/filesystem";
+export declare const ExcalidrawContainerContext: React.Context<{
+    container: HTMLDivElement | null;
+    id: string | null;
+}>;
 export declare const useDevice: () => Readonly<{
     isSmScreen: boolean;
     isMobile: boolean;
@@ -20,6 +24,7 @@ export declare const useExcalidrawContainer: () => {
 export declare const useExcalidrawElements: () => readonly NonDeletedExcalidrawElement[];
 export declare const useExcalidrawAppState: () => AppState;
 export declare const useExcalidrawSetAppState: () => <K extends keyof AppState>(state: AppState | ((prevState: Readonly<AppState>, props: Readonly<any>) => AppState | Pick<AppState, K> | null) | Pick<AppState, K> | null, callback?: (() => void) | undefined) => void;
+export declare const useExcalidrawActionManager: () => ActionManager;
 declare class App extends React.Component<AppProps, AppState> {
     canvas: AppClassProperties["canvas"];
     rc: RoughCanvas | null;
@@ -30,6 +35,7 @@ declare class App extends React.Component<AppProps, AppState> {
     private excalidrawContainerRef;
     static defaultProps: Partial<AppProps>;
     scene: Scene;
+    private fonts;
     private resizeObserver;
     private nearestScrollableContainer;
     library: AppClassProperties["library"];
@@ -42,7 +48,6 @@ declare class App extends React.Component<AppProps, AppState> {
     hitLinkElement?: NonDeletedExcalidrawElement;
     lastPointerDown: React.PointerEvent<HTMLCanvasElement> | null;
     lastPointerUp: React.PointerEvent<HTMLElement> | PointerEvent | null;
-    contextMenuOpen: boolean;
     lastScenePointer: {
         x: number;
         y: number;
@@ -57,7 +62,6 @@ declare class App extends React.Component<AppProps, AppState> {
     private onBlur;
     private onUnload;
     private disableEvent;
-    private onFontLoaded;
     private resetHistory;
     /**
      * Resets scene & history.
@@ -81,7 +85,7 @@ declare class App extends React.Component<AppProps, AppState> {
     private static resetTapTwice;
     private onTapStart;
     private onTapEnd;
-    private pasteFromClipboard;
+    pasteFromClipboard: (event: ClipboardEvent | null) => Promise<void>;
     private addElementsFromPasteOrLibrary;
     private addTextFromPaste;
     setAppState: React.Component<any, AppState>["setState"];
@@ -193,8 +197,7 @@ declare class App extends React.Component<AppProps, AppState> {
     private handleCanvasContextMenu;
     private maybeDragNewGenericElement;
     private maybeHandleResize;
-    /** @private use this.handleCanvasContextMenu */
-    private _openContextMenu;
+    private getContextMenuItems;
     private handleWheel;
     private getTextWysiwygSnappedToCenterPosition;
     private savePointer;

package/types/components/Avatar.d.ts

@@ -7,5 +7,5 @@ declare type AvatarProps = {
     name: string;
     src?: string;
 };
-export declare const Avatar: ({ color, border, onClick, name, src }: AvatarProps) => JSX.Element;
+export declare const Avatar: ({ color, onClick, name, src }: AvatarProps) => JSX.Element;
 export {};

package/types/components/Button.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="react" />
+import "./Button.scss";
+interface ButtonProps extends React.HTMLAttributes<HTMLButtonElement> {
+    type?: "button" | "submit" | "reset";
+    onSelect: () => any;
+    children: React.ReactNode;
+    className?: string;
+}
+/**
+ * A generic button component that follows Excalidraw's design system.
+ * Style can be customised using `className` or `style` prop.
+ * Accepts all props that a regular `button` element accepts.
+ */
+export declare const Button: ({ type, onSelect, children, className, ...rest }: ButtonProps) => JSX.Element;
+export {};

package/types/components/ContextMenu.d.ts

@@ -1,28 +1,15 @@
 import "./ContextMenu.scss";
 import { Action } from "../actions/types";
 import { ActionManager } from "../actions/manager";
-import { AppState } from "../types";
-import { NonDeletedExcalidrawElement } from "../element/types";
-export declare type ContextMenuOption = "separator" | Action;
+import React from "react";
+export declare type ContextMenuItem = typeof CONTEXT_MENU_SEPARATOR | Action;
+export declare type ContextMenuItems = (ContextMenuItem | false | null | undefined)[];
 declare type ContextMenuProps = {
-    options: ContextMenuOption[];
-    onCloseRequest?(): void;
+    actionManager: ActionManager;
+    items: ContextMenuItems;
     top: number;
     left: number;
-    actionManager: ActionManager;
-    appState: Readonly<AppState>;
-    elements: readonly NonDeletedExcalidrawElement[];
-};
-declare type ContextMenuParams = {
-    options: (ContextMenuOption | false | null | undefined)[];
-    top: ContextMenuProps["top"];
-    left: ContextMenuProps["left"];
-    actionManager: ContextMenuProps["actionManager"];
-    appState: Readonly<AppState>;
-    container: HTMLElement;
-    elements: readonly NonDeletedExcalidrawElement[];
-};
-declare const _default: {
-    push(params: ContextMenuParams): void;
 };
-export default _default;
+export declare const CONTEXT_MENU_SEPARATOR = "separator";
+export declare const ContextMenu: React.MemoExoticComponent<({ actionManager, items, top, left }: ContextMenuProps) => JSX.Element>;
+export {};

package/types/components/DialogActionButton.d.ts

@@ -0,0 +1,10 @@
+import { ReactNode } from "react";
+import "./DialogActionButton.scss";
+interface DialogActionButtonProps {
+    label: string;
+    children?: ReactNode;
+    actionType?: "primary" | "danger";
+    isLoading?: boolean;
+}
+declare const DialogActionButton: ({ label, onClick, className, children, actionType, type, isLoading, ...rest }: DialogActionButtonProps & React.ButtonHTMLAttributes<HTMLButtonElement>) => JSX.Element;
+export default DialogActionButton;

package/types/components/HelpButton.d.ts

@@ -0,0 +1,8 @@
+declare type HelpButtonProps = {
+    title?: string;
+    name?: string;
+    id?: string;
+    onClick?(): void;
+};
+export declare const HelpButton: (props: HelpButtonProps) => JSX.Element;
+export {};

package/types/components/ImageExportDialog.d.ts

@@ -1,11 +1,13 @@
+import React from "react";
 import { NonDeletedExcalidrawElement } from "../element/types";
 import { AppState, BinaryFiles } from "../types";
 import "./ExportDialog.scss";
 import { ActionManager } from "../actions/manager";
 export declare const ErrorCanvasPreview: () => JSX.Element;
 export declare type ExportCB = (elements: readonly NonDeletedExcalidrawElement[], scale?: number) => void;
-export declare const ImageExportDialog: ({ elements, appState, files, exportPadding, actionManager, onExportToPng, onExportToSvg, onExportToClipboard, }: {
+export declare const ImageExportDialog: ({ elements, appState, setAppState, files, exportPadding, actionManager, onExportToPng, onExportToSvg, onExportToClipboard, }: {
     appState: AppState;
+    setAppState: React.Component<any, AppState>["setState"];
     elements: readonly NonDeletedExcalidrawElement[];
     files: BinaryFiles;
     exportPadding?: number | undefined;

package/types/components/JSONExportDialog.d.ts

@@ -1,13 +1,15 @@
+import React from "react";
 import { NonDeletedExcalidrawElement } from "../element/types";
 import { AppState, ExportOpts, BinaryFiles } from "../types";
 import "./ExportDialog.scss";
 import { ActionManager } from "../actions/manager";
 export declare type ExportCB = (elements: readonly NonDeletedExcalidrawElement[], scale?: number) => void;
-export declare const JSONExportDialog: ({ elements, appState, files, actionManager, exportOpts, canvas, }: {
+export declare const JSONExportDialog: ({ elements, appState, files, actionManager, exportOpts, canvas, setAppState, }: {
     elements: readonly NonDeletedExcalidrawElement[];
     appState: AppState;
     files: BinaryFiles;
     actionManager: ActionManager;
     exportOpts: ExportOpts;
     canvas: HTMLCanvasElement | null;
+    setAppState: React.Component<any, AppState>["setState"];
 }) => JSX.Element;

package/types/components/LayerUI.d.ts

@@ -13,7 +13,6 @@ interface LayerUIProps {
     canvas: HTMLCanvasElement | null;
     setAppState: React.Component<any, AppState>["setState"];
     elements: readonly NonDeletedExcalidrawElement[];
-    onCollabButtonClick?: () => void;
     onLockToggle: () => void;
     onPenModeToggle: () => void;
     onInsertElements: (elements: readonly NonDeletedExcalidrawElement[]) => void;
@@ -21,7 +20,6 @@ interface LayerUIProps {
     langCode: Language["code"];
     isCollaborating: boolean;
     renderTopRightUI?: ExcalidrawProps["renderTopRightUI"];
-    renderCustomFooter?: ExcalidrawProps["renderFooter"];
     renderCustomStats?: ExcalidrawProps["renderCustomStats"];
     renderCustomSidebar?: ExcalidrawProps["renderSidebar"];
     libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
@@ -32,6 +30,8 @@ interface LayerUIProps {
     onImageAction: (data: {
         insertOnCanvasDirectly: boolean;
     }) => void;
+    renderWelcomeScreen: boolean;
+    children?: React.ReactNode;
 }
-declare const _default: React.MemoExoticComponent<({ actionManager, appState, files, setAppState, elements, canvas, onCollabButtonClick, onLockToggle, onPenModeToggle, onInsertElements, showExitZenModeBtn, isCollaborating, renderTopRightUI, renderCustomFooter, renderCustomStats, renderCustomSidebar, libraryReturnUrl, UIOptions, focusContainer, library, id, onImageAction, }: LayerUIProps) => JSX.Element>;
+declare const _default: React.MemoExoticComponent<({ actionManager, appState, files, setAppState, elements, canvas, onLockToggle, onPenModeToggle, onInsertElements, showExitZenModeBtn, isCollaborating, renderTopRightUI, renderCustomStats, renderCustomSidebar, libraryReturnUrl, UIOptions, focusContainer, library, id, onImageAction, renderWelcomeScreen, children, }: LayerUIProps) => JSX.Element>;
 export default _default;