@excalidraw/excalidraw 0.15.2-6546-5841e6a → 0.15.2-6546-21ca391

package/types/components/LayerUI.d.ts

@@ -26,6 +26,7 @@ interface LayerUIProps {
     onExportImage: AppClassProperties["onExportImage"];
     renderWelcomeScreen: boolean;
     children?: React.ReactNode;
+    app: AppClassProperties;
 }
-declare const _default: React.MemoExoticComponent<({ actionManager, appState, files, setAppState, elements, canvas, onLockToggle, onHandToolToggle, onPenModeToggle, showExitZenModeBtn, renderTopRightUI, renderCustomStats, UIOptions, onImageAction, onExportImage, renderWelcomeScreen, children, }: LayerUIProps) => JSX.Element>;
+declare const _default: React.MemoExoticComponent<({ actionManager, appState, files, setAppState, elements, canvas, onLockToggle, onHandToolToggle, onPenModeToggle, showExitZenModeBtn, renderTopRightUI, renderCustomStats, UIOptions, onImageAction, onExportImage, renderWelcomeScreen, children, app, }: LayerUIProps) => JSX.Element>;
 export default _default;

package/types/components/LibraryMenu.d.ts

@@ -2,30 +2,10 @@ import React from "react";
 import Library from "../data/library";
 import { LibraryItems, LibraryItem, ExcalidrawProps, UIAppState } from "../types";
 import "./LibraryMenu.scss";
-export declare const isLibraryMenuOpenAtom: import("jotai").Atom<boolean> & {
-    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: boolean | ((prev: boolean) => boolean)) => void;
-    onMount?: (<S extends (update: boolean | ((prev: boolean) => boolean)) => void>(setAtom: S) => void | (() => void)) | undefined;
-} & {
+export declare const isLibraryMenuOpenAtom: import("jotai").PrimitiveAtom<boolean> & {
     init: boolean;
 };
-export declare const LibraryMenuContent: ({ onInsertLibraryItems, pendingElements, onAddToLibrary, setAppState, libraryReturnUrl, library, id, appState, selectedItems, onSelectItems, }: {
+export declare const LibraryMenuContent: ({ onInsertLibraryItems, pendingElements, onAddToLibrary, setAppState, libraryReturnUrl, library, id, theme, selectedItems, onSelectItems, }: {
     pendingElements: LibraryItem["elements"];
     onInsertLibraryItems: (libraryItems: LibraryItems) => void;
     onAddToLibrary: () => void;
@@ -33,7 +13,7 @@ export declare const LibraryMenuContent: ({ onInsertLibraryItems, pendingElement
     libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
     library: Library;
     id: string;
-    appState: UIAppState;
+    theme: UIAppState["theme"];
     selectedItems: LibraryItem["id"][];
     onSelectItems: (id: LibraryItem["id"][]) => void;
 }) => JSX.Element;

package/types/components/LibraryMenuItems.d.ts

@@ -1,15 +1,14 @@
 import { ExcalidrawProps, LibraryItem, LibraryItems, UIAppState } from "../types";
 import "./LibraryMenuItems.scss";
-declare const LibraryMenuItems: ({ isLoading, libraryItems, onAddToLibrary, onInsertLibraryItems, pendingElements, selectedItems, onSelectItems, theme, id, libraryReturnUrl, }: {
+export default function LibraryMenuItems({ isLoading, libraryItems, onAddToLibrary, onInsertLibraryItems, pendingElements, theme, id, libraryReturnUrl, onSelectItems, selectedItems, }: {
     isLoading: boolean;
     libraryItems: LibraryItems;
     pendingElements: LibraryItem["elements"];
     onInsertLibraryItems: (libraryItems: LibraryItems) => void;
     onAddToLibrary: (elements: LibraryItem["elements"]) => void;
-    selectedItems: LibraryItem["id"][];
-    onSelectItems: (id: LibraryItem["id"][]) => void;
     libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
     theme: UIAppState["theme"];
     id: string;
-}) => JSX.Element;
-export default LibraryMenuItems;
+    selectedItems: LibraryItem["id"][];
+    onSelectItems: (id: LibraryItem["id"][]) => void;
+}): JSX.Element;

package/types/components/LibraryMenuSection.d.ts

@@ -0,0 +1,22 @@
+import React, { ReactNode } from "react";
+import { LibraryItem } from "../types";
+import { ExcalidrawElement, NonDeleted } from "../element/types";
+import { SvgCache } from "../hooks/useLibraryItemSvg";
+type LibraryOrPendingItem = (LibraryItem | /* pending library item */ {
+    id: null;
+    elements: readonly NonDeleted<ExcalidrawElement>[];
+})[];
+interface Props {
+    items: LibraryOrPendingItem;
+    onClick: (id: LibraryItem["id"] | null) => void;
+    onItemSelectToggle: (id: LibraryItem["id"], event: React.MouseEvent) => void;
+    onItemDrag: (id: LibraryItem["id"], event: React.DragEvent) => void;
+    isItemSelected: (id: LibraryItem["id"] | null) => boolean;
+    svgCache: SvgCache;
+    itemsRenderedPerBatch: number;
+}
+export declare const LibraryMenuSectionGrid: ({ children, }: {
+    children: ReactNode;
+}) => JSX.Element;
+export declare const LibraryMenuSection: React.MemoExoticComponent<({ items, onItemSelectToggle, onItemDrag, isItemSelected, onClick, svgCache, itemsRenderedPerBatch, }: Props) => JSX.Element>;
+export {};

package/types/components/LibraryUnit.d.ts

@@ -1,11 +1,15 @@
+/// <reference types="react" />
 import { LibraryItem } from "../types";
 import "./LibraryUnit.scss";
-export declare const LibraryUnit: ({ id, elements, isPending, onClick, selected, onToggle, onDrag, }: {
+import { SvgCache } from "../hooks/useLibraryItemSvg";
+export declare const LibraryUnit: import("react").MemoExoticComponent<({ id, elements, isPending, onClick, selected, onToggle, onDrag, svgCache, }: {
     id: LibraryItem["id"] | /** for pending item */ null;
     elements?: readonly import("../element/types").NonDeleted<import("../element/types").ExcalidrawElement>[] | undefined;
     isPending?: boolean | undefined;
-    onClick: () => void;
+    onClick: (id: LibraryItem["id"] | null) => void;
     selected: boolean;
     onToggle: (id: string, event: React.MouseEvent) => void;
     onDrag: (id: string, event: React.DragEvent) => void;
-}) => JSX.Element;
+    svgCache: SvgCache;
+}) => JSX.Element>;
+export declare const EmptyLibraryUnit: () => JSX.Element;

package/types/components/MobileMenu.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import { AppState, Device, ExcalidrawProps, UIAppState } from "../types";
+import { AppClassProperties, AppState, Device, ExcalidrawProps, UIAppState } from "../types";
 import { ActionManager } from "../actions/manager";
 import { NonDeletedExcalidrawElement } from "../element/types";
 type MobileMenuProps = {
@@ -21,6 +21,7 @@ type MobileMenuProps = {
     renderSidebars: () => JSX.Element | null;
     device: Device;
     renderWelcomeScreen: boolean;
+    app: AppClassProperties;
 };
-export declare const MobileMenu: ({ appState, elements, actionManager, setAppState, onLockToggle, onHandToolToggle, onPenModeToggle, canvas, onImageAction, renderTopRightUI, renderCustomStats, renderSidebars, device, renderWelcomeScreen, }: MobileMenuProps) => JSX.Element;
+export declare const MobileMenu: ({ appState, elements, actionManager, setAppState, onLockToggle, onHandToolToggle, onPenModeToggle, canvas, onImageAction, renderTopRightUI, renderCustomStats, renderSidebars, device, renderWelcomeScreen, app, }: MobileMenuProps) => JSX.Element;
 export {};

package/types/components/OverwriteConfirm/OverwriteConfirm.d.ts

@@ -0,0 +1,17 @@
+import React from "react";
+import "./OverwriteConfirm.scss";
+export type OverwriteConfirmDialogProps = {
+    children: React.ReactNode;
+};
+declare const OverwriteConfirmDialog: React.FC<OverwriteConfirmDialogProps & {
+    __fallback?: boolean | undefined;
+}> & {
+    Actions: (({ children }: {
+        children: React.ReactNode;
+    }) => JSX.Element) & {
+        ExportToImage: () => JSX.Element;
+        SaveToDisk: () => JSX.Element;
+    };
+    Action: ({ title, children, actionLabel, onClick, }: import("./OverwriteConfirmActions").ActionProps) => JSX.Element;
+};
+export { OverwriteConfirmDialog };

package/types/components/OverwriteConfirm/OverwriteConfirmActions.d.ts

@@ -0,0 +1,17 @@
+import React from "react";
+export type ActionProps = {
+    title: string;
+    children: React.ReactNode;
+    actionLabel: string;
+    onClick: () => void;
+};
+export declare const Action: ({ title, children, actionLabel, onClick, }: ActionProps) => JSX.Element;
+export declare const ExportToImage: () => JSX.Element;
+export declare const SaveToDisk: () => JSX.Element;
+declare const Actions: (({ children }: {
+    children: React.ReactNode;
+}) => JSX.Element) & {
+    ExportToImage: () => JSX.Element;
+    SaveToDisk: () => JSX.Element;
+};
+export { Actions };

package/types/components/OverwriteConfirm/OverwriteConfirmState.d.ts

@@ -0,0 +1,22 @@
+import React from "react";
+export type OverwriteConfirmState = {
+    active: true;
+    title: string;
+    description: React.ReactNode;
+    actionLabel: string;
+    color: "danger" | "warning";
+    onClose: () => void;
+    onConfirm: () => void;
+    onReject: () => void;
+} | {
+    active: false;
+};
+export declare const overwriteConfirmStateAtom: import("jotai").PrimitiveAtom<OverwriteConfirmState> & {
+    init: OverwriteConfirmState;
+};
+export declare function openConfirmModal({ title, description, actionLabel, color, }: {
+    title: string;
+    description: React.ReactNode;
+    actionLabel: string;
+    color: "danger" | "warning";
+}): Promise<boolean>;

package/types/components/ProjectName.d.ts

@@ -5,6 +5,7 @@ type Props = {
     onChange: (value: string) => void;
     label: string;
     isNameEditable: boolean;
+    ignoreFocus?: boolean;
 };
 export declare const ProjectName: (props: Props) => JSX.Element;
 export {};

package/types/components/RadioGroup.d.ts

@@ -0,0 +1,12 @@
+import "./RadioGroup.scss";
+export type RadioGroupChoice<T> = {
+    value: T;
+    label: string;
+};
+export type RadioGroupProps<T> = {
+    choices: RadioGroupChoice<T>[];
+    value: T;
+    onChange: (value: T) => void;
+    name: string;
+};
+export declare const RadioGroup: <T>({ onChange, value, choices, name, }: RadioGroupProps<T>) => JSX.Element;

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

@@ -8,27 +8,7 @@ import "./Sidebar.scss";
  *
  * Since we can only render one Sidebar at a time, we can use a simple flag.
  */
-export declare const isSidebarDockedAtom: import("jotai").Atom<boolean> & {
-    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: boolean | ((prev: boolean) => boolean)) => void;
-    onMount?: (<S extends (update: boolean | ((prev: boolean) => boolean)) => void>(setAtom: S) => void | (() => void)) | undefined;
-} & {
+export declare const isSidebarDockedAtom: import("jotai").PrimitiveAtom<boolean> & {
     init: boolean;
 };
 export declare const SidebarInner: React.ForwardRefExoticComponent<Pick<{

package/types/components/Spinner.d.ts

@@ -1,6 +1,7 @@
 import "./Spinner.scss";
-declare const Spinner: ({ size, circleWidth, }: {
+declare const Spinner: ({ size, circleWidth, synchronized, }: {
     size?: string | number | undefined;
     circleWidth?: number | undefined;
+    synchronized?: boolean | undefined;
 }) => JSX.Element;
 export default Spinner;

package/types/components/Stack.d.ts

@@ -7,9 +7,10 @@ type StackProps = {
     justifyContent?: "center" | "space-around" | "space-between";
     className?: string | boolean;
     style?: React.CSSProperties;
+    ref: React.RefObject<HTMLDivElement>;
 };
 declare const _default: {
-    Row: ({ children, gap, align, justifyContent, className, style, }: StackProps) => JSX.Element;
-    Col: ({ children, gap, align, justifyContent, className, style, }: StackProps) => JSX.Element;
+    Row: React.ForwardRefExoticComponent<Pick<StackProps, "style" | "className" | "children" | "gap" | "justifyContent" | "align"> & React.RefAttributes<HTMLDivElement>>;
+    Col: React.ForwardRefExoticComponent<Pick<StackProps, "style" | "className" | "children" | "gap" | "justifyContent" | "align"> & React.RefAttributes<HTMLDivElement>>;
 };
 export default _default;

package/types/components/Switch.d.ts

@@ -0,0 +1,9 @@
+import "./Switch.scss";
+export type SwitchProps = {
+    name: string;
+    checked: boolean;
+    title?: string;
+    onChange: (value: boolean) => void;
+    disabled?: boolean;
+};
+export declare const Switch: ({ title, name, checked, onChange, disabled, }: SwitchProps) => JSX.Element;

package/types/components/ToolButton.d.ts

@@ -1,5 +1,5 @@
 import "./ToolIcon.scss";
-import React from "react";
+import React, { CSSProperties } from "react";
 import { PointerType } from "../element/types";
 export type ToolButtonSize = "small" | "medium";
 type ToolButtonBaseProps = {
@@ -18,6 +18,7 @@ type ToolButtonBaseProps = {
     visible?: boolean;
     selected?: boolean;
     className?: string;
+    style?: CSSProperties;
     isLoading?: boolean;
 };
 type ToolButtonProps = (ToolButtonBaseProps & {

package/types/components/dropdownMenu/DropdownMenu.d.ts

@@ -6,11 +6,12 @@ declare const DropdownMenu: {
         open: boolean;
     }): JSX.Element;
     Trigger: {
-        ({ className, children, onToggle, }: {
+        ({ className, children, onToggle, title, ...rest }: {
             className?: string | undefined;
             children: React.ReactNode;
             onToggle: () => void;
-        }): JSX.Element;
+            title?: string | undefined;
+        } & Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onSelect">): JSX.Element;
         displayName: string;
     };
     Content: {

package/types/components/dropdownMenu/DropdownMenuTrigger.d.ts

@@ -1,9 +1,11 @@
+/// <reference types="react" />
 declare const MenuTrigger: {
-    ({ className, children, onToggle, }: {
+    ({ className, children, onToggle, title, ...rest }: {
         className?: string | undefined;
         children: React.ReactNode;
         onToggle: () => void;
-    }): JSX.Element;
+        title?: string | undefined;
+    } & Omit<import("react").ButtonHTMLAttributes<HTMLButtonElement>, "onSelect">): JSX.Element;
     displayName: string;
 };
 export default MenuTrigger;

package/types/components/icons.d.ts

@@ -138,4 +138,14 @@ export declare const TextAlignMiddleIcon: React.MemoExoticComponent<({ theme }:
 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/main-menu/MainMenu.d.ts

@@ -10,11 +10,12 @@ declare const MainMenu: React.FC<{
     __fallback?: boolean | undefined;
 }> & {
     Trigger: {
-        ({ className, children, onToggle, }: {
+        ({ className, children, onToggle, title, ...rest }: {
             className?: string | undefined;
             children: React.ReactNode;
             onToggle: () => void;
-        }): JSX.Element;
+            title?: string | undefined;
+        } & Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onSelect">): JSX.Element;
         displayName: string;
     };
     Item: {

package/types/constants.d.ts

@@ -47,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",
@@ -74,6 +75,19 @@ 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;
@@ -119,6 +133,7 @@ export declare const EXPORT_DATA_TYPES: {
     readonly excalidraw: "excalidraw";
     readonly excalidrawClipboard: "excalidraw/clipboard";
     readonly excalidrawLibrary: "excalidrawlib";
+    readonly excalidrawClipboardWithAPI: "excalidraw-api/clipboard";
 };
 export declare const EXPORT_SOURCE: string;
 export declare const IMAGE_RENDER_TIMEOUT = 500;

package/types/context/tunnels.d.ts

@@ -10,6 +10,7 @@ type TunnelsContextValue = {
     FooterCenterTunnel: Tunnel;
     DefaultSidebarTriggerTunnel: Tunnel;
     DefaultSidebarTabTriggersTunnel: Tunnel;
+    OverwriteConfirmDialogTunnel: Tunnel;
     jotaiScope: symbol;
 };
 export declare const TunnelsContext: React.Context<TunnelsContextValue>;

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,4 +1,4 @@
-import { ExcalidrawElement, StrokeRoundness } from "../element/types";
+import { ExcalidrawElement } from "../element/types";
 import { AppState, BinaryFiles, LibraryItem } from "../types";
 import { ImportedDataState } from "./types";
 type RestoredAppState = Omit<AppState, "offsetTop" | "offsetLeft" | "width" | "height">;
@@ -8,15 +8,6 @@ export type RestoredDataState = {
     appState: RestoredAppState;
     files: BinaryFiles;
 };
-export declare const restoreElementWithProperties: <T extends Required<Omit<ExcalidrawElement, "customData">> & {
-    customData?: ExcalidrawElement["customData"];
-    /** @deprecated */
-    boundElementIds?: readonly string[] | undefined;
-    /** @deprecated */
-    strokeSharpness?: StrokeRoundness | undefined;
-    /** metadata that may be present in elements during collaboration */
-    __precedingElement__?: string | undefined;
-}, K extends Pick<T, Exclude<keyof T, "link" | "id" | "x" | "y" | "strokeColor" | "backgroundColor" | "fillStyle" | "strokeWidth" | "strokeStyle" | "roundness" | "roughness" | "opacity" | "width" | "height" | "angle" | "seed" | "version" | "versionNonce" | "isDeleted" | "groupIds" | "boundElements" | "updated" | "locked" | "customData" | "type">>>(element: T, extra: Pick<T, keyof K> & Partial<Pick<ExcalidrawElement, "x" | "y" | "type">>) => T;
 export declare const restoreElements: (elements: ImportedDataState["elements"], localElements: readonly ExcalidrawElement[] | null | undefined, opts?: {
     refreshDimensions?: boolean;
     repairBindings?: boolean;

package/types/data/transform.d.ts

@@ -1,4 +1,73 @@
-import { ExcalidrawElement } from "../element/types";
-import { ImportedDataState } from "./types";
+import { ElementConstructorOpts } from "../element/newElement";
+import { ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawFrameElement, ExcalidrawFreeDrawElement, ExcalidrawGenericElement, ExcalidrawImageElement, ExcalidrawLinearElement, ExcalidrawSelectionElement, ExcalidrawTextElement, FontFamilyValues, TextAlign, VerticalAlign } from "../element/types";
+import { MarkOptional } from "../utility-types";
+export type ValidLinearElement = {
+    type: "arrow" | "line";
+    x: number;
+    y: number;
+    label?: {
+        text: string;
+        fontSize?: number;
+        fontFamily?: FontFamilyValues;
+        textAlign?: TextAlign;
+        verticalAlign?: VerticalAlign;
+    } & MarkOptional<ElementConstructorOpts, "x" | "y">;
+    end?: (({
+        type: Exclude<ExcalidrawBindableElement["type"], "image" | "selection" | "text" | "frame">;
+        id?: ExcalidrawGenericElement["id"];
+    } | {
+        id: ExcalidrawGenericElement["id"];
+        type?: Exclude<ExcalidrawBindableElement["type"], "image" | "selection" | "text" | "frame">;
+    }) | (({
+        type: "text";
+        text: string;
+    } | {
+        type?: "text";
+        id: ExcalidrawTextElement["id"];
+        text: string;
+    }) & Partial<ExcalidrawTextElement>)) & MarkOptional<ElementConstructorOpts, "x" | "y">;
+    start?: (({
+        type: Exclude<ExcalidrawBindableElement["type"], "image" | "selection" | "text" | "frame">;
+        id?: ExcalidrawGenericElement["id"];
+    } | {
+        id: ExcalidrawGenericElement["id"];
+        type?: Exclude<ExcalidrawBindableElement["type"], "image" | "selection" | "text" | "frame">;
+    }) | (({
+        type: "text";
+        text: string;
+    } | {
+        type?: "text";
+        id: ExcalidrawTextElement["id"];
+        text: string;
+    }) & Partial<ExcalidrawTextElement>)) & MarkOptional<ElementConstructorOpts, "x" | "y">;
+} & Partial<ExcalidrawLinearElement>;
+export type ValidContainer = {
+    type: Exclude<ExcalidrawGenericElement["type"], "selection">;
+    id?: ExcalidrawGenericElement["id"];
+    label?: {
+        text: string;
+        fontSize?: number;
+        fontFamily?: FontFamilyValues;
+        textAlign?: TextAlign;
+        verticalAlign?: VerticalAlign;
+    } & MarkOptional<ElementConstructorOpts, "x" | "y">;
+} & ElementConstructorOpts;
+export interface ExcalidrawProgrammaticAPI {
+    elements?: readonly (Extract<ExcalidrawElement, ExcalidrawSelectionElement | ExcalidrawFreeDrawElement | ExcalidrawFrameElement> | ({
+        type: Extract<ExcalidrawLinearElement["type"], "line">;
+        x: number;
+        y: number;
+    } & Partial<ExcalidrawLinearElement>) | ValidContainer | ValidLinearElement | ({
+        type: "text";
+        text: string;
+        x: number;
+        y: number;
+        id?: ExcalidrawTextElement["id"];
+    } & Partial<ExcalidrawTextElement>) | ({
+        type: Extract<ExcalidrawImageElement["type"], "image">;
+        x: number;
+        y: number;
+    } & Partial<ExcalidrawImageElement>))[] | null;
+}
 export declare const ELEMENTS_SUPPORTING_PROGRAMMATIC_API: string[];
-export declare const convertToExcalidrawElements: (elements: ImportedDataState["elements"]) => ExcalidrawElement[];
+export declare const convertToExcalidrawElements: (elements: ExcalidrawProgrammaticAPI["elements"]) => ExcalidrawElement[];

package/types/data/types.d.ts

@@ -1,9 +1,7 @@
-import { ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawGenericElement, ExcalidrawLinearElement, ExcalidrawTextElement, FontFamilyValues, TextAlign, VerticalAlign } from "../element/types";
+import { ExcalidrawElement } from "../element/types";
 import { AppState, BinaryFiles, LibraryItems, LibraryItems_anyVersion } from "../types";
 import type { cleanAppStateForExport } from "../appState";
 import { VERSIONS } from "../constants";
-import { MarkOptional } from "../utility-types";
-import { ElementConstructorOpts } from "../element/newElement";
 export interface ExportedDataState {
     type: string;
     version: number;
@@ -27,50 +25,7 @@ export interface ImportedDataState {
     type?: string;
     version?: number;
     source?: string;
-    elements?: readonly (ExcalidrawElement | ({
-        type: Exclude<ExcalidrawGenericElement["type"], "selection">;
-        id?: ExcalidrawGenericElement["id"];
-        label?: {
-            text: string;
-            fontSize?: number;
-            fontFamily?: FontFamilyValues;
-            textAlign?: TextAlign;
-            verticalAlign?: VerticalAlign;
-        } & MarkOptional<ElementConstructorOpts, "x" | "y">;
-    } & ElementConstructorOpts) | ({
-        type: "text";
-        text: string;
-        x: number;
-        y: number;
-        id?: ExcalidrawTextElement["id"];
-    } & Partial<ExcalidrawTextElement>) | ({
-        type: ExcalidrawLinearElement["type"];
-        x: number;
-        y: number;
-        label?: {
-            text: string;
-            fontSize?: number;
-            fontFamily?: FontFamilyValues;
-            textAlign?: TextAlign;
-            verticalAlign?: VerticalAlign;
-        } & MarkOptional<ElementConstructorOpts, "x" | "y">;
-        end?: ({
-            type: Exclude<ExcalidrawBindableElement["type"], "image" | "selection" | "text">;
-            id?: ExcalidrawGenericElement["id"];
-        } | ({
-            type: "text";
-            text: string;
-            id?: ExcalidrawTextElement["id"];
-        } & Partial<ExcalidrawTextElement>)) & MarkOptional<ElementConstructorOpts, "x" | "y">;
-        start?: ({
-            type: Exclude<ExcalidrawBindableElement["type"], "image" | "selection" | "text">;
-            id?: ExcalidrawGenericElement["id"];
-        } | ({
-            type: "text";
-            text: string;
-            id?: ExcalidrawTextElement["id"];
-        } & Partial<ExcalidrawTextElement>)) & MarkOptional<ElementConstructorOpts, "x" | "y">;
-    } & Partial<ExcalidrawLinearElement>))[] | null;
+    elements?: readonly ExcalidrawElement[] | null;
     appState?: Readonly<Partial<AppState & {
         [T in keyof LegacyAppState]: LegacyAppState[T][0];
     }>> | null;