@dwelle/excalidraw 0.3.56 → 0.3.59-restoreLibraryItems

package/types/actions/actionToggleGridMode.d.ts

@@ -2,6 +2,10 @@
 import { AppState } from "../types";
 export declare const actionToggleGridMode: {
     name: "gridMode";
+    trackEvent: {
+        category: "canvas";
+        predicate: (appState: Readonly<AppState>) => boolean;
+    };
     perform(elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<AppState>): {
         appState: {
             gridSize: number | null;
@@ -18,8 +22,9 @@ export declare const actionToggleGridMode: {
             editingLinearElement: import("../element/linearElementEditor").LinearElementEditor | null;
             activeTool: {
                 type: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | "eraser";
+                lastActiveToolBeforeEraser: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | null;
+                locked: boolean;
             };
-            elementLocked: boolean;
             penMode: boolean;
             penDetected: boolean;
             exportBackground: boolean;

package/types/actions/actionToggleStats.d.ts

@@ -1,6 +1,9 @@
 /// <reference types="react" />
 export declare const actionToggleStats: {
     name: "stats";
+    trackEvent: {
+        category: "menu";
+    };
     perform(elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<import("../types").AppState>): {
         appState: {
             showStats: boolean;
@@ -17,8 +20,9 @@ export declare const actionToggleStats: {
             editingLinearElement: import("../element/linearElementEditor").LinearElementEditor | null;
             activeTool: {
                 type: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | "eraser";
+                lastActiveToolBeforeEraser: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | null;
+                locked: boolean;
             };
-            elementLocked: boolean;
             penMode: boolean;
             penDetected: boolean;
             exportBackground: boolean;

package/types/actions/actionToggleViewMode.d.ts

@@ -1,6 +1,10 @@
 /// <reference types="react" />
 export declare const actionToggleViewMode: {
     name: "viewMode";
+    trackEvent: {
+        category: "canvas";
+        predicate: (appState: Readonly<import("../types").AppState>) => boolean;
+    };
     perform(elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<import("../types").AppState>): {
         appState: {
             viewModeEnabled: boolean;
@@ -17,8 +21,9 @@ export declare const actionToggleViewMode: {
             editingLinearElement: import("../element/linearElementEditor").LinearElementEditor | null;
             activeTool: {
                 type: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | "eraser";
+                lastActiveToolBeforeEraser: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | null;
+                locked: boolean;
             };
-            elementLocked: boolean;
             penMode: boolean;
             penDetected: boolean;
             exportBackground: boolean;

package/types/actions/actionToggleZenMode.d.ts

@@ -1,6 +1,10 @@
 /// <reference types="react" />
 export declare const actionToggleZenMode: {
     name: "zenMode";
+    trackEvent: {
+        category: "canvas";
+        predicate: (appState: Readonly<import("../types").AppState>) => boolean;
+    };
     perform(elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<import("../types").AppState>): {
         appState: {
             zenModeEnabled: boolean;
@@ -17,8 +21,9 @@ export declare const actionToggleZenMode: {
             editingLinearElement: import("../element/linearElementEditor").LinearElementEditor | null;
             activeTool: {
                 type: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | "eraser";
+                lastActiveToolBeforeEraser: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | null;
+                locked: boolean;
             };
-            elementLocked: boolean;
             penMode: boolean;
             penDetected: boolean;
             exportBackground: boolean;

package/types/actions/actionZindex.d.ts

@@ -1,6 +1,9 @@
 import React from "react";
 export declare const actionSendBackward: {
     name: "sendBackward";
+    trackEvent: {
+        category: "element";
+    };
     perform: (elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<import("../types").AppState>) => {
         elements: (import("../element/types").ExcalidrawLinearElement | import("../element/types").ExcalidrawSelectionElement | import("../element/types").ExcalidrawRectangleElement | import("../element/types").ExcalidrawDiamondElement | import("../element/types").ExcalidrawEllipseElement | import("../element/types").ExcalidrawImageElement | import("../element/types").ExcalidrawTextElement | import("../element/types").ExcalidrawFreeDrawElement)[];
         appState: Readonly<import("../types").AppState>;
@@ -15,6 +18,9 @@ export declare const actionSendBackward: {
 };
 export declare const actionBringForward: {
     name: "bringForward";
+    trackEvent: {
+        category: "element";
+    };
     perform: (elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<import("../types").AppState>) => {
         elements: (import("../element/types").ExcalidrawLinearElement | import("../element/types").ExcalidrawSelectionElement | import("../element/types").ExcalidrawRectangleElement | import("../element/types").ExcalidrawDiamondElement | import("../element/types").ExcalidrawEllipseElement | import("../element/types").ExcalidrawImageElement | import("../element/types").ExcalidrawTextElement | import("../element/types").ExcalidrawFreeDrawElement)[];
         appState: Readonly<import("../types").AppState>;
@@ -29,6 +35,9 @@ export declare const actionBringForward: {
 };
 export declare const actionSendToBack: {
     name: "sendToBack";
+    trackEvent: {
+        category: "element";
+    };
     perform: (elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<import("../types").AppState>) => {
         elements: readonly import("../element/types").ExcalidrawElement[];
         appState: Readonly<import("../types").AppState>;
@@ -42,6 +51,9 @@ export declare const actionSendToBack: {
 };
 export declare const actionBringToFront: {
     name: "bringToFront";
+    trackEvent: {
+        category: "element";
+    };
     perform: (elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<import("../types").AppState>) => {
         elements: readonly import("../element/types").ExcalidrawElement[];
         appState: Readonly<import("../types").AppState>;

package/types/actions/manager.d.ts

@@ -1,8 +1,8 @@
 import React from "react";
-import { Action, ActionsManagerInterface, UpdaterFn, ActionName, ActionResult, PanelComponentProps } from "./types";
+import { Action, UpdaterFn, ActionName, ActionResult, PanelComponentProps, ActionSource } from "./types";
 import { ExcalidrawElement } from "../element/types";
 import { AppClassProperties, AppState } from "../types";
-export declare class ActionManager implements ActionsManagerInterface {
+export declare class ActionManager {
     actions: Record<ActionName, Action>;
     updater: (actionResult: ActionResult | Promise<ActionResult>) => void;
     getAppState: () => Readonly<AppState>;
@@ -12,7 +12,7 @@ export declare class ActionManager implements ActionsManagerInterface {
     registerAction(action: Action): void;
     registerAll(actions: readonly Action[]): void;
     handleKeyDown(event: React.KeyboardEvent | KeyboardEvent): boolean;
-    executeAction(action: Action): void;
+    executeAction(action: Action, source?: ActionSource): void;
     /**
      * @param data additional data sent to the PanelComponent
      */

package/types/actions/types.d.ts

@@ -2,6 +2,7 @@ import React from "react";
 import { ExcalidrawElement } from "../element/types";
 import { AppClassProperties, AppState, ExcalidrawProps, BinaryFiles } from "../types";
 import { ToolButtonSize } from "../components/ToolButton";
+export declare type ActionSource = "ui" | "keyboard" | "contextMenu" | "api";
 /** if false, the action should be prevented */
 export declare type ActionResult = {
     elements?: readonly ExcalidrawElement[] | null;
@@ -34,13 +35,10 @@ export interface Action {
     contextItemLabel?: string | ((elements: readonly ExcalidrawElement[], appState: Readonly<AppState>) => string);
     contextItemPredicate?: (elements: readonly ExcalidrawElement[], appState: AppState) => boolean;
     checked?: (appState: Readonly<AppState>) => boolean;
-    trackEvent?: boolean | ((action: Action, type: "ui" | "keyboard" | "api", value: any) => void);
-}
-export interface ActionsManagerInterface {
-    actions: Record<ActionName, Action>;
-    registerAction: (action: Action) => void;
-    handleKeyDown: (event: React.KeyboardEvent | KeyboardEvent) => boolean;
-    renderAction: (name: ActionName) => React.ReactElement | null;
-    executeAction: (action: Action) => void;
+    trackEvent: false | {
+        category: "toolbar" | "element" | "canvas" | "export" | "history" | "menu" | "collab" | "hyperlink";
+        action?: string;
+        predicate?: (appState: Readonly<AppState>, elements: readonly ExcalidrawElement[], value: any) => boolean;
+    };
 }
 export {};

package/types/appState.d.ts

@@ -3,6 +3,8 @@ export declare const getDefaultAppState: () => Omit<AppState, "offsetTop" | "off
 export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>) => {
     activeTool?: {
         type: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | "eraser";
+        lastActiveToolBeforeEraser: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | null;
+        locked: boolean;
     } | undefined;
     scrollX?: number | undefined;
     scrollY?: number | undefined;
@@ -13,7 +15,6 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     shouldCacheIgnoreZoom?: boolean | undefined;
     theme?: string | undefined;
     name?: string | undefined;
-    elementLocked?: boolean | undefined;
     penMode?: boolean | undefined;
     penDetected?: boolean | undefined;
     exportBackground?: boolean | undefined;

package/types/components/App.d.ts

@@ -74,7 +74,7 @@ declare class App extends React.Component<AppProps, AppState> {
     private addTextFromPaste;
     setAppState: (obj: any) => void;
     removePointer: (event: React.PointerEvent<HTMLElement> | PointerEvent) => void;
-    toggleLock: () => void;
+    toggleLock: (source?: "keyboard" | "ui") => void;
     togglePenMode: () => void;
     toggleZenMode: () => void;
     toggleStats: () => void;

package/types/components/ImageExportDialog.d.ts

@@ -1,8 +1,8 @@
 /// <reference types="react" />
-import { ActionsManagerInterface } from "../actions/types";
 import { NonDeletedExcalidrawElement } from "../element/types";
 import { AppState, BinaryFiles } from "../types";
 import "./ExportDialog.scss";
+import { ActionManager } from "../actions/manager";
 export declare const ErrorCanvasPreview: () => JSX.Element;
 export declare type ExportCB = (elements: readonly NonDeletedExcalidrawElement[], scale?: number) => void;
 export declare const ImageExportDialog: ({ elements, appState, files, exportPadding, actionManager, onExportToPng, onExportToSvg, onExportToClipboard, }: {
@@ -10,7 +10,7 @@ export declare const ImageExportDialog: ({ elements, appState, files, exportPadd
     elements: readonly NonDeletedExcalidrawElement[];
     files: BinaryFiles;
     exportPadding?: number | undefined;
-    actionManager: ActionsManagerInterface;
+    actionManager: ActionManager;
     onExportToPng: ExportCB;
     onExportToSvg: ExportCB;
     onExportToClipboard: ExportCB;

package/types/components/JSONExportDialog.d.ts

@@ -1,14 +1,14 @@
 /// <reference types="react" />
-import { ActionsManagerInterface } from "../actions/types";
 import { NonDeletedExcalidrawElement } from "../element/types";
 import { AppState, CanvasActions, BinaryFiles } from "../types";
 import "./ExportDialog.scss";
+import { ActionManager } from "../actions/manager";
 export declare type ExportCB = (elements: readonly NonDeletedExcalidrawElement[], scale?: number) => void;
 export declare const JSONExportDialog: ({ elements, appState, files, actionManager, exportOpts, canvas, }: {
     elements: readonly NonDeletedExcalidrawElement[];
     appState: AppState;
     files: BinaryFiles;
-    actionManager: ActionsManagerInterface;
+    actionManager: ActionManager;
     exportOpts: CanvasActions["export"];
     canvas: HTMLCanvasElement | null;
 }) => JSX.Element;

package/types/data/library.d.ts

@@ -5,9 +5,8 @@ declare class Library {
     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(blob: Blob, defaultStatus?: LibraryItem["status"]): Promise<void>;
     loadLibrary: () => Promise<LibraryItems>;
     saveLibrary: (items: LibraryItems) => Promise<void>;
 }

package/types/element/Hyperlink.d.ts

@@ -32,8 +32,9 @@ export declare const actionLink: {
             editingLinearElement: import("./linearElementEditor").LinearElementEditor | null;
             activeTool: {
                 type: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | "eraser";
+                lastActiveToolBeforeEraser: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | null;
+                locked: boolean;
             };
-            elementLocked: boolean;
             penMode: boolean;
             penDetected: boolean;
             exportBackground: boolean;
@@ -104,7 +105,10 @@ export declare const actionLink: {
         };
         commitToHistory: true;
     };
-    trackEvent: (action: import("../actions/types").Action, source: "ui" | "keyboard" | "api") => void;
+    trackEvent: {
+        category: "hyperlink";
+        action: string;
+    };
     keyTest: (event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean;
     contextItemLabel: (elements: readonly import("./types").ExcalidrawElement[], appState: Readonly<AppState>) => "labels.link.edit" | "labels.link.create";
     contextItemPredicate: (elements: readonly import("./types").ExcalidrawElement[], appState: AppState) => boolean;

package/types/element/linearElementEditor.d.ts

@@ -98,8 +98,9 @@ export declare class LinearElementEditor {
             editingElement: import("./types").NonDeletedExcalidrawElement | null;
             activeTool: {
                 type: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | "eraser";
+                lastActiveToolBeforeEraser: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | null;
+                locked: boolean;
             };
-            elementLocked: boolean;
             penMode: boolean;
             penDetected: boolean;
             exportBackground: boolean;

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

@@ -8,7 +8,7 @@ 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 { restore, restoreAppState, restoreElements, restoreLibraryItems, } from "../../data/restore";
 export { exportToBlob, exportToCanvas, exportToSvg, serializeAsJSON, loadLibraryFromBlob, loadFromBlob, getFreeDrawSvgPath, } from "../../packages/utils";
 export { isLinearElement } from "../../element/typeChecks";
 export { mutateElement, newElementWith, bumpVersion, } from "../../element/mutateElement";

package/types/scene/Scene.d.ts

@@ -15,7 +15,7 @@ declare class Scene {
     private elementsMap;
     getElementsIncludingDeleted(): readonly ExcalidrawElement[];
     getElements(): readonly NonDeletedExcalidrawElement[];
-    getElement(id: ExcalidrawElement["id"]): ExcalidrawElement | null;
+    getElement<T extends ExcalidrawElement>(id: T["id"]): T | null;
     getNonDeletedElement(id: ExcalidrawElement["id"]): NonDeleted<ExcalidrawElement> | null;
     getNonDeletedElements(ids: readonly ExcalidrawElement["id"][]): NonDeleted<ExcalidrawElement>[];
     replaceAllElements(nextElements: readonly ExcalidrawElement[]): void;

package/types/types.d.ts

@@ -56,8 +56,9 @@ export declare type AppState = {
     editingLinearElement: LinearElementEditor | null;
     activeTool: {
         type: typeof SHAPES[number]["value"] | "eraser";
+        lastActiveToolBeforeEraser: typeof SHAPES[number]["value"] | null;
+        locked: boolean;
     };
-    elementLocked: boolean;
     penMode: boolean;
     penDetected: boolean;
     exportBackground: boolean;
@@ -265,6 +266,7 @@ export declare type AppClassProperties = {
         mimeType: typeof ALLOWED_IMAGE_MIME_TYPES[number];
     }>;
     files: BinaryFiles;
+    deviceType: App["deviceType"];
 };
 export declare type PointerDownState = Readonly<{
     origin: Readonly<{

package/types/utils.d.ts

@@ -118,3 +118,5 @@ export declare const wrapEvent: <T extends Event>(name: EVENT, nativeEvent: T) =
     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";