@excalidraw/excalidraw 0.16.1-e8def8d → 0.17.0-7284-25ea35d

package/dist/excalidraw.production.min.js.LICENSE.txt

@@ -1,15 +1,5 @@
 /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */
 
-/**
- * @license React
- * react-jsx-runtime.production.min.js
- *
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
 /**
  * @license React
  * use-sync-external-store-shim.production.min.js

package/main.js

@@ -1,4 +1,10 @@
-if (process.env.NODE_ENV === "production") {
+if (process.env.IS_PREACT === "true") {
+  if (process.env.NODE_ENV === "production") {
+    module.exports = require("./dist/excalidraw-with-preact.production.min.js");
+  } else {
+    module.exports = require("./dist/excalidraw-with-preact.development.js");
+  }
+} else if (process.env.NODE_ENV === "production") {
   module.exports = require("./dist/excalidraw.production.min.js");
 } else {
   module.exports = require("./dist/excalidraw.development.js");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@excalidraw/excalidraw",
-  "version": "0.16.1-e8def8d",
+  "version": "0.17.0-7284-25ea35d",
   "main": "main.js",
   "types": "types/packages/excalidraw/index.d.ts",
   "files": [
@@ -78,7 +78,7 @@
   "homepage": "https://github.com/excalidraw/excalidraw/tree/master/src/packages/excalidraw",
   "scripts": {
     "gen:types": "tsc --project ../../../tsconfig-types.json",
-    "build:umd": "rm -rf dist && cross-env NODE_ENV=production webpack --config webpack.prod.config.js && cross-env NODE_ENV=development webpack --config webpack.dev.config.js && yarn gen:types",
+    "build:umd": "rm -rf dist && cross-env NODE_ENV=production webpack --config webpack.prod.config.js && cross-env NODE_ENV=development webpack --config webpack.dev.config.js && NODE_ENV=development webpack --config webpack.preact.config.js && NODE_ENV=production webpack --config webpack.preact.config.js && yarn gen:types",
     "build:umd:withAnalyzer": "cross-env NODE_ENV=production ANALYZER=true webpack --config webpack.prod.config.js",
     "pack": "yarn build:umd && yarn pack",
     "start": "webpack serve --config webpack.dev-server.config.js",

package/types/actions/actionCanvas.d.ts

@@ -40,7 +40,6 @@ export declare const actionClearCanvas: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
             } & import("../types").ActiveTool;
-            name: string;
             contextMenu: {
                 items: import("../components/ContextMenu").ContextMenuItems;
                 top: number;
@@ -91,6 +90,7 @@ export declare const actionClearCanvas: {
             scrollY: number;
             cursorButton: "up" | "down";
             scrolledOutside: boolean;
+            name: string;
             isResizing: boolean;
             isRotating: boolean;
             zoom: Readonly<{

package/types/actions/actionExport.d.ts

@@ -811,7 +811,6 @@ export declare const actionLoadScene: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
             } & import("../types").ActiveTool;
-            name: string;
             contextMenu: {
                 items: import("../components/ContextMenu").ContextMenuItems;
                 top: number;
@@ -866,6 +865,7 @@ export declare const actionLoadScene: {
             scrollY: number;
             cursorButton: "up" | "down";
             scrolledOutside: boolean;
+            name: string;
             isResizing: boolean;
             isRotating: boolean;
             zoom: Readonly<{

package/types/actions/actionGroup.d.ts

@@ -1,4 +1,4 @@
-import { ExcalidrawElement, ExcalidrawFrameElement } from "../element/types";
+import { ExcalidrawElement } from "../element/types";
 import { AppClassProperties, AppState } from "../types";
 export declare const actionGroup: {
     name: "group";
@@ -37,7 +37,7 @@ export declare const actionGroup: {
             isBindingEnabled: boolean;
             startBoundElement: import("../element/types").NonDeleted<import("../element/types").ExcalidrawBindableElement> | null;
             suggestedBindings: import("../element/binding").SuggestedBinding[];
-            frameToHighlight: import("../element/types").NonDeleted<ExcalidrawFrameElement> | null;
+            frameToHighlight: import("../element/types").NonDeleted<import("../element/types").ExcalidrawFrameElement> | null;
             frameRendering: {
                 enabled: boolean;
                 name: boolean;
@@ -177,7 +177,7 @@ export declare const actionUngroup: {
             isBindingEnabled: boolean;
             startBoundElement: import("../element/types").NonDeleted<import("../element/types").ExcalidrawBindableElement> | null;
             suggestedBindings: import("../element/binding").SuggestedBinding[];
-            frameToHighlight: import("../element/types").NonDeleted<ExcalidrawFrameElement> | null;
+            frameToHighlight: import("../element/types").NonDeleted<import("../element/types").ExcalidrawFrameElement> | null;
             frameRendering: {
                 enabled: boolean;
                 name: boolean;

package/types/actions/actionMenu.d.ts

@@ -262,19 +262,6 @@ export declare const actionToggleEditMenu: {
 } & {
     keyTest?: undefined;
 };
-export declare const actionFullScreen: {
-    name: "toggleFullScreen";
-    viewMode: true;
-    trackEvent: {
-        category: "canvas";
-        predicate: (appState: Readonly<import("../types").AppState>) => boolean;
-    };
-    perform: () => {
-        commitToHistory: false;
-    };
-} & {
-    keyTest?: undefined;
-};
 export declare const actionShortcuts: {
     name: "toggleShortcuts";
     viewMode: true;

package/types/actions/index.d.ts

@@ -7,7 +7,7 @@ export { actionChangeViewBackgroundColor, actionClearCanvas, actionZoomIn, actio
 export { actionFinalize } from "./actionFinalize";
 export { actionChangeProjectName, actionChangeExportBackground, actionSaveToActiveFile, actionSaveFileToDisk, actionLoadScene, } from "./actionExport";
 export { actionCopyStyles, actionPasteStyles } from "./actionStyles";
-export { actionToggleCanvasMenu, actionToggleEditMenu, actionFullScreen, actionShortcuts, } from "./actionMenu";
+export { actionToggleCanvasMenu, actionToggleEditMenu, actionShortcuts, } from "./actionMenu";
 export { actionGroup, actionUngroup } from "./actionGroup";
 export { actionGoToCollaborator } from "./actionNavigate";
 export { actionAddToLibrary } from "./actionAddToLibrary";

package/types/appState.d.ts

@@ -5,7 +5,6 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
         lastActiveTool: import("./types").ActiveTool | null;
         locked: boolean;
     } & import("./types").ActiveTool) | undefined;
-    name?: string | undefined;
     showWelcomeScreen?: boolean | undefined;
     penMode?: boolean | undefined;
     penDetected?: boolean | undefined;
@@ -31,6 +30,7 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     scrollY?: number | undefined;
     cursorButton?: "up" | "down" | undefined;
     scrolledOutside?: boolean | undefined;
+    name?: string | undefined;
     zoom?: Readonly<{
         value: NormalizedZoomValue;
     }> | undefined;

package/types/components/Actions.d.ts

@@ -1,16 +1,17 @@
 import { ActionManager } from "../actions/manager";
 import { ExcalidrawElement } from "../element/types";
-import { AppClassProperties, UIAppState, Zoom } from "../types";
+import { AppClassProperties, AppProps, UIAppState, Zoom } from "../types";
 import "./Actions.scss";
 export declare const SelectedShapeActions: ({ appState, elements, renderAction, }: {
     appState: UIAppState;
     elements: readonly ExcalidrawElement[];
     renderAction: ActionManager["renderAction"];
 }) => JSX.Element;
-export declare const ShapesSwitcher: ({ activeTool, appState, app, }: {
+export declare const ShapesSwitcher: ({ activeTool, appState, app, UIOptions, }: {
     activeTool: UIAppState["activeTool"];
     appState: UIAppState;
     app: AppClassProperties;
+    UIOptions: AppProps["UIOptions"];
 }) => JSX.Element;
 export declare const ZoomActions: ({ renderAction, zoom, }: {
     renderAction: ActionManager["renderAction"];

package/types/components/App.d.ts

@@ -2,8 +2,9 @@ import React from "react";
 import { RoughCanvas } from "roughjs/bin/canvas";
 import { ActionManager } from "../actions/manager";
 import { EXPORT_IMAGE_TYPES } from "../constants";
+import { ExportedElements } from "../data";
 import { LinearElementEditor } from "../element/linearElementEditor";
-import { ExcalidrawElement, NonDeleted, NonDeletedExcalidrawElement } from "../element/types";
+import { ExcalidrawElement, NonDeleted, NonDeletedExcalidrawElement, ExcalidrawFrameElement } from "../element/types";
 import History from "../history";
 import Scene from "../scene/Scene";
 import { AppClassProperties, AppProps, AppState, ExcalidrawImperativeAPI, BinaryFiles, LibraryItems, SceneData, Device, FrameNameBoundsCache, SidebarName, SidebarTabName, ToolType } from "../types";
@@ -18,11 +19,15 @@ export declare const ExcalidrawContainerContext: React.Context<{
 export declare const useApp: () => AppClassProperties;
 export declare const useAppProps: () => AppProps;
 export declare const useDevice: () => Readonly<{
-    isSmScreen: boolean;
-    isMobile: boolean;
+    viewport: {
+        isMobile: boolean;
+        isLandscape: boolean;
+    };
+    editor: {
+        isMobile: boolean;
+        canFitSidebar: boolean;
+    };
     isTouchScreen: boolean;
-    canDeviceFitSidebar: boolean;
-    isLandscape: boolean;
 }>;
 export declare const useExcalidrawContainer: () => {
     container: HTMLDivElement | null;
@@ -39,7 +44,6 @@ declare class App extends React.Component<AppProps, AppState> {
     unmounted: boolean;
     actionManager: ActionManager;
     device: Device;
-    detachIsMobileMqHandler?: () => void;
     private excalidrawContainerRef;
     static defaultProps: Partial<AppProps>;
     scene: Scene;
@@ -220,7 +224,9 @@ declare class App extends React.Component<AppProps, AppState> {
     getSceneElementsIncludingDeleted: () => readonly ExcalidrawElement[];
     getSceneElements: () => readonly NonDeletedExcalidrawElement[];
     onInsertElements: (elements: readonly ExcalidrawElement[]) => void;
-    onExportImage: (type: keyof typeof EXPORT_IMAGE_TYPES, elements: readonly NonDeletedExcalidrawElement[]) => Promise<void>;
+    onExportImage: (type: keyof typeof EXPORT_IMAGE_TYPES, elements: ExportedElements, opts: {
+        exportingFrame: ExcalidrawFrameElement | null;
+    }) => Promise<void>;
     private openEyeDropper;
     private syncActionResult;
     private onBlur;
@@ -233,7 +239,9 @@ declare class App extends React.Component<AppProps, AppState> {
      */
     private resetScene;
     private initializeScene;
-    private refreshDeviceState;
+    private isMobileBreakpoint;
+    private refreshViewportBreakpoints;
+    private refreshEditorBreakpoints;
     componentDidMount(): Promise<void>;
     componentWillUnmount(): void;
     private onResize;
@@ -269,7 +277,7 @@ declare class App extends React.Component<AppProps, AppState> {
         outline: boolean;
         clip: boolean;
     }> | ((prevState: AppState["frameRendering"]) => Partial<AppState["frameRendering"]>)) => void;
-    togglePenMode: (force?: boolean) => void;
+    togglePenMode: (force: boolean | null) => void;
     onHandToolToggle: () => void;
     /**
      * Zooms on canvas viewport center
@@ -321,6 +329,7 @@ declare class App extends React.Component<AppProps, AppState> {
     private onKeyDown;
     private onWheel;
     private onKeyUp;
+    private isToolSupported;
     setActiveTool: (tool: (({
         type: Exclude<ToolType, "image">;
     } | {

package/types/components/ImageExportDialog.d.ts

@@ -10,4 +10,4 @@ export declare const ImageExportDialog: ({ elements, appState, files, actionMana
     actionManager: ActionManager;
     onExportImage: AppClassProperties["onExportImage"];
     onCloseRequest: () => void;
-}) => JSX.Element | null;
+}) => JSX.Element;

package/types/components/LayerUI.d.ts

@@ -14,7 +14,7 @@ interface LayerUIProps {
     elements: readonly NonDeletedExcalidrawElement[];
     onLockToggle: () => void;
     onHandToolToggle: () => void;
-    onPenModeToggle: () => void;
+    onPenModeToggle: AppClassProperties["togglePenMode"];
     showExitZenModeBtn: boolean;
     langCode: Language["code"];
     renderTopRightUI?: ExcalidrawProps["renderTopRightUI"];

package/types/components/MobileMenu.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import { AppClassProperties, AppState, Device, ExcalidrawProps, UIAppState } from "../types";
+import { AppClassProperties, AppProps, AppState, Device, ExcalidrawProps, UIAppState } from "../types";
 import { ActionManager } from "../actions/manager";
 import { NonDeletedExcalidrawElement } from "../element/types";
 type MobileMenuProps = {
@@ -11,13 +11,14 @@ type MobileMenuProps = {
     elements: readonly NonDeletedExcalidrawElement[];
     onLockToggle: () => void;
     onHandToolToggle: () => void;
-    onPenModeToggle: () => void;
+    onPenModeToggle: AppClassProperties["togglePenMode"];
     renderTopRightUI?: (isMobile: boolean, appState: UIAppState) => JSX.Element | null;
     renderCustomStats?: ExcalidrawProps["renderCustomStats"];
     renderSidebars: () => JSX.Element | null;
     device: Device;
     renderWelcomeScreen: boolean;
+    UIOptions: AppProps["UIOptions"];
     app: AppClassProperties;
 };
-export declare const MobileMenu: ({ appState, elements, actionManager, setAppState, onLockToggle, onHandToolToggle, onPenModeToggle, renderTopRightUI, renderCustomStats, renderSidebars, device, renderWelcomeScreen, app, }: MobileMenuProps) => JSX.Element;
+export declare const MobileMenu: ({ appState, elements, actionManager, setAppState, onLockToggle, onHandToolToggle, onPenModeToggle, renderTopRightUI, renderCustomStats, renderSidebars, device, renderWelcomeScreen, UIOptions, app, }: MobileMenuProps) => JSX.Element;
 export {};

package/types/constants.d.ts

@@ -84,6 +84,7 @@ export declare const FONT_FAMILY: {
     Virgil: number;
     Helvetica: number;
     Cascadia: number;
+    Assistant: number;
 };
 export declare const THEME: {
     readonly LIGHT: "light";
@@ -101,6 +102,11 @@ export declare const FRAME_STYLE: {
     } | null;
     backgroundColor: string;
     radius: number;
+    nameOffsetY: number;
+    nameColorLightTheme: string;
+    nameColorDarkTheme: string;
+    nameFontSize: number;
+    nameLineHeight: number;
 };
 export declare const WINDOWS_EMOJI_FALLBACK_FONT = "Segoe UI Emoji";
 export declare const MIN_FONT_SIZE = 1;
@@ -171,7 +177,6 @@ export declare const URL_HASH_KEYS: {
     readonly addLibrary: "addLibrary";
 };
 export declare const DEFAULT_UI_OPTIONS: AppProps["UIOptions"];
-export declare const MQ_SM_MAX_WIDTH = 640;
 export declare const MQ_MAX_WIDTH_PORTRAIT = 730;
 export declare const MQ_MAX_WIDTH_LANDSCAPE = 1000;
 export declare const MQ_MAX_HEIGHT_LANDSCAPE = 500;

package/types/data/index.d.ts

@@ -1,13 +1,21 @@
-import { NonDeletedExcalidrawElement } from "../element/types";
+import { ExcalidrawElement, ExcalidrawFrameElement, NonDeletedExcalidrawElement } from "../element/types";
 import { ExportType } from "../scene/types";
 import { AppState, BinaryFiles } from "../types";
 import { FileSystemHandle } from "./filesystem";
 export { loadFromBlob } from "./blob";
 export { loadFromJSON, saveAsJSON } from "./json";
-export declare const exportCanvas: (type: Omit<ExportType, "backend">, elements: readonly NonDeletedExcalidrawElement[], appState: AppState, files: BinaryFiles, { exportBackground, exportPadding, viewBackgroundColor, name, fileHandle, }: {
+export type ExportedElements = readonly NonDeletedExcalidrawElement[] & {
+    _brand: "exportedElements";
+};
+export declare const prepareElementsForExport: (elements: readonly ExcalidrawElement[], { selectedElementIds }: Pick<AppState, "selectedElementIds">, exportSelectionOnly: boolean) => {
+    exportingFrame: ExcalidrawFrameElement | null;
+    exportedElements: ExportedElements;
+};
+export declare const exportCanvas: (type: Omit<ExportType, "backend">, elements: ExportedElements, appState: AppState, files: BinaryFiles, { exportBackground, exportPadding, viewBackgroundColor, name, fileHandle, exportingFrame, }: {
     exportBackground: boolean;
     exportPadding?: number | undefined;
     viewBackgroundColor: string;
     name: string;
     fileHandle?: FileSystemHandle | null | undefined;
+    exportingFrame: ExcalidrawFrameElement | null;
 }) => Promise<FileSystemHandle | null | undefined>;

package/types/element/embeddable.d.ts

@@ -14,7 +14,7 @@ type EmbeddedLink = ({
     srcdoc: (theme: Theme) => string;
 })) | null;
 export declare const getEmbedLink: (link: string | null | undefined) => EmbeddedLink;
-export declare const isEmbeddableOrFrameLabel: (element: NonDeletedExcalidrawElement) => Boolean;
+export declare const isEmbeddableOrLabel: (element: NonDeletedExcalidrawElement) => Boolean;
 export declare const createPlaceholderEmbeddableLabel: (element: ExcalidrawEmbeddableElement) => ExcalidrawElement;
 export declare const actionSetEmbeddableAsActiveTool: {
     name: "setEmbeddableAsActiveTool";

package/types/element/typeChecks.d.ts

@@ -16,7 +16,7 @@ export declare const isBindingElement: (element?: ExcalidrawElement | null, incl
 export declare const isBindingElementType: (elementType: AppState["activeTool"]["type"]) => boolean;
 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 isExcalidrawElement: (element: any) => element is ExcalidrawElement;
 export declare const hasBoundTextElement: (element: ExcalidrawElement | null) => element is MarkNonNullable<ExcalidrawBindableElement, "boundElements">;
 export declare const isBoundToContainer: (element: ExcalidrawElement | null) => element is ExcalidrawTextElementWithContainer;
 export declare const isUsingAdaptiveRadius: (type: string) => boolean;

package/types/errors.d.ts

@@ -5,4 +5,9 @@ export declare class CanvasError extends Error {
 export declare class AbortError extends DOMException {
     constructor(message?: string);
 }
+type ImageSceneDataErrorCode = "IMAGE_NOT_CONTAINS_SCENE_DATA" | "IMAGE_SCENE_DATA_ERROR";
+export declare class ImageSceneDataError extends Error {
+    code: ImageSceneDataErrorCode;
+    constructor(message?: string, code?: ImageSceneDataErrorCode);
+}
 export {};

package/types/frame.d.ts

@@ -18,7 +18,17 @@ export declare const groupsAreCompletelyOutOfFrame: (elements: readonly NonDelet
  * Returns a map of frameId to frame elements. Includes empty frames.
  */
 export declare const groupByFrames: (elements: readonly ExcalidrawElement[]) => Map<string, ExcalidrawElement[]>;
-export declare const getFrameElements: (allElements: ExcalidrawElementsIncludingDeleted, frameId: string) => ExcalidrawElement[];
+export declare const getFrameChildren: (allElements: ExcalidrawElementsIncludingDeleted, frameId: string) => ExcalidrawElement[];
+export declare const getFrameElements: (allElements: ExcalidrawElementsIncludingDeleted) => ExcalidrawFrameElement[];
+/**
+ * Returns ExcalidrawFrameElements and non-frame-children elements.
+ *
+ * Considers children as root elements if they point to a frame parent
+ * non-existing in the elements set.
+ *
+ * Considers non-frame bound elements (container or arrow labels) as root.
+ */
+export declare const getRootElements: (allElements: ExcalidrawElementsIncludingDeleted) => ExcalidrawElement[];
 export declare const getElementsInResizingFrame: (allElements: ExcalidrawElementsIncludingDeleted, frame: ExcalidrawFrameElement, appState: AppState) => ExcalidrawElement[];
 export declare const getElementsInNewFrame: (allElements: ExcalidrawElementsIncludingDeleted, frame: ExcalidrawFrameElement) => ExcalidrawElement[];
 export declare const getContainingFrame: (element: ExcalidrawElement, elementsMap?: Map<string, ExcalidrawElement>) => ExcalidrawFrameElement | null;

package/types/packages/excalidraw/dist/excalidraw-with-preact.development.d.ts

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

package/types/packages/excalidraw/dist/excalidraw-with-preact.production.min.d.ts

@@ -0,0 +1 @@
+export const ExcalidrawLib: {};

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

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

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

@@ -1,13 +1,12 @@
 import React from "react";
 import "../../css/app.scss";
 import "../../css/styles.scss";
-import { ExcalidrawAPIRefValue, ExcalidrawProps } from "../../types";
+import { ExcalidrawProps } from "../../types";
 import Footer from "../../components/footer/FooterCenter";
 import MainMenu from "../../components/main-menu/MainMenu";
 import WelcomeScreen from "../../components/welcome-screen/WelcomeScreen";
 import LiveCollaborationTrigger from "../../components/live-collaboration/LiveCollaborationTrigger";
-type PublicExcalidrawProps = Omit<ExcalidrawProps, "forwardedRef">;
-export declare const Excalidraw: React.MemoExoticComponent<React.ForwardRefExoticComponent<PublicExcalidrawProps & React.RefAttributes<ExcalidrawAPIRefValue>>>;
+export declare const Excalidraw: React.MemoExoticComponent<(props: ExcalidrawProps) => JSX.Element>;
 export { getSceneVersion, isInvisiblySmallElement, getNonDeletedElements, } from "../../element";
 export { defaultLang, useI18n, languages } from "../../i18n";
 export { restore, restoreAppState, restoreElements, restoreLibraryItems, } from "../../data/restore";
@@ -27,4 +26,5 @@ export { LiveCollaborationTrigger };
 export { DefaultSidebar } from "../../components/DefaultSidebar";
 export { normalizeLink } from "../../data/url";
 export { convertToExcalidrawElements } from "../../data/transform";
+export { getCommonBounds } from "../../element/bounds";
 export { elementsOverlappingBBox, isElementInsideBBox, elementPartiallyOverlapsWithOrContainsBBox, } from "../withinBounds";

package/types/packages/excalidraw/webpack.preact.config.d.ts

@@ -0,0 +1,171 @@
+declare const _exports: {
+    mode: string;
+    devtool: boolean;
+    entry: {
+        "excalidraw.development": string;
+    };
+    output: {
+        path: string;
+        library: string;
+        libraryTarget: string;
+        filename: string;
+        chunkFilename: string;
+        assetModuleFilename: string;
+        publicPath: string;
+    };
+    resolve: {
+        extensions: string[];
+    };
+    module: {
+        rules: ({
+            test: RegExp;
+            exclude: RegExp;
+            use: (string | {
+                loader: string;
+            } | {
+                loader: string;
+                options: {
+                    postcssOptions: {
+                        plugins: (import("postcss").Plugin & import("autoprefixer").ExportedAPI)[];
+                    };
+                };
+            })[];
+        } | {
+            test: RegExp;
+            resolve: {
+                fullySpecified: boolean;
+            };
+        } | {
+            test: RegExp;
+            exclude: RegExp;
+            use: ({
+                loader: string;
+            } | {
+                loader: string;
+                options: {
+                    transpileOnly: boolean;
+                    configFile: string;
+                };
+            })[];
+        } | {
+            test: RegExp;
+            type: string;
+        })[];
+    };
+    optimization: {
+        splitChunks: {
+            chunks: string;
+            cacheGroups: {
+                vendors: {
+                    test: RegExp;
+                    name: string;
+                };
+            };
+        };
+    };
+    plugins: (import("webpack").EvalSourceMapDevToolPlugin | import("webpack").DefinePlugin)[];
+    externals: {
+        react: {
+            root: string;
+            commonjs2: string;
+            commonjs: string;
+            amd: string;
+        };
+        "react-dom": {
+            root: string;
+            commonjs2: string;
+            commonjs: string;
+            amd: string;
+        };
+    };
+} | {
+    mode: string;
+    entry: {
+        "excalidraw.production.min": string;
+    };
+    output: {
+        path: string;
+        library: string;
+        libraryTarget: string;
+        filename: string;
+        chunkFilename: string;
+        assetModuleFilename: string;
+        publicPath: string;
+    };
+    resolve: {
+        extensions: string[];
+    };
+    module: {
+        rules: ({
+            test: RegExp;
+            exclude: RegExp;
+            use: (string | {
+                loader: string;
+            } | {
+                loader: string;
+                options: {
+                    postcssOptions: {
+                        plugins: (import("postcss").Plugin & import("autoprefixer").ExportedAPI)[];
+                    };
+                };
+            })[];
+        } | {
+            test: RegExp;
+            resolve: {
+                fullySpecified: boolean;
+            };
+        } | {
+            test: RegExp;
+            exclude: RegExp;
+            use: ({
+                loader: string;
+            } | {
+                loader: string;
+                options: {
+                    transpileOnly: boolean;
+                    configFile: string;
+                };
+            } | {
+                loader: string;
+                options: {
+                    presets: (string | (string | {
+                        runtime: string;
+                    })[])[];
+                    plugins: string[];
+                };
+            })[];
+        } | {
+            test: RegExp;
+            type: string;
+        })[];
+    };
+    optimization: {
+        minimize: boolean;
+        minimizer: import("terser-webpack-plugin")<import("terser").MinifyOptions>[];
+        splitChunks: {
+            chunks: string;
+            cacheGroups: {
+                vendors: {
+                    test: RegExp;
+                    name: string;
+                };
+            };
+        };
+    };
+    plugins: any[];
+    externals: {
+        react: {
+            root: string;
+            commonjs2: string;
+            commonjs: string;
+            amd: string;
+        };
+        "react-dom": {
+            root: string;
+            commonjs2: string;
+            commonjs: string;
+            amd: string;
+        };
+    };
+};
+export = _exports;

package/types/packages/utils.d.ts

@@ -1,5 +1,5 @@
 import { AppState, BinaryFiles } from "../types";
-import { ExcalidrawElement, NonDeleted } from "../element/types";
+import { ExcalidrawElement, ExcalidrawFrameElement, NonDeleted } from "../element/types";
 import { MIME_TYPES } from "../constants";
 export { MIME_TYPES };
 type ExportOpts = {
@@ -7,13 +7,14 @@ type ExportOpts = {
     appState?: Partial<Omit<AppState, "offsetTop" | "offsetLeft">>;
     files: BinaryFiles | null;
     maxWidthOrHeight?: number;
+    exportingFrame?: ExcalidrawFrameElement | null;
     getDimensions?: (width: number, height: number) => {
         width: number;
         height: number;
         scale?: number;
     };
 };
-export declare const exportToCanvas: ({ elements, appState, files, maxWidthOrHeight, getDimensions, exportPadding, }: ExportOpts & {
+export declare const exportToCanvas: ({ elements, appState, files, maxWidthOrHeight, getDimensions, exportPadding, exportingFrame, }: ExportOpts & {
     exportPadding?: number | undefined;
 }) => Promise<HTMLCanvasElement>;
 export declare const exportToBlob: (opts: ExportOpts & {
@@ -21,7 +22,7 @@ export declare const exportToBlob: (opts: ExportOpts & {
     quality?: number;
     exportPadding?: number;
 }) => Promise<Blob>;
-export declare const exportToSvg: ({ elements, appState, files, exportPadding, renderEmbeddables, }: Omit<ExportOpts, "getDimensions"> & {
+export declare const exportToSvg: ({ elements, appState, files, exportPadding, renderEmbeddables, exportingFrame, }: Omit<ExportOpts, "getDimensions"> & {
     exportPadding?: number | undefined;
     renderEmbeddables?: boolean | undefined;
 }) => Promise<SVGSVGElement>;

package/types/packages/withinBounds.d.ts

@@ -1,4 +1,4 @@
-import type { NonDeletedExcalidrawElement } from "../element/types";
+import type { ExcalidrawElement, NonDeletedExcalidrawElement } from "../element/types";
 import { Bounds } from "../element/bounds";
 type Element = NonDeletedExcalidrawElement;
 type Elements = readonly NonDeletedExcalidrawElement[];
@@ -6,7 +6,7 @@ export declare const isElementInsideBBox: (element: Element, bbox: Bounds, eithe
 export declare const elementPartiallyOverlapsWithOrContainsBBox: (element: Element, bbox: Bounds) => boolean;
 export declare const elementsOverlappingBBox: ({ elements, bounds, type, errorMargin, }: {
     elements: Elements;
-    bounds: Bounds;
+    bounds: Bounds | ExcalidrawElement;
     /** safety offset. Defaults to 0. */
     errorMargin?: number | undefined;
     /**