@excalidraw/common 0.18.0-9ba0f5d → 0.18.0-a9ca16e

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

@@ -2,12 +2,11 @@ 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 "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;
+export declare const getFileHandleType: (handle: FileSystemFileHandle | null) => string | null;
 export declare const isImageFileHandleType: (type: string | null) => type is "png" | "svg";
-export declare const isImageFileHandle: (handle: FileSystemHandle | null) => boolean;
+export declare const isImageFileHandle: (handle: FileSystemFileHandle | null) => handle is FileSystemFileHandle;
 export declare const isSupportedImageFileType: (type: string | null | undefined) => boolean;
 export declare const isSupportedImageFile: (blob: Blob | null | undefined) => blob is Blob & {
     type: ValueOf<typeof IMAGE_MIME_TYPES>;
@@ -15,76 +14,25 @@ export declare const isSupportedImageFile: (blob: Blob | null | undefined) => bl
 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<{
+/** FileSystemFileHandle. Defaults to `blob.handle` if defined, otherwise null. */
+fileHandle?: FileSystemFileHandle | null) => Promise<{
     type: "application/vnd.excalidraw+json";
     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;
+            gridModeEnabled: boolean;
+            objectsSnapModeEnabled: boolean;
+            theme: import("@excalidraw/element/types").Theme;
+            name: string | null;
+            currentItemArrowType: "sharp" | "round" | "elbow";
             gridSize: number;
+            activeTool: {
+                lastActiveTool: import("../types").ActiveTool | null;
+                locked: boolean;
+                fromSelection: boolean;
+            } & import("../types").ActiveTool;
             contextMenu: {
                 items: import("../components/ContextMenu").ContextMenuItems;
                 top: number;
@@ -93,14 +41,32 @@ fileHandle?: FileSystemHandle | null) => Promise<{
             showWelcomeScreen: boolean;
             isLoading: boolean;
             errorMessage: React.ReactNode;
+            activeEmbeddable: {
+                element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
+                state: "hover" | "active";
+            } | null;
+            newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
             resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
+            selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            isBindingEnabled: boolean;
+            bindingPreference: "enabled" | "disabled";
+            isMidpointSnappingEnabled: boolean;
             startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
+            suggestedBinding: {
+                element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
+                midPoint?: import("@excalidraw/math").GlobalPoint;
+            } | null;
+            frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
+            frameRendering: {
+                enabled: boolean;
+                name: boolean;
+                outline: boolean;
+                clip: boolean;
+            };
             editingFrame: string | null;
-            activeTool: {
-                lastActiveTool: import("../types").ActiveTool | null;
-                locked: boolean;
-                fromSelection: boolean;
-            } & import("../types").ActiveTool;
+            elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             preferredSelectionTool: {
                 type: "selection" | "lasso";
                 initialized: boolean;
@@ -110,6 +76,7 @@ fileHandle?: FileSystemHandle | null) => Promise<{
             exportBackground: boolean;
             exportEmbedScene: boolean;
             exportWithDarkMode: boolean;
+            exportScale: number;
             currentItemStrokeColor: string;
             currentItemBackgroundColor: string;
             currentItemFillStyle: ExcalidrawElement["fillStyle"];
@@ -124,53 +91,86 @@ fileHandle?: FileSystemHandle | null) => Promise<{
             currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
             currentHoveredFontFamily: import("@excalidraw/element/types").FontFamilyValues | null;
             currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
-            currentItemArrowType: "sharp" | "round" | "elbow";
+            viewBackgroundColor: string;
+            scrollX: number;
+            scrollY: number;
             cursorButton: "up" | "down";
             scrolledOutside: boolean;
             isResizing: boolean;
+            isRotating: boolean;
+            zoom: import("../types").Zoom;
             openMenu: "canvas" | null;
             openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | "fontFamily" | "compactTextProperties" | "compactStrokeStyles" | "compactOtherProperties" | "compactArrowProperties" | null;
             openSidebar: {
                 name: import("../types").SidebarName;
                 tab?: import("../types").SidebarTabName;
             } | null;
+            openDialog: null | {
+                name: "imageExport" | "help" | "jsonExport";
+            } | {
+                name: "ttd";
+                tab: "text-to-diagram" | "mermaid";
+            } | {
+                name: "commandPalette";
+            } | {
+                name: "settings";
+            } | {
+                name: "elementLinkSelector";
+                sourceElementId: ExcalidrawElement["id"];
+            } | {
+                name: "charts";
+                data: import("../charts").Spreadsheet;
+                rawText: string;
+            };
             defaultSidebarDockedPreference: boolean;
             lastPointerDownWith: import("@excalidraw/element/types").PointerType;
+            selectedElementIds: Readonly<{
+                [id: string]: true;
+            }>;
+            hoveredElementIds: Readonly<{
+                [id: string]: true;
+            }>;
             previousSelectedElementIds: {
                 [id: string]: true;
             };
             selectedElementsAreBeingDragged: boolean;
+            shouldCacheIgnoreZoom: boolean;
             toast: {
-                message: string;
+                message: React.ReactNode;
                 closable?: boolean;
                 duration?: number;
             } | null;
             gridStep: number;
-            gridModeEnabled: boolean;
-            fileHandle: FileSystemHandle | null;
+            selectedGroupIds: {
+                [groupId: string]: boolean;
+            };
+            editingGroupId: import("@excalidraw/element/types").GroupId | null;
+            fileHandle: FileSystemFileHandle | null;
+            collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
             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";
+            selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
+            snapLines: readonly import("../snapping").SnapLine[];
             originSnapOffset: {
                 x: number;
                 y: number;
             } | null;
-            objectsSnapModeEnabled: boolean;
             userToFollow: import("../types").UserToFollow | null;
             followedBy: Set<import("../types").SocketId>;
+            isCropping: boolean;
+            croppingElementId: ExcalidrawElement["id"] | null;
+            searchMatches: Readonly<{
+                focusedId: ExcalidrawElement["id"] | null;
+                matches: readonly import("../types").SearchMatch[];
+            }> | null;
+            activeLockedId: string | null;
             lockedMultiSelections: {
                 [groupId: string]: true;
             };
+            bindMode: import("@excalidraw/element/types").BindMode;
         };
         files: import("../types").BinaryFiles;
     };
@@ -181,74 +181,23 @@ fileHandle?: FileSystemHandle | null) => Promise<{
 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<{
+/** FileSystemFileHandle. Defaults to `blob.handle` if defined, otherwise null. */
+fileHandle?: FileSystemFileHandle | 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;
+        gridModeEnabled: boolean;
+        objectsSnapModeEnabled: boolean;
+        theme: import("@excalidraw/element/types").Theme;
+        name: string | null;
+        currentItemArrowType: "sharp" | "round" | "elbow";
         gridSize: number;
+        activeTool: {
+            lastActiveTool: import("../types").ActiveTool | null;
+            locked: boolean;
+            fromSelection: boolean;
+        } & import("../types").ActiveTool;
         contextMenu: {
             items: import("../components/ContextMenu").ContextMenuItems;
             top: number;
@@ -257,14 +206,32 @@ fileHandle?: FileSystemHandle | null) => Promise<{
         showWelcomeScreen: boolean;
         isLoading: boolean;
         errorMessage: React.ReactNode;
+        activeEmbeddable: {
+            element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
+            state: "hover" | "active";
+        } | null;
+        newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
         resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+        multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
+        selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+        isBindingEnabled: boolean;
+        bindingPreference: "enabled" | "disabled";
+        isMidpointSnappingEnabled: boolean;
         startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
+        suggestedBinding: {
+            element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
+            midPoint?: import("@excalidraw/math").GlobalPoint;
+        } | null;
+        frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
+        frameRendering: {
+            enabled: boolean;
+            name: boolean;
+            outline: boolean;
+            clip: boolean;
+        };
         editingFrame: string | null;
-        activeTool: {
-            lastActiveTool: import("../types").ActiveTool | null;
-            locked: boolean;
-            fromSelection: boolean;
-        } & import("../types").ActiveTool;
+        elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
+        editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
         preferredSelectionTool: {
             type: "selection" | "lasso";
             initialized: boolean;
@@ -274,6 +241,7 @@ fileHandle?: FileSystemHandle | null) => Promise<{
         exportBackground: boolean;
         exportEmbedScene: boolean;
         exportWithDarkMode: boolean;
+        exportScale: number;
         currentItemStrokeColor: string;
         currentItemBackgroundColor: string;
         currentItemFillStyle: ExcalidrawElement["fillStyle"];
@@ -288,53 +256,86 @@ fileHandle?: FileSystemHandle | null) => Promise<{
         currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
         currentHoveredFontFamily: import("@excalidraw/element/types").FontFamilyValues | null;
         currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
-        currentItemArrowType: "sharp" | "round" | "elbow";
+        viewBackgroundColor: string;
+        scrollX: number;
+        scrollY: number;
         cursorButton: "up" | "down";
         scrolledOutside: boolean;
         isResizing: boolean;
+        isRotating: boolean;
+        zoom: import("../types").Zoom;
         openMenu: "canvas" | null;
         openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | "fontFamily" | "compactTextProperties" | "compactStrokeStyles" | "compactOtherProperties" | "compactArrowProperties" | null;
         openSidebar: {
             name: import("../types").SidebarName;
             tab?: import("../types").SidebarTabName;
         } | null;
+        openDialog: null | {
+            name: "imageExport" | "help" | "jsonExport";
+        } | {
+            name: "ttd";
+            tab: "text-to-diagram" | "mermaid";
+        } | {
+            name: "commandPalette";
+        } | {
+            name: "settings";
+        } | {
+            name: "elementLinkSelector";
+            sourceElementId: ExcalidrawElement["id"];
+        } | {
+            name: "charts";
+            data: import("../charts").Spreadsheet;
+            rawText: string;
+        };
         defaultSidebarDockedPreference: boolean;
         lastPointerDownWith: import("@excalidraw/element/types").PointerType;
+        selectedElementIds: Readonly<{
+            [id: string]: true;
+        }>;
+        hoveredElementIds: Readonly<{
+            [id: string]: true;
+        }>;
         previousSelectedElementIds: {
             [id: string]: true;
         };
         selectedElementsAreBeingDragged: boolean;
+        shouldCacheIgnoreZoom: boolean;
         toast: {
-            message: string;
+            message: React.ReactNode;
             closable?: boolean;
             duration?: number;
         } | null;
         gridStep: number;
-        gridModeEnabled: boolean;
-        fileHandle: FileSystemHandle | null;
+        selectedGroupIds: {
+            [groupId: string]: boolean;
+        };
+        editingGroupId: import("@excalidraw/element/types").GroupId | null;
+        fileHandle: FileSystemFileHandle | null;
+        collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
         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";
+        selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
+        snapLines: readonly import("../snapping").SnapLine[];
         originSnapOffset: {
             x: number;
             y: number;
         } | null;
-        objectsSnapModeEnabled: boolean;
         userToFollow: import("../types").UserToFollow | null;
         followedBy: Set<import("../types").SocketId>;
+        isCropping: boolean;
+        croppingElementId: ExcalidrawElement["id"] | null;
+        searchMatches: Readonly<{
+            focusedId: ExcalidrawElement["id"] | null;
+            matches: readonly import("../types").SearchMatch[];
+        }> | null;
+        activeLockedId: string | null;
         lockedMultiSelections: {
             [groupId: string]: true;
         };
+        bindMode: import("@excalidraw/element/types").BindMode;
     };
     files: import("../types").BinaryFiles;
 }>;
@@ -358,7 +359,7 @@ export declare const SVGStringToFile: (SVGString: string, filename?: string) =>
     type: typeof MIME_TYPES.svg;
 };
 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 getFileHandle: (event: DragEvent | React.DragEvent | DataTransferItem) => Promise<FileSystemFileHandle | null>;
 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.

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

@@ -1,6 +1,5 @@
 import { supported as nativeFileSystemSupported } from "browser-fs-access";
 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[];
@@ -14,8 +13,7 @@ export declare const fileSave: (blob: Blob | Promise<Blob>, opts: {
     extension: FILE_EXTENSION;
     mimeTypes?: string[];
     description: string;
-    /** existing FileSystemHandle */
-    fileHandle?: FileSystemHandle | null;
-}) => Promise<FileSystemHandle | null>;
+    /** existing FileSystemFileHandle */
+    fileHandle?: FileSystemFileHandle | null;
+}) => Promise<FileSystemFileHandle | null>;
 export { nativeFileSystemSupported };
-export type { FileSystemHandle };

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

@@ -1,5 +1,4 @@
 import type { ExcalidrawElement, ExcalidrawFrameLikeElement, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
-import type { FileSystemHandle } from "./filesystem";
 import type { ExportType } from "../scene/types";
 import type { AppState, BinaryFiles } from "../types";
 export { loadFromBlob } from "./blob";
@@ -17,6 +16,6 @@ export declare const exportCanvas: (type: Omit<ExportType, "backend">, elements:
     viewBackgroundColor: string;
     /** filename, if applicable */
     name?: string;
-    fileHandle?: FileSystemHandle | null;
+    fileHandle?: FileSystemFileHandle | null;
     exportingFrame: ExcalidrawFrameLikeElement | null;
-}) => Promise<FileSystemHandle | null | undefined>;
+}) => Promise<FileSystemFileHandle | null | undefined>;