@dwelle/excalidraw 0.4.0-d8d86cf → 0.4.0-e03b600

package/types/components/icons.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
 import { Theme } from "../element/types";
-declare type Opts = {
+type Opts = {
     width?: number;
     height?: number;
     mirror?: true;
@@ -73,7 +73,7 @@ export declare const DistributeHorizontallyIcon: JSX.Element;
 export declare const DistributeVerticallyIcon: JSX.Element;
 export declare const CenterVerticallyIcon: JSX.Element;
 export declare const CenterHorizontallyIcon: JSX.Element;
-export declare const UsersIcon: JSX.Element;
+export declare const usersIcon: JSX.Element;
 export declare const start: JSX.Element;
 export declare const stop: JSX.Element;
 export declare const CloseIcon: JSX.Element;
@@ -87,6 +87,7 @@ export declare const GroupIcon: React.MemoExoticComponent<({ theme }: {
 export declare const UngroupIcon: React.MemoExoticComponent<({ theme }: {
     theme: Theme;
 }) => JSX.Element>;
+export declare const FillZigZagIcon: JSX.Element;
 export declare const FillHachureIcon: JSX.Element;
 export declare const FillCrossHatchIcon: JSX.Element;
 export declare const FillSolidIcon: JSX.Element;
@@ -136,4 +137,15 @@ export declare const TextAlignMiddleIcon: React.MemoExoticComponent<({ theme }:
 }) => JSX.Element>;
 export declare const publishIcon: JSX.Element;
 export declare const eraser: JSX.Element;
+export declare const handIcon: JSX.Element;
+export declare const downloadIcon: JSX.Element;
+export declare const copyIcon: JSX.Element;
+export declare const helpIcon: JSX.Element;
+export declare const playerPlayIcon: JSX.Element;
+export declare const playerStopFilledIcon: JSX.Element;
+export declare const tablerCheckIcon: JSX.Element;
+export declare const alertTriangleIcon: JSX.Element;
+export declare const eyeDropperIcon: JSX.Element;
+export declare const extraToolsIcon: JSX.Element;
+export declare const frameToolIcon: JSX.Element;
 export {};

package/types/components/live-collaboration/LiveCollaborationTrigger.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+import "./LiveCollaborationTrigger.scss";
+declare const LiveCollaborationTrigger: {
+    ({ isCollaborating, onSelect, ...rest }: {
+        isCollaborating: boolean;
+        onSelect: () => void;
+    } & import("react").ButtonHTMLAttributes<HTMLButtonElement>): JSX.Element;
+    displayName: string;
+};
+export default LiveCollaborationTrigger;

package/types/components/main-menu/DefaultItems.d.ts

@@ -0,0 +1,47 @@
+import "./DefaultItems.scss";
+import { Theme } from "../../element/types";
+export declare const LoadScene: {
+    (): JSX.Element | null;
+    displayName: string;
+};
+export declare const SaveToActiveFile: {
+    (): JSX.Element | null;
+    displayName: string;
+};
+export declare const SaveAsImage: {
+    (): JSX.Element;
+    displayName: string;
+};
+export declare const Help: {
+    (): JSX.Element;
+    displayName: string;
+};
+export declare const ClearCanvas: {
+    (): JSX.Element | null;
+    displayName: string;
+};
+export declare const ToggleTheme: {
+    (props?: {
+        onSelect?: ((theme: Theme) => void | boolean) | undefined;
+    } | undefined): JSX.Element | null;
+    displayName: string;
+};
+export declare const ChangeCanvasBackground: {
+    (): JSX.Element | null;
+    displayName: string;
+};
+export declare const Export: {
+    (): JSX.Element;
+    displayName: string;
+};
+export declare const Socials: {
+    (): JSX.Element;
+    displayName: string;
+};
+export declare const LiveCollaborationTrigger: {
+    ({ onSelect, isCollaborating, }: {
+        onSelect: () => void;
+        isCollaborating: boolean;
+    }): JSX.Element;
+    displayName: string;
+};

package/types/components/main-menu/MainMenu.d.ts

@@ -0,0 +1,61 @@
+import React from "react";
+import * as DefaultItems from "./DefaultItems";
+declare const MainMenu: React.FC<{
+    children?: React.ReactNode;
+    /**
+     * Called when any menu item is selected (clicked on).
+     */
+    onSelect?: ((event: Event) => void) | undefined;
+} & {
+    __fallback?: boolean | undefined;
+}> & {
+    Trigger: {
+        ({ className, children, onToggle, title, ...rest }: {
+            className?: string | undefined;
+            children: React.ReactNode;
+            onToggle: () => void;
+            title?: string | undefined;
+        } & Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onSelect">): JSX.Element;
+        displayName: string;
+    };
+    Item: {
+        ({ icon, onSelect, children, shortcut, className, ...rest }: {
+            icon?: JSX.Element | undefined;
+            onSelect: (event: Event) => void;
+            children: React.ReactNode;
+            shortcut?: string | undefined;
+            className?: string | undefined;
+        } & Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onSelect">): JSX.Element;
+        displayName: string;
+    };
+    ItemLink: {
+        ({ icon, shortcut, href, children, onSelect, className, ...rest }: {
+            href: string;
+            icon?: JSX.Element | undefined;
+            children: React.ReactNode;
+            shortcut?: string | undefined;
+            className?: string | undefined;
+            onSelect?: ((event: Event) => void) | undefined;
+        } & React.AnchorHTMLAttributes<HTMLAnchorElement>): JSX.Element;
+        displayName: string;
+    };
+    ItemCustom: ({ children, className, ...rest }: {
+        children: React.ReactNode;
+        className?: string | undefined;
+    } & React.HTMLAttributes<HTMLDivElement>) => JSX.Element;
+    Group: {
+        ({ children, className, style, title, }: {
+            children: React.ReactNode;
+            className?: string | undefined;
+            style?: React.CSSProperties | undefined;
+            title?: string | undefined;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Separator: {
+        (): JSX.Element;
+        displayName: string;
+    };
+    DefaultItems: typeof DefaultItems;
+};
+export default MainMenu;

package/types/components/welcome-screen/WelcomeScreen.Center.d.ts

@@ -0,0 +1,58 @@
+/// <reference types="react" />
+declare const Center: {
+    ({ children }: {
+        children?: React.ReactNode;
+    }): JSX.Element;
+    displayName: string;
+    Logo: {
+        ({ children }: {
+            children?: React.ReactNode;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Heading: {
+        ({ children }: {
+            children: React.ReactNode;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Menu: {
+        ({ children }: {
+            children?: React.ReactNode;
+        }): JSX.Element;
+        displayName: string;
+    };
+    MenuItem: {
+        ({ onSelect, children, icon, shortcut, className, ...props }: {
+            onSelect: () => void;
+            children: React.ReactNode;
+            icon?: JSX.Element | undefined;
+            shortcut?: string | null | undefined;
+        } & import("react").ButtonHTMLAttributes<HTMLButtonElement>): JSX.Element;
+        displayName: string;
+    };
+    MenuItemLink: {
+        ({ children, href, icon, shortcut, className, ...props }: {
+            children: React.ReactNode;
+            href: string;
+            icon?: JSX.Element | undefined;
+            shortcut?: string | null | undefined;
+        } & import("react").AnchorHTMLAttributes<HTMLAnchorElement>): JSX.Element;
+        displayName: string;
+    };
+    MenuItemHelp: {
+        (): JSX.Element;
+        displayName: string;
+    };
+    MenuItemLoadScene: {
+        (): JSX.Element | null;
+        displayName: string;
+    };
+    MenuItemLiveCollaborationTrigger: {
+        ({ onSelect, }: {
+            onSelect: () => any;
+        }): JSX.Element;
+        displayName: string;
+    };
+};
+export { Center };

package/types/components/welcome-screen/WelcomeScreen.Hints.d.ts

@@ -0,0 +1,19 @@
+declare const MenuHint: {
+    ({ children }: {
+        children?: React.ReactNode;
+    }): JSX.Element;
+    displayName: string;
+};
+declare const ToolbarHint: {
+    ({ children }: {
+        children?: React.ReactNode;
+    }): JSX.Element;
+    displayName: string;
+};
+declare const HelpHint: {
+    ({ children }: {
+        children?: React.ReactNode;
+    }): JSX.Element;
+    displayName: string;
+};
+export { HelpHint, MenuHint, ToolbarHint };

package/types/components/welcome-screen/WelcomeScreen.d.ts

@@ -0,0 +1,85 @@
+/// <reference types="react" />
+import "./WelcomeScreen.scss";
+declare const WelcomeScreen: {
+    (props: {
+        children?: React.ReactNode;
+    }): JSX.Element;
+    displayName: string;
+    Center: {
+        ({ children }: {
+            children?: import("react").ReactNode;
+        }): JSX.Element;
+        displayName: string;
+        Logo: {
+            ({ children }: {
+                children?: import("react").ReactNode;
+            }): JSX.Element;
+            displayName: string;
+        };
+        Heading: {
+            ({ children }: {
+                children: import("react").ReactNode;
+            }): JSX.Element;
+            displayName: string;
+        };
+        Menu: {
+            ({ children }: {
+                children?: import("react").ReactNode;
+            }): JSX.Element;
+            displayName: string;
+        };
+        MenuItem: {
+            ({ onSelect, children, icon, shortcut, className, ...props }: {
+                onSelect: () => void;
+                children: import("react").ReactNode;
+                icon?: JSX.Element | undefined;
+                shortcut?: string | null | undefined;
+            } & import("react").ButtonHTMLAttributes<HTMLButtonElement>): JSX.Element;
+            displayName: string;
+        };
+        MenuItemLink: {
+            ({ children, href, icon, shortcut, className, ...props }: {
+                children: import("react").ReactNode;
+                href: string;
+                icon?: JSX.Element | undefined;
+                shortcut?: string | null | undefined;
+            } & import("react").AnchorHTMLAttributes<HTMLAnchorElement>): JSX.Element;
+            displayName: string;
+        };
+        MenuItemHelp: {
+            (): JSX.Element;
+            displayName: string;
+        };
+        MenuItemLoadScene: {
+            (): JSX.Element | null;
+            displayName: string;
+        };
+        MenuItemLiveCollaborationTrigger: {
+            ({ onSelect, }: {
+                onSelect: () => any;
+            }): JSX.Element;
+            displayName: string;
+        };
+    };
+    Hints: {
+        MenuHint: {
+            ({ children }: {
+                children?: import("react").ReactNode;
+            }): JSX.Element;
+            displayName: string;
+        };
+        ToolbarHint: {
+            ({ children }: {
+                children?: import("react").ReactNode;
+            }): JSX.Element;
+            displayName: string;
+        };
+        HelpHint: {
+            ({ children }: {
+                children?: import("react").ReactNode;
+            }): JSX.Element;
+            displayName: string;
+        };
+    };
+};
+export default WelcomeScreen;

package/types/constants.d.ts

@@ -1,5 +1,12 @@
-import { AppProps } from "./types";
-import { FontFamilyValues } from "./element/types";
+import { AppProps, NormalizedZoomValue } from "./types";
+import { ExcalidrawElement, FontFamilyValues } from "./element/types";
+export declare const isDarwin: boolean;
+export declare const isWindows: boolean;
+export declare const isAndroid: boolean;
+export declare const isFirefox: boolean;
+export declare const isChrome: boolean;
+export declare const isSafari: boolean;
+export declare const isBrave: () => boolean;
 export declare const APP_NAME = "Excalidraw";
 export declare const DRAGGING_THRESHOLD = 10;
 export declare const LINE_CONFIRM_THRESHOLD = 8;
@@ -40,6 +47,7 @@ export declare enum EVENT {
     GESTURE_START = "gesturestart",
     GESTURE_CHANGE = "gesturechange",
     POINTER_MOVE = "pointermove",
+    POINTER_DOWN = "pointerdown",
     POINTER_UP = "pointerup",
     STATE_CHANGE = "statechange",
     WHEEL = "wheel",
@@ -48,11 +56,13 @@ export declare enum EVENT {
     HASHCHANGE = "hashchange",
     VISIBILITY_CHANGE = "visibilitychange",
     SCROLL = "scroll",
-    EXCALIDRAW_LINK = "excalidraw-link"
+    EXCALIDRAW_LINK = "excalidraw-link",
+    MENU_ITEM_SELECT = "menu.itemSelect"
 }
 export declare const ENV: {
     TEST: string;
     DEVELOPMENT: string;
+    PRODUCTION: string;
 };
 export declare const CLASSES: {
     SHAPE_ACTIONS_MENU: string;
@@ -66,29 +76,63 @@ export declare const THEME: {
     LIGHT: string;
     DARK: string;
 };
+export declare const FRAME_STYLE: {
+    strokeColor: string;
+    strokeWidth: number;
+    strokeStyle: import("./element/types").StrokeStyle;
+    fillStyle: import("./element/types").FillStyle;
+    roughness: number;
+    roundness: {
+        type: import("./element/types").RoundnessType;
+        value?: number | undefined;
+    } | null;
+    backgroundColor: string;
+    radius: number;
+};
 export declare const WINDOWS_EMOJI_FALLBACK_FONT = "Segoe UI Emoji";
 export declare const DEFAULT_FONT_SIZE = 20;
 export declare const DEFAULT_FONT_FAMILY: FontFamilyValues;
 export declare const DEFAULT_TEXT_ALIGN = "left";
 export declare const DEFAULT_VERTICAL_ALIGN = "top";
 export declare const DEFAULT_VERSION = "{version}";
+export declare const DEFAULT_BACKGROUND_COLOR = "#ffffff";
+export declare const DEFAULT_STROKE_COLOR = "#000000";
+export declare const DEFAULT_ZOOM_VALUE: NormalizedZoomValue;
 export declare const CANVAS_ONLY_ACTIONS: string[];
 export declare const GRID_SIZE = 20;
+export declare const IMAGE_MIME_TYPES: {
+    readonly svg: "image/svg+xml";
+    readonly 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 avif: "image/avif";
+    readonly jfif: "image/jfif";
+};
 export declare const MIME_TYPES: {
-    readonly excalidraw: "application/vnd.excalidraw+json";
-    readonly excalidrawlib: "application/vnd.excalidrawlib+json";
-    readonly json: "application/json";
     readonly svg: "image/svg+xml";
-    readonly "excalidraw.svg": "image/svg+xml";
     readonly png: "image/png";
-    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 avif: "image/avif";
+    readonly jfif: "image/jfif";
+    readonly json: "application/json";
+    readonly excalidraw: "application/vnd.excalidraw+json";
+    readonly excalidrawlib: "application/vnd.excalidrawlib+json";
+    readonly "excalidraw.svg": "image/svg+xml";
+    readonly "excalidraw.png": "image/png";
     readonly binary: "application/octet-stream";
 };
+export declare const EXPORT_IMAGE_TYPES: {
+    readonly png: "png";
+    readonly svg: "svg";
+    readonly clipboard: "clipboard";
+};
 export declare const EXPORT_DATA_TYPES: {
     readonly excalidraw: "excalidraw";
     readonly excalidrawClipboard: "excalidraw/clipboard";
@@ -106,11 +150,6 @@ export declare const MIN_ZOOM = 0.1;
 export declare const HYPERLINK_TOOLTIP_DELAY = 300;
 export declare const IDLE_THRESHOLD = 60000;
 export declare const ACTIVE_THRESHOLD = 3000;
-export declare const MODES: {
-    VIEW: string;
-    ZEN: string;
-    GRID: string;
-};
 export declare const THEME_FILTER: any;
 export declare const URL_QUERY_KEYS: {
     readonly addLibrary: "addLibrary";
@@ -129,7 +168,6 @@ 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", "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;
@@ -149,9 +187,28 @@ export declare const TEXT_ALIGN: {
     RIGHT: string;
 };
 export declare const ELEMENT_READY_TO_ERASE_OPACITY = 20;
-export declare const COOKIES: {
-    readonly AUTH_STATE_COOKIE: "excplus-auth";
+export declare const DEFAULT_PROPORTIONAL_RADIUS = 0.25;
+export declare const DEFAULT_ADAPTIVE_RADIUS = 32;
+export declare const ROUNDNESS: {
+    readonly LEGACY: 1;
+    readonly PROPORTIONAL_RADIUS: 2;
+    readonly ADAPTIVE_RADIUS: 3;
 };
 /** key containt id of precedeing elemnt id we use in reconciliation during
  * collaboration */
 export declare const PRECEDING_ELEMENT_KEY = "__precedingElement__";
+export declare const DEFAULT_ELEMENT_PROPS: {
+    strokeColor: ExcalidrawElement["strokeColor"];
+    backgroundColor: ExcalidrawElement["backgroundColor"];
+    fillStyle: ExcalidrawElement["fillStyle"];
+    strokeWidth: ExcalidrawElement["strokeWidth"];
+    strokeStyle: ExcalidrawElement["strokeStyle"];
+    roughness: ExcalidrawElement["roughness"];
+    opacity: ExcalidrawElement["opacity"];
+    locked: ExcalidrawElement["locked"];
+};
+export declare const LIBRARY_SIDEBAR_TAB = "library";
+export declare const DEFAULT_SIDEBAR: {
+    readonly name: "default";
+    readonly defaultTab: "library";
+};

package/types/context/tunnels.d.ts

@@ -0,0 +1,19 @@
+import React from "react";
+import tunnel from "tunnel-rat";
+export type Tunnel = ReturnType<typeof tunnel>;
+type TunnelsContextValue = {
+    MainMenuTunnel: Tunnel;
+    WelcomeScreenMenuHintTunnel: Tunnel;
+    WelcomeScreenToolbarHintTunnel: Tunnel;
+    WelcomeScreenHelpHintTunnel: Tunnel;
+    WelcomeScreenCenterTunnel: Tunnel;
+    FooterCenterTunnel: Tunnel;
+    DefaultSidebarTriggerTunnel: Tunnel;
+    DefaultSidebarTabTriggersTunnel: Tunnel;
+    OverwriteConfirmDialogTunnel: Tunnel;
+    jotaiScope: symbol;
+};
+export declare const TunnelsContext: React.Context<TunnelsContextValue>;
+export declare const useTunnels: () => TunnelsContextValue;
+export declare const useInitializeTunnels: () => TunnelsContextValue;
+export {};

package/types/context/ui-appState.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import { UIAppState } from "../types";
+export declare const UIAppStateContext: React.Context<UIAppState>;
+export declare const useUIAppState: () => UIAppState;

package/types/data/blob.d.ts

@@ -1,6 +1,7 @@
-import { ALLOWED_IMAGE_MIME_TYPES, MIME_TYPES } from "../constants";
+import { IMAGE_MIME_TYPES, MIME_TYPES } from "../constants";
 import { ExcalidrawElement, FileId } from "../element/types";
 import { AppState, DataURL, LibraryItem } from "../types";
+import { ValueOf } from "../utility-types";
 import { FileSystemHandle } from "./filesystem";
 import { ImportedLibraryData } from "./types";
 export declare const getMimeType: (blob: Blob | string) => string;
@@ -8,7 +9,7 @@ export declare const getFileHandleType: (handle: FileSystemHandle | null) => str
 export declare const isImageFileHandleType: (type: string | null) => type is "svg" | "png";
 export declare const isImageFileHandle: (handle: FileSystemHandle | null) => boolean;
 export declare const isSupportedImageFile: (blob: Blob | null | undefined) => blob is Blob & {
-    type: (typeof ALLOWED_IMAGE_MIME_TYPES)[number];
+    type: ValueOf<typeof IMAGE_MIME_TYPES>;
 };
 export declare const loadSceneOrLibraryFromBlob: (blob: Blob | File, localAppState: AppState | null, localElements: readonly ExcalidrawElement[] | null, fileHandle?: FileSystemHandle | null) => Promise<{
     type: "application/vnd.excalidraw+json";

package/types/data/encode.d.ts

@@ -5,7 +5,7 @@ export declare const toByteString: (data: string | Uint8Array | ArrayBuffer) =>
  */
 export declare const stringToBase64: (str: string, isByteString?: boolean) => Promise<string>;
 export declare const base64ToString: (base64: string, isByteString?: boolean) => Promise<string>;
-declare type EncodedData = {
+type EncodedData = {
     encoded: string;
     encoding: "bstring";
     /** whether text is compressed (zlib) */

package/types/data/filesystem.d.ts

@@ -1,5 +1,6 @@
 import { FileSystemHandle, supported as nativeFileSystemSupported } from "browser-fs-access";
-declare type FILE_EXTENSION = "gif" | "jpg" | "png" | "excalidraw.png" | "svg" | "excalidraw.svg" | "json" | "excalidraw" | "excalidrawlib";
+import { MIME_TYPES } from "../constants";
+type FILE_EXTENSION = Exclude<keyof typeof MIME_TYPES, "binary">;
 export declare const fileOpen: <M extends boolean | undefined = false>(opts: {
     extensions?: FILE_EXTENSION[] | undefined;
     description: string;

package/types/data/index.d.ts

@@ -4,7 +4,7 @@ import { AppState, BinaryFiles } from "../types";
 import { FileSystemHandle } from "./filesystem";
 export { loadFromBlob } from "./blob";
 export { loadFromJSON, saveAsJSON } from "./json";
-export declare const exportCanvas: (type: Omit<ExportType, "backend">, elements: readonly NonDeletedExcalidrawElement[], appState: AppState, files: BinaryFiles, { exportBackground, exportPadding, viewBackgroundColor, name, fileHandle, }: {
+export declare const exportAsImage: (type: Omit<ExportType, "backend">, elements: readonly NonDeletedExcalidrawElement[], appState: AppState, files: BinaryFiles, { exportBackground, exportPadding, viewBackgroundColor, name, fileHandle, }: {
     exportBackground: boolean;
     exportPadding?: number | undefined;
     viewBackgroundColor: string;

package/types/data/library.d.ts

@@ -1,55 +1,11 @@
 import { LibraryItems, ExcalidrawImperativeAPI, LibraryItemsSource } from "../types";
 import type App from "../components/App";
 import { ExcalidrawElement } from "../element/types";
-export declare const libraryItemsAtom: import("jotai").Atom<{
+export declare const libraryItemsAtom: import("jotai").PrimitiveAtom<{
     status: "loading" | "loaded";
     isInitialized: boolean;
     libraryItems: LibraryItems;
 }> & {
-    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: {
-        status: "loading" | "loaded";
-        isInitialized: boolean;
-        libraryItems: LibraryItems;
-    } | ((prev: {
-        status: "loading" | "loaded";
-        isInitialized: boolean;
-        libraryItems: LibraryItems;
-    }) => {
-        status: "loading" | "loaded";
-        isInitialized: boolean;
-        libraryItems: LibraryItems;
-    })) => void;
-    onMount?: (<S extends (update: {
-        status: "loading" | "loaded";
-        isInitialized: boolean;
-        libraryItems: LibraryItems;
-    } | ((prev: {
-        status: "loading" | "loaded";
-        isInitialized: boolean;
-        libraryItems: LibraryItems;
-    }) => {
-        status: "loading" | "loaded";
-        isInitialized: boolean;
-        libraryItems: LibraryItems;
-    })) => void>(setAtom: S) => void | (() => void)) | undefined;
-} & {
     init: {
         status: "loading" | "loaded";
         isInitialized: boolean;
@@ -70,6 +26,8 @@ declare class Library {
     private updateQueue;
     private getLastUpdateTask;
     private notifyListeners;
+    /** call on excalidraw instance unmount */
+    destroy: () => void;
     resetLibrary: () => Promise<LibraryItems>;
     /**
      * @returns latest cloned libraryItems. Awaits all in-progress updates first.

package/types/data/restore.d.ts

@@ -1,15 +1,21 @@
 import { ExcalidrawElement } from "../element/types";
 import { AppState, BinaryFiles, LibraryItem } from "../types";
 import { ImportedDataState } from "./types";
-declare type RestoredAppState = Omit<AppState, "offsetTop" | "offsetLeft" | "width" | "height">;
+type RestoredAppState = Omit<AppState, "offsetTop" | "offsetLeft" | "width" | "height">;
 export declare const AllowedExcalidrawActiveTools: Record<AppState["activeTool"]["type"], boolean>;
-export declare type RestoredDataState = {
+export type RestoredDataState = {
     elements: ExcalidrawElement[];
     appState: RestoredAppState;
     files: BinaryFiles;
 };
-export declare const restoreElements: (elements: ImportedDataState["elements"], localElements: readonly ExcalidrawElement[] | null | undefined, refreshDimensions?: boolean) => ExcalidrawElement[];
+export declare const restoreElements: (elements: ImportedDataState["elements"], localElements: readonly ExcalidrawElement[] | null | undefined, opts?: {
+    refreshDimensions?: boolean;
+    repairBindings?: boolean;
+} | undefined) => ExcalidrawElement[];
 export declare const restoreAppState: (appState: ImportedDataState["appState"], localAppState: Partial<AppState> | null | undefined) => RestoredAppState;
-export declare const restore: (data: Pick<ImportedDataState, "appState" | "elements" | "files"> | null, localAppState: Partial<AppState> | null | undefined, localElements: readonly ExcalidrawElement[] | null | undefined) => RestoredDataState;
+export declare const restore: (data: Pick<ImportedDataState, "appState" | "elements" | "files"> | null, localAppState: Partial<AppState> | null | undefined, localElements: readonly ExcalidrawElement[] | null | undefined, elementsConfig?: {
+    refreshDimensions?: boolean;
+    repairBindings?: boolean;
+}) => RestoredDataState;
 export declare const restoreLibraryItems: (libraryItems: ImportedDataState["libraryItems"], defaultStatus: LibraryItem["status"]) => LibraryItem[];
 export {};

package/types/data/types.d.ts

@@ -17,11 +17,9 @@ export interface ExportedDataState {
  * 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 type LegacyAppState = {
+    /** @deprecated #6213 TODO remove 23-06-01 */
+    isSidebarDocked: [boolean, "defaultSidebarDockedPreference"];
 };
 export interface ImportedDataState {
     type?: string;