@excalidraw/excalidraw 0.15.2-45a57d7 → 0.15.2-5b75965

package/types/element/types.d.ts

@@ -1,23 +1,23 @@
 import { Point } from "../types";
 import { FONT_FAMILY, ROUNDNESS, TEXT_ALIGN, THEME, VERTICAL_ALIGN } from "../constants";
 import { MarkNonNullable, ValueOf } from "../utility-types";
-export declare type ChartType = "bar" | "line";
-export declare type FillStyle = "hachure" | "cross-hatch" | "solid" | "zigzag";
-export declare type FontFamilyKeys = keyof typeof FONT_FAMILY;
-export declare type FontFamilyValues = typeof FONT_FAMILY[FontFamilyKeys];
-export declare type Theme = typeof THEME[keyof typeof THEME];
-export declare type FontString = string & {
+export type ChartType = "bar" | "line";
+export type FillStyle = "hachure" | "cross-hatch" | "solid" | "zigzag";
+export type FontFamilyKeys = keyof typeof FONT_FAMILY;
+export type FontFamilyValues = typeof FONT_FAMILY[FontFamilyKeys];
+export type Theme = typeof THEME[keyof typeof THEME];
+export type FontString = string & {
     _brand: "fontString";
 };
-export declare type GroupId = string;
-export declare type PointerType = "mouse" | "pen" | "touch";
-export declare type StrokeRoundness = "round" | "sharp";
-export declare type RoundnessType = ValueOf<typeof ROUNDNESS>;
-export declare type StrokeStyle = "solid" | "dashed" | "dotted";
-export declare type TextAlign = typeof TEXT_ALIGN[keyof typeof TEXT_ALIGN];
-declare type VerticalAlignKeys = keyof typeof VERTICAL_ALIGN;
-export declare type VerticalAlign = typeof VERTICAL_ALIGN[VerticalAlignKeys];
-declare type _ExcalidrawElementBase = Readonly<{
+export type GroupId = string;
+export type PointerType = "mouse" | "pen" | "touch";
+export type StrokeRoundness = "round" | "sharp";
+export type RoundnessType = ValueOf<typeof ROUNDNESS>;
+export type StrokeStyle = "solid" | "dashed" | "dotted";
+export type TextAlign = typeof TEXT_ALIGN[keyof typeof TEXT_ALIGN];
+type VerticalAlignKeys = keyof typeof VERTICAL_ALIGN;
+export type VerticalAlign = typeof VERTICAL_ALIGN[VerticalAlignKeys];
+type _ExcalidrawElementBase = Readonly<{
     id: string;
     x: number;
     y: number;
@@ -60,19 +60,19 @@ declare type _ExcalidrawElementBase = Readonly<{
     locked: boolean;
     customData?: Record<string, any>;
 }>;
-export declare type ExcalidrawSelectionElement = _ExcalidrawElementBase & {
+export type ExcalidrawSelectionElement = _ExcalidrawElementBase & {
     type: "selection";
 };
-export declare type ExcalidrawRectangleElement = _ExcalidrawElementBase & {
+export type ExcalidrawRectangleElement = _ExcalidrawElementBase & {
     type: "rectangle";
 };
-export declare type ExcalidrawDiamondElement = _ExcalidrawElementBase & {
+export type ExcalidrawDiamondElement = _ExcalidrawElementBase & {
     type: "diamond";
 };
-export declare type ExcalidrawEllipseElement = _ExcalidrawElementBase & {
+export type ExcalidrawEllipseElement = _ExcalidrawElementBase & {
     type: "ellipse";
 };
-export declare type ExcalidrawImageElement = _ExcalidrawElementBase & Readonly<{
+export type ExcalidrawImageElement = _ExcalidrawElementBase & Readonly<{
     type: "image";
     fileId: FileId | null;
     /** whether respective file is persisted */
@@ -80,22 +80,22 @@ export declare type ExcalidrawImageElement = _ExcalidrawElementBase & Readonly<{
     /** X and Y scale factors <-1, 1>, used for image axis flipping */
     scale: [number, number];
 }>;
-export declare type InitializedExcalidrawImageElement = MarkNonNullable<ExcalidrawImageElement, "fileId">;
+export type InitializedExcalidrawImageElement = MarkNonNullable<ExcalidrawImageElement, "fileId">;
 /**
  * These are elements that don't have any additional properties.
  */
-export declare type ExcalidrawGenericElement = ExcalidrawSelectionElement | ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawEllipseElement;
+export type ExcalidrawGenericElement = ExcalidrawSelectionElement | ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawEllipseElement;
 /**
  * ExcalidrawElement should be JSON serializable and (eventually) contain
  * no computed data. The list of all ExcalidrawElements should be shareable
  * between peers and contain no state local to the peer.
  */
-export declare type ExcalidrawElement = ExcalidrawGenericElement | ExcalidrawTextElement | ExcalidrawLinearElement | ExcalidrawFreeDrawElement | ExcalidrawImageElement;
-export declare type NonDeleted<TElement extends ExcalidrawElement> = TElement & {
+export type ExcalidrawElement = ExcalidrawGenericElement | ExcalidrawTextElement | ExcalidrawLinearElement | ExcalidrawFreeDrawElement | ExcalidrawImageElement;
+export type NonDeleted<TElement extends ExcalidrawElement> = TElement & {
     isDeleted: boolean;
 };
-export declare type NonDeletedExcalidrawElement = NonDeleted<ExcalidrawElement>;
-export declare type ExcalidrawTextElement = _ExcalidrawElementBase & Readonly<{
+export type NonDeletedExcalidrawElement = NonDeleted<ExcalidrawElement>;
+export type ExcalidrawTextElement = _ExcalidrawElementBase & Readonly<{
     type: "text";
     fontSize: number;
     fontFamily: FontFamilyValues;
@@ -113,18 +113,18 @@ export declare type ExcalidrawTextElement = _ExcalidrawElementBase & Readonly<{
         _brand: "unitlessLineHeight";
     };
 }>;
-export declare type ExcalidrawBindableElement = ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawEllipseElement | ExcalidrawTextElement | ExcalidrawImageElement;
-export declare type ExcalidrawTextContainer = ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawEllipseElement | ExcalidrawImageElement | ExcalidrawArrowElement;
-export declare type ExcalidrawTextElementWithContainer = {
+export type ExcalidrawBindableElement = ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawEllipseElement | ExcalidrawTextElement | ExcalidrawImageElement;
+export type ExcalidrawTextContainer = ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawEllipseElement | ExcalidrawImageElement | ExcalidrawArrowElement;
+export type ExcalidrawTextElementWithContainer = {
     containerId: ExcalidrawTextContainer["id"];
 } & ExcalidrawTextElement;
-export declare type PointBinding = {
+export type PointBinding = {
     elementId: ExcalidrawBindableElement["id"];
     focus: number;
     gap: number;
 };
-export declare type Arrowhead = "arrow" | "bar" | "dot" | "triangle";
-export declare type ExcalidrawLinearElement = _ExcalidrawElementBase & Readonly<{
+export type Arrowhead = "arrow" | "bar" | "dot" | "triangle";
+export type ExcalidrawLinearElement = _ExcalidrawElementBase & Readonly<{
     type: "line" | "arrow";
     points: readonly Point[];
     lastCommittedPoint: Point | null;
@@ -133,17 +133,17 @@ export declare type ExcalidrawLinearElement = _ExcalidrawElementBase & Readonly<
     startArrowhead: Arrowhead | null;
     endArrowhead: Arrowhead | null;
 }>;
-export declare type ExcalidrawArrowElement = ExcalidrawLinearElement & Readonly<{
+export type ExcalidrawArrowElement = ExcalidrawLinearElement & Readonly<{
     type: "arrow";
 }>;
-export declare type ExcalidrawFreeDrawElement = _ExcalidrawElementBase & Readonly<{
+export type ExcalidrawFreeDrawElement = _ExcalidrawElementBase & Readonly<{
     type: "freedraw";
     points: readonly Point[];
     pressures: readonly number[];
     simulatePressure: boolean;
     lastCommittedPoint: Point | null;
 }>;
-export declare type FileId = string & {
+export type FileId = string & {
     _brand: "FileId";
 };
 export {};

package/types/errors.d.ts

@@ -1,4 +1,4 @@
-declare type CANVAS_ERROR_NAMES = "CANVAS_ERROR" | "CANVAS_POSSIBLY_TOO_BIG";
+type CANVAS_ERROR_NAMES = "CANVAS_ERROR" | "CANVAS_POSSIBLY_TOO_BIG";
 export declare class CanvasError extends Error {
     constructor(message?: string, name?: CANVAS_ERROR_NAMES);
 }

package/types/ga.d.ts

@@ -16,15 +16,15 @@
  * See GAPoint, GALine, GADirection and GATransform modules for common
  * operations.
  */
-export declare type Point = NVector;
-export declare type Direction = NVector;
-export declare type Line = NVector;
-export declare type Transform = NVector;
+export type Point = NVector;
+export type Direction = NVector;
+export type Line = NVector;
+export type Transform = NVector;
 export declare const point: (x: number, y: number) => NVector;
 export declare const origin: () => NVector;
 export declare const direction: (x: number, y: number) => NVector;
 export declare const offset: (x: number, y: number) => NVector;
-declare type NVector = readonly [
+type NVector = readonly [
     number,
     number,
     number,

package/types/hooks/useOutsideClick.d.ts

@@ -1,2 +1,2 @@
 /// <reference types="react" />
-export declare const useOutsideClickHook: (handler: (event: Event) => void) => import("react").MutableRefObject<null>;
+export declare const useOutsideClick: (handler: (event: Event) => void) => import("react").MutableRefObject<null>;

package/types/i18n.d.ts

@@ -12,10 +12,10 @@ export declare const setLanguage: (lang: Language) => Promise<void>;
 export declare const getLanguage: () => Language;
 export declare const t: (path: string, replacement?: {
     [key: string]: string | number;
-} | undefined) => string;
+} | null | undefined, fallback?: string) => string;
 export declare const useI18n: () => {
     t: (path: string, replacement?: {
         [key: string]: string | number;
-    } | undefined) => string;
+    } | null | undefined, fallback?: string) => string;
     langCode: string;
 };

package/types/keys.d.ts

@@ -70,7 +70,7 @@ export declare const KEYS: {
     readonly 8: "8";
     readonly 9: "9";
 };
-export declare type Key = keyof typeof KEYS;
+export type Key = keyof typeof KEYS;
 export declare const isArrowKey: (key: string) => boolean;
 export declare const shouldResizeFromCenter: (event: MouseEvent | KeyboardEvent) => boolean;
 export declare const shouldMaintainAspectRatio: (event: MouseEvent | KeyboardEvent) => boolean;

package/types/packages/excalidraw/dist/excalidraw-assets-dev/locales/zh-HK-json-e69824cc96d688bf90d2.d.ts

@@ -0,0 +1,2 @@
+declare const _exports: any;
+export = _exports;

package/types/packages/excalidraw/dist/excalidraw-assets-dev/locales/zh-TW-json-7dbf8aee365138759c72.d.ts

@@ -0,0 +1,2 @@
+declare const _exports: any;
+export = _exports;

package/types/packages/excalidraw/index.d.ts

@@ -6,7 +6,7 @@ import Footer from "../../components/footer/FooterCenter";
 import MainMenu from "../../components/main-menu/MainMenu";
 import WelcomeScreen from "../../components/welcome-screen/WelcomeScreen";
 import LiveCollaborationTrigger from "../../components/live-collaboration/LiveCollaborationTrigger";
-declare type PublicExcalidrawProps = Omit<ExcalidrawProps, "forwardedRef">;
+type PublicExcalidrawProps = Omit<ExcalidrawProps, "forwardedRef">;
 export declare const Excalidraw: React.MemoExoticComponent<React.ForwardRefExoticComponent<PublicExcalidrawProps & React.RefAttributes<ExcalidrawAPIRefValue>>>;
 export { getSceneVersion, isInvisiblySmallElement, getNonDeletedElements, } from "../../element";
 export { defaultLang, useI18n, languages } from "../../i18n";
@@ -24,3 +24,4 @@ export { MainMenu };
 export { useDevice } from "../../components/App";
 export { WelcomeScreen };
 export { LiveCollaborationTrigger };
+export { DefaultSidebar } from "../../components/DefaultSidebar";

package/types/packages/utils.d.ts

@@ -2,7 +2,7 @@ import { AppState, BinaryFiles } from "../types";
 import { ExcalidrawElement, NonDeleted } from "../element/types";
 import { MIME_TYPES } from "../constants";
 export { MIME_TYPES };
-declare type ExportOpts = {
+type ExportOpts = {
     elements: readonly NonDeleted<ExcalidrawElement>[];
     appState?: Partial<Omit<AppState, "offsetTop" | "offsetLeft">>;
     files: BinaryFiles | null;

package/types/renderer/renderElement.d.ts

@@ -15,8 +15,8 @@ export interface ExcalidrawElementWithCanvas {
     boundTextElementVersion: number | null;
 }
 export declare const DEFAULT_LINK_SIZE = 14;
-declare type ElementShape = Drawable | Drawable[] | null;
-declare type ElementShapes = {
+type ElementShape = Drawable | Drawable[] | null;
+type ElementShapes = {
     freedraw: Drawable | null;
     arrow: Drawable[];
     line: Drawable[];

package/types/scene/Scene.d.ts

@@ -1,9 +1,9 @@
 import { ExcalidrawElement, NonDeletedExcalidrawElement, NonDeleted } from "../element/types";
 import { LinearElementEditor } from "../element/linearElementEditor";
-declare type ElementIdKey = InstanceType<typeof LinearElementEditor>["elementId"];
-declare type ElementKey = ExcalidrawElement | ElementIdKey;
-declare type SceneStateCallback = () => void;
-declare type SceneStateCallbackRemover = () => void;
+type ElementIdKey = InstanceType<typeof LinearElementEditor>["elementId"];
+type ElementKey = ExcalidrawElement | ElementIdKey;
+type SceneStateCallback = () => void;
+type SceneStateCallbackRemover = () => void;
 declare class Scene {
     private static sceneMapByElement;
     private static sceneMapById;

package/types/scene/selection.d.ts

@@ -1,11 +1,11 @@
 import { ExcalidrawElement, NonDeletedExcalidrawElement } from "../element/types";
 import { AppState } from "../types";
 export declare const getElementsWithinSelection: (elements: readonly NonDeletedExcalidrawElement[], selection: NonDeletedExcalidrawElement) => NonDeletedExcalidrawElement[];
-export declare const isSomeElementSelected: (elements: readonly NonDeletedExcalidrawElement[], appState: AppState) => boolean;
+export declare const isSomeElementSelected: (elements: readonly NonDeletedExcalidrawElement[], appState: Pick<AppState, "selectedElementIds">) => boolean;
 /**
  * Returns common attribute (picked by `getAttribute` callback) of selected
  *  elements. If elements don't share the same value, returns `null`.
  */
-export declare const getCommonAttributeOfSelectedElements: <T>(elements: readonly NonDeletedExcalidrawElement[], appState: AppState, getAttribute: (element: ExcalidrawElement) => T) => T | null;
-export declare const getSelectedElements: (elements: readonly NonDeletedExcalidrawElement[], appState: AppState, includeBoundTextElement?: boolean) => NonDeletedExcalidrawElement[];
-export declare const getTargetElements: (elements: readonly NonDeletedExcalidrawElement[], appState: AppState) => NonDeletedExcalidrawElement[];
+export declare const getCommonAttributeOfSelectedElements: <T>(elements: readonly NonDeletedExcalidrawElement[], appState: Pick<AppState, "selectedElementIds">, getAttribute: (element: ExcalidrawElement) => T) => T | null;
+export declare const getSelectedElements: (elements: readonly NonDeletedExcalidrawElement[], appState: Pick<AppState, "selectedElementIds">, includeBoundTextElement?: boolean) => NonDeletedExcalidrawElement[];
+export declare const getTargetElements: (elements: readonly NonDeletedExcalidrawElement[], appState: Pick<AppState, "selectedElementIds" | "editingElement">) => NonDeletedExcalidrawElement[];

package/types/scene/types.d.ts

@@ -1,6 +1,6 @@
 import { ExcalidrawTextElement } from "../element/types";
 import { AppClassProperties, AppState } from "../types";
-export declare type RenderConfig = {
+export type RenderConfig = {
     scrollX: AppState["scrollX"];
     scrollY: AppState["scrollY"];
     /** null indicates transparent bg */
@@ -35,15 +35,15 @@ export declare type RenderConfig = {
     isExporting: boolean;
     selectionColor?: string;
 };
-export declare type SceneScroll = {
+export type SceneScroll = {
     scrollX: number;
     scrollY: number;
 };
 export interface Scene {
     elements: ExcalidrawTextElement[];
 }
-export declare type ExportType = "png" | "clipboard" | "clipboard-svg" | "backend" | "svg";
-export declare type ScrollBars = {
+export type ExportType = "png" | "clipboard" | "clipboard-svg" | "backend" | "svg";
+export type ScrollBars = {
     horizontal: {
         x: number;
         y: number;

package/types/types.d.ts

@@ -1,3 +1,4 @@
+import React from "react";
 import { PointerType, ExcalidrawLinearElement, NonDeletedExcalidrawElement, NonDeleted, TextAlign, ExcalidrawElement, GroupId, ExcalidrawBindableElement, Arrowhead, ChartType, FontFamilyValues, FileId, ExcalidrawImageElement, Theme, StrokeRoundness } from "./element/types";
 import { SHAPES } from "./shapes";
 import { Point as RoughPoint } from "roughjs/bin/geometry";
@@ -16,9 +17,8 @@ import type { FileSystemHandle } from "./data/filesystem";
 import type { IMAGE_MIME_TYPES, MIME_TYPES } from "./constants";
 import { ContextMenuItems } from "./components/ContextMenu";
 import { Merge, ForwardRef, ValueOf } from "./utility-types";
-import React from "react";
-export declare type Point = Readonly<RoughPoint>;
-export declare type Collaborator = {
+export type Point = Readonly<RoughPoint>;
+export type Collaborator = {
     pointer?: {
         x: number;
         y: number;
@@ -34,10 +34,10 @@ export declare type Collaborator = {
     avatarUrl?: string;
     id?: string;
 };
-export declare type DataURL = string & {
+export type DataURL = string & {
     _brand: "DataURL";
 };
-export declare type BinaryFileData = {
+export type BinaryFileData = {
     mimeType: ValueOf<typeof IMAGE_MIME_TYPES> | typeof MIME_TYPES.binary;
     id: FileId;
     dataURL: DataURL;
@@ -54,16 +54,18 @@ export declare type BinaryFileData = {
      */
     lastRetrieved?: number;
 };
-export declare type BinaryFileMetadata = Omit<BinaryFileData, "dataURL">;
-export declare type BinaryFiles = Record<ExcalidrawElement["id"], BinaryFileData>;
-export declare type LastActiveTool = {
+export type BinaryFileMetadata = Omit<BinaryFileData, "dataURL">;
+export type BinaryFiles = Record<ExcalidrawElement["id"], BinaryFileData>;
+export type LastActiveTool = {
     type: typeof SHAPES[number]["value"] | "eraser" | "hand";
     customType: null;
 } | {
     type: "custom";
     customType: string;
 } | null;
-export declare type AppState = {
+export type SidebarName = string;
+export type SidebarTabName = string;
+export type AppState = {
     contextMenu: {
         items: ContextMenuItems;
         top: number;
@@ -124,10 +126,20 @@ export declare type AppState = {
     isRotating: boolean;
     zoom: Zoom;
     openMenu: "canvas" | "shape" | null;
-    openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-    openSidebar: "library" | "customSidebar" | null;
+    openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+    openSidebar: {
+        name: SidebarName;
+        tab?: SidebarTabName;
+    } | null;
     openDialog: "imageExport" | "help" | "jsonExport" | null;
-    isSidebarDocked: boolean;
+    /**
+     * Reflects user preference for whether the default sidebar should be docked.
+     *
+     * NOTE this is only a user preference and does not reflect the actual docked
+     * state of the sidebar, because the host apps can override this through
+     * a DefaultSidebar prop, which is not reflected back to the appState.
+     */
+    defaultSidebarDockedPreference: boolean;
     lastPointerDownWith: PointerType;
     selectedElementIds: {
         [id: string]: boolean;
@@ -172,17 +184,18 @@ export declare type AppState = {
     showHyperlinkPopup: false | "info" | "editor";
     selectedLinearElement: LinearElementEditor | null;
 };
-export declare type NormalizedZoomValue = number & {
+export type UIAppState = Omit<AppState, "suggestedBindings" | "startBoundElement" | "cursorButton" | "scrollX" | "scrollY">;
+export type NormalizedZoomValue = number & {
     _brand: "normalizedZoom";
 };
-export declare type Zoom = Readonly<{
+export type Zoom = Readonly<{
     value: NormalizedZoomValue;
 }>;
-export declare type PointerCoords = Readonly<{
+export type PointerCoords = Readonly<{
     x: number;
     y: number;
 }>;
-export declare type Gesture = {
+export type Gesture = {
     pointers: Map<number, PointerCoords>;
     lastCenter: {
         x: number;
@@ -196,11 +209,11 @@ export declare class GestureEvent extends UIEvent {
     readonly scale: number;
 }
 /** @deprecated legacy: do not use outside of migration paths */
-export declare type LibraryItem_v1 = readonly NonDeleted<ExcalidrawElement>[];
+export type LibraryItem_v1 = readonly NonDeleted<ExcalidrawElement>[];
 /** @deprecated legacy: do not use outside of migration paths */
-declare type LibraryItems_v1 = readonly LibraryItem_v1[];
+type LibraryItems_v1 = readonly LibraryItem_v1[];
 /** v2 library item */
-export declare type LibraryItem = {
+export type LibraryItem = {
     id: string;
     status: "published" | "unpublished";
     elements: readonly NonDeleted<ExcalidrawElement>[];
@@ -209,14 +222,14 @@ export declare type LibraryItem = {
     name?: string;
     error?: string;
 };
-export declare type LibraryItems = readonly LibraryItem[];
-export declare type LibraryItems_anyVersion = LibraryItems | LibraryItems_v1;
-export declare type LibraryItemsSource = ((currentLibraryItems: LibraryItems) => Blob | LibraryItems_anyVersion | Promise<LibraryItems_anyVersion | Blob>) | Blob | LibraryItems_anyVersion | Promise<LibraryItems_anyVersion | Blob>;
-export declare type ExcalidrawAPIRefValue = ExcalidrawImperativeAPI | {
+export type LibraryItems = readonly LibraryItem[];
+export type LibraryItems_anyVersion = LibraryItems | LibraryItems_v1;
+export type LibraryItemsSource = ((currentLibraryItems: LibraryItems) => Blob | LibraryItems_anyVersion | Promise<LibraryItems_anyVersion | Blob>) | Blob | LibraryItems_anyVersion | Promise<LibraryItems_anyVersion | Blob>;
+export type ExcalidrawAPIRefValue = ExcalidrawImperativeAPI | {
     readyPromise?: ResolvablePromise<ExcalidrawImperativeAPI>;
     ready?: false;
 };
-export declare type ExcalidrawInitialDataState = Merge<ImportedDataState, {
+export type ExcalidrawInitialDataState = Merge<ImportedDataState, {
     libraryItems?: Required<ImportedDataState>["libraryItems"] | Promise<Required<ImportedDataState>["libraryItems"]>;
 }>;
 export interface ExcalidrawProps {
@@ -233,7 +246,7 @@ export interface ExcalidrawProps {
         pointersMap: Gesture["pointers"];
     }) => void;
     onPaste?: (data: ClipboardData, event: ClipboardEvent | null) => Promise<boolean> | boolean;
-    renderTopRightUI?: (isMobile: boolean, appState: AppState) => JSX.Element | null;
+    renderTopRightUI?: (isMobile: boolean, appState: UIAppState) => JSX.Element | null;
     langCode?: Language["code"];
     viewModeEnabled?: boolean;
     zenModeEnabled?: boolean;
@@ -241,7 +254,7 @@ export interface ExcalidrawProps {
     libraryReturnUrl?: string;
     theme?: Theme;
     name?: string;
-    renderCustomStats?: (elements: readonly NonDeletedExcalidrawElement[], appState: AppState) => JSX.Element;
+    renderCustomStats?: (elements: readonly NonDeletedExcalidrawElement[], appState: UIAppState) => JSX.Element;
     UIOptions?: Partial<UIOptions>;
     detectScroll?: boolean;
     handleKeyboardGlobally?: boolean;
@@ -253,13 +266,9 @@ export interface ExcalidrawProps {
     }>) => void;
     onPointerDown?: (activeTool: AppState["activeTool"], pointerDownState: PointerDownState) => void;
     onScrollChange?: (scrollX: number, scrollY: number) => void;
-    /**
-     * Render function that renders custom <Sidebar /> component.
-     */
-    renderSidebar?: () => JSX.Element | null;
     children?: React.ReactNode;
 }
-export declare type SceneData = {
+export type SceneData = {
     elements?: ImportedDataState["elements"];
     appState?: ImportedDataState["appState"];
     collaborators?: Map<string, Collaborator>;
@@ -270,12 +279,12 @@ export declare enum UserIdleState {
     AWAY = "away",
     IDLE = "idle"
 }
-export declare type ExportOpts = {
+export type ExportOpts = {
     saveFileToDisk?: boolean;
-    onExportToBackend?: (exportedElements: readonly NonDeletedExcalidrawElement[], appState: AppState, files: BinaryFiles, canvas: HTMLCanvasElement | null) => void;
-    renderCustomUI?: (exportedElements: readonly NonDeletedExcalidrawElement[], appState: AppState, files: BinaryFiles, canvas: HTMLCanvasElement | null) => JSX.Element;
+    onExportToBackend?: (exportedElements: readonly NonDeletedExcalidrawElement[], appState: UIAppState, files: BinaryFiles, canvas: HTMLCanvasElement | null) => void;
+    renderCustomUI?: (exportedElements: readonly NonDeletedExcalidrawElement[], appState: UIAppState, files: BinaryFiles, canvas: HTMLCanvasElement | null) => JSX.Element;
 };
-declare type CanvasActions = Partial<{
+type CanvasActions = Partial<{
     changeViewBackgroundColor: boolean;
     clearCanvas: boolean;
     export: false | ExportOpts;
@@ -284,13 +293,13 @@ declare type CanvasActions = Partial<{
     toggleTheme: boolean | null;
     saveAsImage: boolean;
 }>;
-declare type UIOptions = Partial<{
+type UIOptions = Partial<{
     dockedSidebarBreakpoint: number;
     canvasActions: CanvasActions;
     /** @deprecated does nothing. Will be removed in 0.15 */
     welcomeScreen?: boolean;
 }>;
-export declare type AppProps = Merge<ExcalidrawProps, {
+export type AppProps = Merge<ExcalidrawProps, {
     UIOptions: Merge<UIOptions, {
         canvasActions: Required<CanvasActions> & {
             export: ExportOpts;
@@ -303,7 +312,7 @@ export declare type AppProps = Merge<ExcalidrawProps, {
 }>;
 /** A subset of App class properties that we need to use elsewhere
  * in the app, eg Manager. Factored out into a separate type to keep DRY. */
-export declare type AppClassProperties = {
+export type AppClassProperties = {
     props: AppProps;
     canvas: HTMLCanvasElement | null;
     focusContainer(): void;
@@ -316,8 +325,11 @@ export declare type AppClassProperties = {
     device: App["device"];
     scene: App["scene"];
     pasteFromClipboard: App["pasteFromClipboard"];
+    id: App["id"];
+    onInsertElements: App["onInsertElements"];
+    onExportImage: App["onExportImage"];
 };
-export declare type PointerDownState = Readonly<{
+export type PointerDownState = Readonly<{
     origin: Readonly<{
         x: number;
         y: number;
@@ -376,7 +388,7 @@ export declare type PointerDownState = Readonly<{
         };
     };
 }>;
-export declare type ExcalidrawImperativeAPI = {
+export type ExcalidrawImperativeAPI = {
     updateScene: InstanceType<typeof App>["updateScene"];
     updateLibrary: InstanceType<typeof Library>["updateLibrary"];
     resetScene: InstanceType<typeof App>["resetScene"];
@@ -397,12 +409,13 @@ export declare type ExcalidrawImperativeAPI = {
     setActiveTool: InstanceType<typeof App>["setActiveTool"];
     setCursor: InstanceType<typeof App>["setCursor"];
     resetCursor: InstanceType<typeof App>["resetCursor"];
-    toggleMenu: InstanceType<typeof App>["toggleMenu"];
+    toggleSidebar: InstanceType<typeof App>["toggleSidebar"];
 };
-export declare type Device = Readonly<{
+export type Device = Readonly<{
     isSmScreen: boolean;
     isMobile: boolean;
     isTouchScreen: boolean;
     canDeviceFitSidebar: boolean;
+    isLandscape: boolean;
 }>;
 export {};

package/types/utility-types.d.ts

@@ -1,22 +1,22 @@
 /// <reference types="react" />
-export declare type Mutable<T> = {
+export type Mutable<T> = {
     -readonly [P in keyof T]: T[P];
 };
-export declare type ValueOf<T> = T[keyof T];
-export declare type Merge<M, N> = Omit<M, keyof N> & N;
+export type ValueOf<T> = T[keyof T];
+export type Merge<M, N> = Omit<M, keyof N> & N;
 /** utility type to assert that the second type is a subtype of the first type.
  * Returns the subtype. */
-export declare type SubtypeOf<Supertype, Subtype extends Supertype> = Subtype;
-export declare type ResolutionType<T extends (...args: any) => any> = T extends (...args: any) => Promise<infer R> ? R : any;
-export declare type MarkOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
-export declare type MarkRequired<T, RK extends keyof T> = Exclude<T, RK> & Required<Pick<T, RK>>;
-export declare type MarkNonNullable<T, K extends keyof T> = {
+export type SubtypeOf<Supertype, Subtype extends Supertype> = Subtype;
+export type ResolutionType<T extends (...args: any) => any> = T extends (...args: any) => Promise<infer R> ? R : any;
+export type MarkOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+export type MarkRequired<T, RK extends keyof T> = Exclude<T, RK> & Required<Pick<T, RK>>;
+export type MarkNonNullable<T, K extends keyof T> = {
     [P in K]-?: P extends K ? NonNullable<T[P]> : T[P];
 } & {
     [P in keyof T]: T[P];
 };
-export declare type NonOptional<T> = Exclude<T, undefined>;
-export declare type SignatureType<T> = T extends (...args: infer R) => any ? R : never;
-export declare type CallableType<T extends (...args: any[]) => any> = (...args: SignatureType<T>) => ReturnType<T>;
-export declare type ForwardRef<T, P = any> = Parameters<CallableType<React.ForwardRefRenderFunction<T, P>>>[1];
-export declare type ExtractSetType<T extends Set<any>> = T extends Set<infer U> ? U : never;
+export type NonOptional<T> = Exclude<T, undefined>;
+export type SignatureType<T> = T extends (...args: infer R) => any ? R : never;
+export type CallableType<T extends (...args: any[]) => any> = (...args: SignatureType<T>) => ReturnType<T>;
+export type ForwardRef<T, P = any> = Parameters<CallableType<React.ForwardRefRenderFunction<T, P>>>[1];
+export type ExtractSetType<T extends Set<any>> = T extends Set<infer U> ? U : never;

package/types/utils.d.ts

@@ -6,8 +6,8 @@ export declare const setDateTimeForTests: (dateTime: string) => void;
 export declare const getDateTime: () => string;
 export declare const capitalizeString: (str: string) => string;
 export declare const isToolIcon: (target: Element | EventTarget | null) => target is HTMLElement;
-export declare const isInputLike: (target: Element | EventTarget | null) => target is HTMLBRElement | HTMLDivElement | HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
-export declare const isWritableElement: (target: Element | EventTarget | null) => target is HTMLBRElement | HTMLDivElement | HTMLInputElement | HTMLTextAreaElement;
+export declare const isInputLike: (target: Element | EventTarget | null) => target is HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement | HTMLBRElement | HTMLDivElement;
+export declare const isWritableElement: (target: Element | EventTarget | null) => target is HTMLInputElement | HTMLTextAreaElement | HTMLBRElement | HTMLDivElement;
 export declare const getFontFamilyString: ({ fontFamily, }: {
     fontFamily: FontFamilyValues;
 }) => string;
@@ -63,7 +63,7 @@ export declare const updateActiveTool: (appState: Pick<AppState, "activeTool">,
 export declare const resetCursor: (canvas: HTMLCanvasElement | null) => void;
 export declare const setCursor: (canvas: HTMLCanvasElement | null, cursor: string) => void;
 export declare const setEraserCursor: (canvas: HTMLCanvasElement | null, theme: AppState["theme"]) => void;
-export declare const setCursorForShape: (canvas: HTMLCanvasElement | null, appState: AppState) => void;
+export declare const setCursorForShape: (canvas: HTMLCanvasElement | null, appState: Pick<AppState, "activeTool" | "theme">) => void;
 export declare const isFullScreen: () => boolean;
 export declare const allowFullScreen: () => Promise<void>;
 export declare const exitFullScreen: () => Promise<void>;
@@ -111,7 +111,7 @@ export declare const muteFSAbortError: (error?: Error) => void;
 export declare const findIndex: <T>(array: readonly T[], cb: (element: T, index: number, array: readonly T[]) => boolean, fromIndex?: number) => number;
 export declare const findLastIndex: <T>(array: readonly T[], cb: (element: T, index: number, array: readonly T[]) => boolean, fromIndex?: number) => number;
 export declare const isTransparent: (color: string) => boolean;
-export declare type ResolvablePromise<T> = Promise<T> & {
+export type ResolvablePromise<T> = Promise<T> & {
     resolve: [T] extends [undefined] ? (value?: T) => void : (value: T) => void;
     reject: (error: Error) => void;
 };
@@ -156,7 +156,7 @@ export declare const isPrimitive: (val: any) => boolean;
 export declare const getFrame: () => "top" | "iframe";
 export declare const isPromiseLike: (value: any) => value is Promise<any>;
 export declare const queryFocusableElements: (container: HTMLElement | null) => HTMLElement[];
-export declare const isShallowEqual: <T extends Record<string, any>>(objA: T, objB: T) => boolean;
+export declare const isShallowEqual: <T extends Record<string, any>, I extends keyof T>(objA: T, objB: T, comparators?: Record<I, (a: T[I], b: T[I]) => boolean> | undefined, debug?: boolean) => boolean;
 export declare const composeEventHandlers: <E>(originalEventHandler?: ((event: E) => void) | undefined, ourEventHandler?: ((event: E) => void) | undefined, { checkForDefaultPrevented }?: {
     checkForDefaultPrevented?: boolean | undefined;
 }) => (event: E) => void;