@excalidraw/excalidraw 0.12.0-5390617 → 0.12.0-55110bf

package/types/components/LibraryMenu.d.ts

@@ -1,16 +1,25 @@
+/// <reference types="react" />
 import Library from "../data/library";
-import { LibraryItems, LibraryItem, AppState, BinaryFiles, ExcalidrawProps } from "../types";
+import { LibraryItems, LibraryItem, AppState, ExcalidrawProps } from "../types";
 import "./LibraryMenu.scss";
-export declare const LibraryMenu: ({ onClose, onInsertLibraryItems, pendingElements, onAddToLibrary, setAppState, files, libraryReturnUrl, focusContainer, library, id, appState, }: {
+import { NonDeletedExcalidrawElement } from "../element/types";
+export declare const LibraryMenuContent: ({ onInsertLibraryItems, pendingElements, onAddToLibrary, setAppState, libraryReturnUrl, library, id, appState, selectedItems, onSelectItems, }: {
     pendingElements: LibraryItem["elements"];
-    onClose: () => void;
     onInsertLibraryItems: (libraryItems: LibraryItems) => void;
     onAddToLibrary: () => void;
-    files: BinaryFiles;
     setAppState: React.Component<any, AppState>["setState"];
     libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
-    focusContainer: () => void;
     library: Library;
     id: string;
     appState: AppState;
+    selectedItems: LibraryItem["id"][];
+    onSelectItems: (id: LibraryItem["id"][]) => void;
 }) => JSX.Element;
+export declare const LibraryMenu: React.FC<{
+    appState: AppState;
+    onInsertElements: (elements: readonly NonDeletedExcalidrawElement[]) => void;
+    libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
+    focusContainer: () => void;
+    library: Library;
+    id: string;
+}>;

package/types/components/LibraryMenuHeaderContent.d.ts

@@ -0,0 +1,12 @@
+import React from "react";
+import Library from "../data/library";
+import { AppState, LibraryItem } from "../types";
+export declare const LibraryMenuHeader: React.FC<{
+    setAppState: React.Component<any, AppState>["setState"];
+    selectedItems: LibraryItem["id"][];
+    library: Library;
+    onRemoveFromLibrary: () => void;
+    resetLibrary: () => void;
+    onSelectItems: (items: LibraryItem["id"][]) => void;
+    appState: AppState;
+}>;

package/types/components/LibraryMenuItems.d.ts

@@ -1,24 +1,12 @@
-import React from "react";
-import Library from "../data/library";
-import { AppState, BinaryFiles, ExcalidrawProps, LibraryItem, LibraryItems } from "../types";
+import { LibraryItem, LibraryItems } from "../types";
 import "./LibraryMenuItems.scss";
-declare const LibraryMenuItems: ({ isLoading, libraryItems, onRemoveFromLibrary, onAddToLibrary, onInsertLibraryItems, pendingElements, theme, setAppState, appState, libraryReturnUrl, library, files, id, selectedItems, onSelectItems, onPublish, resetLibrary, }: {
+declare const LibraryMenuItems: ({ isLoading, libraryItems, onAddToLibrary, onInsertLibraryItems, pendingElements, selectedItems, onSelectItems, }: {
     isLoading: boolean;
     libraryItems: LibraryItems;
     pendingElements: LibraryItem["elements"];
-    onRemoveFromLibrary: () => void;
     onInsertLibraryItems: (libraryItems: LibraryItems) => void;
     onAddToLibrary: (elements: LibraryItem["elements"]) => void;
-    theme: AppState["theme"];
-    files: BinaryFiles;
-    setAppState: React.Component<any, AppState>["setState"];
-    appState: AppState;
-    libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
-    library: Library;
-    id: string;
     selectedItems: LibraryItem["id"][];
     onSelectItems: (id: LibraryItem["id"][]) => void;
-    onPublish: () => void;
-    resetLibrary: () => void;
 }) => JSX.Element;
 export default LibraryMenuItems;

package/types/components/LibraryUnit.d.ts

@@ -1,9 +1,8 @@
-import { BinaryFiles, LibraryItem } from "../types";
+import { LibraryItem } from "../types";
 import "./LibraryUnit.scss";
-export declare const LibraryUnit: ({ id, elements, files, isPending, onClick, selected, onToggle, onDrag, }: {
+export declare const LibraryUnit: ({ id, elements, isPending, onClick, selected, onToggle, onDrag, }: {
     id: LibraryItem["id"] | /** for pending item */ null;
     elements?: readonly import("../element/types").NonDeleted<import("../element/types").ExcalidrawElement>[] | undefined;
-    files: BinaryFiles;
     isPending?: boolean | undefined;
     onClick: () => void;
     selected: boolean;

package/types/components/LoadingMessage.d.ts

@@ -1,4 +1,6 @@
 /// <reference types="react" />
+import { Theme } from "../element/types";
 export declare const LoadingMessage: React.FC<{
     delay?: number;
+    theme?: Theme;
 }>;

package/types/components/MobileMenu.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import { AppState, ExcalidrawProps } from "../types";
+import { AppState, Device, ExcalidrawProps } from "../types";
 import { ActionManager } from "../actions/manager";
 import { NonDeletedExcalidrawElement } from "../element/types";
 declare type MobileMenuProps = {
@@ -9,19 +9,19 @@ declare type MobileMenuProps = {
     renderImageExportDialog: () => React.ReactNode;
     setAppState: React.Component<any, AppState>["setState"];
     elements: readonly NonDeletedExcalidrawElement[];
-    libraryMenu: JSX.Element | null;
     onCollabButtonClick?: () => void;
     onLockToggle: () => void;
     onPenModeToggle: () => void;
     canvas: HTMLCanvasElement | null;
     isCollaborating: boolean;
     renderCustomFooter?: (isMobile: boolean, appState: AppState) => JSX.Element | null;
-    showThemeBtn: boolean;
     onImageAction: (data: {
         insertOnCanvasDirectly: boolean;
     }) => void;
     renderTopRightUI?: (isMobile: boolean, appState: AppState) => JSX.Element | null;
     renderCustomStats?: ExcalidrawProps["renderCustomStats"];
+    renderSidebars: () => JSX.Element | null;
+    device: Device;
 };
-export declare const MobileMenu: ({ appState, elements, libraryMenu, actionManager, renderJSONExportDialog, renderImageExportDialog, setAppState, onCollabButtonClick, onLockToggle, onPenModeToggle, canvas, isCollaborating, renderCustomFooter, showThemeBtn, onImageAction, renderTopRightUI, renderCustomStats, }: MobileMenuProps) => JSX.Element;
+export declare const MobileMenu: ({ appState, elements, actionManager, renderJSONExportDialog, renderImageExportDialog, setAppState, onCollabButtonClick, onLockToggle, onPenModeToggle, canvas, isCollaborating, renderCustomFooter, onImageAction, renderTopRightUI, renderCustomStats, renderSidebars, device, }: MobileMenuProps) => JSX.Element;
 export {};

package/types/components/Sidebar/Sidebar.d.ts

@@ -0,0 +1,73 @@
+/// <reference types="react" />
+import "./Sidebar.scss";
+/** using a counter instead of boolean to handle race conditions where
+ * the host app may render (mount/unmount) multiple different sidebar */
+export declare const hostSidebarCountersAtom: import("jotai").Atom<{
+    rendered: number;
+    docked: number;
+}> & {
+    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: {
+        rendered: number;
+        docked: number;
+    } | ((prev: {
+        rendered: number;
+        docked: number;
+    }) => {
+        rendered: number;
+        docked: number;
+    })) => void;
+    onMount?: (<S extends (update: {
+        rendered: number;
+        docked: number;
+    } | ((prev: {
+        rendered: number;
+        docked: number;
+    }) => {
+        rendered: number;
+        docked: number;
+    })) => void>(setAtom: S) => void | (() => void)) | undefined;
+} & {
+    /** @private internal */
+    init: {
+        rendered: number;
+        docked: number;
+    };
+};
+export declare const Sidebar: import("react").ForwardRefExoticComponent<{
+    children: import("react").ReactNode;
+    onClose?: (() => boolean | void) | undefined;
+    onDock?: ((docked: boolean) => void) | undefined;
+    docked?: boolean | undefined;
+    dockable?: boolean | undefined;
+    className?: string | undefined;
+} & {
+    /** @private internal */
+    __isInternal?: boolean | undefined;
+} & import("react").RefAttributes<HTMLDivElement>> & {
+    Header: {
+        (props: {
+            children?: import("react").ReactNode;
+            className?: string | undefined;
+        } & {
+            __isFallback?: boolean | undefined;
+        }): JSX.Element | null;
+        displayName: string;
+    };
+};

package/types/components/Sidebar/SidebarHeader.d.ts

@@ -0,0 +1,20 @@
+/// <reference types="react" />
+export declare const SidebarDockButton: (props: {
+    checked: boolean;
+    onChange?(): void;
+}) => JSX.Element;
+/** @private */
+export declare const SidebarHeaderComponents: {
+    Context: import("react").FC<{
+        children: import("react").ReactNode;
+    }>;
+    Component: {
+        (props: {
+            children?: React.ReactNode;
+            className?: string | undefined;
+        } & {
+            __isFallback?: boolean | undefined;
+        }): JSX.Element | null;
+        displayName: string;
+    };
+};

package/types/components/Sidebar/common.d.ts

@@ -0,0 +1,15 @@
+import React from "react";
+export declare type SidebarProps<P = {}> = {
+    children: React.ReactNode;
+    /**
+     * Called on sidebar close (either by user action or by the editor).
+     */
+    onClose?: () => void | boolean;
+    /** if not supplied, sidebar won't be dockable */
+    onDock?: (docked: boolean) => void;
+    docked?: boolean;
+    dockable?: boolean;
+    className?: string;
+} & P;
+export declare type SidebarPropsContextValue = Pick<SidebarProps, "onClose" | "onDock" | "docked" | "dockable">;
+export declare const SidebarPropsContext: React.Context<SidebarPropsContextValue>;

package/types/components/hoc/withUpstreamOverride.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+export declare const withUpstreamOverride: <P>(Component: React.ComponentType<P>) => readonly [React.FC<{
+    children: React.ReactNode;
+}>, {
+    (props: P & {
+        /** @private internal */
+        __isFallback?: boolean | undefined;
+    }): JSX.Element | null;
+    displayName: string;
+}];

package/types/constants.d.ts

@@ -84,6 +84,9 @@ export declare const MIME_TYPES: {
     readonly "excalidraw.png": "image/png";
     readonly jpg: "image/jpeg";
     readonly gif: "image/gif";
+    readonly webp: "image/webp";
+    readonly bmp: "image/bmp";
+    readonly ico: "image/x-icon";
     readonly binary: "application/octet-stream";
 };
 export declare const EXPORT_DATA_TYPES: {
@@ -125,7 +128,7 @@ export declare const MAX_DECIMALS_FOR_SVG_EXPORT = 2;
 export declare const EXPORT_SCALES: number[];
 export declare const DEFAULT_EXPORT_PADDING = 10;
 export declare const DEFAULT_MAX_IMAGE_WIDTH_OR_HEIGHT = 1440;
-export declare const ALLOWED_IMAGE_MIME_TYPES: readonly ["image/png", "image/jpeg", "image/svg+xml", "image/gif"];
+export declare const ALLOWED_IMAGE_MIME_TYPES: readonly ["image/png", "image/jpeg", "image/svg+xml", "image/gif", "image/webp", "image/bmp", "image/x-icon"];
 export declare const MAX_ALLOWED_FILE_BYTES: number;
 export declare const SVG_NS = "http://www.w3.org/2000/svg";
 export declare const ENCRYPTION_KEY_BITS = 128;
@@ -139,7 +142,15 @@ export declare const VERTICAL_ALIGN: {
     MIDDLE: string;
     BOTTOM: string;
 };
+export declare const TEXT_ALIGN: {
+    LEFT: string;
+    CENTER: string;
+    RIGHT: string;
+};
 export declare const ELEMENT_READY_TO_ERASE_OPACITY = 20;
 export declare const COOKIES: {
     readonly AUTH_STATE_COOKIE: "excplus-auth";
 };
+/** key containt id of precedeing elemnt id we use in reconciliation during
+ * collaboration */
+export declare const PRECEDING_ELEMENT_KEY = "__precedingElement__";

package/types/data/types.d.ts

@@ -10,12 +10,27 @@ export interface ExportedDataState {
     appState: ReturnType<typeof cleanAppStateForExport>;
     files: BinaryFiles | undefined;
 }
+/**
+ * Map of legacy AppState keys, with values of:
+ *  [<legacy type>, <new AppState proeprty>]
+ *
+ * This is a helper type used in downstream abstractions.
+ * Don't consume on its own.
+ */
+export declare type LegacyAppState = {
+    /** @deprecated #5663 TODO remove 22-12-15 */
+    isLibraryOpen: [boolean, "openSidebar"];
+    /** @deprecated #5663 TODO remove 22-12-15 */
+    isLibraryMenuDocked: [boolean, "isSidebarDocked"];
+};
 export interface ImportedDataState {
     type?: string;
     version?: number;
     source?: string;
     elements?: readonly ExcalidrawElement[] | null;
-    appState?: Readonly<Partial<AppState>> | null;
+    appState?: Readonly<Partial<AppState & {
+        [T in keyof LegacyAppState]: LegacyAppState[T][0];
+    }>> | null;
     scrollToContent?: boolean;
     libraryItems?: LibraryItems_anyVersion;
     files?: BinaryFiles;

package/types/element/Hyperlink.d.ts

@@ -55,7 +55,7 @@ export declare const actionLink: {
             currentItemOpacity: number;
             currentItemFontFamily: number;
             currentItemFontSize: number;
-            currentItemTextAlign: import("./types").TextAlign;
+            currentItemTextAlign: string;
             currentItemStrokeSharpness: import("./types").StrokeSharpness;
             currentItemStartArrowhead: import("./types").Arrowhead | null;
             currentItemEndArrowhead: import("./types").Arrowhead | null;
@@ -72,6 +72,8 @@ export declare const actionLink: {
                 value: import("../types").NormalizedZoomValue;
             }>;
             openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
+            openSidebar: "library" | "customSidebar" | null;
+            isSidebarDocked: boolean;
             lastPointerDownWith: import("./types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -98,8 +100,6 @@ export declare const actionLink: {
             height: number;
             offsetTop: number;
             offsetLeft: number;
-            isLibraryOpen: boolean;
-            isLibraryMenuDocked: boolean;
             fileHandle: import("browser-fs-access").FileSystemHandle | null;
             collaborators: Map<string, import("../types").Collaborator>;
             showStats: boolean;

package/types/element/image.d.ts

@@ -10,7 +10,7 @@ export declare const updateImageCache: ({ fileIds, files, imageCache, }: {
 }) => Promise<{
     imageCache: Map<FileId, {
         image: HTMLImageElement | Promise<HTMLImageElement>;
-        mimeType: "image/svg+xml" | "image/png" | "image/jpeg" | "image/gif";
+        mimeType: "image/svg+xml" | "image/png" | "image/jpeg" | "image/gif" | "image/webp" | "image/bmp" | "image/x-icon";
     }>;
     /** includes errored files because they cache was updated nonetheless */
     updatedFiles: Map<FileId, true>;

package/types/element/linearElementEditor.d.ts

@@ -142,7 +142,7 @@ export declare class LinearElementEditor {
             currentItemOpacity: number;
             currentItemFontFamily: number;
             currentItemFontSize: number;
-            currentItemTextAlign: import("./types").TextAlign;
+            currentItemTextAlign: string;
             currentItemStrokeSharpness: import("./types").StrokeSharpness;
             currentItemStartArrowhead: import("./types").Arrowhead | null;
             currentItemEndArrowhead: import("./types").Arrowhead | null;
@@ -160,6 +160,8 @@ export declare class LinearElementEditor {
             }>;
             openMenu: "canvas" | "shape" | null;
             openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
+            openSidebar: "library" | "customSidebar" | null;
+            isSidebarDocked: boolean;
             lastPointerDownWith: import("./types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -170,7 +172,7 @@ export declare class LinearElementEditor {
             shouldCacheIgnoreZoom: boolean;
             showHelpDialog: boolean;
             toast: {
-                message: string; /** @returns whether point was dragged */
+                message: string;
                 closable?: boolean | undefined;
                 duration?: number | undefined;
             } | null;
@@ -186,8 +188,6 @@ export declare class LinearElementEditor {
             height: number;
             offsetTop: number;
             offsetLeft: number;
-            isLibraryOpen: boolean;
-            isLibraryMenuDocked: boolean;
             fileHandle: import("browser-fs-access").FileSystemHandle | null;
             collaborators: Map<string, import("../types").Collaborator>;
             showStats: boolean;

package/types/element/newElement.d.ts

@@ -12,7 +12,9 @@ export declare const newTextElement: (opts: {
     verticalAlign: VerticalAlign;
     containerId?: ExcalidrawRectangleElement["id"];
 } & ElementConstructorOpts) => NonDeleted<ExcalidrawTextElement>;
-export declare const updateTextElement: (element: ExcalidrawTextElement, { text, isDeleted, originalText, }: {
+export declare const getMaxContainerWidth: (container: ExcalidrawElement) => number;
+export declare const getMaxContainerHeight: (container: ExcalidrawElement) => number;
+export declare const updateTextElement: (textElement: ExcalidrawTextElement, { text, isDeleted, originalText, }: {
     text: string;
     isDeleted?: boolean | undefined;
     originalText: string;
@@ -30,6 +32,9 @@ export declare const newLinearElement: (opts: {
 } & ElementConstructorOpts) => NonDeleted<ExcalidrawLinearElement>;
 export declare const newImageElement: (opts: {
     type: ExcalidrawImageElement["type"];
+    status?: ExcalidrawImageElement["status"];
+    fileId?: ExcalidrawImageElement["fileId"];
+    scale?: ExcalidrawImageElement["scale"];
 } & ElementConstructorOpts) => NonDeleted<ExcalidrawImageElement>;
 export declare const deepCopyElement: (val: any, depth?: number) => any;
 /**

package/types/element/textElement.d.ts

@@ -1,6 +1,6 @@
 import { ExcalidrawElement, ExcalidrawTextElement, ExcalidrawTextElementWithContainer, FontString, NonDeletedExcalidrawElement } from "./types";
 import { MaybeTransformHandleType } from "./transformHandles";
-export declare const redrawTextBoundingBox: (element: ExcalidrawTextElement, container: ExcalidrawElement | null) => void;
+export declare const redrawTextBoundingBox: (textElement: ExcalidrawTextElement, container: ExcalidrawElement | null) => void;
 export declare const bindTextToShapeAfterDuplication: (sceneElements: ExcalidrawElement[], oldElements: ExcalidrawElement[], oldIdToDuplicatedId: Map<ExcalidrawElement["id"], ExcalidrawElement["id"]>) => void;
 export declare const handleBindTextResize: (element: NonDeletedExcalidrawElement, transformHandleType: MaybeTransformHandleType) => void;
 export declare const measureText: (text: string, font: FontString, maxWidth?: number | null) => {
@@ -9,7 +9,7 @@ export declare const measureText: (text: string, font: FontString, maxWidth?: nu
     baseline: number;
 };
 export declare const getApproxLineHeight: (font: FontString) => number;
-export declare const wrapText: (text: string, font: FontString, containerWidth: number) => string;
+export declare const wrapText: (text: string, font: FontString, maxWidth: number) => string;
 export declare const charWidth: {
     calculate: (char: string, font: FontString) => number;
     getCache: (font: FontString) => number[];
@@ -24,3 +24,7 @@ export declare const getBoundTextElement: (element: ExcalidrawElement | null) =>
 export declare const getContainerElement: (element: (ExcalidrawElement & {
     containerId: ExcalidrawElement["id"] | null;
 }) | null) => ExcalidrawElement | null;
+export declare const getContainerDims: (element: ExcalidrawElement) => {
+    width: number;
+    height: number;
+};

package/types/element/types.d.ts

@@ -1,5 +1,5 @@
 import { Point } from "../types";
-import { FONT_FAMILY, THEME, VERTICAL_ALIGN } from "../constants";
+import { FONT_FAMILY, TEXT_ALIGN, THEME, VERTICAL_ALIGN } from "../constants";
 export declare type ChartType = "bar" | "line";
 export declare type FillStyle = "hachure" | "cross-hatch" | "solid";
 export declare type FontFamilyKeys = keyof typeof FONT_FAMILY;
@@ -12,7 +12,7 @@ export declare type GroupId = string;
 export declare type PointerType = "mouse" | "pen" | "touch";
 export declare type StrokeSharpness = "round" | "sharp";
 export declare type StrokeStyle = "solid" | "dashed" | "dotted";
-export declare type TextAlign = "left" | "center" | "right";
+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<{