@excalidraw/excalidraw 0.15.2 → 0.16.0-f8b3692

package/types/actions/types.d.ts

@@ -2,9 +2,9 @@ import React from "react";
 import { ExcalidrawElement } from "../element/types";
 import { AppClassProperties, AppState, ExcalidrawProps, BinaryFiles } from "../types";
 import { MarkOptional } from "../utility-types";
-export declare type ActionSource = "ui" | "keyboard" | "contextMenu" | "api";
+export type ActionSource = "ui" | "keyboard" | "contextMenu" | "api";
 /** if false, the action should be prevented */
-export declare type ActionResult = {
+export type ActionResult = {
     elements?: readonly ExcalidrawElement[] | null;
     appState?: MarkOptional<AppState, "offsetTop" | "offsetLeft" | "width" | "height"> | null;
     files?: BinaryFiles | null;
@@ -12,24 +12,25 @@ export declare type ActionResult = {
     syncHistory?: boolean;
     replaceFiles?: boolean;
 } | false;
-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" | "changeRoundness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "viewMode" | "exportWithDarkMode" | "toggleTheme" | "increaseFontSize" | "decreaseFontSize" | "unbindText" | "hyperlink" | "bindText" | "toggleLock" | "toggleLinearEditor" | "toggleEraserTool" | "toggleHandTool" | "wrapTextInContainer";
-export declare type PanelComponentProps = {
+type ActionFn = (elements: readonly ExcalidrawElement[], appState: Readonly<AppState>, formData: any, 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" | "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" | "zoomToFitSelection" | "zoomToFitSelectionInViewport" | "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" | "bindText" | "unlockAllElements" | "toggleElementLock" | "toggleLinearEditor" | "toggleEraserTool" | "toggleHandTool" | "selectAllElementsInFrame" | "removeAllElementsFromFrame" | "updateFrameRendering" | "setFrameAsActiveTool" | "setEmbeddableAsActiveTool" | "createContainerFromText" | "wrapTextInContainer";
+export type PanelComponentProps = {
     elements: readonly ExcalidrawElement[];
     appState: AppState;
     updateData: (formData?: any) => void;
     appProps: ExcalidrawProps;
     data?: Record<string, any>;
+    app: AppClassProperties;
 };
 export interface Action {
     name: ActionName;
     PanelComponent?: React.FC<PanelComponentProps>;
     perform: ActionFn;
     keyPriority?: number;
-    keyTest?: (event: React.KeyboardEvent | KeyboardEvent, appState: AppState, elements: readonly ExcalidrawElement[]) => boolean;
-    contextItemLabel?: string | ((elements: readonly ExcalidrawElement[], appState: Readonly<AppState>) => string);
+    keyTest?: (event: React.KeyboardEvent | KeyboardEvent, appState: AppState, elements: readonly ExcalidrawElement[], app: AppClassProperties) => boolean;
+    contextItemLabel?: string | ((elements: readonly ExcalidrawElement[], appState: Readonly<AppState>, app: AppClassProperties) => string);
     predicate?: (elements: readonly ExcalidrawElement[], appState: AppState, appProps: ExcalidrawProps, app: AppClassProperties) => boolean;
     checked?: (appState: Readonly<AppState>) => boolean;
     trackEvent: false | {

package/types/appState.d.ts

@@ -1,20 +1,20 @@
 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;
+    theme?: import("./element/types").Theme | undefined;
     name?: string | undefined;
     activeTool?: ({
         lastActiveTool: import("./types").LastActiveTool;
         locked: boolean;
     } & ({
-        type: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | "eraser" | "hand";
+        type: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "embeddable" | "image" | "frame" | "freedraw" | "eraser" | "hand";
         customType: null;
     } | {
         type: "custom";
         customType: string;
     })) | undefined;
-    showWelcomeScreen?: boolean | undefined;
     penMode?: boolean | undefined;
+    showWelcomeScreen?: boolean | undefined;
     penDetected?: boolean | undefined;
     exportBackground?: boolean | undefined;
     exportEmbedScene?: boolean | undefined;
@@ -42,14 +42,17 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
         value: NormalizedZoomValue;
     }> | undefined;
     openMenu?: "canvas" | "shape" | null | undefined;
-    openSidebar?: "library" | "customSidebar" | null | undefined;
-    isSidebarDocked?: boolean | undefined;
+    openSidebar?: {
+        name: string;
+        tab?: string | undefined;
+    } | null | undefined;
+    defaultSidebarDockedPreference?: boolean | undefined;
     lastPointerDownWith?: import("./element/types").PointerType | undefined;
-    selectedElementIds?: {
-        [id: string]: boolean;
-    } | undefined;
+    selectedElementIds?: Readonly<{
+        [id: string]: true;
+    }> | undefined;
     previousSelectedElementIds?: {
-        [id: string]: boolean;
+        [id: string]: true;
     } | undefined;
     shouldCacheIgnoreZoom?: boolean | undefined;
     zenModeEnabled?: boolean | undefined;

package/types/charts.d.ts

@@ -1,5 +1,5 @@
 import { NonDeletedExcalidrawElement } from "./element/types";
-export declare type ChartElements = readonly NonDeletedExcalidrawElement[];
+export type ChartElements = readonly NonDeletedExcalidrawElement[];
 export interface Spreadsheet {
     title: string | null;
     labels: string[] | null;
@@ -7,7 +7,7 @@ export interface Spreadsheet {
 }
 export declare const NOT_SPREADSHEET = "NOT_SPREADSHEET";
 export declare const VALID_SPREADSHEET = "VALID_SPREADSHEET";
-declare type ParseSpreadsheetResult = {
+type ParseSpreadsheetResult = {
     type: typeof NOT_SPREADSHEET;
     reason: string;
 } | {

package/types/clients.d.ts

@@ -1,6 +1,5 @@
-import { AppState } from "./types";
-export declare const getClientColors: (clientId: string, appState: AppState) => {
-    background: string;
-    stroke: string;
-};
-export declare const getClientInitials: (userName?: string | null) => string;
+export declare const getClientColor: (id: string) => string;
+/**
+ * returns first char, capitalized
+ */
+export declare const getNameInitial: (name?: string | null) => string;

package/types/clipboard.d.ts

@@ -1,5 +1,5 @@
 import { ExcalidrawElement, NonDeletedExcalidrawElement } from "./element/types";
-import { AppState, BinaryFiles } from "./types";
+import { BinaryFiles } from "./types";
 import { Spreadsheet } from "./charts";
 export interface ClipboardData {
     spreadsheet?: Spreadsheet;
@@ -7,11 +7,12 @@ export interface ClipboardData {
     files?: BinaryFiles;
     text?: string;
     errorMessage?: string;
+    programmaticAPI?: boolean;
 }
 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>;
+export declare const copyToClipboard: (elements: readonly NonDeletedExcalidrawElement[], files: BinaryFiles | null) => Promise<string | undefined>;
 /**
  * Retrieves content from system clipboard (either from ClipboardEvent or
  *  via async clipboard API if supported)

package/types/colors.d.ts

@@ -1,6 +1,61 @@
-declare const _default: {
-    canvasBackground: string[];
-    elementBackground: string[];
-    elementStroke: string[];
+import oc from "open-color";
+import { Merge } from "./utility-types";
+export type ColorPickerColor = Exclude<keyof oc, "indigo" | "lime"> | "transparent" | "bronze";
+export type ColorTuple = readonly [string, string, string, string, string];
+export type ColorPalette = Merge<Record<ColorPickerColor, ColorTuple>, {
+    black: "#1e1e1e";
+    white: "#ffffff";
+    transparent: "transparent";
+}>;
+export type ColorPaletteCustom = {
+    [key: string]: ColorTuple | string;
 };
-export default _default;
+export type ColorShadesIndexes = [number, number, number, number, number];
+export declare const MAX_CUSTOM_COLORS_USED_IN_CANVAS = 5;
+export declare const COLORS_PER_ROW = 5;
+export declare const DEFAULT_CHART_COLOR_INDEX = 4;
+export declare const DEFAULT_ELEMENT_STROKE_COLOR_INDEX = 4;
+export declare const DEFAULT_ELEMENT_BACKGROUND_COLOR_INDEX = 1;
+export declare const ELEMENTS_PALETTE_SHADE_INDEXES: readonly [0, 2, 4, 6, 8];
+export declare const CANVAS_PALETTE_SHADE_INDEXES: readonly [0, 1, 2, 3, 4];
+export declare const getSpecificColorShades: (color: Exclude<ColorPickerColor, "transparent" | "white" | "black" | "bronze">, indexArr: readonly [number, number, number, number, number]) => ColorTuple;
+export declare const COLOR_PALETTE: ColorPalette;
+export declare const DEFAULT_ELEMENT_STROKE_PICKS: ColorTuple;
+export declare const DEFAULT_ELEMENT_BACKGROUND_PICKS: ColorTuple;
+export declare const DEFAULT_CANVAS_BACKGROUND_PICKS: ColorTuple;
+export declare const DEFAULT_ELEMENT_STROKE_COLOR_PALETTE: {
+    readonly red: ColorTuple;
+    readonly pink: ColorTuple;
+    readonly grape: ColorTuple;
+    readonly violet: ColorTuple;
+    readonly blue: ColorTuple;
+    readonly cyan: ColorTuple;
+    readonly teal: ColorTuple;
+    readonly green: ColorTuple;
+    readonly yellow: ColorTuple;
+    readonly orange: ColorTuple;
+    readonly transparent: "transparent";
+    readonly white: "#ffffff";
+    readonly gray: ColorTuple;
+    readonly black: "#1e1e1e";
+    readonly bronze: ColorTuple;
+};
+export declare const DEFAULT_ELEMENT_BACKGROUND_COLOR_PALETTE: {
+    readonly red: ColorTuple;
+    readonly pink: ColorTuple;
+    readonly grape: ColorTuple;
+    readonly violet: ColorTuple;
+    readonly blue: ColorTuple;
+    readonly cyan: ColorTuple;
+    readonly teal: ColorTuple;
+    readonly green: ColorTuple;
+    readonly yellow: ColorTuple;
+    readonly orange: ColorTuple;
+    readonly transparent: "transparent";
+    readonly white: "#ffffff";
+    readonly gray: ColorTuple;
+    readonly black: "#1e1e1e";
+    readonly bronze: ColorTuple;
+};
+export declare const getAllColorsSpecificShade: (index: 0 | 1 | 2 | 3 | 4) => readonly [string, string, string, string, string, string, string, string, string, string];
+export declare const rgbToHex: (r: number, g: number, b: number) => string;

package/types/components/Actions.d.ts

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

package/types/components/ActiveConfirmDialog.d.ts

@@ -1,24 +1,4 @@
-export declare const activeConfirmDialogAtom: import("jotai").Atom<"clearCanvas" | null> & {
-    write: (get: {
-        <Value>(atom: import("jotai").Atom<Value | Promise<Value>>): Value;
-        <Value_1>(atom: import("jotai").Atom<Promise<Value_1>>): Value_1;
-        <Value_2>(atom: import("jotai").Atom<Value_2>): Value_2 extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? any : V : V : V : V : V : V : V : V : V : V : Value_2;
-    } & {
-        <Value_3>(atom: import("jotai").Atom<Value_3 | Promise<Value_3>>, options: {
-            unstable_promise: true;
-        }): Value_3 | Promise<Value_3>;
-        <Value_4>(atom: import("jotai").Atom<Promise<Value_4>>, options: {
-            unstable_promise: true;
-        }): Value_4 | Promise<Value_4>;
-        <Value_5>(atom: import("jotai").Atom<Value_5>, options: {
-            unstable_promise: true;
-        }): (Value_5 extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? any : V : V : V : V : V : V : V : V : V : V : Value_5) | Promise<Value_5 extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? any : V : V : V : V : V : V : V : V : V : V : Value_5>;
-    }, set: {
-        <Value_6, Result extends void | Promise<void>>(atom: import("jotai").WritableAtom<Value_6, undefined, Result>): Result;
-        <Value_7, Update, Result_1 extends void | Promise<void>>(atom: import("jotai").WritableAtom<Value_7, Update, Result_1>, update: Update): Result_1;
-    }, update: "clearCanvas" | ((prev: "clearCanvas" | null) => "clearCanvas" | null) | null) => void;
-    onMount?: (<S extends (update: "clearCanvas" | ((prev: "clearCanvas" | null) => "clearCanvas" | null) | null) => void>(setAtom: S) => void | (() => void)) | undefined;
-} & {
+export declare const activeConfirmDialogAtom: import("jotai").PrimitiveAtom<"clearCanvas" | null> & {
     init: "clearCanvas" | null;
 };
 export declare const ActiveConfirmDialog: () => JSX.Element | null;

package/types/components/App.d.ts

@@ -1,21 +1,26 @@
 import React from "react";
 import { RoughCanvas } from "roughjs/bin/canvas";
 import { ActionManager } from "../actions/manager";
+import { EXPORT_IMAGE_TYPES } from "../constants";
 import { LinearElementEditor } from "../element/linearElementEditor";
 import { ExcalidrawElement, NonDeletedExcalidrawElement } from "../element/types";
 import History from "../history";
 import Scene from "../scene/Scene";
-import { AppClassProperties, AppProps, AppState, ExcalidrawImperativeAPI, BinaryFiles, LibraryItems, SceneData, Device } from "../types";
+import { AppClassProperties, AppProps, AppState, ExcalidrawImperativeAPI, BinaryFiles, LibraryItems, SceneData, Device, FrameNameBoundsCache, SidebarName, SidebarTabName } from "../types";
 import { FileSystemHandle } from "../data/filesystem";
+import { Renderer } from "../scene/Renderer";
 export declare const ExcalidrawContainerContext: React.Context<{
     container: HTMLDivElement | null;
     id: string | null;
 }>;
+export declare const useApp: () => AppClassProperties;
+export declare const useAppProps: () => AppProps;
 export declare const useDevice: () => Readonly<{
     isSmScreen: boolean;
     isMobile: boolean;
     isTouchScreen: boolean;
     canDeviceFitSidebar: boolean;
+    isLandscape: boolean;
 }>;
 export declare const useExcalidrawContainer: () => {
     container: HTMLDivElement | null;
@@ -27,7 +32,8 @@ export declare const useExcalidrawSetAppState: () => <K extends keyof AppState>(
 export declare const useExcalidrawActionManager: () => ActionManager;
 declare class App extends React.Component<AppProps, AppState> {
     canvas: AppClassProperties["canvas"];
-    rc: RoughCanvas | null;
+    interactiveCanvas: AppClassProperties["interactiveCanvas"];
+    rc: RoughCanvas;
     unmounted: boolean;
     actionManager: ActionManager;
     device: Device;
@@ -35,29 +41,43 @@ declare class App extends React.Component<AppProps, AppState> {
     private excalidrawContainerRef;
     static defaultProps: Partial<AppProps>;
     scene: Scene;
+    renderer: Renderer;
     private fonts;
     private resizeObserver;
     private nearestScrollableContainer;
     library: AppClassProperties["library"];
     libraryItemsFromStorage: LibraryItems | undefined;
-    private id;
+    id: string;
     private history;
     private excalidrawContainerValue;
     files: BinaryFiles;
     imageCache: AppClassProperties["imageCache"];
+    private iFrameRefs;
     hitLinkElement?: NonDeletedExcalidrawElement;
-    lastPointerDown: React.PointerEvent<HTMLCanvasElement> | null;
+    lastPointerDown: React.PointerEvent<HTMLElement> | null;
     lastPointerUp: React.PointerEvent<HTMLElement> | PointerEvent | null;
-    lastScenePointer: {
+    lastViewportPosition: {
         x: number;
         y: number;
-    } | null;
+    };
     constructor(props: AppProps);
-    private renderCanvas;
+    private onWindowMessage;
+    private updateEmbeddableRef;
+    private getHTMLIFrameElement;
+    private handleEmbeddableCenterClick;
+    private isEmbeddableCenter;
+    private updateEmbeddables;
+    private renderEmbeddables;
+    private getFrameNameDOMId;
+    frameNameBoundsCache: FrameNameBoundsCache;
+    private renderFrameNames;
     render(): JSX.Element;
     focusContainer: AppClassProperties["focusContainer"];
     getSceneElementsIncludingDeleted: () => readonly ExcalidrawElement[];
     getSceneElements: () => readonly NonDeletedExcalidrawElement[];
+    onInsertElements: (elements: readonly ExcalidrawElement[]) => void;
+    onExportImage: (type: keyof typeof EXPORT_IMAGE_TYPES, elements: readonly NonDeletedExcalidrawElement[]) => Promise<void>;
+    private openEyeDropper;
     private syncActionResult;
     private onBlur;
     private onUnload;
@@ -76,21 +96,27 @@ declare class App extends React.Component<AppProps, AppState> {
     private removeEventListeners;
     private addEventListeners;
     componentDidUpdate(prevProps: AppProps, prevState: AppState): void;
-    private renderScene;
+    private renderInteractiveSceneCallback;
     private onScroll;
     private onCut;
     private onCopy;
     private cutAll;
     private copyAll;
     private static resetTapTwice;
-    private onTapStart;
-    private onTapEnd;
+    private onTouchStart;
+    private onTouchEnd;
     pasteFromClipboard: (event: ClipboardEvent | null) => Promise<void>;
     private addElementsFromPasteOrLibrary;
     private addTextFromPaste;
     setAppState: React.Component<any, AppState>["setState"];
     removePointer: (event: React.PointerEvent<HTMLElement> | PointerEvent) => void;
     toggleLock: (source?: "keyboard" | "ui") => void;
+    updateFrameRendering: (opts: Partial<{
+        enabled: boolean;
+        name: boolean;
+        outline: boolean;
+        clip: boolean;
+    }> | ((prevState: AppState["frameRendering"]) => Partial<AppState["frameRendering"]>)) => void;
     togglePenMode: () => void;
     onHandToolToggle: () => void;
     /**
@@ -100,6 +126,17 @@ declare class App extends React.Component<AppProps, AppState> {
     private cancelInProgresAnimation;
     scrollToContent: (target?: ExcalidrawElement | readonly ExcalidrawElement[], opts?: {
         fitToContent?: boolean;
+        fitToViewport?: never;
+        viewportZoomFactor?: never;
+        animate?: boolean;
+        duration?: number;
+    } | {
+        fitToContent?: never;
+        fitToViewport?: boolean;
+        /** when fitToViewport=true, how much screen should the content cover,
+         * between 0.1 (10%) and 1 (100%)
+         */
+        viewportZoomFactor?: number;
         animate?: boolean;
         duration?: number;
     }) => void;
@@ -123,7 +160,11 @@ declare class App extends React.Component<AppProps, AppState> {
     /**
      * @returns whether the menu was toggled on or off
      */
-    toggleMenu: (type: "library" | "customSidebar", force?: boolean) => boolean;
+    toggleSidebar: ({ name, tab, force, }: {
+        name: SidebarName;
+        tab?: string | undefined;
+        force?: boolean | undefined;
+    }) => boolean;
     private updateCurrentCursorPosition;
     private onKeyDown;
     private onWheel;
@@ -150,6 +191,7 @@ declare class App extends React.Component<AppProps, AppState> {
     private handleCanvasDoubleClick;
     private getElementLinkAtPosition;
     private redirectToLink;
+    private getTopLayerFrameAtSceneCoords;
     private handleCanvasPointerMove;
     private handleEraser;
     private handleTouchMove;
@@ -172,9 +214,12 @@ declare class App extends React.Component<AppProps, AppState> {
     private isHittingCommonBoundingBoxOfSelectedElements;
     private handleTextOnPointerDown;
     private handleFreeDrawElementOnPointerDown;
+    private insertEmbeddableElement;
     private createImageElement;
     private handleLinearElementOnPointerDown;
+    private getCurrentItemRoundness;
     private createGenericElementOnPointerDown;
+    private createFrameElementOnPointerDown;
     private onKeyDownFromPointerDownHandler;
     private onKeyUpFromPointerDownHandler;
     private onPointerMoveFromPointerDownHandler;
@@ -203,7 +248,7 @@ declare class App extends React.Component<AppProps, AppState> {
     private maybeSuggestBindingsForLinearElementAtCoords;
     private maybeSuggestBindingForAll;
     private clearSelection;
-    private handleCanvasRef;
+    private handleInteractiveCanvasRef;
     private handleAppOnDrop;
     loadFileToCanvas: (file: File, fileHandle: FileSystemHandle | null) => Promise<void>;
     private handleCanvasContextMenu;

package/types/components/Avatar.d.ts

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

package/types/components/Button.d.ts

@@ -1,8 +1,9 @@
-/// <reference types="react" />
 import "./Button.scss";
 interface ButtonProps extends React.HTMLAttributes<HTMLButtonElement> {
     type?: "button" | "submit" | "reset";
     onSelect: () => any;
+    /** whether button is in active state */
+    selected?: boolean;
     children: React.ReactNode;
     className?: string;
 }
@@ -11,5 +12,5 @@ interface ButtonProps extends React.HTMLAttributes<HTMLButtonElement> {
  * 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 declare const Button: ({ type, onSelect, selected, children, className, ...rest }: ButtonProps) => JSX.Element;
 export {};

package/types/components/Card.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import OpenColor from "open-color";
 import "./Card.scss";
 export declare const Card: React.FC<{

package/types/components/ColorPicker/ColorInput.d.ts

@@ -0,0 +1,9 @@
+import { ColorPickerType } from "./colorPickerUtils";
+interface ColorInputProps {
+    color: string;
+    onChange: (color: string) => void;
+    label: string;
+    colorPickerType: ColorPickerType;
+}
+export declare const ColorInput: ({ color, onChange, label, colorPickerType, }: ColorInputProps) => JSX.Element;
+export {};

package/types/components/ColorPicker/ColorPicker.d.ts

@@ -0,0 +1,19 @@
+import { ExcalidrawElement } from "../../element/types";
+import { AppState } from "../../types";
+import { ColorPickerType } from "./colorPickerUtils";
+import { ColorTuple, ColorPaletteCustom } from "../../colors";
+import "./ColorPicker.scss";
+export declare const getColor: (color: string) => string | null;
+interface ColorPickerProps {
+    type: ColorPickerType;
+    color: string;
+    onChange: (color: string) => void;
+    label: string;
+    elements: readonly ExcalidrawElement[];
+    appState: AppState;
+    palette?: ColorPaletteCustom | null;
+    topPicks?: ColorTuple;
+    updateData: (formData?: any) => void;
+}
+export declare const ColorPicker: ({ type, color, onChange, label, elements, palette, topPicks, updateData, appState, }: ColorPickerProps) => JSX.Element;
+export {};

package/types/components/ColorPicker/CustomColorList.d.ts

@@ -0,0 +1,8 @@
+interface CustomColorListProps {
+    colors: string[];
+    color: string;
+    onChange: (color: string) => void;
+    label: string;
+}
+export declare const CustomColorList: ({ colors, color, onChange, label, }: CustomColorListProps) => JSX.Element;
+export {};

package/types/components/ColorPicker/HotkeyLabel.d.ts

@@ -0,0 +1,8 @@
+interface HotkeyLabelProps {
+    color: string;
+    keyLabel: string | number;
+    isCustomColor?: boolean;
+    isShade?: boolean;
+}
+declare const HotkeyLabel: ({ color, keyLabel, isCustomColor, isShade, }: HotkeyLabelProps) => JSX.Element;
+export default HotkeyLabel;

package/types/components/ColorPicker/Picker.d.ts

@@ -0,0 +1,18 @@
+import React from "react";
+import { ExcalidrawElement } from "../../element/types";
+import { ColorPickerType } from "./colorPickerUtils";
+import { ColorPaletteCustom } from "../../colors";
+interface PickerProps {
+    color: string;
+    onChange: (color: string) => void;
+    label: string;
+    type: ColorPickerType;
+    elements: readonly ExcalidrawElement[];
+    palette: ColorPaletteCustom;
+    updateData: (formData?: any) => void;
+    children?: React.ReactNode;
+    onEyeDropperToggle: (force?: boolean) => void;
+    onEscape: (event: React.KeyboardEvent | KeyboardEvent) => void;
+}
+export declare const Picker: ({ color, onChange, label, type, elements, palette, updateData, children, onEyeDropperToggle, onEscape, }: PickerProps) => JSX.Element;
+export {};

package/types/components/ColorPicker/PickerColorList.d.ts

@@ -0,0 +1,10 @@
+import { ColorPaletteCustom } from "../../colors";
+interface PickerColorListProps {
+    palette: ColorPaletteCustom;
+    color: string;
+    onChange: (color: string) => void;
+    label: string;
+    activeShade: number;
+}
+declare const PickerColorList: ({ palette, color, onChange, label, activeShade, }: PickerColorListProps) => JSX.Element;
+export default PickerColorList;

package/types/components/ColorPicker/PickerHeading.d.ts

@@ -0,0 +1,5 @@
+import { ReactNode } from "react";
+declare const PickerHeading: ({ children }: {
+    children: ReactNode;
+}) => JSX.Element;
+export default PickerHeading;

package/types/components/ColorPicker/ShadeList.d.ts

@@ -0,0 +1,8 @@
+import { ColorPaletteCustom } from "../../colors";
+interface ShadeListProps {
+    hex: string;
+    onChange: (color: string) => void;
+    palette: ColorPaletteCustom;
+}
+export declare const ShadeList: ({ hex, onChange, palette }: ShadeListProps) => JSX.Element;
+export {};

package/types/components/ColorPicker/TopPicks.d.ts

@@ -0,0 +1,9 @@
+import { ColorPickerType } from "./colorPickerUtils";
+interface TopPicksProps {
+    onChange: (color: string) => void;
+    type: ColorPickerType;
+    activeColor: string;
+    topPicks?: readonly string[];
+}
+export declare const TopPicks: ({ onChange, type, activeColor, topPicks, }: TopPicksProps) => JSX.Element | null;
+export {};

package/types/components/ColorPicker/colorPickerUtils.d.ts

@@ -0,0 +1,21 @@
+import { ExcalidrawElement } from "../../element/types";
+import { ColorPickerColor, ColorPaletteCustom } from "../../colors";
+export declare const getColorNameAndShadeFromColor: ({ palette, color, }: {
+    palette: ColorPaletteCustom;
+    color: string;
+}) => {
+    colorName: ColorPickerColor;
+    shade: number | null;
+} | null;
+export declare const colorPickerHotkeyBindings: string[];
+export declare const isCustomColor: ({ color, palette, }: {
+    color: string;
+    palette: ColorPaletteCustom;
+}) => boolean;
+export declare const getMostUsedCustomColors: (elements: readonly ExcalidrawElement[], type: "elementBackground" | "elementStroke", palette: ColorPaletteCustom) => string[];
+export type ActiveColorPickerSectionAtomType = "custom" | "baseColors" | "shades" | "hex" | null;
+export declare const activeColorPickerSectionAtom: import("jotai").PrimitiveAtom<ActiveColorPickerSectionAtomType> & {
+    init: ActiveColorPickerSectionAtomType;
+};
+export declare const getContrastYIQ: (bgHex: string, isCustomColor: boolean) => "white" | "black";
+export type ColorPickerType = "canvasBackground" | "elementBackground" | "elementStroke";

package/types/components/ColorPicker/keyboardNavHandlers.d.ts

@@ -0,0 +1,20 @@
+import { ColorPaletteCustom } from "../../colors";
+import { ActiveColorPickerSectionAtomType } from "./colorPickerUtils";
+interface ColorPickerKeyNavHandlerProps {
+    event: React.KeyboardEvent;
+    activeColorPickerSection: ActiveColorPickerSectionAtomType;
+    palette: ColorPaletteCustom;
+    color: string;
+    onChange: (color: string) => void;
+    customColors: string[];
+    setActiveColorPickerSection: (update: React.SetStateAction<ActiveColorPickerSectionAtomType>) => void;
+    updateData: (formData?: any) => void;
+    activeShade: number;
+    onEyeDropperToggle: (force?: boolean) => void;
+    onEscape: (event: React.KeyboardEvent | KeyboardEvent) => void;
+}
+/**
+ * @returns true if the event was handled
+ */
+export declare const colorPickerKeyNavHandler: ({ event, activeColorPickerSection, palette, color, onChange, customColors, setActiveColorPickerSection, updateData, activeShade, onEyeDropperToggle, onEscape, }: ColorPickerKeyNavHandlerProps) => boolean;
+export {};