@excalidraw/excalidraw 0.15.1 → 0.15.2-13780f3

package/types/actions/actionProperties.d.ts

@@ -5,7 +5,7 @@ export declare const actionChangeStrokeColor: {
     name: "changeStrokeColor";
     trackEvent: false;
     perform: (elements: readonly ExcalidrawElement[], appState: Readonly<AppState>, value: any) => any;
-    PanelComponent: ({ elements, appState, updateData }: import("./types").PanelComponentProps) => JSX.Element;
+    PanelComponent: ({ elements, appState, updateData, appProps }: import("./types").PanelComponentProps) => JSX.Element;
 } & {
     keyTest?: undefined;
 };
@@ -13,7 +13,7 @@ export declare const actionChangeBackgroundColor: {
     name: "changeBackgroundColor";
     trackEvent: false;
     perform: (elements: readonly ExcalidrawElement[], appState: Readonly<AppState>, value: any) => any;
-    PanelComponent: ({ elements, appState, updateData }: import("./types").PanelComponentProps) => JSX.Element;
+    PanelComponent: ({ elements, appState, updateData, appProps }: import("./types").PanelComponentProps) => JSX.Element;
 } & {
     keyTest?: undefined;
 };
@@ -81,10 +81,13 @@ export declare const actionChangeFillStyle: {
                 value: import("../../src/types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -195,10 +198,13 @@ export declare const actionChangeStrokeWidth: {
                 value: import("../../src/types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -309,10 +315,13 @@ export declare const actionChangeSloppiness: {
                 value: import("../../src/types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -423,10 +432,13 @@ export declare const actionChangeStrokeStyle: {
                 value: import("../../src/types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -537,10 +549,13 @@ export declare const actionChangeOpacity: {
                 value: import("../../src/types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -651,10 +666,13 @@ export declare const actionChangeFontSize: {
                 value: import("../../src/types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -765,10 +783,13 @@ export declare const actionDecreaseFontSize: {
                 value: import("../../src/types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -879,10 +900,13 @@ export declare const actionIncreaseFontSize: {
                 value: import("../../src/types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -993,10 +1017,13 @@ export declare const actionChangeFontFamily: {
                 value: import("../../src/types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -1107,10 +1134,13 @@ export declare const actionChangeTextAlign: {
                 value: import("../../src/types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -1223,10 +1253,13 @@ export declare const actionChangeVerticalAlign: {
                 value: import("../../src/types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -1337,10 +1370,13 @@ export declare const actionChangeRoundness: {
                 value: import("../../src/types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -1454,10 +1490,13 @@ export declare const actionChangeArrowhead: {
                 value: import("../../src/types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;

package/types/actions/actionStyles.d.ts

@@ -68,10 +68,13 @@ export declare const actionCopyStyles: {
                 value: import("../types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;

package/types/actions/actionToggleGridMode.d.ts

@@ -68,10 +68,13 @@ export declare const actionToggleGridMode: {
                 value: import("../types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;

package/types/actions/actionToggleStats.d.ts

@@ -66,10 +66,13 @@ export declare const actionToggleStats: {
                 value: import("../types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;

package/types/actions/actionToggleViewMode.d.ts

@@ -67,10 +67,13 @@ export declare const actionToggleViewMode: {
                 value: import("../types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;

package/types/actions/actionToggleZenMode.d.ts

@@ -67,10 +67,13 @@ export declare const actionToggleZenMode: {
                 value: import("../types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("../element/types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;

package/types/actions/index.d.ts

@@ -20,5 +20,5 @@ export { actionToggleZenMode } from "./actionToggleZenMode";
 export { actionToggleStats } from "./actionToggleStats";
 export { actionUnbindText, actionBindText } from "./actionBoundText";
 export { actionLink } from "../element/Hyperlink";
-export { actionToggleLock } from "./actionToggleLock";
+export { actionToggleElementLock } from "./actionElementLock";
 export { actionToggleLinearEditor } from "./actionLinearEditor";

package/types/actions/shortcuts.d.ts

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

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,11 +12,11 @@ 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" | "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" | "unlockAllElements" | "toggleElementLock" | "toggleLinearEditor" | "toggleEraserTool" | "toggleHandTool" | "wrapTextInContainer";
+export type PanelComponentProps = {
     elements: readonly ExcalidrawElement[];
     appState: AppState;
     updateData: (formData?: any) => void;

package/types/appState.d.ts

@@ -42,8 +42,11 @@ 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;

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

@@ -3,4 +3,7 @@ export declare const getClientColors: (clientId: string, appState: AppState) =>
     background: string;
     stroke: string;
 };
-export declare const getClientInitials: (userName?: string | null) => 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;
@@ -11,7 +11,7 @@ export interface ClipboardData {
 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,60 @@
-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: string;
+    white: string;
+    transparent: string;
+}>;
+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: string;
+    readonly white: string;
+    readonly gray: ColorTuple;
+    readonly black: string;
+    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: string;
+    readonly white: string;
+    readonly gray: ColorTuple;
+    readonly black: string;
+    readonly bronze: ColorTuple;
+};
+export declare const getAllColorsSpecificShade: (index: 0 | 1 | 2 | 3 | 4) => readonly [string, string, string, string, string, string, string, string, string, 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"];
+    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/App.d.ts

@@ -1,21 +1,25 @@
 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, SidebarName, SidebarTabName } from "../types";
 import { FileSystemHandle } from "../data/filesystem";
 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;
@@ -40,7 +44,7 @@ declare class App extends React.Component<AppProps, AppState> {
     private nearestScrollableContainer;
     library: AppClassProperties["library"];
     libraryItemsFromStorage: LibraryItems | undefined;
-    private id;
+    id: string;
     private history;
     private excalidrawContainerValue;
     files: BinaryFiles;
@@ -58,6 +62,8 @@ declare class App extends React.Component<AppProps, AppState> {
     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 syncActionResult;
     private onBlur;
     private onUnload;
@@ -123,7 +129,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;

package/types/components/Avatar.d.ts

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

package/types/components/Button.d.ts

@@ -3,6 +3,8 @@ 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 +13,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/ColorPicker/ColorInput.d.ts

@@ -0,0 +1,7 @@
+interface ColorInputProps {
+    color: string | null;
+    onChange: (color: string) => void;
+    label: string;
+}
+export declare const ColorInput: ({ color, onChange, label }: ColorInputProps) => JSX.Element;
+export {};