@dwelle/excalidraw 0.3.58 → 0.3.60

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dwelle/excalidraw",
-  "version": "0.3.58",
+  "version": "0.3.60",
   "main": "main.js",
   "types": "types/packages/excalidraw/index.d.ts",
   "files": [

package/types/actions/actionClipboard.d.ts

@@ -513,3 +513,16 @@ export declare const actionCopyAsPng: {
 } & {
     keyTest?: ((event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean) | undefined;
 };
+export declare const copyText: {
+    name: "copyText";
+    trackEvent: {
+        category: "element";
+    };
+    perform: (elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<import("../types").AppState>) => {
+        commitToHistory: false;
+    };
+    contextItemPredicate: (elements: readonly import("../element/types").ExcalidrawElement[], appState: import("../types").AppState) => boolean;
+    contextItemLabel: string;
+} & {
+    keyTest?: undefined;
+};

package/types/actions/actionFinalize.d.ts

@@ -6,6 +6,7 @@ export declare const actionFinalize: {
     perform: (elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<import("../types").AppState>, _: any, { canvas, focusContainer }: import("../types").AppClassProperties) => {
         elements: import("../element/types").ExcalidrawElement[] | undefined;
         appState: {
+            cursorButton: "up";
             editingLinearElement: null;
             isLoading: boolean;
             errorMessage: string | null;
@@ -45,7 +46,6 @@ export declare const actionFinalize: {
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
-            cursorButton: "up" | "down";
             scrolledOutside: boolean;
             name: string;
             isResizing: boolean;
@@ -96,6 +96,7 @@ export declare const actionFinalize: {
     } | {
         elements: readonly import("../element/types").ExcalidrawElement[];
         appState: {
+            cursorButton: "up";
             activeTool: {
                 type: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | "eraser";
                 lastActiveToolBeforeEraser: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | null;
@@ -139,7 +140,6 @@ export declare const actionFinalize: {
             viewBackgroundColor: string;
             scrollX: number;
             scrollY: number;
-            cursorButton: "up" | "down";
             scrolledOutside: boolean;
             name: string;
             isResizing: boolean;

package/types/actions/actionToggleLock.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="react" />
+import { ExcalidrawElement } from "../element/types";
+export declare const actionToggleLock: {
+    name: "toggleLock";
+    trackEvent: {
+        category: "element";
+    };
+    perform: (elements: readonly ExcalidrawElement[], appState: Readonly<import("../types").AppState>) => false | {
+        elements: ExcalidrawElement[];
+        appState: Readonly<import("../types").AppState>;
+        commitToHistory: true;
+    };
+    contextItemLabel: (elements: readonly ExcalidrawElement[], appState: Readonly<import("../types").AppState>) => "labels.elementLock.unlock" | "labels.elementLock.lock" | "labels.elementLock.lockAll" | "labels.elementLock.unlockAll";
+    keyTest: (event: KeyboardEvent | import("react").KeyboardEvent<Element>, appState: import("../types").AppState, elements: readonly ExcalidrawElement[]) => boolean;
+} & {
+    keyTest?: ((event: KeyboardEvent | import("react").KeyboardEvent<Element>, appState: import("../types").AppState, elements: readonly ExcalidrawElement[]) => boolean) | undefined;
+};

package/types/actions/index.d.ts

@@ -14,9 +14,10 @@ export { actionAddToLibrary } from "./actionAddToLibrary";
 export { actionAlignTop, actionAlignBottom, actionAlignLeft, actionAlignRight, actionAlignVerticallyCentered, actionAlignHorizontallyCentered, } from "./actionAlign";
 export { distributeHorizontally, distributeVertically, } from "./actionDistribute";
 export { actionFlipHorizontal, actionFlipVertical } from "./actionFlip";
-export { actionCopy, actionCut, actionCopyAsPng, actionCopyAsSvg, } from "./actionClipboard";
+export { actionCopy, actionCut, actionCopyAsPng, actionCopyAsSvg, copyText, } from "./actionClipboard";
 export { actionToggleGridMode } from "./actionToggleGridMode";
 export { actionToggleZenMode } from "./actionToggleZenMode";
 export { actionToggleStats } from "./actionToggleStats";
 export { actionUnbindText, actionBindText } from "./actionBoundText";
 export { actionLink } from "../element/Hyperlink";
+export { actionToggleLock } from "./actionToggleLock";

package/types/actions/shortcuts.d.ts

@@ -1,3 +1,3 @@
 import { ActionName } from "./types";
-export declare type ShortcutName = SubtypeOf<ActionName, "cut" | "copy" | "paste" | "copyStyles" | "pasteStyles" | "selectAll" | "deleteSelectedElements" | "duplicateSelection" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyAsPng" | "copyAsSvg" | "group" | "ungroup" | "gridMode" | "zenMode" | "stats" | "addToLibrary" | "viewMode" | "flipHorizontal" | "flipVertical" | "hyperlink">;
+export declare type ShortcutName = SubtypeOf<ActionName, "cut" | "copy" | "paste" | "copyStyles" | "pasteStyles" | "selectAll" | "deleteSelectedElements" | "duplicateSelection" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyAsPng" | "copyAsSvg" | "group" | "ungroup" | "gridMode" | "zenMode" | "stats" | "addToLibrary" | "viewMode" | "flipHorizontal" | "flipVertical" | "hyperlink" | "toggleLock">;
 export declare const getShortcutFromShortcutName: (name: ShortcutName) => string;

package/types/actions/types.d.ts

@@ -15,7 +15,7 @@ export declare type ActionResult = {
 declare type ActionFn = (elements: readonly ExcalidrawElement[], appState: Readonly<AppState>, formData: any, app: AppClassProperties) => ActionResult | Promise<ActionResult>;
 export declare type UpdaterFn = (res: ActionResult) => void;
 export declare type ActionFilterFn = (action: Action) => void;
-export declare type ActionName = "copy" | "cut" | "paste" | "copyAsPng" | "copyAsSvg" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyStyles" | "selectAll" | "pasteStyles" | "gridMode" | "zenMode" | "stats" | "changeStrokeColor" | "changeBackgroundColor" | "changeFillStyle" | "changeStrokeWidth" | "changeStrokeShape" | "changeSloppiness" | "changeStrokeStyle" | "changeArrowhead" | "changeOpacity" | "changeFontSize" | "toggleCanvasMenu" | "toggleEditMenu" | "undo" | "redo" | "finalize" | "changeProjectName" | "changeExportBackground" | "changeExportEmbedScene" | "changeExportScale" | "saveToActiveFile" | "saveFileToDisk" | "loadScene" | "duplicateSelection" | "deleteSelectedElements" | "changeViewBackgroundColor" | "clearCanvas" | "zoomIn" | "zoomOut" | "resetZoom" | "zoomToFit" | "zoomToSelection" | "changeFontFamily" | "changeTextAlign" | "changeVerticalAlign" | "toggleFullScreen" | "toggleShortcuts" | "group" | "ungroup" | "goToCollaborator" | "addToLibrary" | "changeSharpness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "viewMode" | "exportWithDarkMode" | "toggleTheme" | "increaseFontSize" | "decreaseFontSize" | "unbindText" | "hyperlink" | "eraser" | "bindText";
+export declare type ActionName = "copy" | "cut" | "paste" | "copyAsPng" | "copyAsSvg" | "copyText" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyStyles" | "selectAll" | "pasteStyles" | "gridMode" | "zenMode" | "stats" | "changeStrokeColor" | "changeBackgroundColor" | "changeFillStyle" | "changeStrokeWidth" | "changeStrokeShape" | "changeSloppiness" | "changeStrokeStyle" | "changeArrowhead" | "changeOpacity" | "changeFontSize" | "toggleCanvasMenu" | "toggleEditMenu" | "undo" | "redo" | "finalize" | "changeProjectName" | "changeExportBackground" | "changeExportEmbedScene" | "changeExportScale" | "saveToActiveFile" | "saveFileToDisk" | "loadScene" | "duplicateSelection" | "deleteSelectedElements" | "changeViewBackgroundColor" | "clearCanvas" | "zoomIn" | "zoomOut" | "resetZoom" | "zoomToFit" | "zoomToSelection" | "changeFontFamily" | "changeTextAlign" | "changeVerticalAlign" | "toggleFullScreen" | "toggleShortcuts" | "group" | "ungroup" | "goToCollaborator" | "addToLibrary" | "changeSharpness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "viewMode" | "exportWithDarkMode" | "toggleTheme" | "increaseFontSize" | "decreaseFontSize" | "unbindText" | "hyperlink" | "eraser" | "bindText" | "toggleLock";
 export declare type PanelComponentProps = {
     elements: readonly ExcalidrawElement[];
     appState: AppState;

package/types/clipboard.d.ts

@@ -16,5 +16,5 @@ export declare const copyToClipboard: (elements: readonly NonDeletedExcalidrawEl
  * Attempts to parse clipboard. Prefers system clipboard.
  */
 export declare const parseClipboard: (event: ClipboardEvent | null) => Promise<ClipboardData>;
-export declare const copyBlobToClipboardAsPng: (blob: Blob) => Promise<void>;
+export declare const copyBlobToClipboardAsPng: (blob: Blob | Promise<Blob>) => Promise<void>;
 export declare const copyTextToSystemClipboard: (text: string | null) => Promise<void>;

package/types/components/App.d.ts

@@ -89,7 +89,7 @@ declare class App extends React.Component<AppProps, AppState> {
         appState?: Pick<AppState, K> | null | undefined;
         collaborators?: SceneData["collaborators"];
         commitToHistory?: SceneData["commitToHistory"];
-        libraryItems?: SceneData["libraryItems"];
+        libraryItems?: LibraryItems | import("../types").LibraryItems_v1 | Promise<LibraryItems | import("../types").LibraryItems_v1> | undefined;
     }) => void;
     private onSceneUpdated;
     private updateCurrentCursorPosition;

package/types/components/LibraryMenu.d.ts

@@ -15,4 +15,4 @@ export declare const LibraryMenu: ({ onClose, onInsertShape, pendingElements, on
     library: Library;
     id: string;
     appState: AppState;
-}) => JSX.Element | null;
+}) => JSX.Element;

package/types/components/LoadingMessage.d.ts

@@ -1,2 +1,4 @@
 /// <reference types="react" />
-export declare const LoadingMessage: () => JSX.Element;
+export declare const LoadingMessage: React.FC<{
+    delay?: number;
+}>;

package/types/data/blob.d.ts

@@ -1,8 +1,7 @@
 import { ALLOWED_IMAGE_MIME_TYPES, MIME_TYPES } from "../constants";
 import { ExcalidrawElement, FileId } from "../element/types";
-import { AppState, DataURL } from "../types";
+import { AppState, DataURL, LibraryItem } from "../types";
 import { FileSystemHandle } from "./filesystem";
-import { ImportedLibraryData } from "./types";
 export declare const getMimeType: (blob: Blob | string) => string;
 export declare const getFileHandleType: (handle: FileSystemHandle | null) => string | null;
 export declare const isImageFileHandleType: (type: string | null) => type is "svg" | "png";
@@ -11,7 +10,7 @@ export declare const isSupportedImageFile: (blob: Blob | null | undefined) => bl
     type: typeof ALLOWED_IMAGE_MIME_TYPES[number];
 };
 export declare const loadFromBlob: (blob: Blob, localAppState: AppState | null, localElements: readonly ExcalidrawElement[] | null) => Promise<import("./restore").RestoredDataState>;
-export declare const loadLibraryFromBlob: (blob: Blob) => Promise<ImportedLibraryData>;
+export declare const loadLibraryFromBlob: (blob: Blob, defaultStatus?: LibraryItem["status"]) => Promise<LibraryItem[]>;
 export declare const canvasToBlob: (canvas: HTMLCanvasElement) => Promise<Blob>;
 /** generates SHA-1 digest from supplied file (if not supported, falls back
     to a 40-char base64 random id) */

package/types/data/index.d.ts

@@ -4,7 +4,7 @@ import { AppState, BinaryFiles } from "../types";
 import { FileSystemHandle } from "./filesystem";
 export { loadFromBlob } from "./blob";
 export { loadFromJSON, saveAsJSON } from "./json";
-export declare const exportCanvas: (type: ExportType, elements: readonly NonDeletedExcalidrawElement[], appState: AppState, files: BinaryFiles, { exportBackground, exportPadding, viewBackgroundColor, name, fileHandle, }: {
+export declare const exportCanvas: (type: Omit<ExportType, "backend">, elements: readonly NonDeletedExcalidrawElement[], appState: AppState, files: BinaryFiles, { exportBackground, exportPadding, viewBackgroundColor, name, fileHandle, }: {
     exportBackground: boolean;
     exportPadding?: number | undefined;
     viewBackgroundColor: string;

package/types/data/json.d.ts

@@ -1,6 +1,6 @@
 import { ExcalidrawElement } from "../element/types";
 import { AppState, BinaryFiles, LibraryItems } from "../types";
-import { ImportedDataState } from "./types";
+import { ImportedDataState, ImportedLibraryData } from "./types";
 import Library from "./library";
 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) => Promise<{
@@ -12,6 +12,7 @@ export declare const isValidExcalidrawData: (data?: {
     elements?: any;
     appState?: any;
 } | undefined) => data is ImportedDataState;
-export declare const isValidLibrary: (json: any) => any;
+export declare const isValidLibrary: (json: any) => json is ImportedLibraryData;
+export declare const serializeLibraryAsJSON: (libraryItems: LibraryItems) => string;
 export declare const saveLibraryAsJSON: (libraryItems: LibraryItems) => Promise<void>;
 export declare const importLibraryFromJSON: (library: Library) => Promise<void>;

package/types/data/library.d.ts

@@ -1,14 +1,97 @@
 import { LibraryItems, LibraryItem } from "../types";
 import type App from "../components/App";
+import { ImportedDataState } from "./types";
+export declare const libraryItemsAtom: import("jotai").Atom<{
+    status: "loading";
+    libraryItems: null;
+    promise: Promise<LibraryItems>;
+} | {
+    status: "loaded";
+    libraryItems: LibraryItems;
+}> & {
+    write: (get: {
+        <Value>(atom: import("jotai").Atom<Value | Promise<Value>>): Value;
+        <Value_1>(atom: import("jotai").Atom<Promise<Value_1>>): Value_1;
+        <Value_2>(atom: import("jotai").Atom<Value_2>): Value_2 extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? any : V : V : V : V : V : V : V : V : V : V : Value_2;
+    } & {
+        <Value_3>(atom: import("jotai").Atom<Value_3 | Promise<Value_3>>, options: {
+            unstable_promise: true;
+        }): Value_3 | Promise<Value_3>;
+        <Value_4>(atom: import("jotai").Atom<Promise<Value_4>>, options: {
+            unstable_promise: true;
+        }): Value_4 | Promise<Value_4>;
+        <Value_5>(atom: import("jotai").Atom<Value_5>, options: {
+            unstable_promise: true;
+        }): (Value_5 extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? any : V : V : V : V : V : V : V : V : V : V : Value_5) | Promise<Value_5 extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? any : V : V : V : V : V : V : V : V : V : V : Value_5>;
+    }, set: {
+        <Value_6, Result extends void | Promise<void>>(atom: import("jotai").WritableAtom<Value_6, undefined, Result>): Result;
+        <Value_7, Update, Result_1 extends void | Promise<void>>(atom: import("jotai").WritableAtom<Value_7, Update, Result_1>, update: Update): Result_1;
+    }, update: {
+        status: "loading";
+        libraryItems: null;
+        promise: Promise<LibraryItems>;
+    } | {
+        status: "loaded";
+        libraryItems: LibraryItems;
+    } | ((prev: {
+        status: "loading";
+        libraryItems: null;
+        promise: Promise<LibraryItems>;
+    } | {
+        status: "loaded";
+        libraryItems: LibraryItems;
+    }) => {
+        status: "loading";
+        libraryItems: null;
+        promise: Promise<LibraryItems>;
+    } | {
+        status: "loaded";
+        libraryItems: LibraryItems;
+    })) => void;
+    onMount?: (<S extends (update: {
+        status: "loading";
+        libraryItems: null;
+        promise: Promise<LibraryItems>;
+    } | {
+        status: "loaded";
+        libraryItems: LibraryItems;
+    } | ((prev: {
+        status: "loading";
+        libraryItems: null;
+        promise: Promise<LibraryItems>;
+    } | {
+        status: "loaded";
+        libraryItems: LibraryItems;
+    }) => {
+        status: "loading";
+        libraryItems: null;
+        promise: Promise<LibraryItems>;
+    } | {
+        status: "loaded";
+        libraryItems: LibraryItems;
+    })) => void>(setAtom: S) => void | (() => void)) | undefined;
+} & {
+    init: {
+        status: "loading";
+        libraryItems: null;
+        promise: Promise<LibraryItems>;
+    } | {
+        status: "loaded";
+        libraryItems: LibraryItems;
+    };
+};
 declare class Library {
-    private libraryCache;
+    /** cache for currently active promise when initializing/updating libaries
+     asynchronously */
+    private libraryItemsPromise;
+    /** last resolved libraryItems */
+    private lastLibraryItems;
     private app;
     constructor(app: App);
     resetLibrary: () => Promise<void>;
-    restoreLibraryItem: (libraryItem: LibraryItem) => LibraryItem | null;
     /** imports library (currently merges, removing duplicates) */
-    importLibrary(blob: Blob, defaultStatus?: string): Promise<void>;
+    importLibrary(library: Blob | Required<ImportedDataState>["libraryItems"] | Promise<Required<ImportedDataState>["libraryItems"]>, defaultStatus?: LibraryItem["status"]): Promise<void>;
     loadLibrary: () => Promise<LibraryItems>;
-    saveLibrary: (items: LibraryItems) => Promise<void>;
+    saveLibrary: (items: LibraryItems | Promise<LibraryItems>) => Promise<void>;
 }
 export default Library;

package/types/data/restore.d.ts

@@ -10,6 +10,6 @@ export declare type RestoredDataState = {
 };
 export declare const restoreElements: (elements: ImportedDataState["elements"], localElements: readonly ExcalidrawElement[] | null | undefined) => ExcalidrawElement[];
 export declare const restoreAppState: (appState: ImportedDataState["appState"], localAppState: Partial<AppState> | null | undefined) => RestoredAppState;
-export declare const restore: (data: ImportedDataState | null, localAppState: Partial<AppState> | null | undefined, localElements: readonly ExcalidrawElement[] | null | undefined) => RestoredDataState;
-export declare const restoreLibraryItems: (libraryItems: NonOptional<ImportedDataState["libraryItems"]>, defaultStatus: LibraryItem["status"]) => LibraryItem[];
+export declare const restore: (data: Pick<ImportedDataState, "appState" | "elements" | "files"> | null, localAppState: Partial<AppState> | null | undefined, localElements: readonly ExcalidrawElement[] | null | undefined) => RestoredDataState;
+export declare const restoreLibraryItems: (libraryItems: ImportedDataState["libraryItems"], defaultStatus: LibraryItem["status"]) => LibraryItem[];
 export {};

package/types/element/typeChecks.d.ts

@@ -8,10 +8,10 @@ export declare const isFreeDrawElement: (element?: ExcalidrawElement | null | un
 export declare const isFreeDrawElementType: (elementType: ExcalidrawElement["type"]) => boolean;
 export declare const isLinearElement: (element?: ExcalidrawElement | null | undefined) => element is ExcalidrawLinearElement;
 export declare const isLinearElementType: (elementType: AppState["activeTool"]["type"]) => boolean;
-export declare const isBindingElement: (element?: ExcalidrawElement | null | undefined) => element is ExcalidrawLinearElement;
+export declare const isBindingElement: (element?: ExcalidrawElement | null | undefined, includeLocked?: boolean) => element is ExcalidrawLinearElement;
 export declare const isBindingElementType: (elementType: AppState["activeTool"]["type"]) => boolean;
-export declare const isBindableElement: (element: ExcalidrawElement | null) => element is ExcalidrawBindableElement;
-export declare const isTextBindableContainer: (element: ExcalidrawElement | null) => element is ExcalidrawTextContainer;
+export declare const isBindableElement: (element: ExcalidrawElement | null, includeLocked?: boolean) => element is ExcalidrawBindableElement;
+export declare const isTextBindableContainer: (element: ExcalidrawElement | null, includeLocked?: boolean) => element is ExcalidrawTextContainer;
 export declare const isExcalidrawElement: (element: any) => boolean;
 export declare const hasBoundTextElement: (element: ExcalidrawElement | null) => element is ExcalidrawBindableElement;
 export declare const isBoundToContainer: (element: ExcalidrawElement | null) => element is ExcalidrawTextElementWithContainer;

package/types/element/types.d.ts

@@ -52,6 +52,7 @@ declare type _ExcalidrawElementBase = Readonly<{
     /** epoch (ms) timestamp of last element update */
     updated: number;
     link: string | null;
+    locked: boolean;
 }>;
 export declare type ExcalidrawSelectionElement = _ExcalidrawElementBase & {
     type: "selection";

package/types/jotai.d.ts

@@ -0,0 +1,120 @@
+export declare const jotaiScope: unique symbol;
+export declare const jotaiStore: {
+    get: <Value>(atom: import("jotai").Atom<Value>) => (Value extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? any : V : V : V : V : V : V : V : V : V : V : Value) | undefined;
+    asyncGet: <Value_1>(atom: import("jotai").Atom<Value_1>) => Promise<Value_1 extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? V extends Promise<infer V> ? any : V : V : V : V : V : V : V : V : V : V : Value_1>;
+    set: <Value_2, Update, Result extends void | Promise<void>>(atom: import("jotai").WritableAtom<Value_2, Update, Result>, update: Update) => Result;
+    sub: (atom: {
+        toString: () => string;
+        debugLabel?: string | undefined;
+        read: (get: {
+            <Value_3>(atom: import("jotai").Atom<Value_3 | Promise<Value_3>>): Value_3;
+            <Value_4>(atom: import("jotai").Atom<Promise<Value_4>>): Value_4;
+            <Value_5>(atom: import("jotai").Atom<Value_5>): Value_5 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? any : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : Value_5;
+        }) => unknown;
+    }, callback: () => void) => () => void;
+    SECRET_INTERNAL_store: {
+        r: <Value_6>(readingAtom: import("jotai").Atom<Value_6>, version?: import("jotai/core/store").VersionObject | undefined) => import("jotai/core/store").AtomState<Value_6>;
+        w: <Value_1_1, Update_1, Result_1 extends void | Promise<void>>(writingAtom: import("jotai").WritableAtom<Value_1_1, Update_1, Result_1>, update: Update_1, version?: import("jotai/core/store").VersionObject | undefined) => Result_1;
+        c: (_atom: {
+            toString: () => string;
+            debugLabel?: string | undefined;
+            read: (get: {
+                <Value_3>(atom: import("jotai").Atom<Value_3 | Promise<Value_3>>): Value_3;
+                <Value_4>(atom: import("jotai").Atom<Promise<Value_4>>): Value_4;
+                <Value_5>(atom: import("jotai").Atom<Value_5>): Value_5 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? any : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : Value_5;
+            }) => unknown;
+        } | null, version?: import("jotai/core/store").VersionObject | undefined) => void;
+        s: (atom: {
+            toString: () => string;
+            debugLabel?: string | undefined;
+            read: (get: {
+                <Value_3>(atom: import("jotai").Atom<Value_3 | Promise<Value_3>>): Value_3;
+                <Value_4>(atom: import("jotai").Atom<Promise<Value_4>>): Value_4;
+                <Value_5>(atom: import("jotai").Atom<Value_5>): Value_5 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? any : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : Value_5;
+            }) => unknown;
+        }, callback: (version?: import("jotai/core/store").VersionObject | undefined) => void) => () => void;
+        h: (values: Iterable<readonly [{
+            toString: () => string;
+            debugLabel?: string | undefined;
+            read: (get: {
+                <Value_3>(atom: import("jotai").Atom<Value_3 | Promise<Value_3>>): Value_3;
+                <Value_4>(atom: import("jotai").Atom<Promise<Value_4>>): Value_4;
+                <Value_5>(atom: import("jotai").Atom<Value_5>): Value_5 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? any : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : Value_5;
+            }) => unknown;
+        }, unknown]>, version?: import("jotai/core/store").VersionObject | undefined) => void;
+        n: (l: () => void) => () => void;
+        l: () => IterableIterator<{
+            toString: () => string;
+            debugLabel?: string | undefined;
+            read: (get: {
+                <Value_3>(atom: import("jotai").Atom<Value_3 | Promise<Value_3>>): Value_3;
+                <Value_4>(atom: import("jotai").Atom<Promise<Value_4>>): Value_4;
+                <Value_5>(atom: import("jotai").Atom<Value_5>): Value_5 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? any : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : Value_5;
+            }) => unknown;
+        }>;
+        a: (a: {
+            toString: () => string;
+            debugLabel?: string | undefined;
+            read: (get: {
+                <Value_3>(atom: import("jotai").Atom<Value_3 | Promise<Value_3>>): Value_3;
+                <Value_4>(atom: import("jotai").Atom<Promise<Value_4>>): Value_4;
+                <Value_5>(atom: import("jotai").Atom<Value_5>): Value_5 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? any : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : Value_5;
+            }) => unknown;
+        }) => import("jotai/core/store").AtomState<unknown> | undefined;
+        m: (a: {
+            toString: () => string;
+            debugLabel?: string | undefined;
+            read: (get: {
+                <Value_3>(atom: import("jotai").Atom<Value_3 | Promise<Value_3>>): Value_3;
+                <Value_4>(atom: import("jotai").Atom<Promise<Value_4>>): Value_4;
+                <Value_5>(atom: import("jotai").Atom<Value_5>): Value_5 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? any : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : Value_5;
+            }) => unknown;
+        }) => {
+            l: Set<(version?: import("jotai/core/store").VersionObject | undefined) => void>;
+            t: Set<{
+                toString: () => string;
+                debugLabel?: string | undefined;
+                read: (get: {
+                    <Value_3>(atom: import("jotai").Atom<Value_3 | Promise<Value_3>>): Value_3;
+                    <Value_4>(atom: import("jotai").Atom<Promise<Value_4>>): Value_4;
+                    <Value_5>(atom: import("jotai").Atom<Value_5>): Value_5 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? any : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : Value_5;
+                }) => unknown;
+            }>;
+            u?: (() => void) | undefined;
+        } | undefined;
+    } | {
+        r: <Value_7>(readingAtom: import("jotai").Atom<Value_7>, version?: import("jotai/core/store").VersionObject | undefined) => import("jotai/core/store").AtomState<Value_7>;
+        w: <Value_1_2, Update_2, Result_2 extends void | Promise<void>>(writingAtom: import("jotai").WritableAtom<Value_1_2, Update_2, Result_2>, update: Update_2, version?: import("jotai/core/store").VersionObject | undefined) => Result_2;
+        c: (_atom: {
+            toString: () => string;
+            debugLabel?: string | undefined;
+            read: (get: {
+                <Value_3>(atom: import("jotai").Atom<Value_3 | Promise<Value_3>>): Value_3;
+                <Value_4>(atom: import("jotai").Atom<Promise<Value_4>>): Value_4;
+                <Value_5>(atom: import("jotai").Atom<Value_5>): Value_5 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? any : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : Value_5;
+            }) => unknown;
+        } | null, version?: import("jotai/core/store").VersionObject | undefined) => void;
+        s: (atom: {
+            toString: () => string;
+            debugLabel?: string | undefined;
+            read: (get: {
+                <Value_3>(atom: import("jotai").Atom<Value_3 | Promise<Value_3>>): Value_3;
+                <Value_4>(atom: import("jotai").Atom<Promise<Value_4>>): Value_4;
+                <Value_5>(atom: import("jotai").Atom<Value_5>): Value_5 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? any : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : Value_5;
+            }) => unknown;
+        }, callback: (version?: import("jotai/core/store").VersionObject | undefined) => void) => () => void;
+        h: (values: Iterable<readonly [{
+            toString: () => string;
+            debugLabel?: string | undefined;
+            read: (get: {
+                <Value_3>(atom: import("jotai").Atom<Value_3 | Promise<Value_3>>): Value_3;
+                <Value_4>(atom: import("jotai").Atom<Promise<Value_4>>): Value_4;
+                <Value_5>(atom: import("jotai").Atom<Value_5>): Value_5 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? V_1 extends Promise<infer V_1> ? any : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : V_1 : Value_5;
+            }) => unknown;
+        }, unknown]>, version?: import("jotai/core/store").VersionObject | undefined) => void;
+        n?: undefined;
+        l?: undefined;
+        a?: undefined;
+        m?: undefined;
+    };
+};

package/types/packages/excalidraw/dist/excalidraw.production.min.d.ts

@@ -1,3 +1,3 @@
 declare const _exports: any;
 export = _exports;
-export var Excalidraw: any;
+export var ExcalidrawLib: any;

package/types/packages/excalidraw/entry.d.ts

@@ -1,3 +1,3 @@
-export default Excalidraw;
+export { Excalidraw };
 export * from "./index";
 import Excalidraw from "./index";

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

@@ -8,11 +8,12 @@ declare const _default: React.MemoExoticComponent<React.ForwardRefExoticComponen
 export default _default;
 export { getSceneVersion, isInvisiblySmallElement, getNonDeletedElements, } from "../../element";
 export { defaultLang, languages } from "../../i18n";
-export { restore, restoreElements, restoreAppState } from "../../data/restore";
-export { exportToBlob, exportToCanvas, exportToSvg, serializeAsJSON, loadLibraryFromBlob, loadFromBlob, getFreeDrawSvgPath, } from "../../packages/utils";
+export { restore, restoreAppState, restoreElements, restoreLibraryItems, } from "../../data/restore";
+export { exportToBlob, exportToCanvas, exportToSvg, serializeAsJSON, serializeLibraryAsJSON, loadLibraryFromBlob, loadFromBlob, getFreeDrawSvgPath, } from "../../packages/utils";
 export { isLinearElement } from "../../element/typeChecks";
 export { mutateElement, newElementWith, bumpVersion, } from "../../element/mutateElement";
 export { FONT_FAMILY, THEME } from "../../constants";
 export { exportToClipboard } from "../utils";
 export { getDefaultAppState } from "../../appState";
 export { cleanAppStateForExport, clearAppStateForLocalStorage, } from "../../appState";
+export { jotaiScope, jotaiStore } from "../../jotai";

package/types/packages/utils.d.ts

@@ -19,10 +19,10 @@ export declare const exportToBlob: (opts: ExportOpts & {
 export declare const exportToSvg: ({ elements, appState, files, exportPadding, }: Omit<ExportOpts, "getDimensions"> & {
     exportPadding?: number | undefined;
 }) => Promise<SVGSVGElement>;
+export { serializeAsJSON, serializeLibraryAsJSON } from "../data/json";
 export declare const exportToClipboard: (opts: ExportOpts & {
     mimeType?: string;
     quality?: number;
 }) => Promise<void>;
-export { serializeAsJSON } from "../data/json";
 export { loadFromBlob, loadLibraryFromBlob } from "../data/blob";
 export { getFreeDrawSvgPath } from "../renderer/renderElement";

package/types/types.d.ts

@@ -173,15 +173,16 @@ export declare type ExcalidrawAPIRefValue = ExcalidrawImperativeAPI | {
     readyPromise?: ResolvablePromise<ExcalidrawImperativeAPI>;
     ready?: false;
 };
-declare type InitialData = ImportedDataState & {
+export declare type ExcalidrawInitialDataState = Merge<ImportedDataState, {
     scrollX?: number;
     scrollY?: number;
-};
+    libraryItems?: Required<ImportedDataState>["libraryItems"] | Promise<Required<ImportedDataState>["libraryItems"]>;
+}>;
 export interface ExcalidrawProps {
     id?: string | null;
     onChange?: (elements: readonly ExcalidrawElement[], appState: AppState, files: BinaryFiles, id?: string | null) => void;
+    initialData?: ExcalidrawInitialDataState | null | Promise<ExcalidrawInitialDataState | null>;
     onHomeButtonClick?: () => void;
-    initialData?: InitialData | null | Promise<InitialData | null>;
     user?: {
         name?: string | null;
     };
@@ -352,4 +353,3 @@ export declare type DeviceType = {
     isMobile: boolean;
     isTouchScreen: boolean;
 };
-export {};

package/types/utils.d.ts

@@ -120,3 +120,4 @@ export declare const wrapEvent: <T extends Event>(name: EVENT, nativeEvent: T) =
 export declare const updateObject: <T extends Record<string, any>>(obj: T, updates: Partial<T>) => T;
 export declare const isPrimitive: (val: any) => boolean;
 export declare const getFrame: () => "top" | "iframe";
+export declare const isPromiseLike: (value: any) => value is Promise<any>;

package/dist/excalidraw-assets/image-2be1c869cd5bacebdc3c.js

@@ -1 +0,0 @@
-"use strict";(self.webpackChunkExcalidraw=self.webpackChunkExcalidraw||[]).push([[9],{673:(e,t,r)=>{r.r(t),r.d(t,{decodePngMetadata:()=>h,decodeSvgMetadata:()=>E,encodePngMetadata:()=>x,encodeSvgMetadata:()=>A,getTEXtChunk:()=>p});var n=r(2983),a=r.n(n),o=r(1194),c=r(3434),d=r.n(c),i=r(2744),s=r(8288);const w=e=>new Promise(((t,r)=>{const n="string"==typeof e?new Blob([(new TextEncoder).encode(e)]):new Blob([e instanceof Uint8Array?e:new Uint8Array(e)]),a=new FileReader;a.onload=e=>{if(!e.target||"string"!=typeof e.target.result)return r(new Error("couldn't convert to byte string"));t(e.target.result)},a.readAsBinaryString(n)})),l=e=>{const t=new ArrayBuffer(e.length),r=new Uint8Array(t);for(let t=0,n=e.length;t<n;t++)r[t]=e.charCodeAt(t);return t},y=e=>new TextDecoder("utf-8").decode(l(e)),u=async e=>{let t,{text:r,compress:n}=e;if(!1!==n)try{t=await w((0,i.deflate)(r))}catch(e){console.error("encode: cannot deflate",e)}return{version:"1",encoding:"bstring",compressed:!!t,encoded:t||await w(r)}},f=async e=>{let t;if("bstring"!==e.encoding)throw new Error('decode: unknown encoding "'.concat(e.encoding,'"'));return t=e.compressed?e.encoded:await y(e.encoded),e.compressed?(0,i.inflate)(new Uint8Array(l(t)),{to:"string"}):t};const g=e=>"arrayBuffer"in e?e.arrayBuffer():new Promise(((t,r)=>{const n=new FileReader;n.onload=e=>{var n;if(null===(n=e.target)||void 0===n||!n.result)return r(new Error("couldn't convert blob to ArrayBuffer"));t(e.target.result)},n.readAsArrayBuffer(e)})),p=async e=>{const t=a()(new Uint8Array(await g(e))).find((e=>"tEXt"===e.name));return t?o.decode(t.data):null},x=async e=>{let{blob:t,metadata:r}=e;const n=a()(new Uint8Array(await g(t))),c=o.encode(s.LO.excalidraw,JSON.stringify(await u({text:r,compress:!0})));return n.splice(-1,0,c),new Blob([d()(n)],{type:s.LO.png})},h=async e=>{const t=await p(e);if((null==t?void 0:t.keyword)===s.LO.excalidraw)try{const e=JSON.parse(t.text);if(!("encoded"in e)){if("type"in e&&e.type===s.r8.excalidraw)return t.text;throw new Error("FAILED")}return await f(e)}catch(e){throw console.error(e),new Error("FAILED")}throw new Error("INVALID")},A=async e=>{let{text:t}=e;const r=await async function(e){return arguments.length>1&&void 0!==arguments[1]&&arguments[1]?window.btoa(e):window.btoa(await w(e))}(JSON.stringify(await u({text:t})),!0);let n="";return n+="\x3c!-- payload-type:".concat(s.LO.excalidraw," --\x3e"),n+="\x3c!-- payload-version:2 --\x3e",n+="\x3c!-- payload-start --\x3e",n+=r,n+="\x3c!-- payload-end --\x3e",n},E=async e=>{let{svg:t}=e;if(t.includes("payload-type:".concat(s.LO.excalidraw))){const e=t.match(/<!-- payload-start -->(.+?)<!-- payload-end -->/);if(!e)throw new Error("INVALID");const r=t.match(/<!-- payload-version:(\d+) -->/),n="1"!==((null==r?void 0:r[1])||"1");try{const t=await async function(e){return arguments.length>1&&void 0!==arguments[1]&&arguments[1]?window.atob(e):y(window.atob(e))}(e[1],n),r=JSON.parse(t);if(!("encoded"in r)){if("type"in r&&r.type===s.r8.excalidraw)return t;throw new Error("FAILED")}return await f(r)}catch(e){throw console.error(e),new Error("FAILED")}}throw new Error("INVALID")}}}]);