@myoc/excalidraw 0.19.502 → 0.19.503

package/dist/types/excalidraw/components/dropdownMenu/common.d.ts

@@ -3,4 +3,4 @@ export declare const DropdownMenuContentPropsContext: React.Context<{
     onSelect?: (event: Event) => void;
 }>;
 export declare const getDropdownMenuItemClassName: (className?: string, selected?: boolean, hovered?: boolean) => string;
-export declare const useHandleDropdownMenuItemClick: (origOnClick: React.MouseEventHandler<HTMLAnchorElement | HTMLButtonElement> | undefined, onSelect: ((event: Event) => void) | undefined) => (event: React.MouseEvent<HTMLAnchorElement | HTMLButtonElement, MouseEvent>) => void;
+export declare const useHandleDropdownMenuItemSelect: (onSelect: ((event: Event) => void) | undefined) => (event: Event) => void;

package/dist/types/excalidraw/components/dropdownMenu/dropdownMenuUtils.d.ts

@@ -1,3 +1,5 @@
 import React from "react";
 export declare const getMenuTriggerComponent: (children: React.ReactNode) => string | number | bigint | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null;
 export declare const getMenuContentComponent: (children: React.ReactNode) => string | number | bigint | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null;
+export declare const getSubMenuTriggerComponent: (children: React.ReactNode) => string | number | bigint | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null;
+export declare const getSubMenuContentComponent: (children: React.ReactNode) => string | number | bigint | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null;

package/dist/types/excalidraw/components/icons.d.ts

@@ -116,38 +116,49 @@ export declare const SloppinessArtistIcon: import("react/jsx-runtime").JSX.Eleme
 export declare const SloppinessCartoonistIcon: import("react/jsx-runtime").JSX.Element;
 export declare const EdgeSharpIcon: import("react/jsx-runtime").JSX.Element;
 export declare const EdgeRoundIcon: import("react/jsx-runtime").JSX.Element;
-export declare const ArrowheadNoneIcon: import("react/jsx-runtime").JSX.Element;
+export declare const ArrowheadNoneIcon: React.MemoExoticComponent<({ flip }: {
+    flip?: boolean;
+}) => import("react/jsx-runtime").JSX.Element>;
 export declare const ArrowheadArrowIcon: React.MemoExoticComponent<({ flip }: {
     flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
+export declare const ArrowheadTriangleIcon: React.MemoExoticComponent<({ flip }: {
+    flip?: boolean;
+}) => import("react/jsx-runtime").JSX.Element>;
+export declare const ArrowheadTriangleOutlineIcon: React.MemoExoticComponent<({ flip }: {
+    flip?: boolean;
+}) => import("react/jsx-runtime").JSX.Element>;
 export declare const ArrowheadCircleIcon: React.MemoExoticComponent<({ flip }: {
     flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
 export declare const ArrowheadCircleOutlineIcon: React.MemoExoticComponent<({ flip }: {
     flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const ArrowheadBarIcon: React.MemoExoticComponent<({ flip }: {
+export declare const ArrowheadDiamondIcon: React.MemoExoticComponent<({ flip }: {
     flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const ArrowheadTriangleIcon: React.MemoExoticComponent<({ flip }: {
+export declare const ArrowheadDiamondOutlineIcon: React.MemoExoticComponent<({ flip }: {
     flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const ArrowheadTriangleOutlineIcon: React.MemoExoticComponent<({ flip }: {
+export declare const ArrowheadBarIcon: React.MemoExoticComponent<({ flip }: {
     flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const ArrowheadDiamondIcon: React.MemoExoticComponent<({ flip }: {
+export declare const ArrowheadCardinalityOneIcon: React.MemoExoticComponent<({ flip }: {
     flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const ArrowheadDiamondOutlineIcon: React.MemoExoticComponent<({ flip }: {
+export declare const ArrowheadCardinalityManyIcon: React.MemoExoticComponent<({ flip }: {
+    flip?: boolean;
+}) => import("react/jsx-runtime").JSX.Element>;
+export declare const ArrowheadCardinalityOneOrManyIcon: React.MemoExoticComponent<({ flip }: {
     flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const ArrowheadCrowfootIcon: React.MemoExoticComponent<({ flip }: {
+export declare const ArrowheadCardinalityExactlyOneIcon: React.MemoExoticComponent<({ flip }: {
     flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const ArrowheadCrowfootOneIcon: React.MemoExoticComponent<({ flip }: {
+export declare const ArrowheadCardinalityZeroOrOneIcon: React.MemoExoticComponent<({ flip }: {
     flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const ArrowheadCrowfootOneOrManyIcon: React.MemoExoticComponent<({ flip }: {
+export declare const ArrowheadCardinalityZeroOrManyIcon: React.MemoExoticComponent<({ flip }: {
     flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
 export declare const FontSizeSmallIcon: import("react/jsx-runtime").JSX.Element;
@@ -238,4 +249,7 @@ export declare const chevronLeftIcon: import("react/jsx-runtime").JSX.Element;
 export declare const sidebarRightIcon: import("react/jsx-runtime").JSX.Element;
 export declare const messageCircleIcon: import("react/jsx-runtime").JSX.Element;
 export declare const presentationIcon: import("react/jsx-runtime").JSX.Element;
+export declare const emptyIcon: import("react/jsx-runtime").JSX.Element;
+export declare const chevronRight: import("react/jsx-runtime").JSX.Element;
+export declare const settingsIcon: import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/excalidraw/components/main-menu/DefaultItems.d.ts

@@ -58,3 +58,20 @@ export declare const LiveCollaborationTrigger: {
     }): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
+export declare const PreferencesToggleGridModeItem: () => import("react/jsx-runtime").JSX.Element;
+export declare const PreferencesToggleZenModeItem: () => import("react/jsx-runtime").JSX.Element;
+export declare const Preferences: {
+    ({ children, additionalItems, }: {
+        children?: React.ReactNode;
+        additionalItems?: React.ReactNode;
+    }): import("react/jsx-runtime").JSX.Element;
+    ToggleToolLock: () => import("react/jsx-runtime").JSX.Element;
+    ToggleSnapMode: () => import("react/jsx-runtime").JSX.Element;
+    ToggleArrowBinding: () => import("react/jsx-runtime").JSX.Element;
+    ToggleMidpointSnapping: () => import("react/jsx-runtime").JSX.Element;
+    ToggleGridMode: () => import("react/jsx-runtime").JSX.Element;
+    ToggleZenMode: () => import("react/jsx-runtime").JSX.Element;
+    ToggleViewMode: () => import("react/jsx-runtime").JSX.Element;
+    ToggleElementProperties: () => import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/types/excalidraw/components/main-menu/MainMenu.d.ts

@@ -19,19 +19,7 @@ declare const MainMenu: React.FC<{
         displayName: string;
     };
     Item: {
-        ({ icon, value, order, children, shortcut, className, hovered, selected, textStyle, onSelect, onClick, badge, ...rest }: {
-            icon?: React.JSX.Element;
-            value?: string | number | undefined;
-            order?: number;
-            onSelect?: (event: Event) => void;
-            children: React.ReactNode;
-            shortcut?: string;
-            hovered?: boolean;
-            selected?: boolean;
-            textStyle?: React.CSSProperties;
-            className?: string;
-            badge?: React.ReactNode;
-        } & Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onSelect">): import("react/jsx-runtime").JSX.Element;
+        ({ icon, badge, value, children, shortcut, className, selected, onSelect, ...rest }: import("../dropdownMenu/DropdownMenuItem").DropdownMenuItemProps): import("react/jsx-runtime").JSX.Element;
         displayName: string;
         Badge: {
             ({ type, children, }: {
@@ -72,6 +60,28 @@ declare const MainMenu: React.FC<{
         (): import("react/jsx-runtime").JSX.Element;
         displayName: string;
     };
+    Sub: {
+        ({ children }: {
+            children?: React.ReactNode;
+        }): import("react/jsx-runtime").JSX.Element;
+        Trigger: {
+            ({ children, icon, shortcut, className, }: {
+                children: React.ReactNode;
+                icon?: React.JSX.Element;
+                shortcut?: string;
+                className?: string;
+            }): import("react/jsx-runtime").JSX.Element;
+            displayName: string;
+        };
+        Content: {
+            ({ children, className, }: {
+                children?: React.ReactNode;
+                className?: string;
+            }): import("react/jsx-runtime").JSX.Element;
+            displayName: string;
+        };
+        displayName: string;
+    };
     DefaultItems: typeof DefaultItems;
 };
 export default MainMenu;

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,6 +92,7 @@ fileHandle?: FileSystemHandle | null) => Promise<{
             }>;
             shouldCacheIgnoreZoom: boolean;
             exportScale: number;
+            currentItemArrowType: "sharp" | "round" | "elbow";
             bindMode: import("@excalidraw/element/types").BindMode;
             gridSize: number;
             contextMenu: {
@@ -103,13 +116,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;
@@ -133,7 +142,6 @@ 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";
             cursorButton: "up" | "down";
             scrolledOutside: boolean;
             isResizing: boolean;
@@ -150,25 +158,17 @@ fileHandle?: FileSystemHandle | null) => Promise<{
             };
             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;
@@ -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,6 +266,7 @@ fileHandle?: FileSystemHandle | null) => Promise<{
         }>;
         shouldCacheIgnoreZoom: boolean;
         exportScale: number;
+        currentItemArrowType: "sharp" | "round" | "elbow";
         bindMode: import("@excalidraw/element/types").BindMode;
         gridSize: number;
         contextMenu: {
@@ -276,13 +290,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;
@@ -306,7 +316,6 @@ 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";
         cursorButton: "up" | "down";
         scrolledOutside: boolean;
         isResizing: boolean;
@@ -323,25 +332,17 @@ fileHandle?: FileSystemHandle | null) => Promise<{
         };
         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;
@@ -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,6 +90,7 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         }>;
         shouldCacheIgnoreZoom: boolean;
         exportScale: number;
+        currentItemArrowType: "sharp" | "round" | "elbow";
         bindMode: import("@excalidraw/element/types").BindMode;
         gridSize: number;
         contextMenu: {
@@ -92,13 +114,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;
@@ -122,7 +140,6 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         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;
@@ -139,25 +156,17 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         };
         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;

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