@excalidraw/excalidraw 0.15.1-b64beaf → 0.15.2-13780f3

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";
-export declare type SidebarProps<P = {}> = {
+import { AppState, SidebarName, SidebarTabName } from "../../types";
+export type SidebarTriggerProps = {
+    name: SidebarName;
+    tab?: SidebarTabName;
+    icon?: JSX.Element;
+    children?: React.ReactNode;
+    title?: string;
+    className?: string;
+    onToggle?: (open: boolean) => void;
+    style?: React.CSSProperties;
+};
+export 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 type SidebarPropsContextValue = Pick<SidebarProps, "onDock" | "docked"> & {
+    onCloseRequest: () => void;
+    shouldRenderDockButton: boolean;
+};
 export declare const SidebarPropsContext: React.Context<SidebarPropsContextValue>;

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

@@ -1,6 +1,6 @@
 import "./Stack.scss";
 import React from "react";
-declare type StackProps = {
+type StackProps = {
     children: React.ReactNode;
     gap?: number;
     align?: "start" | "center" | "end" | "baseline";

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/ToolButton.d.ts

@@ -1,8 +1,8 @@
 import "./ToolIcon.scss";
 import React from "react";
 import { PointerType } from "../element/types";
-export declare type ToolButtonSize = "small" | "medium";
-declare type ToolButtonBaseProps = {
+export type ToolButtonSize = "small" | "medium";
+type ToolButtonBaseProps = {
     icon?: React.ReactNode;
     "aria-label": string;
     "aria-keyshortcuts"?: string;
@@ -20,7 +20,7 @@ declare type ToolButtonBaseProps = {
     className?: string;
     isLoading?: boolean;
 };
-declare type ToolButtonProps = (ToolButtonBaseProps & {
+type ToolButtonProps = (ToolButtonBaseProps & {
     type: "button";
     children?: React.ReactNode;
     onClick?(event: React.MouseEvent): void;

package/types/components/Tooltip.d.ts

@@ -7,7 +7,7 @@ export declare const updateTooltipPosition: (tooltip: HTMLDivElement, item: {
     width: number;
     height: number;
 }, position?: "bottom" | "top") => void;
-declare type TooltipProps = {
+type TooltipProps = {
     children: React.ReactNode;
     label: string;
     long?: boolean;

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/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;

package/types/constants.d.ts

@@ -82,21 +82,39 @@ export declare const DEFAULT_VERTICAL_ALIGN = "top";
 export declare const DEFAULT_VERSION = "{version}";
 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";
@@ -132,7 +150,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;
@@ -172,3 +189,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 type Tunnel = ReturnType<typeof tunnel>;
+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;

package/types/data/blob.d.ts

@@ -1,4 +1,4 @@
-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";
@@ -9,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/restore.d.ts

@@ -1,9 +1,9 @@
 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;

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;

package/types/element/Hyperlink.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="react" />
-import { AppState, ExcalidrawProps } from "../types";
+import { AppState, ExcalidrawProps, UIAppState } from "../types";
 import { NonDeletedExcalidrawElement } from "./types";
 import { Bounds } from "./bounds";
 import "./Hyperlink.scss";
@@ -75,10 +75,13 @@ export declare const actionLink: {
             zoom: Readonly<{
                 value: import("../types").NormalizedZoomValue;
             }>;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("./types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;
@@ -132,7 +135,7 @@ export declare const actionLink: {
     keyTest?: ((event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean) | undefined;
 };
 export declare const getContextMenuLabel: (elements: readonly NonDeletedExcalidrawElement[], appState: AppState) => "labels.link.edit" | "labels.link.create";
-export declare const getLinkHandleFromCoords: ([x1, y1, x2, y2]: Bounds, angle: number, appState: AppState) => [x: number, y: number, width: number, height: number];
+export declare const getLinkHandleFromCoords: ([x1, y1, x2, y2]: Bounds, angle: number, appState: UIAppState) => [x: number, y: number, width: number, height: number];
 export declare const isPointHittingLinkIcon: (element: NonDeletedExcalidrawElement, appState: AppState, [x, y]: readonly [number, number], isMobile: boolean) => boolean;
 export declare const showHyperlinkTooltip: (element: NonDeletedExcalidrawElement, appState: AppState) => void;
 export declare const hideHyperlinkToolip: () => void;

package/types/element/binding.d.ts

@@ -1,8 +1,8 @@
 import { ExcalidrawLinearElement, ExcalidrawBindableElement, NonDeleted, NonDeletedExcalidrawElement, ExcalidrawElement } from "./types";
 import { AppState } from "../types";
 import Scene from "../scene/Scene";
-export declare type SuggestedBinding = NonDeleted<ExcalidrawBindableElement> | SuggestedPointBinding;
-export declare type SuggestedPointBinding = [
+export type SuggestedBinding = NonDeleted<ExcalidrawBindableElement> | SuggestedPointBinding;
+export type SuggestedPointBinding = [
     NonDeleted<ExcalidrawLinearElement>,
     "start" | "end" | "both",
     NonDeleted<ExcalidrawBindableElement>

package/types/element/bounds.d.ts

@@ -1,6 +1,6 @@
 import { ExcalidrawElement, ExcalidrawLinearElement, Arrowhead, NonDeleted } from "./types";
 import { Drawable, Op } from "roughjs/bin/core";
-export declare type Bounds = readonly [number, number, number, number];
+export type Bounds = readonly [number, number, number, number];
 export declare const getElementAbsoluteCoords: (element: ExcalidrawElement, includeBoundText?: boolean) => [number, number, number, number, number, number];
 export declare const pointRelativeTo: (element: ExcalidrawElement, absoluteCoords: readonly [number, number]) => readonly [number, number];
 export declare const getDiamondPoints: (element: ExcalidrawElement) => number[];

package/types/element/image.d.ts

@@ -10,7 +10,17 @@ 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" | "image/webp" | "image/bmp" | "image/x-icon";
+        mimeType: import("../utility-types").ValueOf<{
+            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";
+        }>;
     }>;
     /** includes errored files because they cache was updated nonetheless */
     updatedFiles: Map<FileId, true>;

package/types/element/linearElementEditor.d.ts

@@ -180,10 +180,13 @@ export declare class LinearElementEditor {
                 value: import("../types").NormalizedZoomValue;
             }>;
             openMenu: "canvas" | "shape" | null;
-            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
-            openSidebar: "library" | "customSidebar" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | null;
+            openSidebar: {
+                name: string;
+                tab?: string | undefined;
+            } | null;
             openDialog: "imageExport" | "help" | "jsonExport" | null;
-            isSidebarDocked: boolean;
+            defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("./types").PointerType;
             selectedElementIds: {
                 [id: string]: boolean;

package/types/element/mutateElement.d.ts

@@ -1,6 +1,6 @@
 import { ExcalidrawElement } from "./types";
 import { Mutable } from "../utility-types";
-declare type ElementUpdate<TElement extends ExcalidrawElement> = Omit<Partial<TElement>, "id" | "version" | "versionNonce">;
+type ElementUpdate<TElement extends ExcalidrawElement> = Omit<Partial<TElement>, "id" | "version" | "versionNonce">;
 export declare const mutateElement: <TElement extends Mutable<ExcalidrawElement>>(element: TElement, updates: ElementUpdate<TElement>, informMutation?: boolean) => TElement;
 export declare const newElementWith: <TElement extends ExcalidrawElement>(element: TElement, updates: ElementUpdate<TElement>) => TElement;
 /**

package/types/element/newElement.d.ts

@@ -1,7 +1,7 @@
 import { ExcalidrawElement, ExcalidrawImageElement, ExcalidrawTextElement, ExcalidrawLinearElement, ExcalidrawGenericElement, NonDeleted, TextAlign, GroupId, VerticalAlign, Arrowhead, ExcalidrawFreeDrawElement, FontFamilyValues, ExcalidrawTextContainer } from "../element/types";
 import { AppState } from "../types";
 import { MarkOptional, Mutable } from "../utility-types";
-declare type ElementConstructorOpts = MarkOptional<Omit<ExcalidrawGenericElement, "id" | "type" | "isDeleted" | "updated">, "width" | "height" | "angle" | "groupIds" | "boundElements" | "seed" | "version" | "versionNonce" | "link" | "strokeStyle" | "fillStyle" | "strokeColor" | "backgroundColor" | "roughness" | "strokeWidth" | "roundness" | "locked" | "opacity">;
+type ElementConstructorOpts = MarkOptional<Omit<ExcalidrawGenericElement, "id" | "type" | "isDeleted" | "updated">, "width" | "height" | "angle" | "groupIds" | "boundElements" | "seed" | "version" | "versionNonce" | "link" | "strokeStyle" | "fillStyle" | "strokeColor" | "backgroundColor" | "roughness" | "strokeWidth" | "roundness" | "locked" | "opacity">;
 export declare const newElement: (opts: {
     type: ExcalidrawGenericElement["type"];
 } & ElementConstructorOpts) => NonDeleted<ExcalidrawGenericElement>;
@@ -77,6 +77,11 @@ export declare const duplicateElement: <TElement extends ExcalidrawElement>(edit
  * it's advised to supply the whole elements array, or sets of elements that
  * are encapsulated (such as library items), if the purpose is to retain
  * bindings to the cloned elements intact.
+ *
+ * NOTE by default does not randomize or regenerate anything except the id.
  */
-export declare const duplicateElements: (elements: readonly ExcalidrawElement[]) => ExcalidrawElement[];
+export declare const duplicateElements: (elements: readonly ExcalidrawElement[], opts?: {
+    /** NOTE also updates version flags and `updated` */
+    randomizeSeed: boolean;
+}) => ExcalidrawElement[];
 export {};

package/types/element/showSelectedShapeActions.d.ts

@@ -1,3 +1,3 @@
-import { AppState } from "../types";
 import { NonDeletedExcalidrawElement } from "./types";
-export declare const showSelectedShapeActions: (appState: AppState, elements: readonly NonDeletedExcalidrawElement[]) => boolean;
+import { UIAppState } from "../types";
+export declare const showSelectedShapeActions: (appState: UIAppState, elements: readonly NonDeletedExcalidrawElement[]) => boolean;