@excalidraw/excalidraw 0.10.1 → 0.11.0-11a3380

package/types/actions/index.d.ts

@@ -2,7 +2,7 @@ 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, } from "./actionProperties";
+export { actionChangeStrokeColor, actionChangeBackgroundColor, actionChangeStrokeWidth, actionChangeFillStyle, actionChangeSloppiness, actionChangeOpacity, actionChangeFontSize, actionChangeFontFamily, actionChangeTextAlign, actionChangeVerticalAlign, } from "./actionProperties";
 export { actionChangeViewBackgroundColor, actionClearCanvas, actionZoomIn, actionZoomOut, actionResetZoom, actionZoomToFit, actionToggleTheme, } from "./actionCanvas";
 export { actionFinalize } from "./actionFinalize";
 export { actionChangeProjectName, actionChangeExportBackground, actionSaveToActiveFile, actionSaveFileToDisk, actionLoadScene, } from "./actionExport";
@@ -14,7 +14,10 @@ export { actionAddToLibrary } from "./actionAddToLibrary";
 export { actionAlignTop, actionAlignBottom, actionAlignLeft, actionAlignRight, actionAlignVerticallyCentered, actionAlignHorizontallyCentered, } from "./actionAlign";
 export { distributeHorizontally, distributeVertically, } from "./actionDistribute";
 export { actionFlipHorizontal, actionFlipVertical } from "./actionFlip";
-export { actionCopy, actionCut, actionCopyAsPng, actionCopyAsSvg, } from "./actionClipboard";
+export { actionCopy, actionCut, actionCopyAsPng, actionCopyAsSvg, copyText, } from "./actionClipboard";
 export { actionToggleGridMode } from "./actionToggleGridMode";
 export { actionToggleZenMode } from "./actionToggleZenMode";
 export { actionToggleStats } from "./actionToggleStats";
+export { actionUnbindText, actionBindText } from "./actionBoundText";
+export { actionLink } from "../element/Hyperlink";
+export { actionToggleLock } from "./actionToggleLock";

package/types/actions/manager.d.ts

@@ -1,28 +1,20 @@
 import React from "react";
-import { Action, ActionsManagerInterface, UpdaterFn, ActionName, ActionResult, PanelComponentProps } from "./types";
+import { Action, UpdaterFn, ActionName, ActionResult, PanelComponentProps, ActionSource } from "./types";
 import { ExcalidrawElement } from "../element/types";
-import { AppProps, AppState } from "../types";
-import Library from "../data/library";
-declare type App = {
-    canvas: HTMLCanvasElement | null;
-    focusContainer: () => void;
-    props: AppProps;
-    library: Library;
-};
-export declare class ActionManager implements ActionsManagerInterface {
+import { AppClassProperties, AppState } from "../types";
+export declare class ActionManager {
     actions: Record<ActionName, Action>;
     updater: (actionResult: ActionResult | Promise<ActionResult>) => void;
     getAppState: () => Readonly<AppState>;
     getElementsIncludingDeleted: () => readonly ExcalidrawElement[];
-    app: App;
-    constructor(updater: UpdaterFn, getAppState: () => AppState, getElementsIncludingDeleted: () => readonly ExcalidrawElement[], app: App);
+    app: AppClassProperties;
+    constructor(updater: UpdaterFn, getAppState: () => AppState, getElementsIncludingDeleted: () => readonly ExcalidrawElement[], app: AppClassProperties);
     registerAction(action: Action): void;
     registerAll(actions: readonly Action[]): void;
     handleKeyDown(event: React.KeyboardEvent | KeyboardEvent): boolean;
-    executeAction(action: Action): void;
+    executeAction(action: Action, source?: ActionSource): void;
     /**
      * @param data additional data sent to the PanelComponent
      */
     renderAction: (name: ActionName, data?: PanelComponentProps["data"]) => JSX.Element | null;
 }
-export {};

package/types/actions/register.d.ts

@@ -1,3 +1,5 @@
 import { Action } from "./types";
 export declare let actions: readonly Action[];
-export declare const register: (action: Action) => Action;
+export declare const register: <T extends Action>(action: T) => T & {
+    keyTest?: (unknown extends T["keyTest"] ? never : T["keyTest"]) | undefined;
+};

package/types/actions/shortcuts.d.ts

@@ -1,2 +1,3 @@
-export declare type ShortcutName = "cut" | "copy" | "paste" | "copyStyles" | "pasteStyles" | "selectAll" | "deleteSelectedElements" | "duplicateSelection" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyAsPng" | "copyAsSvg" | "group" | "ungroup" | "gridMode" | "zenMode" | "stats" | "addToLibrary" | "viewMode" | "flipHorizontal" | "flipVertical";
+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 const getShortcutFromShortcutName: (name: ShortcutName) => string;

package/types/actions/types.d.ts

@@ -1,33 +1,26 @@
 import React from "react";
 import { ExcalidrawElement } from "../element/types";
-import { AppState, ExcalidrawProps } from "../types";
-import Library from "../data/library";
-import { ToolButtonSize } from "../components/ToolButton";
+import { AppClassProperties, AppState, ExcalidrawProps, BinaryFiles } from "../types";
+export declare type ActionSource = "ui" | "keyboard" | "contextMenu" | "api";
 /** if false, the action should be prevented */
 export declare type ActionResult = {
     elements?: readonly ExcalidrawElement[] | null;
     appState?: MarkOptional<AppState, "offsetTop" | "offsetLeft" | "width" | "height"> | null;
+    files?: BinaryFiles | null;
     commitToHistory: boolean;
     syncHistory?: boolean;
+    replaceFiles?: boolean;
 } | false;
-declare type AppAPI = {
-    canvas: HTMLCanvasElement | null;
-    focusContainer(): void;
-    library: Library;
-};
-declare type ActionFn = (elements: readonly ExcalidrawElement[], appState: Readonly<AppState>, formData: any, app: AppAPI) => ActionResult | Promise<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" | "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" | "toggleFullScreen" | "toggleShortcuts" | "group" | "ungroup" | "goToCollaborator" | "addToLibrary" | "changeSharpness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "viewMode" | "exportWithDarkMode" | "toggleTheme";
+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";
 export declare type PanelComponentProps = {
     elements: readonly ExcalidrawElement[];
     appState: AppState;
     updateData: (formData?: any) => void;
     appProps: ExcalidrawProps;
-    data?: Partial<{
-        id: string;
-        size: ToolButtonSize;
-    }>;
+    data?: Record<string, any>;
 };
 export interface Action {
     name: ActionName;
@@ -35,15 +28,13 @@ export interface Action {
     perform: ActionFn;
     keyPriority?: number;
     keyTest?: (event: React.KeyboardEvent | KeyboardEvent, appState: AppState, elements: readonly ExcalidrawElement[]) => boolean;
-    contextItemLabel?: string;
+    contextItemLabel?: string | ((elements: readonly ExcalidrawElement[], appState: Readonly<AppState>) => string);
     contextItemPredicate?: (elements: readonly ExcalidrawElement[], appState: AppState) => boolean;
     checked?: (appState: Readonly<AppState>) => boolean;
-}
-export interface ActionsManagerInterface {
-    actions: Record<ActionName, Action>;
-    registerAction: (action: Action) => void;
-    handleKeyDown: (event: React.KeyboardEvent | KeyboardEvent) => boolean;
-    renderAction: (name: ActionName) => React.ReactElement | null;
-    executeAction: (action: Action) => void;
+    trackEvent: false | {
+        category: "toolbar" | "element" | "canvas" | "export" | "history" | "menu" | "collab" | "hyperlink";
+        action?: string;
+        predicate?: (appState: Readonly<AppState>, elements: readonly ExcalidrawElement[], value: any) => boolean;
+    };
 }
 export {};

package/types/align.d.ts

@@ -4,4 +4,3 @@ export interface Alignment {
     axis: "x" | "y";
 }
 export declare const alignElements: (selectedElements: ExcalidrawElement[], alignment: Alignment) => ExcalidrawElement[];
-export declare const getMaximumGroups: (elements: ExcalidrawElement[]) => ExcalidrawElement[][];

package/types/analytics.d.ts

@@ -1 +1 @@
-export declare const trackEvent: (category: string, name: string, label?: string | undefined, value?: number | undefined) => void;
+export declare const trackEvent: (category: string, action: string, label?: string | undefined, value?: number | undefined) => void;

package/types/appState.d.ts

@@ -1,17 +1,27 @@
 import { AppState, NormalizedZoomValue } from "./types";
 export declare const getDefaultAppState: () => Omit<AppState, "offsetTop" | "offsetLeft" | "width" | "height">;
 export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>) => {
+    activeTool?: {
+        type: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | "eraser";
+        lastActiveToolBeforeEraser: import("./types").LastActiveToolBeforeEraser;
+        locked: boolean;
+        customType: null;
+    } | {
+        type: "custom";
+        customType: string;
+        lastActiveToolBeforeEraser: import("./types").LastActiveToolBeforeEraser;
+        locked: boolean;
+    } | undefined;
+    scrollX?: number | undefined;
+    scrollY?: number | undefined;
+    viewBackgroundColor?: string | undefined;
     zoom?: Readonly<{
         value: NormalizedZoomValue;
-        translation: Readonly<{
-            x: number;
-            y: number;
-        }>;
     }> | undefined;
-    scrollX?: number | undefined;
-    scrollY?: number | undefined;
-    elementType?: "line" | "selection" | "rectangle" | "diamond" | "ellipse" | "text" | "arrow" | "freedraw" | undefined;
-    elementLocked?: boolean | undefined;
+    shouldCacheIgnoreZoom?: boolean | undefined;
+    theme?: string | undefined;
+    penMode?: boolean | undefined;
+    penDetected?: boolean | undefined;
     exportBackground?: boolean | undefined;
     exportEmbedScene?: boolean | undefined;
     exportWithDarkMode?: boolean | undefined;
@@ -30,7 +40,6 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     currentItemStartArrowhead?: import("./element/types").Arrowhead | null | undefined;
     currentItemEndArrowhead?: import("./element/types").Arrowhead | null | undefined;
     currentItemLinearStrokeSharpness?: import("./element/types").StrokeSharpness | undefined;
-    viewBackgroundColor?: string | undefined;
     cursorButton?: "up" | "down" | undefined;
     scrolledOutside?: boolean | undefined;
     name?: string | undefined;
@@ -42,14 +51,14 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     previousSelectedElementIds?: {
         [id: string]: boolean;
     } | undefined;
-    shouldCacheIgnoreZoom?: boolean | undefined;
     zenModeEnabled?: boolean | undefined;
-    theme?: "light" | "dark" | undefined;
     gridSize?: number | null | undefined;
     selectedGroupIds?: {
         [groupId: string]: boolean;
     } | undefined;
     editingGroupId?: string | null | undefined;
+    isLibraryOpen?: boolean | undefined;
+    isLibraryMenuDocked?: boolean | undefined;
     showStats?: boolean | undefined;
     currentChartType?: import("./element/types").ChartType | undefined;
 };
@@ -57,3 +66,10 @@ export declare const cleanAppStateForExport: (appState: Partial<AppState>) => {
     viewBackgroundColor?: string | undefined;
     gridSize?: number | null | undefined;
 };
+export declare const clearAppStateForDatabase: (appState: Partial<AppState>) => {
+    viewBackgroundColor?: string | undefined;
+    gridSize?: number | null | undefined;
+};
+export declare const isEraserActive: ({ activeTool, }: {
+    activeTool: AppState["activeTool"];
+}) => boolean;

package/types/charts.d.ts

@@ -14,6 +14,14 @@ declare type ParseSpreadsheetResult = {
     type: typeof VALID_SPREADSHEET;
     spreadsheet: Spreadsheet;
 };
+/**
+ * @private exported for testing
+ */
+export declare const tryParseNumber: (s: string) => number | null;
+/**
+ * @private exported for testing
+ */
+export declare const tryParseCells: (cells: string[][]) => ParseSpreadsheetResult;
 export declare const tryParseSpreadsheet: (text: string) => ParseSpreadsheetResult;
 export declare const renderSpreadsheet: (chartType: string, spreadsheet: Spreadsheet, x: number, y: number) => ChartElements;
 export {};

package/types/clipboard.d.ts

@@ -1,19 +1,20 @@
 import { ExcalidrawElement, NonDeletedExcalidrawElement } from "./element/types";
-import { AppState } from "./types";
+import { AppState, BinaryFiles } from "./types";
 import { Spreadsheet } from "./charts";
 export interface ClipboardData {
     spreadsheet?: Spreadsheet;
     elements?: readonly ExcalidrawElement[];
+    files?: BinaryFiles;
     text?: string;
     errorMessage?: string;
 }
 export declare const probablySupportsClipboardReadText: boolean;
 export declare const probablySupportsClipboardWriteText: boolean;
 export declare const probablySupportsClipboardBlob: boolean;
-export declare const copyToClipboard: (elements: readonly NonDeletedExcalidrawElement[], appState: AppState) => Promise<void>;
+export declare const copyToClipboard: (elements: readonly NonDeletedExcalidrawElement[], appState: AppState, files: BinaryFiles | null) => Promise<void>;
 /**
- * Attemps to parse clipboard. Prefers system clipboard.
+ * Attempts to parse clipboard. Prefers system clipboard.
  */
 export declare const parseClipboard: (event: ClipboardEvent | null) => Promise<ClipboardData>;
-export declare const copyBlobToClipboardAsPng: (blob: Blob) => Promise<void>;
+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

@@ -1,17 +1,21 @@
 import React from "react";
 import { ActionManager } from "../actions/manager";
-import { ExcalidrawElement } from "../element/types";
+import { ExcalidrawElement, PointerType } from "../element/types";
 import { AppState, Zoom } from "../types";
-export declare const SelectedShapeActions: ({ appState, elements, renderAction, elementType, }: {
+export declare const SelectedShapeActions: ({ appState, elements, renderAction, activeTool, }: {
     appState: AppState;
     elements: readonly ExcalidrawElement[];
     renderAction: ActionManager["renderAction"];
-    elementType: ExcalidrawElement["type"];
+    activeTool: AppState["activeTool"]["type"];
 }) => JSX.Element;
-export declare const ShapesSwitcher: ({ canvas, elementType, setAppState, }: {
+export declare const ShapesSwitcher: ({ canvas, activeTool, setAppState, onImageAction, appState, }: {
     canvas: HTMLCanvasElement | null;
-    elementType: ExcalidrawElement["type"];
+    activeTool: AppState["activeTool"];
     setAppState: React.Component<any, AppState>["setState"];
+    onImageAction: (data: {
+        pointerType: PointerType | null;
+    }) => void;
+    appState: AppState;
 }) => JSX.Element;
 export declare const ZoomActions: ({ renderAction, zoom, }: {
     renderAction: ActionManager["renderAction"];

package/types/components/App.d.ts

@@ -1,44 +1,59 @@
 import React from "react";
 import { RoughCanvas } from "roughjs/bin/canvas";
 import { ActionManager } from "../actions/manager";
-import Library from "../data/library";
-import { ExcalidrawElement } from "../element/types";
+import { ExcalidrawElement, NonDeletedExcalidrawElement } from "../element/types";
 import History from "../history";
-import { AppProps, AppState, LibraryItems, SceneData } from "../types";
-export declare const useIsMobile: () => boolean;
+import Scene from "../scene/Scene";
+import { AppClassProperties, AppProps, AppState, ExcalidrawImperativeAPI, BinaryFiles, LibraryItems, SceneData, Device } from "../types";
+import { FileSystemHandle } from "../data/filesystem";
+export declare const useDevice: () => Readonly<{
+    isSmScreen: boolean;
+    isMobile: boolean;
+    isTouchScreen: boolean;
+    canDeviceFitSidebar: boolean;
+}>;
 export declare const useExcalidrawContainer: () => {
     container: HTMLDivElement | null;
     id: string | null;
 };
 declare class App extends React.Component<AppProps, AppState> {
-    canvas: HTMLCanvasElement | null;
+    canvas: AppClassProperties["canvas"];
     rc: RoughCanvas | null;
     unmounted: boolean;
     actionManager: ActionManager;
-    isMobile: boolean;
+    device: Device;
     detachIsMobileMqHandler?: () => void;
     private excalidrawContainerRef;
     static defaultProps: Partial<AppProps>;
-    private scene;
+    scene: Scene;
     private resizeObserver;
     private nearestScrollableContainer;
-    library: Library;
+    library: AppClassProperties["library"];
     libraryItemsFromStorage: LibraryItems | undefined;
     private id;
     private history;
     private excalidrawContainerValue;
+    files: BinaryFiles;
+    imageCache: AppClassProperties["imageCache"];
+    hitLinkElement?: NonDeletedExcalidrawElement;
+    lastPointerDown: React.PointerEvent<HTMLCanvasElement> | null;
+    lastPointerUp: React.PointerEvent<HTMLElement> | PointerEvent | null;
+    contextMenuOpen: boolean;
+    lastScenePointer: {
+        x: number;
+        y: number;
+    } | null;
     constructor(props: AppProps);
     private renderCanvas;
     render(): JSX.Element;
-    focusContainer: () => void;
+    focusContainer: AppClassProperties["focusContainer"];
     getSceneElementsIncludingDeleted: () => readonly ExcalidrawElement[];
-    getSceneElements: () => readonly import("../element/types").NonDeletedExcalidrawElement[];
+    getSceneElements: () => readonly NonDeletedExcalidrawElement[];
     private syncActionResult;
     private onBlur;
     private onUnload;
     private disableEvent;
     private onFontLoaded;
-    private importLibraryFromUrl;
     private resetHistory;
     /**
      * Resets scene & history.
@@ -46,6 +61,7 @@ declare class App extends React.Component<AppProps, AppState> {
      */
     private resetScene;
     private initializeScene;
+    private refreshDeviceState;
     componentDidMount(): Promise<void>;
     componentWillUnmount(): void;
     private onResize;
@@ -65,13 +81,15 @@ declare class App extends React.Component<AppProps, AppState> {
     private addTextFromPaste;
     setAppState: (obj: any) => void;
     removePointer: (event: React.PointerEvent<HTMLElement> | PointerEvent) => void;
-    toggleLock: () => void;
+    toggleLock: (source?: "keyboard" | "ui") => void;
+    togglePenMode: () => void;
     toggleZenMode: () => void;
-    toggleStats: () => void;
     scrollToContent: (target?: ExcalidrawElement | readonly ExcalidrawElement[]) => void;
     clearToast: () => void;
     setToastMessage: (toastMessage: string) => void;
     restoreFileFromShare: () => Promise<void>;
+    /** adds supplied files to existing files in the appState */
+    addFiles: ExcalidrawImperativeAPI["addFiles"];
     updateScene: <K extends keyof AppState>(sceneData: {
         elements?: SceneData["elements"];
         appState?: Pick<AppState, K> | null | undefined;
@@ -82,7 +100,16 @@ declare class App extends React.Component<AppProps, AppState> {
     private updateCurrentCursorPosition;
     private onKeyDown;
     private onKeyUp;
-    private selectShapeTool;
+    private setActiveTool;
+    private setCursor;
+    private resetCursor;
+    /**
+     * returns whether user is making a gesture with >= 2 fingers (points)
+     * on o touch screen (not on a trackpad). Currently only relates to Darwin
+     * (iOS/iPadOS,MacOS), but may work on other devices in the future if
+     * GestureEvent is standardized.
+     */
+    private isTouchScreenMultiTouchGesture;
     private onGestureStart;
     private onGestureChange;
     private onGestureEnd;
@@ -93,10 +120,15 @@ declare class App extends React.Component<AppProps, AppState> {
     private getElementsAtPosition;
     private startTextEditing;
     private handleCanvasDoubleClick;
+    private getElementLinkAtPosition;
+    private redirectToLink;
     private handleCanvasPointerMove;
+    private handleEraser;
     private handleTouchMove;
     private handleCanvasPointerDown;
+    private handleCanvasPointerUp;
     private maybeOpenContextMenuAfterPointerDownOnTouchDevices;
+    private resetContextMenuTimer;
     private maybeCleanupAfterMissingPointerUp;
     private handleCanvasPanUsingWheelOrSpaceDrag;
     private updateGestureOnPointerDown;
@@ -111,6 +143,7 @@ declare class App extends React.Component<AppProps, AppState> {
     private isHittingCommonBoundingBoxOfSelectedElements;
     private handleTextOnPointerDown;
     private handleFreeDrawElementOnPointerDown;
+    private createImageElement;
     private handleLinearElementOnPointerDown;
     private createGenericElementOnPointerDown;
     private onKeyDownFromPointerDownHandler;
@@ -118,14 +151,32 @@ declare class App extends React.Component<AppProps, AppState> {
     private onPointerMoveFromPointerDownHandler;
     private handlePointerMoveOverScrollbars;
     private onPointerUpFromPointerDownHandler;
+    private restoreReadyToEraseElements;
+    private eraseElements;
+    private initializeImage;
+    /**
+     * inserts image into elements array and rerenders
+     */
+    private insertImageElement;
+    private setImagePreviewCursor;
+    private onImageAction;
+    private initializeImageDimensions;
+    /** updates image cache, refreshing updated elements and/or setting status
+        to error for images that fail during <img> element creation */
+    private updateImageCache;
+    /** adds new images to imageCache and re-renders if needed */
+    private addNewImagesToImageCache;
+    /** generally you should use `addNewImagesToImageCache()` directly if you need
+     *  to render new images. This is just a failsafe  */
+    private scheduleImageRefresh;
     private updateBindingEnabledOnPointerMove;
     private maybeSuggestBindingAtCursor;
-    private maybeSuggestBindingForLinearElementAtCursor;
+    private maybeSuggestBindingsForLinearElementAtCoords;
     private maybeSuggestBindingForAll;
     private clearSelection;
     private handleCanvasRef;
     private handleAppOnDrop;
-    loadFileToCanvas: (file: Blob) => void;
+    loadFileToCanvas: (file: File, fileHandle: FileSystemHandle | null) => Promise<void>;
     private handleCanvasContextMenu;
     private maybeDragNewGenericElement;
     private maybeHandleResize;

package/types/components/Avatar.d.ts

@@ -1,10 +1,11 @@
 import "./Avatar.scss";
 import React from "react";
 declare type AvatarProps = {
-    children: string;
     onClick: (e: React.MouseEvent<HTMLDivElement, MouseEvent>) => void;
     color: string;
     border: string;
+    name: string;
+    src?: string;
 };
-export declare const Avatar: ({ children, color, border, onClick }: AvatarProps) => JSX.Element;
+export declare const Avatar: ({ color, border, onClick, name, src }: AvatarProps) => JSX.Element;
 export {};

package/types/components/ButtonIconSelect.d.ts

@@ -4,6 +4,7 @@ export declare const ButtonIconSelect: <T extends Object>({ options, value, onCh
         value: T;
         text: string;
         icon: JSX.Element;
+        testId?: string | undefined;
     }[];
     value: T | null;
     onChange: (value: T) => void;

package/types/components/Card.d.ts

@@ -2,5 +2,5 @@
 import OpenColor from "open-color";
 import "./Card.scss";
 export declare const Card: React.FC<{
-    color: keyof OpenColor;
+    color: keyof OpenColor | "primary";
 }>;

package/types/components/CheckboxItem.d.ts

@@ -2,5 +2,6 @@ import React from "react";
 import "./CheckboxItem.scss";
 export declare const CheckboxItem: React.FC<{
     checked: boolean;
-    onChange: (checked: boolean) => void;
+    onChange: (checked: boolean, event: React.MouseEvent) => void;
+    className?: string;
 }>;

package/types/components/ColorPicker.d.ts

@@ -1,10 +1,15 @@
 /// <reference types="react" />
 import "./ColorPicker.scss";
-export declare const ColorPicker: ({ type, color, onChange, label, isActive, setActive, }: {
+import { ExcalidrawElement } from "../element/types";
+import { AppState } from "../types";
+export declare const getCustomColors: (elements: readonly ExcalidrawElement[], type: "elementBackground" | "elementStroke") => string[];
+export declare const ColorPicker: ({ type, color, onChange, label, isActive, setActive, elements, appState, }: {
     type: "canvasBackground" | "elementBackground" | "elementStroke";
     color: string | null;
     onChange: (color: string) => void;
     label: string;
     isActive: boolean;
     setActive: (active: boolean) => void;
+    elements: readonly ExcalidrawElement[];
+    appState: AppState;
 }) => JSX.Element;

package/types/components/ContextMenu.d.ts

@@ -2,6 +2,7 @@ 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;
 declare type ContextMenuProps = {
     options: ContextMenuOption[];
@@ -10,6 +11,7 @@ declare type ContextMenuProps = {
     left: number;
     actionManager: ActionManager;
     appState: Readonly<AppState>;
+    elements: readonly NonDeletedExcalidrawElement[];
 };
 declare type ContextMenuParams = {
     options: (ContextMenuOption | false | null | undefined)[];
@@ -18,6 +20,7 @@ declare type ContextMenuParams = {
     actionManager: ContextMenuProps["actionManager"];
     appState: Readonly<AppState>;
     container: HTMLElement;
+    elements: readonly NonDeletedExcalidrawElement[];
 };
 declare const _default: {
     push(params: ContextMenuParams): void;

package/types/components/DarkModeToggle.d.ts

@@ -1,8 +1,8 @@
 /// <reference types="react" />
 import "./ToolIcon.scss";
-export declare type Appearence = "light" | "dark";
+import { Theme } from "../element/types";
 export declare const DarkModeToggle: (props: {
-    value: Appearence;
-    onChange: (value: Appearence) => void;
+    value: Theme;
+    onChange: (value: Theme) => void;
     title?: string | undefined;
 }) => JSX.Element;

package/types/components/Dialog.d.ts

@@ -1,7 +1,7 @@
 import React from "react";
 import "./Dialog.scss";
 import { AppState } from "../types";
-export declare const Dialog: (props: {
+export interface DialogProps {
     children: React.ReactNode;
     className?: string;
     small?: boolean;
@@ -9,4 +9,6 @@ export declare const Dialog: (props: {
     title: React.ReactNode;
     autofocus?: boolean;
     theme?: AppState["theme"];
-}) => JSX.Element;
+    closeOnClickOutside?: boolean;
+}
+export declare const Dialog: (props: DialogProps) => JSX.Element;

package/types/components/HintViewer.d.ts

@@ -2,9 +2,10 @@
 import { NonDeletedExcalidrawElement } from "../element/types";
 import "./HintViewer.scss";
 import { AppState } from "../types";
-interface Hint {
+interface HintViewerProps {
     appState: AppState;
     elements: readonly NonDeletedExcalidrawElement[];
+    isMobile: boolean;
 }
-export declare const HintViewer: ({ appState, elements }: Hint) => JSX.Element | null;
+export declare const HintViewer: ({ appState, elements, isMobile, }: HintViewerProps) => JSX.Element | null;
 export {};

package/types/components/ImageExportDialog.d.ts

@@ -1,15 +1,16 @@
 /// <reference types="react" />
-import { ActionsManagerInterface } from "../actions/types";
 import { NonDeletedExcalidrawElement } from "../element/types";
-import { AppState } from "../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, exportPadding, actionManager, onExportToPng, onExportToSvg, onExportToClipboard, }: {
+export declare const ImageExportDialog: ({ elements, appState, files, exportPadding, actionManager, onExportToPng, onExportToSvg, onExportToClipboard, }: {
     appState: AppState;
     elements: readonly NonDeletedExcalidrawElement[];
+    files: BinaryFiles;
     exportPadding?: number | undefined;
-    actionManager: ActionsManagerInterface;
+    actionManager: ActionManager;
     onExportToPng: ExportCB;
     onExportToSvg: ExportCB;
     onExportToClipboard: ExportCB;

package/types/components/InitializeApp.d.ts

@@ -2,15 +2,7 @@ import React from "react";
 import { Language } from "../i18n";
 interface Props {
     langCode: Language["code"];
+    children: React.ReactElement;
 }
-interface State {
-    isLoading: boolean;
-}
-export declare class InitializeApp extends React.Component<Props, State> {
-    state: {
-        isLoading: boolean;
-    };
-    componentDidMount(): Promise<void>;
-    render(): React.ReactNode;
-}
+export declare const InitializeApp: (props: Props) => JSX.Element;
 export {};