@excalidraw/common 0.18.0-b9d27d3 → 0.18.0-c158187

package/dist/types/excalidraw/data/blob.d.ts

@@ -2,7 +2,7 @@ import { IMAGE_MIME_TYPES, MIME_TYPES } from "@excalidraw/common";
 import type { ValueOf } from "@excalidraw/common/utility-types";
 import type { ExcalidrawElement, FileId } from "@excalidraw/element/types";
 import type { AppState, DataURL, LibraryItem } from "../types";
-import type { FileSystemHandle } from "./filesystem";
+import type { FileSystemHandle } from "browser-fs-access";
 import type { ImportedLibraryData } from "./types";
 export declare const getMimeType: (blob: Blob | string) => string;
 export declare const getFileHandleType: (handle: FileSystemHandle | null) => string | null;
@@ -12,14 +12,332 @@ export declare const isSupportedImageFileType: (type: string | null | undefined)
 export declare const isSupportedImageFile: (blob: Blob | null | undefined) => blob is Blob & {
     type: ValueOf<typeof IMAGE_MIME_TYPES>;
 };
-export declare const loadSceneOrLibraryFromBlob: (blob: Blob | File, localAppState: AppState | null, localElements: readonly ExcalidrawElement[] | null, fileHandle?: FileSystemHandle | null) => Promise<{
+export declare const loadSceneOrLibraryFromBlob: (blob: Blob | File, 
+/** @see restore.localAppState */
+localAppState: AppState | null, localElements: readonly ExcalidrawElement[] | null, 
+/** FileSystemHandle. Defaults to `blob.handle` if defined, otherwise null. */
+fileHandle?: FileSystemHandle | null) => Promise<{
     type: "application/vnd.excalidraw+json";
-    data: import("./restore").RestoredDataState;
+    data: {
+        elements: import("@excalidraw/element/types").OrderedExcalidrawElement[];
+        appState: {
+            viewBackgroundColor: string;
+            theme: import("@excalidraw/element/types").Theme;
+            frameRendering: {
+                enabled: boolean;
+                name: boolean;
+                outline: boolean;
+                clip: boolean;
+            };
+            name: string | null;
+            zoom: import("../types").Zoom;
+            scrollX: number;
+            scrollY: number;
+            viewModeEnabled: boolean;
+            openDialog: null | {
+                name: "imageExport" | "help" | "jsonExport";
+            } | {
+                name: "ttd";
+                tab: "text-to-diagram" | "mermaid";
+            } | {
+                name: "commandPalette";
+            } | {
+                name: "settings";
+            } | {
+                name: "elementLinkSelector";
+                sourceElementId: ExcalidrawElement["id"];
+            };
+            editingGroupId: import("@excalidraw/element/types").GroupId | null;
+            selectedElementIds: Readonly<{
+                [id: string]: true;
+            }>;
+            frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
+            activeEmbeddable: {
+                element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
+                state: "hover" | "active";
+            } | null;
+            selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            selectedGroupIds: {
+                [groupId: string]: boolean;
+            };
+            selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
+            multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
+            newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
+            isBindingEnabled: boolean;
+            suggestedBinding: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
+            isRotating: boolean;
+            elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
+            collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
+            snapLines: readonly import("../snapping").SnapLine[];
+            zenModeEnabled: boolean;
+            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            isCropping: boolean;
+            croppingElementId: ExcalidrawElement["id"] | null;
+            searchMatches: Readonly<{
+                focusedId: ExcalidrawElement["id"] | null;
+                matches: readonly import("../types").SearchMatch[];
+            }> | null;
+            activeLockedId: string | null;
+            hoveredElementIds: Readonly<{
+                [id: string]: true;
+            }>;
+            shouldCacheIgnoreZoom: boolean;
+            exportScale: number;
+            bindMode: import("@excalidraw/element/types").BindMode;
+            gridSize: number;
+            contextMenu: {
+                items: import("../components/ContextMenu").ContextMenuItems;
+                top: number;
+                left: number;
+            } | null;
+            showWelcomeScreen: boolean;
+            isLoading: boolean;
+            errorMessage: React.ReactNode;
+            resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
+            editingFrame: string | null;
+            activeTool: {
+                lastActiveTool: import("../types").ActiveTool | null;
+                locked: boolean;
+                fromSelection: boolean;
+            } & import("../types").ActiveTool;
+            preferredSelectionTool: {
+                type: "selection" | "lasso";
+                initialized: boolean;
+            };
+            penMode: boolean;
+            penDetected: boolean;
+            exportBackground: boolean;
+            exportEmbedScene: boolean;
+            exportWithDarkMode: boolean;
+            currentItemStrokeColor: string;
+            currentItemBackgroundColor: string;
+            currentItemFillStyle: ExcalidrawElement["fillStyle"];
+            currentItemStrokeWidth: number;
+            currentItemStrokeStyle: ExcalidrawElement["strokeStyle"];
+            currentItemRoughness: number;
+            currentItemOpacity: number;
+            currentItemFontFamily: import("@excalidraw/element/types").FontFamilyValues;
+            currentItemFontSize: number;
+            currentItemTextAlign: import("@excalidraw/element/types").TextAlign;
+            currentItemStartArrowhead: import("@excalidraw/element/types").Arrowhead | null;
+            currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
+            currentHoveredFontFamily: import("@excalidraw/element/types").FontFamilyValues | null;
+            currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
+            currentItemArrowType: "sharp" | "round" | "elbow";
+            cursorButton: "up" | "down";
+            scrolledOutside: boolean;
+            isResizing: boolean;
+            openMenu: "canvas" | null;
+            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | "fontFamily" | "compactTextProperties" | "compactStrokeStyles" | "compactOtherProperties" | "compactArrowProperties" | null;
+            openSidebar: {
+                name: import("../types").SidebarName;
+                tab?: import("../types").SidebarTabName;
+            } | null;
+            defaultSidebarDockedPreference: boolean;
+            lastPointerDownWith: import("@excalidraw/element/types").PointerType;
+            previousSelectedElementIds: {
+                [id: string]: true;
+            };
+            selectedElementsAreBeingDragged: boolean;
+            toast: {
+                message: string;
+                closable?: boolean;
+                duration?: number;
+            } | null;
+            gridStep: number;
+            gridModeEnabled: boolean;
+            fileHandle: FileSystemHandle | null;
+            stats: {
+                open: boolean;
+                panels: number;
+            };
+            currentChartType: import("@excalidraw/element/types").ChartType;
+            pasteDialog: {
+                shown: false;
+                data: null;
+            } | {
+                shown: true;
+                data: import("../charts").Spreadsheet;
+            };
+            showHyperlinkPopup: false | "info" | "editor";
+            originSnapOffset: {
+                x: number;
+                y: number;
+            } | null;
+            objectsSnapModeEnabled: boolean;
+            userToFollow: import("../types").UserToFollow | null;
+            followedBy: Set<import("../types").SocketId>;
+            lockedMultiSelections: {
+                [groupId: string]: true;
+            };
+        };
+        files: import("../types").BinaryFiles;
+    };
 } | {
     type: "application/vnd.excalidrawlib+json";
     data: ImportedLibraryData;
 }>;
-export declare const loadFromBlob: (blob: Blob, localAppState: AppState | null, localElements: readonly ExcalidrawElement[] | null, fileHandle?: FileSystemHandle | null) => Promise<import("./restore").RestoredDataState>;
+export declare const loadFromBlob: (blob: Blob, 
+/** @see restore.localAppState */
+localAppState: AppState | null, localElements: readonly ExcalidrawElement[] | null, 
+/** FileSystemHandle. Defaults to `blob.handle` if defined, otherwise null. */
+fileHandle?: FileSystemHandle | null) => Promise<{
+    elements: import("@excalidraw/element/types").OrderedExcalidrawElement[];
+    appState: {
+        viewBackgroundColor: string;
+        theme: import("@excalidraw/element/types").Theme;
+        frameRendering: {
+            enabled: boolean;
+            name: boolean;
+            outline: boolean;
+            clip: boolean;
+        };
+        name: string | null;
+        zoom: import("../types").Zoom;
+        scrollX: number;
+        scrollY: number;
+        viewModeEnabled: boolean;
+        openDialog: null | {
+            name: "imageExport" | "help" | "jsonExport";
+        } | {
+            name: "ttd";
+            tab: "text-to-diagram" | "mermaid";
+        } | {
+            name: "commandPalette";
+        } | {
+            name: "settings";
+        } | {
+            name: "elementLinkSelector";
+            sourceElementId: ExcalidrawElement["id"];
+        };
+        editingGroupId: import("@excalidraw/element/types").GroupId | null;
+        selectedElementIds: Readonly<{
+            [id: string]: true;
+        }>;
+        frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
+        activeEmbeddable: {
+            element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
+            state: "hover" | "active";
+        } | null;
+        selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+        selectedGroupIds: {
+            [groupId: string]: boolean;
+        };
+        selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
+        multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
+        newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
+        isBindingEnabled: boolean;
+        suggestedBinding: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
+        isRotating: boolean;
+        elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
+        collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
+        snapLines: readonly import("../snapping").SnapLine[];
+        zenModeEnabled: boolean;
+        editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+        isCropping: boolean;
+        croppingElementId: ExcalidrawElement["id"] | null;
+        searchMatches: Readonly<{
+            focusedId: ExcalidrawElement["id"] | null;
+            matches: readonly import("../types").SearchMatch[];
+        }> | null;
+        activeLockedId: string | null;
+        hoveredElementIds: Readonly<{
+            [id: string]: true;
+        }>;
+        shouldCacheIgnoreZoom: boolean;
+        exportScale: number;
+        bindMode: import("@excalidraw/element/types").BindMode;
+        gridSize: number;
+        contextMenu: {
+            items: import("../components/ContextMenu").ContextMenuItems;
+            top: number;
+            left: number;
+        } | null;
+        showWelcomeScreen: boolean;
+        isLoading: boolean;
+        errorMessage: React.ReactNode;
+        resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+        startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
+        editingFrame: string | null;
+        activeTool: {
+            lastActiveTool: import("../types").ActiveTool | null;
+            locked: boolean;
+            fromSelection: boolean;
+        } & import("../types").ActiveTool;
+        preferredSelectionTool: {
+            type: "selection" | "lasso";
+            initialized: boolean;
+        };
+        penMode: boolean;
+        penDetected: boolean;
+        exportBackground: boolean;
+        exportEmbedScene: boolean;
+        exportWithDarkMode: boolean;
+        currentItemStrokeColor: string;
+        currentItemBackgroundColor: string;
+        currentItemFillStyle: ExcalidrawElement["fillStyle"];
+        currentItemStrokeWidth: number;
+        currentItemStrokeStyle: ExcalidrawElement["strokeStyle"];
+        currentItemRoughness: number;
+        currentItemOpacity: number;
+        currentItemFontFamily: import("@excalidraw/element/types").FontFamilyValues;
+        currentItemFontSize: number;
+        currentItemTextAlign: import("@excalidraw/element/types").TextAlign;
+        currentItemStartArrowhead: import("@excalidraw/element/types").Arrowhead | null;
+        currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
+        currentHoveredFontFamily: import("@excalidraw/element/types").FontFamilyValues | null;
+        currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
+        currentItemArrowType: "sharp" | "round" | "elbow";
+        cursorButton: "up" | "down";
+        scrolledOutside: boolean;
+        isResizing: boolean;
+        openMenu: "canvas" | null;
+        openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | "fontFamily" | "compactTextProperties" | "compactStrokeStyles" | "compactOtherProperties" | "compactArrowProperties" | null;
+        openSidebar: {
+            name: import("../types").SidebarName;
+            tab?: import("../types").SidebarTabName;
+        } | null;
+        defaultSidebarDockedPreference: boolean;
+        lastPointerDownWith: import("@excalidraw/element/types").PointerType;
+        previousSelectedElementIds: {
+            [id: string]: true;
+        };
+        selectedElementsAreBeingDragged: boolean;
+        toast: {
+            message: string;
+            closable?: boolean;
+            duration?: number;
+        } | null;
+        gridStep: number;
+        gridModeEnabled: boolean;
+        fileHandle: FileSystemHandle | null;
+        stats: {
+            open: boolean;
+            panels: number;
+        };
+        currentChartType: import("@excalidraw/element/types").ChartType;
+        pasteDialog: {
+            shown: false;
+            data: null;
+        } | {
+            shown: true;
+            data: import("../charts").Spreadsheet;
+        };
+        showHyperlinkPopup: false | "info" | "editor";
+        originSnapOffset: {
+            x: number;
+            y: number;
+        } | null;
+        objectsSnapModeEnabled: boolean;
+        userToFollow: import("../types").UserToFollow | null;
+        followedBy: Set<import("../types").SocketId>;
+        lockedMultiSelections: {
+            [groupId: string]: true;
+        };
+    };
+    files: import("../types").BinaryFiles;
+}>;
 export declare const parseLibraryJSON: (json: string, defaultStatus?: LibraryItem["status"]) => LibraryItem[];
 export declare const loadLibraryFromBlob: (blob: Blob, defaultStatus?: LibraryItem["status"]) => Promise<LibraryItem[]>;
 export declare const canvasToBlob: (canvas: HTMLCanvasElement | Promise<HTMLCanvasElement>) => Promise<Blob>;
@@ -41,7 +359,7 @@ export declare const SVGStringToFile: (SVGString: string, filename?: string) =>
 };
 export declare const ImageURLToFile: (imageUrl: string, filename?: string) => Promise<File | undefined>;
 export declare const getFileHandle: (event: DragEvent | React.DragEvent | DataTransferItem) => Promise<FileSystemHandle | null>;
-export declare const createFile: (blob: File | Blob | ArrayBuffer, mimeType: ValueOf<typeof MIME_TYPES>, name: string | undefined) => File;
+export declare const createFile: (blob: File | Blob | ArrayBuffer, mimeType: string, name: string | undefined) => File;
 /** attempts to detect correct mimeType if none is set, or if an image
  * has an incorrect extension.
  * Note: doesn't handle missing .excalidraw/.excalidrawlib extension  */

package/dist/types/excalidraw/data/encode.d.ts

@@ -21,7 +21,7 @@ type EncodedData = {
 export declare const encode: ({ text, compress, }: {
     text: string;
     /** defaults to `true`. If compression fails, falls back to bstring alone. */
-    compress?: boolean | undefined;
+    compress?: boolean;
 }) => EncodedData;
 export declare const decode: (data: EncodedData) => string;
 /**
@@ -40,16 +40,16 @@ export declare const decode: (data: EncodedData) => string;
 export declare const compressData: <T extends Record<string, any> = never>(dataBuffer: Uint8Array, options: {
     encryptionKey: string;
 } & ([T] extends [never] ? {
-    metadata?: T | undefined;
+    metadata?: T;
 } : {
     metadata: T;
-})) => Promise<Uint8Array>;
+})) => Promise<Uint8Array<ArrayBuffer>>;
 export declare const decompressData: <T extends Record<string, any>>(bufferView: Uint8Array, options: {
     decryptionKey: string;
 }) => Promise<{
     /** metadata source is always JSON so we can decode it here */
     metadata: T;
     /** data can be anything so the caller must decode it */
-    data: Uint8Array;
+    data: Uint8Array<ArrayBuffer>;
 }>;
 export {};

package/dist/types/excalidraw/data/encryption.d.ts

@@ -1,9 +1,9 @@
 export declare const IV_LENGTH_BYTES = 12;
-export declare const createIV: () => Uint8Array;
-export declare const generateEncryptionKey: <T extends "string" | "cryptoKey" = "string">(returnAs?: T | undefined) => Promise<T extends "cryptoKey" ? CryptoKey : string>;
+export declare const createIV: () => Uint8Array<ArrayBuffer>;
+export declare const generateEncryptionKey: <T extends "string" | "cryptoKey" = "string">(returnAs?: T) => Promise<T extends "cryptoKey" ? CryptoKey : string>;
 export declare const getCryptoKey: (key: string, usage: KeyUsage) => Promise<CryptoKey>;
-export declare const encryptData: (key: string | CryptoKey, data: Uint8Array | ArrayBuffer | Blob | File | string) => Promise<{
+export declare const encryptData: (key: string | CryptoKey, data: Uint8Array<ArrayBuffer> | ArrayBuffer | Blob | File | string) => Promise<{
     encryptedBuffer: ArrayBuffer;
-    iv: Uint8Array;
+    iv: Uint8Array<ArrayBuffer>;
 }>;
-export declare const decryptData: (iv: Uint8Array, encrypted: Uint8Array | ArrayBuffer, privateKey: string) => Promise<ArrayBuffer>;
+export declare const decryptData: (iv: Uint8Array<ArrayBuffer>, encrypted: Uint8Array<ArrayBuffer> | ArrayBuffer, privateKey: string) => Promise<ArrayBuffer>;

package/dist/types/excalidraw/data/filesystem.d.ts

@@ -3,9 +3,9 @@ import { MIME_TYPES } from "@excalidraw/common";
 import type { FileSystemHandle } from "browser-fs-access";
 type FILE_EXTENSION = Exclude<keyof typeof MIME_TYPES, "binary">;
 export declare const fileOpen: <M extends boolean | undefined = false>(opts: {
-    extensions?: FILE_EXTENSION[] | undefined;
+    extensions?: FILE_EXTENSION[];
     description: string;
-    multiple?: M | undefined;
+    multiple?: M;
 }) => Promise<M extends false | undefined ? File : File[]>;
 export declare const fileSave: (blob: Blob | Promise<Blob>, opts: {
     /** supply without the extension */

package/dist/types/excalidraw/data/index.d.ts

@@ -13,10 +13,10 @@ export declare const prepareElementsForExport: (elements: readonly ExcalidrawEle
 };
 export declare const exportCanvas: (type: Omit<ExportType, "backend">, elements: ExportedElements, appState: AppState, files: BinaryFiles, { exportBackground, exportPadding, viewBackgroundColor, name, fileHandle, exportingFrame, }: {
     exportBackground: boolean;
-    exportPadding?: number | undefined;
+    exportPadding?: number;
     viewBackgroundColor: string;
     /** filename, if applicable */
-    name?: string | undefined;
-    fileHandle?: FileSystemHandle | null | undefined;
+    name?: string;
+    fileHandle?: FileSystemHandle | null;
     exportingFrame: ExcalidrawFrameLikeElement | null;
 }) => Promise<FileSystemHandle | null | undefined>;

package/dist/types/excalidraw/data/json.d.ts

@@ -2,10 +2,167 @@ import type { ExcalidrawElement } from "@excalidraw/element/types";
 import type { AppState, BinaryFiles, LibraryItems } from "../types";
 import type { ImportedDataState, ImportedLibraryData } from "./types";
 export declare const serializeAsJSON: (elements: readonly ExcalidrawElement[], appState: Partial<AppState>, files: BinaryFiles, type: "local" | "database") => string;
-export declare const saveAsJSON: (elements: readonly ExcalidrawElement[], appState: AppState, files: BinaryFiles, name?: string) => Promise<{
+export declare const saveAsJSON: (elements: readonly ExcalidrawElement[], appState: AppState, files: BinaryFiles, 
+/** filename */
+name?: string) => Promise<{
     fileHandle: import("browser-fs-access").FileSystemHandle | null;
 }>;
-export declare const loadFromJSON: (localAppState: AppState, localElements: readonly ExcalidrawElement[] | null) => Promise<import("./restore").RestoredDataState>;
+export declare const loadFromJSON: (localAppState: AppState, localElements: readonly ExcalidrawElement[] | null) => Promise<{
+    elements: import("@excalidraw/element/types").OrderedExcalidrawElement[];
+    appState: {
+        viewBackgroundColor: string;
+        theme: import("@excalidraw/element/types").Theme;
+        frameRendering: {
+            enabled: boolean;
+            name: boolean;
+            outline: boolean;
+            clip: boolean;
+        };
+        name: string | null;
+        zoom: import("../types").Zoom;
+        scrollX: number;
+        scrollY: number;
+        viewModeEnabled: boolean;
+        openDialog: null | {
+            name: "imageExport" | "help" | "jsonExport";
+        } | {
+            name: "ttd";
+            tab: "text-to-diagram" | "mermaid";
+        } | {
+            name: "commandPalette";
+        } | {
+            name: "settings";
+        } | {
+            name: "elementLinkSelector";
+            sourceElementId: ExcalidrawElement["id"];
+        };
+        editingGroupId: import("@excalidraw/element/types").GroupId | null;
+        selectedElementIds: Readonly<{
+            [id: string]: true;
+        }>;
+        frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
+        activeEmbeddable: {
+            element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
+            state: "hover" | "active";
+        } | null;
+        selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+        selectedGroupIds: {
+            [groupId: string]: boolean;
+        };
+        selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
+        multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
+        newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
+        isBindingEnabled: boolean;
+        suggestedBinding: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
+        isRotating: boolean;
+        elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
+        collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
+        snapLines: readonly import("../snapping").SnapLine[];
+        zenModeEnabled: boolean;
+        editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+        isCropping: boolean;
+        croppingElementId: ExcalidrawElement["id"] | null;
+        searchMatches: Readonly<{
+            focusedId: ExcalidrawElement["id"] | null;
+            matches: readonly import("../types").SearchMatch[];
+        }> | null;
+        activeLockedId: string | null;
+        hoveredElementIds: Readonly<{
+            [id: string]: true;
+        }>;
+        shouldCacheIgnoreZoom: boolean;
+        exportScale: number;
+        bindMode: import("@excalidraw/element/types").BindMode;
+        gridSize: number;
+        contextMenu: {
+            items: import("../components/ContextMenu").ContextMenuItems;
+            top: number;
+            left: number;
+        } | null;
+        showWelcomeScreen: boolean;
+        isLoading: boolean;
+        errorMessage: React.ReactNode;
+        resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+        startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
+        editingFrame: string | null;
+        activeTool: {
+            lastActiveTool: import("../types").ActiveTool | null;
+            locked: boolean;
+            fromSelection: boolean;
+        } & import("../types").ActiveTool;
+        preferredSelectionTool: {
+            type: "selection" | "lasso";
+            initialized: boolean;
+        };
+        penMode: boolean;
+        penDetected: boolean;
+        exportBackground: boolean;
+        exportEmbedScene: boolean;
+        exportWithDarkMode: boolean;
+        currentItemStrokeColor: string;
+        currentItemBackgroundColor: string;
+        currentItemFillStyle: ExcalidrawElement["fillStyle"];
+        currentItemStrokeWidth: number;
+        currentItemStrokeStyle: ExcalidrawElement["strokeStyle"];
+        currentItemRoughness: number;
+        currentItemOpacity: number;
+        currentItemFontFamily: import("@excalidraw/element/types").FontFamilyValues;
+        currentItemFontSize: number;
+        currentItemTextAlign: import("@excalidraw/element/types").TextAlign;
+        currentItemStartArrowhead: import("@excalidraw/element/types").Arrowhead | null;
+        currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
+        currentHoveredFontFamily: import("@excalidraw/element/types").FontFamilyValues | null;
+        currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
+        currentItemArrowType: "sharp" | "round" | "elbow";
+        cursorButton: "up" | "down";
+        scrolledOutside: boolean;
+        isResizing: boolean;
+        openMenu: "canvas" | null;
+        openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | "fontFamily" | "compactTextProperties" | "compactStrokeStyles" | "compactOtherProperties" | "compactArrowProperties" | null;
+        openSidebar: {
+            name: import("../types").SidebarName;
+            tab?: import("../types").SidebarTabName;
+        } | null;
+        defaultSidebarDockedPreference: boolean;
+        lastPointerDownWith: import("@excalidraw/element/types").PointerType;
+        previousSelectedElementIds: {
+            [id: string]: true;
+        };
+        selectedElementsAreBeingDragged: boolean;
+        toast: {
+            message: string;
+            closable?: boolean;
+            duration?: number;
+        } | null;
+        gridStep: number;
+        gridModeEnabled: boolean;
+        fileHandle: import("browser-fs-access").FileSystemHandle | null;
+        stats: {
+            open: boolean;
+            panels: number;
+        };
+        currentChartType: import("@excalidraw/element/types").ChartType;
+        pasteDialog: {
+            shown: false;
+            data: null;
+        } | {
+            shown: true;
+            data: import("../charts").Spreadsheet;
+        };
+        showHyperlinkPopup: false | "info" | "editor";
+        originSnapOffset: {
+            x: number;
+            y: number;
+        } | null;
+        objectsSnapModeEnabled: boolean;
+        userToFollow: import("../types").UserToFollow | null;
+        followedBy: Set<import("../types").SocketId>;
+        lockedMultiSelections: {
+            [groupId: string]: true;
+        };
+    };
+    files: BinaryFiles;
+}>;
 export declare const isValidExcalidrawData: (data?: {
     type?: any;
     elements?: any;

package/dist/types/excalidraw/data/library.d.ts

@@ -74,16 +74,31 @@ declare class Library {
     getLatestLibrary: () => Promise<LibraryItems>;
     updateLibrary: ({ libraryItems, prompt, merge, openLibraryMenu, defaultStatus, }: {
         libraryItems: LibraryItemsSource;
-        merge?: boolean | undefined;
-        prompt?: boolean | undefined;
-        openLibraryMenu?: boolean | undefined;
-        defaultStatus?: "published" | "unpublished" | undefined;
+        merge?: boolean;
+        prompt?: boolean;
+        openLibraryMenu?: boolean;
+        defaultStatus?: "unpublished" | "published";
     }) => Promise<LibraryItems>;
-    setLibrary: (libraryItems: LibraryItems | Promise<LibraryItems> | ((latestLibraryItems: LibraryItems) => LibraryItems | Promise<LibraryItems>)) => Promise<LibraryItems>;
+    setLibrary: (
+    /**
+     * LibraryItems that will replace current items. Can be a function which
+     * will be invoked after all previous tasks are resolved
+     * (this is the prefered way to update the library to avoid race conditions,
+     * but you'll want to manually merge the library items in the callback
+     *  - which is what we're doing in Library.importLibrary()).
+     *
+     * If supplied promise is rejected with AbortError, we swallow it and
+     * do not update the library.
+     */
+    libraryItems: LibraryItems | Promise<LibraryItems> | ((latestLibraryItems: LibraryItems) => LibraryItems | Promise<LibraryItems>)) => Promise<LibraryItems>;
 }
 export default Library;
 export declare const distributeLibraryItemsOnSquareGrid: (libraryItems: LibraryItems) => ExcalidrawElement[];
-export declare const validateLibraryUrl: (libraryUrl: string, validator?: string[] | ((libraryUrl: string) => boolean)) => true;
+export declare const validateLibraryUrl: (libraryUrl: string, 
+/**
+ * @returns `true` if the URL is valid, throws otherwise.
+ */
+validator?: ((libraryUrl: string) => boolean) | string[]) => true;
 export declare const parseLibraryTokensFromUrl: () => {
     libraryUrl: string;
     idToken: string | null;
@@ -95,10 +110,10 @@ export declare const useHandleLibrary: (opts: {
      * Return `true` if the library install url should be allowed.
      * If not supplied, only the excalidraw.com base domain is allowed.
      */
-    validateLibraryUrl?: ((libraryUrl: string) => boolean) | undefined;
+    validateLibraryUrl?: (libraryUrl: string) => boolean;
 } & ({
     /** @deprecated we recommend using `opts.adapter` instead */
-    getInitialLibraryItems?: (() => MaybePromise<LibraryItemsSource>) | undefined;
+    getInitialLibraryItems?: () => MaybePromise<LibraryItemsSource>;
 } | {
     adapter: LibraryPersistenceAdapter;
     /**
@@ -108,5 +123,5 @@ export declare const useHandleLibrary: (opts: {
      *
      * Can be a different LibraryPersistenceAdapter.
      */
-    migrationAdapter?: LibraryMigrationAdapter | undefined;
+    migrationAdapter?: LibraryMigrationAdapter;
 })) => void;