@excalidraw/excalidraw 0.14.2-fe83e29 → 0.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@excalidraw/excalidraw",
-  "version": "0.14.2-fe83e29",
+  "version": "0.15.0",
   "main": "main.js",
   "types": "types/packages/excalidraw/index.d.ts",
   "files": [
@@ -64,7 +64,7 @@
     "terser-webpack-plugin": "5.3.3",
     "ts-loader": "9.3.1",
     "typescript": "4.7.4",
-    "webpack": "5.73.0",
+    "webpack": "5.76.0",
     "webpack-bundle-analyzer": "4.5.0",
     "webpack-cli": "4.10.0",
     "webpack-dev-server": "4.9.3",
@@ -81,4 +81,4 @@
     "install:deps": "yarn install --frozen-lockfile && yarn --cwd ../../../",
     "build:example": "EXAMPLE=true webpack --config webpack.dev-server.config.js && yarn gen:types"
   }
-}
+}

package/types/actions/actionBoundText.d.ts

@@ -1,15 +1,16 @@
 /// <reference types="react" />
 import { ExcalidrawElement, ExcalidrawLinearElement } from "../element/types";
+import { AppState } from "../types";
 export declare const actionUnbindText: {
     name: "unbindText";
     contextItemLabel: string;
     trackEvent: {
         category: "element";
     };
-    predicate: (elements: readonly ExcalidrawElement[], appState: import("../types").AppState) => boolean;
-    perform: (elements: readonly ExcalidrawElement[], appState: Readonly<import("../types").AppState>) => {
+    predicate: (elements: readonly ExcalidrawElement[], appState: AppState) => boolean;
+    perform: (elements: readonly ExcalidrawElement[], appState: Readonly<AppState>) => {
         elements: readonly ExcalidrawElement[];
-        appState: Readonly<import("../types").AppState>;
+        appState: Readonly<AppState>;
         commitToHistory: true;
     };
 } & {
@@ -21,8 +22,8 @@ export declare const actionBindText: {
     trackEvent: {
         category: "element";
     };
-    predicate: (elements: readonly ExcalidrawElement[], appState: import("../types").AppState) => boolean;
-    perform: (elements: readonly ExcalidrawElement[], appState: Readonly<import("../types").AppState>) => {
+    predicate: (elements: readonly ExcalidrawElement[], appState: AppState) => boolean;
+    perform: (elements: readonly ExcalidrawElement[], appState: Readonly<AppState>) => {
         elements: ExcalidrawElement[];
         appState: {
             selectedElementIds: {
@@ -132,16 +133,118 @@ export declare const actionBindText: {
 } & {
     keyTest?: undefined;
 };
-export declare const actionCreateContainerFromText: {
-    name: "createContainerFromText";
+export declare const actionWrapTextInContainer: {
+    name: "wrapTextInContainer";
     contextItemLabel: string;
     trackEvent: {
         category: "element";
     };
-    predicate: (elements: readonly ExcalidrawElement[], appState: import("../types").AppState) => boolean;
-    perform: (elements: readonly ExcalidrawElement[], appState: Readonly<import("../types").AppState>) => {
-        elements: ExcalidrawElement[];
-        appState: Readonly<import("../types").AppState>;
+    predicate: (elements: readonly ExcalidrawElement[], appState: AppState) => boolean;
+    perform: (elements: readonly ExcalidrawElement[], appState: Readonly<AppState>) => {
+        elements: readonly ExcalidrawElement[];
+        appState: {
+            selectedElementIds: {
+                [id: string]: boolean;
+            };
+            contextMenu: {
+                items: import("../components/ContextMenu").ContextMenuItems;
+                top: number;
+                left: number;
+            } | null;
+            showWelcomeScreen: boolean;
+            isLoading: boolean;
+            errorMessage: import("react").ReactNode;
+            draggingElement: import("../element/types").NonDeletedExcalidrawElement | null;
+            resizingElement: import("../element/types").NonDeletedExcalidrawElement | null;
+            multiElement: import("../element/types").NonDeleted<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: {
+                lastActiveTool: import("../types").LastActiveTool;
+                locked: boolean;
+            } & ({
+                type: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | "eraser" | "hand";
+                customType: null;
+            } | {
+                type: "custom";
+                customType: string;
+            });
+            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: string;
+            currentItemStartArrowhead: import("../element/types").Arrowhead | null;
+            currentItemEndArrowhead: import("../element/types").Arrowhead | null;
+            currentItemRoundness: import("../element/types").StrokeRoundness;
+            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;
+            openSidebar: "library" | "customSidebar" | null;
+            openDialog: "imageExport" | "help" | "jsonExport" | null;
+            isSidebarDocked: boolean;
+            lastPointerDownWith: import("../element/types").PointerType;
+            previousSelectedElementIds: {
+                [id: string]: boolean;
+            };
+            shouldCacheIgnoreZoom: boolean;
+            toast: {
+                message: string;
+                closable?: boolean | undefined;
+                duration?: number | undefined;
+            } | 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;
+            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;
+            };
+            pendingImageElementId: string | null;
+            showHyperlinkPopup: false | "info" | "editor";
+            selectedLinearElement: import("../element/linearElementEditor").LinearElementEditor | null;
+        };
         commitToHistory: true;
     };
 } & {

package/types/actions/actionCanvas.d.ts

@@ -477,6 +477,112 @@ export declare const actionResetZoom: {
 } & {
     keyTest?: ((event: KeyboardEvent | import("react").KeyboardEvent<Element>) => boolean) | undefined;
 };
+export declare const zoomToFitElements: (elements: readonly ExcalidrawElement[], appState: Readonly<AppState>, zoomToSelection: boolean) => {
+    appState: {
+        zoom: {
+            value: NormalizedZoomValue;
+        };
+        scrollX: number;
+        scrollY: number;
+        contextMenu: {
+            items: import("../components/ContextMenu").ContextMenuItems;
+            top: number;
+            left: number;
+        } | null;
+        showWelcomeScreen: boolean;
+        isLoading: boolean;
+        errorMessage: import("react").ReactNode;
+        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: {
+            lastActiveTool: import("../types").LastActiveTool;
+            locked: boolean;
+        } & ({
+            type: "line" | "arrow" | "text" | "selection" | "rectangle" | "diamond" | "ellipse" | "image" | "freedraw" | "eraser" | "hand";
+            customType: null;
+        } | {
+            type: "custom";
+            customType: string;
+        });
+        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: string;
+        currentItemStartArrowhead: import("../element/types").Arrowhead | null;
+        currentItemEndArrowhead: import("../element/types").Arrowhead | null;
+        currentItemRoundness: import("../element/types").StrokeRoundness;
+        viewBackgroundColor: string;
+        cursorButton: "up" | "down";
+        scrolledOutside: boolean;
+        name: string;
+        isResizing: boolean;
+        isRotating: boolean;
+        openMenu: "canvas" | "shape" | null;
+        openPopup: "canvasColorPicker" | "backgroundColorPicker" | "strokeColorPicker" | null;
+        openSidebar: "library" | "customSidebar" | null;
+        openDialog: "imageExport" | "help" | "jsonExport" | null;
+        isSidebarDocked: boolean;
+        lastPointerDownWith: import("../element/types").PointerType;
+        selectedElementIds: {
+            [id: string]: boolean;
+        };
+        previousSelectedElementIds: {
+            [id: string]: boolean;
+        };
+        shouldCacheIgnoreZoom: boolean;
+        toast: {
+            message: string;
+            closable?: boolean | undefined;
+            duration?: number | undefined;
+        } | 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;
+        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;
+        };
+        pendingImageElementId: string | null;
+        showHyperlinkPopup: false | "info" | "editor";
+        selectedLinearElement: import("../element/linearElementEditor").LinearElementEditor | null;
+    };
+    commitToHistory: boolean;
+};
 export declare const actionZoomToSelected: {
     name: "zoomToSelection";
     trackEvent: {

package/types/actions/actionProperties.d.ts

@@ -20,7 +20,7 @@ export declare const actionChangeBackgroundColor: {
 export declare const actionChangeFillStyle: {
     name: "changeFillStyle";
     trackEvent: false;
-    perform: (elements: readonly ExcalidrawElement[], appState: Readonly<AppState>, value: any) => {
+    perform: (elements: readonly ExcalidrawElement[], appState: Readonly<AppState>, value: any, app: import("../../src/types").AppClassProperties) => {
         elements: ExcalidrawElement[];
         appState: {
             currentItemFillStyle: any;

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" | "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" | "changeRoundness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "viewMode" | "exportWithDarkMode" | "toggleTheme" | "increaseFontSize" | "decreaseFontSize" | "unbindText" | "hyperlink" | "bindText" | "toggleLock" | "toggleLinearEditor" | "toggleEraserTool" | "toggleHandTool" | "createContainerFromText";
+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" | "changeRoundness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "viewMode" | "exportWithDarkMode" | "toggleTheme" | "increaseFontSize" | "decreaseFontSize" | "unbindText" | "hyperlink" | "bindText" | "toggleLock" | "toggleLinearEditor" | "toggleEraserTool" | "toggleHandTool" | "wrapTextInContainer";
 export declare type PanelComponentProps = {
     elements: readonly ExcalidrawElement[];
     appState: AppState;

package/types/bug-issue-template.d.ts

@@ -0,0 +1,2 @@
+declare function _default(sentryErrorId: any): string;
+export default _default;

package/types/components/ActiveFile.d.ts

@@ -0,0 +1,7 @@
+import "./ActiveFile.scss";
+declare type ActiveFileProps = {
+    fileName?: string;
+    onSave: () => void;
+};
+export declare const ActiveFile: ({ fileName, onSave }: ActiveFileProps) => JSX.Element;
+export {};

package/types/components/App.d.ts

@@ -93,7 +93,18 @@ declare class App extends React.Component<AppProps, AppState> {
     toggleLock: (source?: "keyboard" | "ui") => void;
     togglePenMode: () => void;
     onHandToolToggle: () => void;
-    scrollToContent: (target?: ExcalidrawElement | readonly ExcalidrawElement[]) => void;
+    /**
+     * Zooms on canvas viewport center
+     */
+    zoomCanvas: (value: number) => void;
+    private cancelInProgresAnimation;
+    scrollToContent: (target?: ExcalidrawElement | readonly ExcalidrawElement[], opts?: {
+        fitToContent?: boolean;
+        animate?: boolean;
+        duration?: number;
+    }) => void;
+    /** use when changing scrollX/scrollY/zoom based on user interaction */
+    private translateCanvas;
     setToast: (toast: {
         message: string;
         closable?: boolean;

package/types/components/ButtonIconSelect.d.ts

@@ -1,11 +1,19 @@
-export declare const ButtonIconSelect: <T extends Object>({ options, value, onChange, group, }: {
+export declare const ButtonIconSelect: <T extends Object>(props: {
     options: {
         value: T;
         text: string;
         icon: JSX.Element;
         testId?: string | undefined;
+        /** if not supplied, defaults to value identity check */
+        active?: boolean | undefined;
     }[];
     value: T | null;
-    onChange: (value: T) => void;
+    type?: "button" | "radio" | undefined;
+} & ({
+    type?: "radio" | undefined;
     group: string;
-}) => JSX.Element;
+    onChange: (value: T) => void;
+} | {
+    type: "button";
+    onClick: (value: T, event: React.MouseEvent<HTMLButtonElement, MouseEvent>) => void;
+})) => JSX.Element;

package/types/components/ClearCanvas.d.ts

@@ -0,0 +1,4 @@
+declare const ClearCanvas: ({ onConfirm }: {
+    onConfirm: () => void;
+}) => JSX.Element;
+export default ClearCanvas;

package/types/components/CollabButton.d.ts

@@ -0,0 +1,7 @@
+import "./CollabButton.scss";
+declare const CollabButton: ({ isCollaborating, collaboratorCount, onClick, }: {
+    isCollaborating: boolean;
+    collaboratorCount: number;
+    onClick: () => void;
+}) => JSX.Element;
+export default CollabButton;

package/types/components/MenuItem.d.ts

@@ -0,0 +1,11 @@
+import "./Menu.scss";
+interface MenuProps {
+    icon: JSX.Element;
+    onClick: () => void;
+    label: string;
+    dataTestId: string;
+    shortcut?: string;
+    isCollaborating?: boolean;
+}
+declare const MenuItem: ({ icon, onClick, label, dataTestId, shortcut, isCollaborating, }: MenuProps) => JSX.Element;
+export default MenuItem;

package/types/components/MenuUtils.d.ts

@@ -0,0 +1,2 @@
+export declare const MenuLinks: () => JSX.Element;
+export declare const Separator: () => JSX.Element;

package/types/components/TopErrorBoundary.d.ts

@@ -0,0 +1,15 @@
+import React from "react";
+interface TopErrorBoundaryState {
+    hasError: boolean;
+    sentryEventId: string;
+    localStorage: string;
+}
+export declare class TopErrorBoundary extends React.Component<any, TopErrorBoundaryState> {
+    state: TopErrorBoundaryState;
+    render(): any;
+    componentDidCatch(error: Error, errorInfo: any): void;
+    private selectTextArea;
+    private createGithubIssue;
+    private errorSplash;
+}
+export {};

package/types/components/WelcomeScreen.d.ts

@@ -0,0 +1,8 @@
+import { ActionManager } from "../actions/manager";
+import { AppState } from "../types";
+import "./WelcomeScreen.scss";
+declare const WelcomeScreen: ({ appState, actionManager, }: {
+    appState: AppState;
+    actionManager: ActionManager;
+}) => JSX.Element;
+export default WelcomeScreen;

package/types/components/WelcomeScreenDecor.d.ts

@@ -0,0 +1,6 @@
+import { ReactNode } from "react";
+declare const WelcomeScreenDecor: ({ children, shouldRender, }: {
+    children: ReactNode;
+    shouldRender: boolean;
+}) => JSX.Element | null;
+export default WelcomeScreenDecor;

package/types/components/icons.d.ts

@@ -87,6 +87,7 @@ export declare const GroupIcon: React.MemoExoticComponent<({ theme }: {
 export declare const UngroupIcon: React.MemoExoticComponent<({ theme }: {
     theme: Theme;
 }) => JSX.Element>;
+export declare const FillZigZagIcon: JSX.Element;
 export declare const FillHachureIcon: JSX.Element;
 export declare const FillCrossHatchIcon: JSX.Element;
 export declare const FillSolidIcon: JSX.Element;

package/types/components/mainMenu/DefaultItems.d.ts

@@ -0,0 +1,44 @@
+import { ExcalidrawProps } from "../../types";
+export declare const LoadScene: {
+    (): JSX.Element | null;
+    displayName: string;
+};
+export declare const SaveToActiveFile: {
+    (): JSX.Element | null;
+    displayName: string;
+};
+export declare const SaveAsImage: {
+    (): JSX.Element;
+    displayName: string;
+};
+export declare const Help: {
+    (): JSX.Element | null;
+    displayName: string;
+};
+export declare const ClearCanvas: {
+    (): JSX.Element | null;
+    displayName: string;
+};
+export declare const ToggleTheme: {
+    (): JSX.Element | null;
+    displayName: string;
+};
+export declare const ChangeCanvasBackground: {
+    (): JSX.Element | null;
+    displayName: string;
+};
+export declare const Export: {
+    (): JSX.Element;
+    displayName: string;
+};
+export declare const Socials: {
+    (): JSX.Element;
+    displayName: string;
+};
+export declare const LiveCollaboration: {
+    ({ onClick, isCollaborating, }: {
+        onClick: ExcalidrawProps["onCollabButtonClick"];
+        isCollaborating: ExcalidrawProps["isCollaborating"];
+    }): JSX.Element;
+    displayName: string;
+};

package/types/components/mainMenu/MainMenu.d.ts

@@ -0,0 +1,44 @@
+import React from "react";
+import * as DefaultItems from "./DefaultItems";
+declare const MainMenu: {
+    ({ children }: {
+        children?: React.ReactNode;
+    }): JSX.Element;
+    Trigger: {
+        ({ className, children, onToggle, }: {
+            className?: string | undefined;
+            children: React.ReactNode;
+            onToggle: () => void;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Item: {
+        ({ icon, onClick, children, dataTestId, shortcut, className, link, style, }: {
+            icon?: JSX.Element | undefined;
+            onClick?: (() => void) | undefined;
+            children: React.ReactNode;
+            dataTestId?: string | undefined;
+            shortcut?: string | undefined;
+            className?: string | undefined;
+            link?: string | undefined;
+            style?: React.CSSProperties | undefined;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Group: {
+        ({ children, className, style, title, }: {
+            children: React.ReactNode;
+            className?: string | undefined;
+            style?: React.CSSProperties | undefined;
+            title?: string | undefined;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Separator: {
+        (): JSX.Element;
+        displayName: string;
+    };
+    DefaultItems: typeof DefaultItems;
+    displayName: string;
+};
+export default MainMenu;

package/types/constants.d.ts

@@ -1,5 +1,5 @@
 import { AppProps } from "./types";
-import { FontFamilyValues } from "./element/types";
+import { ExcalidrawElement, FontFamilyValues } from "./element/types";
 export declare const isDarwin: boolean;
 export declare const isWindows: boolean;
 export declare const isAndroid: boolean;
@@ -162,3 +162,13 @@ export declare const ROUNDNESS: {
 /** key containt id of precedeing elemnt id we use in reconciliation during
  * collaboration */
 export declare const PRECEDING_ELEMENT_KEY = "__precedingElement__";
+export declare const DEFAULT_ELEMENT_PROPS: {
+    strokeColor: ExcalidrawElement["strokeColor"];
+    backgroundColor: ExcalidrawElement["backgroundColor"];
+    fillStyle: ExcalidrawElement["fillStyle"];
+    strokeWidth: ExcalidrawElement["strokeWidth"];
+    strokeStyle: ExcalidrawElement["strokeStyle"];
+    roughness: ExcalidrawElement["roughness"];
+    opacity: ExcalidrawElement["opacity"];
+    locked: ExcalidrawElement["locked"];
+};

package/types/element/newElement.d.ts

@@ -1,25 +1,28 @@
 import { ExcalidrawElement, ExcalidrawImageElement, ExcalidrawTextElement, ExcalidrawLinearElement, ExcalidrawGenericElement, NonDeleted, TextAlign, GroupId, VerticalAlign, Arrowhead, ExcalidrawFreeDrawElement, FontFamilyValues, ExcalidrawTextContainer } from "../element/types";
 import { AppState } from "../types";
 import { MarkOptional, Mutable } from "../utility-types";
-declare type ElementConstructorOpts = MarkOptional<Omit<ExcalidrawGenericElement, "id" | "type" | "isDeleted" | "updated">, "width" | "height" | "angle" | "groupIds" | "boundElements" | "seed" | "version" | "versionNonce" | "link">;
+declare type ElementConstructorOpts = MarkOptional<Omit<ExcalidrawGenericElement, "id" | "type" | "isDeleted" | "updated">, "width" | "height" | "angle" | "groupIds" | "boundElements" | "seed" | "version" | "versionNonce" | "link" | "strokeStyle" | "fillStyle" | "strokeColor" | "backgroundColor" | "roughness" | "strokeWidth" | "roundness" | "locked" | "opacity">;
 export declare const newElement: (opts: {
     type: ExcalidrawGenericElement["type"];
 } & ElementConstructorOpts) => NonDeleted<ExcalidrawGenericElement>;
 export declare const newTextElement: (opts: {
     text: string;
-    fontSize: number;
-    fontFamily: FontFamilyValues;
-    textAlign: TextAlign;
-    verticalAlign: VerticalAlign;
+    fontSize?: number;
+    fontFamily?: FontFamilyValues;
+    textAlign?: TextAlign;
+    verticalAlign?: VerticalAlign;
     containerId?: ExcalidrawTextContainer["id"];
+    lineHeight?: ExcalidrawTextElement["lineHeight"];
+    strokeWidth?: ExcalidrawTextElement["strokeWidth"];
 } & ElementConstructorOpts) => NonDeleted<ExcalidrawTextElement>;
 export declare const refreshTextDimensions: (textElement: ExcalidrawTextElement, text?: string) => {
     x: number;
     y: number;
     width: number;
     height: number;
+    baseline: number;
     text: string;
-};
+} | undefined;
 export declare const updateTextElement: (textElement: ExcalidrawTextElement, { text, isDeleted, originalText, }: {
     text: string;
     isDeleted?: boolean | undefined;
@@ -42,7 +45,16 @@ export declare const newImageElement: (opts: {
     fileId?: ExcalidrawImageElement["fileId"];
     scale?: ExcalidrawImageElement["scale"];
 } & ElementConstructorOpts) => NonDeleted<ExcalidrawImageElement>;
-export declare const deepCopyElement: (val: any, depth?: number) => any;
+/**
+ * Clones ExcalidrawElement data structure. Does not regenerate id, nonce, or
+ * any value. The purpose is to to break object references for immutability
+ * reasons, whenever we want to keep the original element, but ensure it's not
+ * mutated.
+ *
+ * Only clones plain objects and arrays. Doesn't clone Date, RegExp, Map, Set,
+ * Typed arrays and other non-null objects.
+ */
+export declare const deepCopyElement: <T extends ExcalidrawElement>(val: T) => Mutable<T>;
 /**
  * Duplicate an element, often used in the alt-drag operation.
  * Note that this method has gotten a bit complicated since the
@@ -57,5 +69,14 @@ export declare const deepCopyElement: (val: any, depth?: number) => any;
  * @param element Element to duplicate
  * @param overrides Any element properties to override
  */
-export declare const duplicateElement: <TElement extends Mutable<ExcalidrawElement>>(editingGroupId: AppState["editingGroupId"], groupIdMapForOperation: Map<GroupId, GroupId>, element: TElement, overrides?: Partial<TElement> | undefined) => TElement;
+export declare const duplicateElement: <TElement extends ExcalidrawElement>(editingGroupId: AppState["editingGroupId"], groupIdMapForOperation: Map<GroupId, GroupId>, element: TElement, overrides?: Partial<TElement> | undefined) => Readonly<TElement>;
+/**
+ * Clones elements, regenerating their ids (including bindings) and group ids.
+ *
+ * If bindings don't exist in the elements array, they are removed. Therefore,
+ * it's advised to supply the whole elements array, or sets of elements that
+ * are encapsulated (such as library items), if the purpose is to retain
+ * bindings to the cloned elements intact.
+ */
+export declare const duplicateElements: (elements: readonly ExcalidrawElement[]) => ExcalidrawElement[];
 export {};