@excalidraw/excalidraw 0.15.2-45a57d7 → 0.15.2-6546-d83860c

package/types/components/DefaultSidebar.d.ts

@@ -0,0 +1,30 @@
+/// <reference types="react" />
+import { MarkOptional } from "../utility-types";
+import { SidebarProps, SidebarTriggerProps } from "./Sidebar/common";
+export declare const DefaultSidebar: import("react").FC<Omit<MarkOptional<Omit<{
+    name: string;
+    children: import("react").ReactNode;
+    onStateChange?: ((state: {
+        name: string;
+        tab?: string | undefined;
+    } | null) => void) | undefined;
+    onDock?: ((docked: boolean) => void) | undefined;
+    docked?: boolean | undefined;
+    className?: string | undefined;
+    __fallback?: boolean | undefined;
+}, "name">, "children">, "onDock"> & {
+    /** pass `false` to disable docking */
+    onDock?: SidebarProps["onDock"] | false;
+} & {
+    __fallback?: boolean | undefined;
+}> & {
+    Trigger: import("react").FC<Omit<SidebarTriggerProps, "name"> & import("react").HTMLAttributes<HTMLDivElement> & {
+        __fallback?: boolean | undefined;
+    }>;
+    TabTriggers: {
+        ({ children, ...rest }: {
+            children: React.ReactNode;
+        } & import("react").HTMLAttributes<HTMLDivElement>): JSX.Element;
+        displayName: string;
+    };
+};

package/types/components/HintViewer.d.ts

@@ -1,8 +1,8 @@
 import { NonDeletedExcalidrawElement } from "../element/types";
+import { Device, UIAppState } from "../types";
 import "./HintViewer.scss";
-import { AppState, Device } from "../types";
 interface HintViewerProps {
-    appState: AppState;
+    appState: UIAppState;
     elements: readonly NonDeletedExcalidrawElement[];
     isMobile: boolean;
     device: Device;

package/types/components/ImageExportDialog.d.ts

@@ -1,13 +1,13 @@
 import React from "react";
 import { NonDeletedExcalidrawElement } from "../element/types";
-import { AppState, BinaryFiles } from "../types";
-import "./ExportDialog.scss";
+import { BinaryFiles, UIAppState } from "../types";
 import { ActionManager } from "../actions/manager";
+import "./ExportDialog.scss";
 export declare const ErrorCanvasPreview: () => JSX.Element;
 export declare type ExportCB = (elements: readonly NonDeletedExcalidrawElement[], scale?: number) => void;
 export declare const ImageExportDialog: ({ elements, appState, setAppState, files, exportPadding, actionManager, onExportToPng, onExportToSvg, onExportToClipboard, }: {
-    appState: AppState;
-    setAppState: React.Component<any, AppState>["setState"];
+    appState: UIAppState;
+    setAppState: React.Component<any, UIAppState>["setState"];
     elements: readonly NonDeletedExcalidrawElement[];
     files: BinaryFiles;
     exportPadding?: number | undefined;

package/types/components/JSONExportDialog.d.ts

@@ -1,15 +1,15 @@
 import React from "react";
 import { NonDeletedExcalidrawElement } from "../element/types";
-import { AppState, ExportOpts, BinaryFiles } from "../types";
+import { ExportOpts, BinaryFiles, UIAppState } from "../types";
 import "./ExportDialog.scss";
 import { ActionManager } from "../actions/manager";
 export declare type ExportCB = (elements: readonly NonDeletedExcalidrawElement[], scale?: number) => void;
 export declare const JSONExportDialog: ({ elements, appState, files, actionManager, exportOpts, canvas, setAppState, }: {
     elements: readonly NonDeletedExcalidrawElement[];
-    appState: AppState;
+    appState: UIAppState;
     files: BinaryFiles;
     actionManager: ActionManager;
     exportOpts: ExportOpts;
     canvas: HTMLCanvasElement | null;
-    setAppState: React.Component<any, AppState>["setState"];
+    setAppState: React.Component<any, UIAppState>["setState"];
 }) => JSX.Element;

package/types/components/LayerUI.d.ts

@@ -2,13 +2,12 @@ import React from "react";
 import { ActionManager } from "../actions/manager";
 import { NonDeletedExcalidrawElement } from "../element/types";
 import { Language } from "../i18n";
-import { AppProps, AppState, ExcalidrawProps, BinaryFiles } from "../types";
-import Library from "../data/library";
+import { AppProps, AppState, ExcalidrawProps, BinaryFiles, UIAppState } from "../types";
 import "./LayerUI.scss";
 import "./Toolbar.scss";
 interface LayerUIProps {
     actionManager: ActionManager;
-    appState: AppState;
+    appState: UIAppState;
     files: BinaryFiles;
     canvas: HTMLCanvasElement | null;
     setAppState: React.Component<any, AppState>["setState"];
@@ -16,22 +15,16 @@ interface LayerUIProps {
     onLockToggle: () => void;
     onHandToolToggle: () => void;
     onPenModeToggle: () => void;
-    onInsertElements: (elements: readonly NonDeletedExcalidrawElement[]) => void;
     showExitZenModeBtn: boolean;
     langCode: Language["code"];
     renderTopRightUI?: ExcalidrawProps["renderTopRightUI"];
     renderCustomStats?: ExcalidrawProps["renderCustomStats"];
-    renderCustomSidebar?: ExcalidrawProps["renderSidebar"];
-    libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
     UIOptions: AppProps["UIOptions"];
-    focusContainer: () => void;
-    library: Library;
-    id: string;
     onImageAction: (data: {
         insertOnCanvasDirectly: boolean;
     }) => void;
     renderWelcomeScreen: boolean;
     children?: React.ReactNode;
 }
-declare const _default: React.MemoExoticComponent<({ actionManager, appState, files, setAppState, elements, canvas, onLockToggle, onHandToolToggle, onPenModeToggle, onInsertElements, showExitZenModeBtn, renderTopRightUI, renderCustomStats, renderCustomSidebar, libraryReturnUrl, UIOptions, focusContainer, library, id, onImageAction, renderWelcomeScreen, children, }: LayerUIProps) => JSX.Element>;
+declare const _default: React.MemoExoticComponent<({ actionManager, appState, files, setAppState, elements, canvas, onLockToggle, onHandToolToggle, onPenModeToggle, showExitZenModeBtn, renderTopRightUI, renderCustomStats, UIOptions, onImageAction, renderWelcomeScreen, children, }: LayerUIProps) => JSX.Element>;
 export default _default;

package/types/components/LibraryMenu.d.ts

@@ -1,25 +1,44 @@
-/// <reference types="react" />
+import React from "react";
 import Library from "../data/library";
-import { LibraryItems, LibraryItem, AppState, ExcalidrawProps } from "../types";
+import { LibraryItems, LibraryItem, ExcalidrawProps, UIAppState } from "../types";
 import "./LibraryMenu.scss";
-import { NonDeletedExcalidrawElement } from "../element/types";
+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;
+} & {
+    init: boolean;
+};
 export declare const LibraryMenuContent: ({ onInsertLibraryItems, pendingElements, onAddToLibrary, setAppState, libraryReturnUrl, library, id, appState, selectedItems, onSelectItems, }: {
     pendingElements: LibraryItem["elements"];
     onInsertLibraryItems: (libraryItems: LibraryItems) => void;
     onAddToLibrary: () => void;
-    setAppState: React.Component<any, AppState>["setState"];
+    setAppState: React.Component<any, UIAppState>["setState"];
     libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
     library: Library;
     id: string;
-    appState: AppState;
+    appState: UIAppState;
     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;
-}>;
+/**
+ * This component is meant to be rendered inside <Sidebar.Tab/> inside our
+ * <DefaultSidebar/> or host apps Sidebar components.
+ */
+export declare const LibraryMenu: () => JSX.Element;

package/types/components/LibraryMenuBrowseButton.d.ts

@@ -1,7 +1,7 @@
-import { AppState, ExcalidrawProps } from "../types";
+import { ExcalidrawProps, UIAppState } from "../types";
 declare const LibraryMenuBrowseButton: ({ theme, id, libraryReturnUrl, }: {
     libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
-    theme: AppState["theme"];
+    theme: UIAppState["theme"];
     id: string;
 }) => JSX.Element;
 export default LibraryMenuBrowseButton;

package/types/components/LibraryMenuControlButtons.d.ts

@@ -0,0 +1,9 @@
+import { LibraryItem, ExcalidrawProps, UIAppState } from "../types";
+export declare const LibraryMenuControlButtons: ({ selectedItems, onSelectItems, libraryReturnUrl, theme, id, style, }: {
+    selectedItems: LibraryItem["id"][];
+    onSelectItems: (id: LibraryItem["id"][]) => void;
+    libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
+    theme: UIAppState["theme"];
+    id: string;
+    style: React.CSSProperties;
+}) => JSX.Element;

package/types/components/LibraryMenuHeaderContent.d.ts

@@ -1,35 +1,16 @@
-import React from "react";
+/// <reference types="react" />
+import { LibraryItem, UIAppState } from "../types";
 import Library from "../data/library";
-import { AppState, LibraryItem } from "../types";
-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;
-} & {
-    init: boolean;
-};
-export declare const LibraryMenuHeader: React.FC<{
-    setAppState: React.Component<any, AppState>["setState"];
+export declare const LibraryDropdownMenuButton: React.FC<{
+    setAppState: React.Component<any, UIAppState>["setState"];
     selectedItems: LibraryItem["id"][];
     library: Library;
     onRemoveFromLibrary: () => void;
     resetLibrary: () => void;
     onSelectItems: (items: LibraryItem["id"][]) => void;
-    appState: AppState;
+    appState: UIAppState;
 }>;
+export declare const LibraryDropdownMenu: ({ selectedItems, onSelectItems, }: {
+    selectedItems: LibraryItem["id"][];
+    onSelectItems: (id: LibraryItem["id"][]) => void;
+}) => JSX.Element;

package/types/components/LibraryMenuItems.d.ts

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

package/types/components/MobileMenu.d.ts

@@ -1,9 +1,9 @@
 import React from "react";
-import { AppState, Device, ExcalidrawProps } from "../types";
+import { AppState, Device, ExcalidrawProps, UIAppState } from "../types";
 import { ActionManager } from "../actions/manager";
 import { NonDeletedExcalidrawElement } from "../element/types";
 declare type MobileMenuProps = {
-    appState: AppState;
+    appState: UIAppState;
     actionManager: ActionManager;
     renderJSONExportDialog: () => React.ReactNode;
     renderImageExportDialog: () => React.ReactNode;
@@ -16,7 +16,7 @@ declare type MobileMenuProps = {
     onImageAction: (data: {
         insertOnCanvasDirectly: boolean;
     }) => void;
-    renderTopRightUI?: (isMobile: boolean, appState: AppState) => JSX.Element | null;
+    renderTopRightUI?: (isMobile: boolean, appState: UIAppState) => JSX.Element | null;
     renderCustomStats?: ExcalidrawProps["renderCustomStats"];
     renderSidebars: () => JSX.Element | null;
     device: Device;

package/types/components/PasteChartDialog.d.ts

@@ -1,9 +1,8 @@
 import React from "react";
-import { AppState, LibraryItem } from "../types";
+import { UIAppState } from "../types";
 import "./PasteChartDialog.scss";
-export declare const PasteChartDialog: ({ setAppState, appState, onClose, onInsertChart, }: {
-    appState: AppState;
+export declare const PasteChartDialog: ({ setAppState, appState, onClose, }: {
+    appState: UIAppState;
     onClose: () => void;
-    setAppState: React.Component<any, AppState>["setState"];
-    onInsertChart: (elements: LibraryItem["elements"]) => void;
+    setAppState: React.Component<any, UIAppState>["setState"];
 }) => JSX.Element;

package/types/components/PublishLibrary.d.ts

@@ -1,9 +1,9 @@
-import { AppState, LibraryItems } from "../types";
+import { LibraryItems, UIAppState } from "../types";
 import "./PublishLibrary.scss";
 declare const PublishLibrary: ({ onClose, libraryItems, appState, onSuccess, onError, updateItemsInStorage, onRemove, }: {
     onClose: () => void;
     libraryItems: LibraryItems;
-    appState: AppState;
+    appState: UIAppState;
     onSuccess: (data: {
         url: string;
         authorName: string;

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

@@ -1,11 +1,14 @@
-/// <reference types="react" />
+import React from "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;
-}> & {
+/**
+ * Flags whether the currently rendered Sidebar is docked or not, for use
+ * in upstream components that need to act on this (e.g. LayerUI to shift the
+ * UI). We use an atom because of potential host app sidebars (for the default
+ * sidebar we could just read from appState.defaultSidebarDockedPreference).
+ *
+ * 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;
@@ -23,51 +26,71 @@ export declare const hostSidebarCountersAtom: import("jotai").Atom<{
     }, 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;
+    }, update: boolean | ((prev: boolean) => boolean)) => void;
+    onMount?: (<S extends (update: boolean | ((prev: boolean) => boolean)) => void>(setAtom: S) => void | (() => void)) | undefined;
 } & {
-    init: {
-        rendered: number;
-        docked: number;
-    };
+    init: boolean;
 };
-export declare const Sidebar: import("react").ForwardRefExoticComponent<{
-    children: import("react").ReactNode;
-    onClose?: (() => boolean | void) | undefined;
+export declare const SidebarInner: React.ForwardRefExoticComponent<Pick<{
+    name: string;
+    children: React.ReactNode;
+    onStateChange?: ((state: {
+        name: string;
+        tab?: string | undefined;
+    } | null) => void) | undefined;
     onDock?: ((docked: boolean) => void) | undefined;
     docked?: boolean | undefined;
-    initialDockedState?: boolean | undefined;
-    dockable?: boolean | undefined;
     className?: string | undefined;
-} & {
-    /** @private internal */
-    __isInternal?: boolean | undefined;
-} & import("react").RefAttributes<HTMLDivElement>> & {
+    __fallback?: boolean | undefined;
+} & Omit<React.RefAttributes<HTMLDivElement>, "onSelect">, "className" | "name" | "children" | "key" | "onDock" | "docked" | "onStateChange" | "__fallback"> & React.RefAttributes<HTMLDivElement>>;
+export declare const Sidebar: React.ForwardRefExoticComponent<{
+    name: string;
+    children: React.ReactNode;
+    onStateChange?: ((state: {
+        name: string;
+        tab?: string | undefined;
+    } | null) => void) | undefined;
+    onDock?: ((docked: boolean) => void) | undefined;
+    docked?: boolean | undefined;
+    className?: string | undefined;
+    __fallback?: boolean | undefined;
+} & React.RefAttributes<HTMLDivElement>> & {
     Header: {
-        (props: {
-            children?: import("react").ReactNode;
+        ({ children, className, }: {
+            children?: React.ReactNode;
             className?: string | undefined;
-        } & {
-            __isFallback?: boolean | undefined;
-        }): JSX.Element | null;
+        }): JSX.Element;
+        displayName: string;
+    };
+    TabTriggers: {
+        ({ children, ...rest }: {
+            children: React.ReactNode;
+        } & Omit<React.RefAttributes<HTMLDivElement>, "onSelect">): JSX.Element;
+        displayName: string;
+    };
+    TabTrigger: {
+        ({ children, tab, onSelect, ...rest }: {
+            children: React.ReactNode;
+            tab: string;
+            onSelect?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+        } & Omit<React.HTMLAttributes<HTMLButtonElement>, "onSelect">): JSX.Element;
+        displayName: string;
+    };
+    Tabs: {
+        ({ children, ...rest }: {
+            children: React.ReactNode;
+        } & Omit<React.RefAttributes<HTMLDivElement>, "onSelect">): JSX.Element | null;
+        displayName: string;
+    };
+    Tab: {
+        ({ tab, children, ...rest }: {
+            tab: string;
+            children: React.ReactNode;
+        } & React.HTMLAttributes<HTMLDivElement>): JSX.Element;
+        displayName: string;
+    };
+    Trigger: {
+        ({ name, tab, icon, title, children, onToggle, className, style, }: import("./common").SidebarTriggerProps): JSX.Element;
         displayName: string;
     };
 };

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

@@ -1,20 +1,7 @@
-/// <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;
-    };
+export declare const SidebarHeader: {
+    ({ children, className, }: {
+        children?: React.ReactNode;
+        className?: string | undefined;
+    }): JSX.Element;
+    displayName: string;
 };

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

@@ -0,0 +1,9 @@
+/// <reference types="react" />
+import { SidebarTabName } from "../../types";
+export declare const SidebarTab: {
+    ({ tab, children, ...rest }: {
+        tab: SidebarTabName;
+        children: React.ReactNode;
+    } & import("react").HTMLAttributes<HTMLDivElement>): JSX.Element;
+    displayName: string;
+};

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

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+import { SidebarTabName } from "../../types";
+export declare const SidebarTabTrigger: {
+    ({ children, tab, onSelect, ...rest }: {
+        children: React.ReactNode;
+        tab: SidebarTabName;
+        onSelect?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    } & Omit<import("react").HTMLAttributes<HTMLButtonElement>, "onSelect">): JSX.Element;
+    displayName: string;
+};

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

@@ -0,0 +1,7 @@
+/// <reference types="react" />
+export declare const SidebarTabTriggers: {
+    ({ children, ...rest }: {
+        children: React.ReactNode;
+    } & Omit<import("react").RefAttributes<HTMLDivElement>, "onSelect">): JSX.Element;
+    displayName: string;
+};

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

@@ -0,0 +1,7 @@
+/// <reference types="react" />
+export declare const SidebarTabs: {
+    ({ children, ...rest }: {
+        children: React.ReactNode;
+    } & Omit<import("react").RefAttributes<HTMLDivElement>, "onSelect">): JSX.Element | null;
+    displayName: string;
+};

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

@@ -0,0 +1,6 @@
+import { SidebarTriggerProps } from "./common";
+import "./SidebarTrigger.scss";
+export declare const SidebarTrigger: {
+    ({ name, tab, icon, title, children, onToggle, className, style, }: SidebarTriggerProps): JSX.Element;
+    displayName: string;
+};

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

@@ -1,16 +1,33 @@
 import React from "react";
+import { AppState, SidebarName, SidebarTabName } from "../../types";
+export declare type SidebarTriggerProps = {
+    name: SidebarName;
+    tab?: SidebarTabName;
+    icon?: JSX.Element;
+    children?: React.ReactNode;
+    title?: string;
+    className?: string;
+    onToggle?: (open: boolean) => void;
+    style?: React.CSSProperties;
+};
 export declare type SidebarProps<P = {}> = {
+    name: SidebarName;
     children: React.ReactNode;
     /**
-     * Called on sidebar close (either by user action or by the editor).
+     * Called on sidebar open/close or tab change.
+     */
+    onStateChange?: (state: AppState["openSidebar"]) => void;
+    /**
+     * supply alongside `docked` prop in order to make the Sidebar user-dockable
      */
-    onClose?: () => void | boolean;
-    /** if not supplied, sidebar won't be dockable */
     onDock?: (docked: boolean) => void;
     docked?: boolean;
-    initialDockedState?: boolean;
-    dockable?: boolean;
     className?: string;
+    /** @private internal */
+    __fallback?: boolean;
 } & P;
-export declare type SidebarPropsContextValue = Pick<SidebarProps, "onClose" | "onDock" | "docked" | "dockable">;
+export declare type SidebarPropsContextValue = Pick<SidebarProps, "onDock" | "docked"> & {
+    onCloseRequest: () => void;
+    shouldRenderDockButton: boolean;
+};
 export declare const SidebarPropsContext: React.Context<SidebarPropsContextValue>;

package/types/components/Stats.d.ts

@@ -1,10 +1,10 @@
 import React from "react";
 import { NonDeletedExcalidrawElement } from "../element/types";
-import { AppState, ExcalidrawProps } from "../types";
+import { ExcalidrawProps, UIAppState } from "../types";
 import "./Stats.scss";
 export declare const Stats: (props: {
-    appState: AppState;
-    setAppState: React.Component<any, AppState>["setState"];
+    appState: UIAppState;
+    setAppState: React.Component<any, UIAppState>["setState"];
     elements: readonly NonDeletedExcalidrawElement[];
     onClose: () => void;
     renderCustomStats: ExcalidrawProps["renderCustomStats"];

package/types/components/Trans.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+declare const Trans: ({ i18nKey, children, ...props }: {
+    [key: string]: React.ReactNode | ((el: React.ReactNode) => React.ReactNode);
+    i18nKey: string;
+}) => React.FunctionComponentElement<{
+    children?: React.ReactNode;
+}>;
+export default Trans;

package/types/components/footer/Footer.d.ts

@@ -1,8 +1,8 @@
 import { ActionManager } from "../../actions/manager";
-import { AppState } from "../../types";
+import { UIAppState } from "../../types";
 declare const Footer: {
     ({ appState, actionManager, showExitZenModeBtn, renderWelcomeScreen, }: {
-        appState: AppState;
+        appState: UIAppState;
         actionManager: ActionManager;
         showExitZenModeBtn: boolean;
         renderWelcomeScreen: boolean;

package/types/constants.d.ts

@@ -184,3 +184,8 @@ export declare const DEFAULT_ELEMENT_PROPS: {
     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,18 @@
+import React from "react";
+import tunnel from "tunnel-rat";
+export declare type Tunnel = ReturnType<typeof tunnel>;
+declare type TunnelsContextValue = {
+    MainMenuTunnel: Tunnel;
+    WelcomeScreenMenuHintTunnel: Tunnel;
+    WelcomeScreenToolbarHintTunnel: Tunnel;
+    WelcomeScreenHelpHintTunnel: Tunnel;
+    WelcomeScreenCenterTunnel: Tunnel;
+    FooterCenterTunnel: Tunnel;
+    DefaultSidebarTriggerTunnel: Tunnel;
+    DefaultSidebarTabTriggersTunnel: 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;