@excalidraw/excalidraw 0.10.0 → 0.10.1

package/package.json

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

package/types/actions/actionBoundText.d.ts

@@ -0,0 +1,116 @@
+export declare const actionUnbindText: {
+    name: "unbindText";
+    contextItemLabel: string;
+    trackEvent: {
+        category: "element";
+    };
+    contextItemPredicate: (elements: readonly import("../element/types").ExcalidrawElement[], appState: import("../types").AppState) => boolean;
+    perform: (elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<import("../types").AppState>) => {
+        elements: readonly import("../element/types").ExcalidrawElement[];
+        appState: Readonly<import("../types").AppState>;
+        commitToHistory: true;
+    };
+} & {
+    keyTest?: undefined;
+};
+export declare const actionBindText: {
+    name: "bindText";
+    contextItemLabel: string;
+    trackEvent: {
+        category: "element";
+    };
+    contextItemPredicate: (elements: readonly import("../element/types").ExcalidrawElement[], appState: import("../types").AppState) => boolean;
+    perform: (elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<import("../types").AppState>) => {
+        elements: import("../element/types").ExcalidrawElement[];
+        appState: {
+            selectedElementIds: {
+                [x: string]: true;
+            };
+            isLoading: boolean;
+            errorMessage: string | null;
+            draggingElement: import("../element/types").NonDeletedExcalidrawElement | null;
+            resizingElement: import("../element/types").NonDeletedExcalidrawElement | null;
+            multiElement: import("../element/types").NonDeleted<import("../element/types").ExcalidrawLinearElement> | null;
+            selectionElement: import("../element/types").NonDeletedExcalidrawElement | null;
+            isBindingEnabled: boolean;
+            startBoundElement: import("../element/types").NonDeleted<import("../element/types").ExcalidrawBindableElement> | null;
+            suggestedBindings: import("../element/binding").SuggestedBinding[];
+            editingElement: import("../element/types").NonDeletedExcalidrawElement | null;
+            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;
+            };
+            penMode: boolean;
+            penDetected: boolean;
+            exportBackground: boolean;
+            exportEmbedScene: boolean;
+            exportWithDarkMode: boolean;
+            exportScale: number;
+            currentItemStrokeColor: string;
+            currentItemBackgroundColor: string;
+            currentItemFillStyle: import("../element/types").FillStyle;
+            currentItemStrokeWidth: number;
+            currentItemStrokeStyle: import("../element/types").StrokeStyle;
+            currentItemRoughness: number;
+            currentItemOpacity: number;
+            currentItemFontFamily: number;
+            currentItemFontSize: number;
+            currentItemTextAlign: import("../element/types").TextAlign;
+            currentItemStrokeSharpness: import("../element/types").StrokeSharpness;
+            currentItemStartArrowhead: import("../element/types").Arrowhead | null;
+            currentItemEndArrowhead: import("../element/types").Arrowhead | null;
+            currentItemLinearStrokeSharpness: import("../element/types").StrokeSharpness;
+            viewBackgroundColor: string;
+            scrollX: number;
+            scrollY: number;
+            cursorButton: "up" | "down";
+            scrolledOutside: boolean;
+            name: string;
+            isResizing: boolean;
+            isRotating: boolean;
+            zoom: Readonly<{
+                value: import("../types").NormalizedZoomValue;
+            }>;
+            openMenu: "canvas" | "shape" | null;
+            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
+            lastPointerDownWith: import("../element/types").PointerType;
+            previousSelectedElementIds: {
+                [id: string]: boolean;
+            };
+            shouldCacheIgnoreZoom: boolean;
+            showHelpDialog: boolean;
+            toastMessage: string | null;
+            zenModeEnabled: boolean;
+            theme: string;
+            gridSize: number | null;
+            viewModeEnabled: boolean;
+            selectedGroupIds: {
+                [groupId: string]: boolean;
+            };
+            editingGroupId: string | null;
+            width: number;
+            height: number;
+            offsetTop: number;
+            offsetLeft: number;
+            isLibraryOpen: boolean;
+            fileHandle: import("browser-fs-access").FileSystemHandle | null;
+            collaborators: Map<string, import("../types").Collaborator>;
+            showStats: boolean;
+            currentChartType: import("../element/types").ChartType;
+            pasteDialog: {
+                shown: false;
+                data: null;
+            } | {
+                shown: true;
+                data: import("../charts").Spreadsheet;
+            };
+            pendingImageElement: import("../element/types").NonDeleted<import("../element/types").ExcalidrawImageElement> | null;
+            showHyperlinkPopup: false | "info" | "editor";
+        };
+        commitToHistory: true;
+    };
+} & {
+    keyTest?: undefined;
+};

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/actionUnbindText.d.ts

@@ -0,0 +1,11 @@
+export declare const actionUnbindText: {
+    name: "unbindText";
+    contextItemLabel: string;
+    perform: (elements: readonly import("../element/types").ExcalidrawElement[], appState: Readonly<import("../types").AppState>) => {
+        elements: readonly import("../element/types").ExcalidrawElement[];
+        appState: Readonly<import("../types").AppState>;
+        commitToHistory: true;
+    };
+} & {
+    keyTest?: undefined;
+};

package/types/components/ClearCanvas.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="react" />
+declare const ClearCanvas: ({ onConfirm }: {
+    onConfirm: () => void;
+}) => JSX.Element;
+export default ClearCanvas;

package/types/components/ConfirmDialog.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="react" />
+import { DialogProps } from "./Dialog";
+import "./ConfirmDialog.scss";
+interface Props extends Omit<DialogProps, "onCloseRequest"> {
+    onConfirm: () => void;
+    onCancel: () => void;
+    confirmText?: string;
+    cancelText?: string;
+}
+declare const ConfirmDialog: (props: Props) => JSX.Element;
+export default ConfirmDialog;

package/types/components/LibraryMenu.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="react" />
+import Library from "../data/library";
+import { LibraryItem, AppState, BinaryFiles, ExcalidrawProps } from "../types";
+import "./LibraryMenu.scss";
+export declare const LibraryMenu: ({ onClose, onInsertShape, pendingElements, onAddToLibrary, theme, setAppState, files, libraryReturnUrl, focusContainer, library, id, appState, }: {
+    pendingElements: LibraryItem["elements"];
+    onClose: () => void;
+    onInsertShape: (elements: LibraryItem["elements"]) => void;
+    onAddToLibrary: () => void;
+    theme: AppState["theme"];
+    files: BinaryFiles;
+    setAppState: React.Component<any, AppState>["setState"];
+    libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
+    focusContainer: () => void;
+    library: Library;
+    id: string;
+    appState: AppState;
+}) => JSX.Element | null;

package/types/components/LibraryMenuItems.d.ts

@@ -0,0 +1,22 @@
+/// <reference types="react" />
+import Library from "../data/library";
+import { AppState, BinaryFiles, ExcalidrawProps, LibraryItem, LibraryItems } from "../types";
+import "./LibraryMenuItems.scss";
+declare const LibraryMenuItems: ({ libraryItems, onRemoveFromLibrary, onAddToLibrary, onInsertShape, pendingElements, theme, setAppState, libraryReturnUrl, library, files, id, selectedItems, onToggle, onPublish, resetLibrary, }: {
+    libraryItems: LibraryItems;
+    pendingElements: LibraryItem["elements"];
+    onRemoveFromLibrary: () => void;
+    onInsertShape: (elements: LibraryItem["elements"]) => void;
+    onAddToLibrary: (elements: LibraryItem["elements"]) => void;
+    theme: AppState["theme"];
+    files: BinaryFiles;
+    setAppState: React.Component<any, AppState>["setState"];
+    libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
+    library: Library;
+    id: string;
+    selectedItems: LibraryItem["id"][];
+    onToggle: (id: LibraryItem["id"], event: React.MouseEvent) => void;
+    onPublish: () => void;
+    resetLibrary: () => void;
+}) => JSX.Element;
+export default LibraryMenuItems;

package/types/components/PenModeButton.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="react" />
+import "./ToolIcon.scss";
+declare type PenModeIconProps = {
+    title?: string;
+    name?: string;
+    checked: boolean;
+    onChange?(): void;
+    zenModeEnabled?: boolean;
+    isMobile?: boolean;
+    penDetected: boolean;
+};
+export declare const PenModeButton: (props: PenModeIconProps) => JSX.Element | null;
+export {};

package/types/components/PublishLibrary.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="react" />
+import { AppState, LibraryItems } from "../types";
+import "./PublishLibrary.scss";
+declare const PublishLibrary: ({ onClose, libraryItems, appState, onSuccess, onError, updateItemsInStorage, onRemove, }: {
+    onClose: () => void;
+    libraryItems: LibraryItems;
+    appState: AppState;
+    onSuccess: (data: {
+        url: string;
+        authorName: string;
+        items: LibraryItems;
+    }) => void;
+    onError: (error: Error) => void;
+    updateItemsInStorage: (items: LibraryItems) => void;
+    onRemove: (id: string) => void;
+}) => JSX.Element;
+export default PublishLibrary;

package/types/components/SingleLibraryItem.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="react" />
+import { AppState, LibraryItem } from "../types";
+import "./SingleLibraryItem.scss";
+declare const SingleLibraryItem: ({ libItem, appState, index, onChange, onRemove, }: {
+    libItem: LibraryItem;
+    appState: AppState;
+    index: number;
+    onChange: (val: string, index: number) => void;
+    onRemove: (id: string) => void;
+}) => JSX.Element;
+export default SingleLibraryItem;

package/types/components/Spinner.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="react" />
+import "./Spinner.scss";
+declare const Spinner: ({ size, circleWidth, }: {
+    size?: string | number | undefined;
+    circleWidth?: number | undefined;
+}) => JSX.Element;
+export default Spinner;

package/types/data/encryption.d.ts

@@ -0,0 +1,9 @@
+export declare const IV_LENGTH_BYTES = 12;
+export declare const createIV: () => Uint8Array;
+export declare const generateEncryptionKey: <T extends "string" | "cryptoKey" = "string">(returnAs?: T | undefined) => Promise<T extends "cryptoKey" ? CryptoKey : string>;
+export declare const getCryptoKey: (key: string, usage: KeyUsage) => Promise<CryptoKey>;
+export declare const encryptData: (key: string | CryptoKey, data: Uint8Array | ArrayBuffer | Blob | File | string) => Promise<{
+    encryptedBuffer: ArrayBuffer;
+    iv: Uint8Array;
+}>;
+export declare const decryptData: (iv: Uint8Array, encrypted: Uint8Array | ArrayBuffer, privateKey: string) => Promise<ArrayBuffer>;

package/types/element/Hyperlink.d.ts

@@ -0,0 +1,124 @@
+/// <reference types="react" />
+import { AppState, ExcalidrawProps } from "../types";
+import { NonDeletedExcalidrawElement } from "./types";
+import { Bounds } from "./bounds";
+import "./Hyperlink.scss";
+export declare const EXTERNAL_LINK_IMG: HTMLImageElement;
+export declare const Hyperlink: ({ element, appState, setAppState, onLinkOpen, }: {
+    element: NonDeletedExcalidrawElement;
+    appState: AppState;
+    setAppState: React.Component<any, AppState>["setState"];
+    onLinkOpen: ExcalidrawProps["onLinkOpen"];
+}) => JSX.Element | null;
+export declare const normalizeLink: (link: string) => string;
+export declare const isLocalLink: (link: string | null) => boolean;
+export declare const actionLink: {
+    name: "hyperlink";
+    perform: (elements: readonly import("./types").ExcalidrawElement[], appState: Readonly<AppState>) => false | {
+        elements: readonly import("./types").ExcalidrawElement[];
+        appState: {
+            showHyperlinkPopup: "editor";
+            openMenu: null;
+            isLoading: boolean;
+            errorMessage: string | null;
+            draggingElement: NonDeletedExcalidrawElement | null;
+            resizingElement: NonDeletedExcalidrawElement | null;
+            multiElement: import("./types").NonDeleted<import("./types").ExcalidrawLinearElement> | null;
+            selectionElement: NonDeletedExcalidrawElement | null;
+            isBindingEnabled: boolean;
+            startBoundElement: import("./types").NonDeleted<import("./types").ExcalidrawBindableElement> | null;
+            suggestedBindings: import("./binding").SuggestedBinding[];
+            editingElement: NonDeletedExcalidrawElement | null;
+            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;
+            };
+            penMode: boolean;
+            penDetected: boolean;
+            exportBackground: boolean;
+            exportEmbedScene: boolean;
+            exportWithDarkMode: boolean;
+            exportScale: number;
+            currentItemStrokeColor: string;
+            currentItemBackgroundColor: string;
+            currentItemFillStyle: import("./types").FillStyle;
+            currentItemStrokeWidth: number;
+            currentItemStrokeStyle: import("./types").StrokeStyle;
+            currentItemRoughness: number;
+            currentItemOpacity: number;
+            currentItemFontFamily: number;
+            currentItemFontSize: number;
+            currentItemTextAlign: import("./types").TextAlign;
+            currentItemStrokeSharpness: import("./types").StrokeSharpness;
+            currentItemStartArrowhead: import("./types").Arrowhead | null;
+            currentItemEndArrowhead: import("./types").Arrowhead | null;
+            currentItemLinearStrokeSharpness: import("./types").StrokeSharpness;
+            viewBackgroundColor: string;
+            scrollX: number;
+            scrollY: number;
+            cursorButton: "up" | "down";
+            scrolledOutside: boolean;
+            name: string;
+            isResizing: boolean;
+            isRotating: boolean;
+            zoom: Readonly<{
+                value: import("../types").NormalizedZoomValue;
+            }>;
+            openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
+            lastPointerDownWith: import("./types").PointerType;
+            selectedElementIds: {
+                [id: string]: boolean;
+            };
+            previousSelectedElementIds: {
+                [id: string]: boolean;
+            };
+            shouldCacheIgnoreZoom: boolean;
+            showHelpDialog: boolean;
+            toastMessage: string | null;
+            zenModeEnabled: boolean;
+            theme: string;
+            gridSize: number | null;
+            viewModeEnabled: boolean;
+            selectedGroupIds: {
+                [groupId: string]: boolean;
+            };
+            editingGroupId: string | null;
+            width: number;
+            height: number;
+            offsetTop: number;
+            offsetLeft: number;
+            isLibraryOpen: boolean;
+            fileHandle: import("browser-fs-access").FileSystemHandle | null;
+            collaborators: Map<string, import("../types").Collaborator>;
+            showStats: boolean;
+            currentChartType: import("./types").ChartType;
+            pasteDialog: {
+                shown: false;
+                data: null;
+            } | {
+                shown: true;
+                data: import("../charts").Spreadsheet;
+            };
+            pendingImageElement: import("./types").NonDeleted<import("./types").ExcalidrawImageElement> | null;
+        };
+        commitToHistory: true;
+    };
+    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;
+    PanelComponent: ({ elements, appState, updateData }: import("react").PropsWithChildren<import("../actions/types").PanelComponentProps>) => JSX.Element;
+} & {
+    keyTest?: ((event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean) | undefined;
+};
+export declare const getContextMenuLabel: (elements: readonly NonDeletedExcalidrawElement[], appState: AppState) => "labels.link.edit" | "labels.link.create";
+export declare const getLinkHandleFromCoords: ([x1, y1, x2, y2]: Bounds, angle: number, appState: AppState) => [x: number, y: number, width: number, height: number];
+export declare const isPointHittingLinkIcon: (element: NonDeletedExcalidrawElement, appState: AppState, [x, y]: readonly [number, number], isMobile: boolean) => boolean;
+export declare const showHyperlinkTooltip: (element: NonDeletedExcalidrawElement, appState: AppState) => void;
+export declare const hideHyperlinkToolip: () => void;
+export declare const shouldHideLinkPopup: (element: NonDeletedExcalidrawElement, appState: AppState, [clientX, clientY]: readonly [number, number]) => Boolean;

package/types/element/image.d.ts

@@ -0,0 +1,22 @@
+import { AppClassProperties, DataURL, BinaryFiles } from "../types";
+import { ExcalidrawElement, FileId, InitializedExcalidrawImageElement } from "./types";
+export declare const loadHTMLImageElement: (dataURL: DataURL) => Promise<HTMLImageElement>;
+/** NOTE: updates cache even if already populated with given image. Thus,
+ * you should filter out the images upstream if you want to optimize this. */
+export declare const updateImageCache: ({ fileIds, files, imageCache, }: {
+    fileIds: FileId[];
+    files: BinaryFiles;
+    imageCache: AppClassProperties["imageCache"];
+}) => Promise<{
+    imageCache: Map<FileId, {
+        image: HTMLImageElement | Promise<HTMLImageElement>;
+        mimeType: "image/svg+xml" | "image/png" | "image/jpeg" | "image/gif";
+    }>;
+    /** includes errored files because they cache was updated nonetheless */
+    updatedFiles: Map<FileId, true>;
+    /** files that failed when creating HTMLImageElement */
+    erroredFiles: Map<FileId, true>;
+}>;
+export declare const getInitializedImageElements: (elements: readonly ExcalidrawElement[]) => InitializedExcalidrawImageElement[];
+export declare const isHTMLSVGElement: (node: Node | null) => node is SVGElement;
+export declare const normalizeSVG: (SVGString: string) => Promise<string>;

package/types/packages/excalidraw/dist/bundle.d.ts

@@ -0,0 +1,2 @@
+export = __WEBPACK_EXTERNAL_MODULE_react_dom__;
+export = __WEBPACK_EXTERNAL_MODULE_react_dom__;