@myoc/excalidraw 0.19.502 → 0.19.504

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,8 +14,8 @@ 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[];
@@ -43,12 +42,21 @@ fileHandle?: FileSystemHandle | null) => Promise<{
             } | {
                 name: "elementLinkSelector";
                 sourceElementId: ExcalidrawElement["id"];
+            } | {
+                name: "charts";
+                data: import("../charts").Spreadsheet;
+                rawText: string;
             };
             editingGroupId: import("@excalidraw/element/types").GroupId | null;
             selectedElementIds: Readonly<{
                 [id: string]: true;
             }>;
             frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
+            activeTool: {
+                lastActiveTool: import("../types").ActiveTool | null;
+                locked: boolean;
+                fromSelection: boolean;
+            } & import("../types").ActiveTool;
             activeEmbeddable: {
                 element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
                 state: "hover" | "active";
@@ -61,13 +69,17 @@ fileHandle?: FileSystemHandle | null) => Promise<{
             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;
+            isMidpointSnappingEnabled: boolean;
+            suggestedBinding: {
+                element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
+                midPoint?: import("@excalidraw/math").GlobalPoint;
+            } | 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;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             isCropping: boolean;
             croppingElementId: ExcalidrawElement["id"] | null;
             searchMatches: Readonly<{
@@ -80,8 +92,15 @@ fileHandle?: FileSystemHandle | null) => Promise<{
             }>;
             shouldCacheIgnoreZoom: boolean;
             exportScale: number;
+            currentItemArrowType: "sharp" | "round" | "elbow";
             bindMode: import("@excalidraw/element/types").BindMode;
             gridSize: number;
+            gridModeEnabled: boolean;
+            objectsSnapModeEnabled: boolean;
+            wheelZoomsOnDefault?: boolean | undefined;
+            selectedElementsAreBeingDragged: boolean;
+            gridStep: number;
+            currentHoveredFontFamily: import("@excalidraw/element/types").FontFamilyValues | null;
             contextMenu: {
                 items: import("../components/ContextMenu").ContextMenuItems;
                 top: number;
@@ -92,7 +111,6 @@ fileHandle?: FileSystemHandle | null) => Promise<{
             myocSimplifiedMode: boolean;
             dontResizeLimitMBs: number;
             hideMainMenus: boolean;
-            wheelZoomsOnDefault?: boolean | undefined;
             arrangeConfiguration: {
                 algorithm: import("@excalidraw/element/types").ArrangeAlgorithms;
                 gap: number;
@@ -103,13 +121,9 @@ fileHandle?: FileSystemHandle | null) => Promise<{
             };
             errorMessage: React.ReactNode;
             resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            bindingPreference: "enabled" | "disabled";
             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;
@@ -131,9 +145,7 @@ fileHandle?: FileSystemHandle | null) => Promise<{
             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;
@@ -148,33 +160,21 @@ fileHandle?: FileSystemHandle | null) => Promise<{
             previousSelectedElementIds: {
                 [id: string]: true;
             };
-            selectedElementsAreBeingDragged: boolean;
             toast: {
-                message: string;
+                message: React.ReactNode;
                 closable?: boolean;
                 duration?: number;
             } | null;
-            gridStep: number;
-            gridModeEnabled: boolean;
-            fileHandle: FileSystemHandle | null;
+            fileHandle: FileSystemFileHandle | 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: {
@@ -190,8 +190,8 @@ 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;
@@ -216,12 +216,21 @@ fileHandle?: FileSystemHandle | null) => Promise<{
         } | {
             name: "elementLinkSelector";
             sourceElementId: ExcalidrawElement["id"];
+        } | {
+            name: "charts";
+            data: import("../charts").Spreadsheet;
+            rawText: string;
         };
         editingGroupId: import("@excalidraw/element/types").GroupId | null;
         selectedElementIds: Readonly<{
             [id: string]: true;
         }>;
         frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
+        activeTool: {
+            lastActiveTool: import("../types").ActiveTool | null;
+            locked: boolean;
+            fromSelection: boolean;
+        } & import("../types").ActiveTool;
         activeEmbeddable: {
             element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
             state: "hover" | "active";
@@ -234,13 +243,17 @@ fileHandle?: FileSystemHandle | null) => Promise<{
         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;
+        isMidpointSnappingEnabled: boolean;
+        suggestedBinding: {
+            element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
+            midPoint?: import("@excalidraw/math").GlobalPoint;
+        } | 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;
+        editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
         isCropping: boolean;
         croppingElementId: ExcalidrawElement["id"] | null;
         searchMatches: Readonly<{
@@ -253,8 +266,15 @@ fileHandle?: FileSystemHandle | null) => Promise<{
         }>;
         shouldCacheIgnoreZoom: boolean;
         exportScale: number;
+        currentItemArrowType: "sharp" | "round" | "elbow";
         bindMode: import("@excalidraw/element/types").BindMode;
         gridSize: number;
+        gridModeEnabled: boolean;
+        objectsSnapModeEnabled: boolean;
+        wheelZoomsOnDefault?: boolean | undefined;
+        selectedElementsAreBeingDragged: boolean;
+        gridStep: number;
+        currentHoveredFontFamily: import("@excalidraw/element/types").FontFamilyValues | null;
         contextMenu: {
             items: import("../components/ContextMenu").ContextMenuItems;
             top: number;
@@ -265,7 +285,6 @@ fileHandle?: FileSystemHandle | null) => Promise<{
         myocSimplifiedMode: boolean;
         dontResizeLimitMBs: number;
         hideMainMenus: boolean;
-        wheelZoomsOnDefault?: boolean | undefined;
         arrangeConfiguration: {
             algorithm: import("@excalidraw/element/types").ArrangeAlgorithms;
             gap: number;
@@ -276,13 +295,9 @@ fileHandle?: FileSystemHandle | null) => Promise<{
         };
         errorMessage: React.ReactNode;
         resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+        bindingPreference: "enabled" | "disabled";
         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;
@@ -304,9 +319,7 @@ fileHandle?: FileSystemHandle | null) => Promise<{
         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;
@@ -321,33 +334,21 @@ fileHandle?: FileSystemHandle | null) => Promise<{
         previousSelectedElementIds: {
             [id: string]: true;
         };
-        selectedElementsAreBeingDragged: boolean;
         toast: {
-            message: string;
+            message: React.ReactNode;
             closable?: boolean;
             duration?: number;
         } | null;
-        gridStep: number;
-        gridModeEnabled: boolean;
-        fileHandle: FileSystemHandle | null;
+        fileHandle: FileSystemFileHandle | 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: {
@@ -376,7 +377,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>;

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

@@ -1,11 +1,19 @@
-import type { ExcalidrawElement } from "@excalidraw/element/types";
+import type { ExcalidrawElement, NonDeleted } from "@excalidraw/element/types";
+import type { MaybePromise } from "@excalidraw/common/utility-types";
 import type { AppState, BinaryFiles, LibraryItems } from "../types";
 import type { ImportedDataState, ImportedLibraryData } from "./types";
+export type JSONExportData = {
+    elements: readonly NonDeleted<ExcalidrawElement>[];
+    appState: AppState;
+    files: BinaryFiles;
+};
 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, 
-/** filename */
-name?: string) => Promise<{
-    fileHandle: import("browser-fs-access").FileSystemHandle | null;
+export declare const saveAsJSON: ({ data, filename, fileHandle, }: {
+    data: MaybePromise<JSONExportData>;
+    filename: string;
+    fileHandle: AppState["fileHandle"];
+}) => Promise<{
+    fileHandle: FileSystemFileHandle | null;
 }>;
 export declare const loadFromJSON: (localAppState: AppState, localElements: readonly ExcalidrawElement[] | null) => Promise<{
     elements: import("@excalidraw/element/types").OrderedExcalidrawElement[];
@@ -32,12 +40,21 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         } | {
             name: "elementLinkSelector";
             sourceElementId: ExcalidrawElement["id"];
+        } | {
+            name: "charts";
+            data: import("../charts").Spreadsheet;
+            rawText: string;
         };
         editingGroupId: import("@excalidraw/element/types").GroupId | null;
         selectedElementIds: Readonly<{
             [id: string]: true;
         }>;
-        frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
+        frameToHighlight: NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
+        activeTool: {
+            lastActiveTool: import("../types").ActiveTool | null;
+            locked: boolean;
+            fromSelection: boolean;
+        } & import("../types").ActiveTool;
         activeEmbeddable: {
             element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
             state: "hover" | "active";
@@ -47,16 +64,20 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
             [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;
+        multiElement: NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
+        newElement: NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
         isBindingEnabled: boolean;
-        suggestedBinding: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
+        isMidpointSnappingEnabled: boolean;
+        suggestedBinding: {
+            element: NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
+            midPoint?: import("@excalidraw/math").GlobalPoint;
+        } | null;
         isRotating: boolean;
-        elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
+        elementsToHighlight: 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;
+        editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
         isCropping: boolean;
         croppingElementId: ExcalidrawElement["id"] | null;
         searchMatches: Readonly<{
@@ -69,8 +90,15 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         }>;
         shouldCacheIgnoreZoom: boolean;
         exportScale: number;
+        currentItemArrowType: "sharp" | "round" | "elbow";
         bindMode: import("@excalidraw/element/types").BindMode;
         gridSize: number;
+        gridModeEnabled: boolean;
+        objectsSnapModeEnabled: boolean;
+        wheelZoomsOnDefault?: boolean | undefined;
+        selectedElementsAreBeingDragged: boolean;
+        gridStep: number;
+        currentHoveredFontFamily: import("@excalidraw/element/types").FontFamilyValues | null;
         contextMenu: {
             items: import("../components/ContextMenu").ContextMenuItems;
             top: number;
@@ -81,7 +109,6 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         myocSimplifiedMode: boolean;
         dontResizeLimitMBs: number;
         hideMainMenus: boolean;
-        wheelZoomsOnDefault?: boolean | undefined;
         arrangeConfiguration: {
             algorithm: import("@excalidraw/element/types").ArrangeAlgorithms;
             gap: number;
@@ -92,13 +119,9 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         };
         errorMessage: React.ReactNode;
         resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
-        startBoundElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement> | null;
+        bindingPreference: "enabled" | "disabled";
+        startBoundElement: 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;
@@ -120,9 +143,7 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         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;
@@ -137,33 +158,21 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         previousSelectedElementIds: {
             [id: string]: true;
         };
-        selectedElementsAreBeingDragged: boolean;
         toast: {
-            message: string;
+            message: React.ReactNode;
             closable?: boolean;
             duration?: number;
         } | null;
-        gridStep: number;
-        gridModeEnabled: boolean;
-        fileHandle: import("browser-fs-access").FileSystemHandle | null;
+        fileHandle: FileSystemFileHandle | 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: {

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

@@ -1,5 +1,10 @@
+import type { MaybePromise } from "@excalidraw/common/utility-types";
 import type { ExcalidrawElement } from "@excalidraw/element/types";
 import type { AppState, BinaryFiles } from "../types";
-export declare const resaveAsImageWithScene: (elements: readonly ExcalidrawElement[], appState: AppState, files: BinaryFiles, name: string) => Promise<{
-    fileHandle: import("browser-fs-access").FileSystemHandle;
+export declare const resaveAsImageWithScene: (data: MaybePromise<{
+    elements: readonly ExcalidrawElement[];
+    appState: AppState;
+    files: BinaryFiles;
+}>, fileHandle: FileSystemFileHandle, filename: string) => Promise<{
+    fileHandle: FileSystemFileHandle;
 }>;

package/dist/types/excalidraw/editorPreferences.d.ts

@@ -0,0 +1,11 @@
+import type { AppState, ArrangePreferences, EditorPreferences, NormalisePreferences, SmartZoomPreferences } from "./types";
+export type ResolvedSmartZoomPreferences = Required<SmartZoomPreferences>;
+export type ResolvedArrangePreferences = Required<ArrangePreferences>;
+export type ResolvedNormalisePreferences = Required<NormalisePreferences>;
+export type ResolvedEditorPreferences = {
+    smartZoom: ResolvedSmartZoomPreferences;
+    arrange: ResolvedArrangePreferences;
+    normalise: ResolvedNormalisePreferences;
+};
+export declare const DEFAULT_SMART_ZOOM_PREFERENCES: ResolvedSmartZoomPreferences;
+export declare const getEffectiveEditorPreferences: (appState: Readonly<Pick<AppState, "arrangeConfiguration" | "normaliseConfiguration">>, editorPreferences?: EditorPreferences) => ResolvedEditorPreferences;

package/dist/types/excalidraw/hooks/useAppStateValue.d.ts

@@ -0,0 +1,29 @@
+import type { AppState } from "../types";
+/**
+ * Subscribes to specific appState changes. The component re-renders
+ * only when the specified prop(s) change — not on every appState update.
+ *
+ * Works both inside and outside the <Excalidraw> tree, as long as
+ * ExcalidrawAPIContext.Provider is an ancestor (automatically provided
+ * inside <Excalidraw>, or manually by the host app).
+ *
+ * Returns the narrowed value depending on prop form:
+ *  - `keyof AppState` → `AppState[K]`
+ *  - `(keyof AppState)[]` → whole `AppState`
+ *  - selector function → selector's return type `T`
+ *
+ * If excalidrawAPI is not ready yet (host apps), hook is rerendered with latest
+ * value once available.
+ */
+export declare function useAppStateValue<K extends keyof AppState>(prop: K, _internal?: boolean): AppState[K];
+export declare function useAppStateValue(props: (keyof AppState)[], _internal?: boolean): AppState;
+export declare function useAppStateValue<T>(selector: (appState: AppState) => T, _internal?: boolean): T;
+/**
+ * Subscribes to specific appState changes without causing component rerenders.
+ *
+ * The callback is called on every matching change, but also on initial render
+ * so you can initialize your state.
+ */
+export declare function useOnAppStateChange<K extends keyof AppState>(prop: K, callback: (value: AppState[K], appState: AppState) => void): undefined;
+export declare function useOnAppStateChange(props: (keyof AppState)[], callback: (props: AppState, appState: AppState) => void): undefined;
+export declare function useOnAppStateChange<T>(selector: (appState: AppState) => T, callback: (value: T, appState: AppState) => void): undefined;

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

@@ -3,10 +3,19 @@ import Footer from "./components/footer/FooterCenter";
 import LiveCollaborationTrigger from "./components/live-collaboration/LiveCollaborationTrigger";
 import MainMenu from "./components/main-menu/MainMenu";
 import WelcomeScreen from "./components/welcome-screen/WelcomeScreen";
+import { useOnAppStateChange as _useOnAppStateChange } from "./hooks/useAppStateValue";
 import "./css/app.scss";
 import "./css/styles.scss";
 import "./fonts/fonts.css";
-import type { ExcalidrawProps } from "./types";
+import type { AppState, ExcalidrawProps } from "./types";
+/**
+ * Stateless provider that allows `useExcalidrawAPI()` (and hooks built
+ * on it, such as `useAppStateValue()` and `useOnAppStateChange()`) to work
+ * outside the <Excalidraw> component tree.
+ */
+export declare const ExcalidrawAPIProvider: ({ children, }: {
+    children: React.ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;
 export declare const Excalidraw: React.MemoExoticComponent<(props: ExcalidrawProps) => import("react/jsx-runtime").JSX.Element>;
 export { getSceneVersion, hashElementsVersion, hashString, getNonDeletedElements, } from "@excalidraw/element";
 export { getTextFromElements } from "@excalidraw/element";
@@ -19,7 +28,7 @@ export { serializeAsJSON, serializeLibraryAsJSON } from "./data/json";
 export { loadFromBlob, loadSceneOrLibraryFromBlob, loadLibraryFromBlob, } from "./data/blob";
 export { mergeLibraryItems, getLibraryItemsHash } from "./data/library";
 export { isLinearElement } from "@excalidraw/element";
-export { FONT_FAMILY, THEME, MIME_TYPES, ROUNDNESS, DEFAULT_LASER_COLOR, UserIdleState, normalizeLink, sceneCoordsToViewportCoords, viewportCoordsToSceneCoords, getFormFactor, } from "@excalidraw/common";
+export { FONT_FAMILY, THEME, MIME_TYPES, ROUNDNESS, DEFAULT_LASER_COLOR, UserIdleState, normalizeLink, sceneCoordsToViewportCoords, viewportCoordsToSceneCoords, getFormFactor, throttleRAF, } from "@excalidraw/common";
 export { mutateElement, newElementWith, bumpVersion, } from "@excalidraw/element";
 export { CaptureUpdateAction } from "@excalidraw/element";
 export { parseLibraryTokensFromUrl, useHandleLibrary } from "./data/library";
@@ -28,7 +37,7 @@ export { Button } from "./components/Button";
 export { Footer };
 export { MainMenu };
 export { Ellipsify } from "./components/Ellipsify";
-export { useEditorInterface, useStylesPanelMode } from "./components/App";
+export { useEditorInterface, useStylesPanelMode, useExcalidrawAPI, ExcalidrawAPIContext, } from "./components/App";
 export { WelcomeScreen };
 export { LiveCollaborationTrigger };
 export { Stats } from "./components/Stats";
@@ -39,4 +48,18 @@ export { elementsOverlappingBBox, isElementInsideBBox, elementPartiallyOverlapsW
 export { DiagramToCodePlugin } from "./components/DiagramToCodePlugin/DiagramToCodePlugin";
 export { getDataURL } from "./data/blob";
 export { isElementLink } from "@excalidraw/element";
+export { Fonts } from "./fonts/Fonts";
 export { setCustomTextMetricsProvider } from "@excalidraw/element";
+export { CommandPalette } from "./components/CommandPalette/CommandPalette";
+export type { ArrangePreferences, EditorPreferences, NormalisePreferences, SmartZoomPreferences, } from "./types";
+export { renderSpreadsheet, tryParseSpreadsheet, isSpreadsheetValidForChartType, } from "./charts";
+/**
+ * hook that subscribes to specific appState prop(s)
+ *
+ * @param prop - appState prop(s) to subscribe to, or a selector function.
+ * NOTE `prop/selector` is memoized and will not change after initial render
+ */
+export declare function useExcalidrawStateValue<K extends keyof AppState>(prop: K): AppState[K] | undefined;
+export declare function useExcalidrawStateValue<T extends keyof AppState>(props: T[]): AppState | undefined;
+export declare function useExcalidrawStateValue<T>(selector: (appState: AppState) => T): T | undefined;
+export { _useOnAppStateChange as useOnExcalidrawStateChange };

package/dist/types/excalidraw/textAutoResizeHandle.d.ts

@@ -0,0 +1,15 @@
+import { type GlobalPoint } from "@excalidraw/math";
+import type { EditorInterface } from "@excalidraw/common";
+import type { ExcalidrawTextElement } from "@excalidraw/element/types";
+export declare const getTextBoxPadding: (zoomValue: number) => number;
+export declare const getTextAutoResizeHandle: (textElement: ExcalidrawTextElement, zoomValue: number, formFactor: EditorInterface["formFactor"]) => {
+    center: GlobalPoint | import("@excalidraw/math").LocalPoint;
+    start: GlobalPoint;
+    end: GlobalPoint;
+    hitboxWidth: number;
+    hitboxHeight: number;
+} | null;
+export declare const isPointHittingTextAutoResizeHandle: (point: Readonly<{
+    x: number;
+    y: number;
+}>, textElement: ExcalidrawTextElement, zoomValue: number, formFactor: EditorInterface["formFactor"]) => boolean;