@excalidraw/math 0.18.0-4ce38fb → 0.18.0-4ce8305

package/dist/types/excalidraw/actions/actionGroup.d.ts

@@ -13,8 +13,8 @@ export declare const actionGroup: {
         captureUpdate: "EVENTUALLY";
     } | {
         appState: {
-            editingGroupId: import("../types").AppState["editingGroupId"];
             selectedElementIds: import("../types").AppState["selectedElementIds"];
+            editingGroupId: import("../types").AppState["editingGroupId"];
             selectedGroupIds: import("../types").AppState["selectedGroupIds"];
             contextMenu: {
                 items: import("../components/ContextMenu").ContextMenuItems;
@@ -210,8 +210,8 @@ export declare const actionUngroup: {
         captureUpdate: "EVENTUALLY";
     } | {
         appState: {
-            editingGroupId: import("../types").AppState["editingGroupId"];
             selectedElementIds: import("../types").AppState["selectedElementIds"];
+            editingGroupId: import("../types").AppState["editingGroupId"];
             selectedGroupIds: import("../types").AppState["selectedGroupIds"];
             contextMenu: {
                 items: import("../components/ContextMenu").ContextMenuItems;

package/dist/types/excalidraw/actions/actionSelectAll.d.ts

@@ -11,8 +11,8 @@ export declare const actionSelectAll: {
     perform: (elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<import("../types").AppState>, value: unknown, app: import("../types").AppClassProperties) => false | {
         appState: {
             selectedLinearElement: LinearElementEditor | null;
-            editingGroupId: import("../types").AppState["editingGroupId"];
             selectedElementIds: import("../types").AppState["selectedElementIds"];
+            editingGroupId: import("../types").AppState["editingGroupId"];
             selectedGroupIds: import("../types").AppState["selectedGroupIds"];
             contextMenu: {
                 items: import("../components/ContextMenu").ContextMenuItems;

package/dist/types/excalidraw/actions/actionToggleWrap.d.ts

@@ -0,0 +1,12 @@
+export declare const actionToggleWrap: {
+    name: "toggleWrap";
+    label: string;
+    trackEvent: {
+        category: "element";
+    };
+    predicate: (elements: readonly import("@excalidraw/element/types").ExcalidrawElement[], appState: import("../types").AppState, _: import("../types").ExcalidrawProps, app: import("../types").AppClassProperties) => boolean;
+    perform: (elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<import("../types").AppState>, _: unknown, app: import("../types").AppClassProperties) => import("./types").ActionResult;
+    keyTest: (event: KeyboardEvent | import("react").KeyboardEvent<Element>, appState: import("../types").AppState, elements: readonly import("@excalidraw/element/types").ExcalidrawElement[], app: import("../types").AppClassProperties) => boolean;
+} & {
+    keyTest?: ((event: KeyboardEvent | import("react").KeyboardEvent<Element>, appState: import("../types").AppState, elements: readonly import("@excalidraw/element/types").ExcalidrawElement[], app: import("../types").AppClassProperties) => boolean) | undefined;
+};

package/dist/types/excalidraw/actions/index.d.ts

@@ -24,6 +24,7 @@ export { actionToggleMidpointSnapping } from "./actionToggleMidpointSnapping";
 export { actionToggleShowHints } from "./actionToggleShowHints";
 export { actionToggleStats } from "./actionToggleStats";
 export { actionUnbindText, actionBindText } from "./actionBoundText";
+export { actionToggleWrap } from "./actionToggleWrap";
 export { actionLink } from "./actionLink";
 export { actionToggleElementLock } from "./actionElementLock";
 export { actionToggleLinearEditor } from "./actionLinearEditor";

package/dist/types/excalidraw/actions/shortcuts.d.ts

@@ -1,4 +1,4 @@
 import type { SubtypeOf } from "@excalidraw/common/utility-types";
 import type { ActionName } from "./types";
-export type ShortcutName = SubtypeOf<ActionName, "toggleTheme" | "loadScene" | "clearCanvas" | "cut" | "copy" | "paste" | "copyStyles" | "pasteStyles" | "selectAll" | "deleteSelectedElements" | "duplicateSelection" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyAsPng" | "group" | "ungroup" | "gridMode" | "zenMode" | "objectsSnapMode" | "stats" | "addToLibrary" | "viewMode" | "flipHorizontal" | "flipVertical" | "hyperlink" | "toggleElementLock" | "resetZoom" | "zoomOut" | "zoomIn" | "zoomToFit" | "zoomToFitSelectionInViewport" | "zoomToFitSelection" | "saveFileToDisk" | "saveToActiveFile" | "toggleShortcuts" | "wrapSelectionInFrame"> | "saveScene" | "imageExport" | "commandPalette" | "searchMenu" | "toolLock";
+export type ShortcutName = SubtypeOf<ActionName, "toggleTheme" | "loadScene" | "clearCanvas" | "cut" | "copy" | "paste" | "copyStyles" | "pasteStyles" | "selectAll" | "deleteSelectedElements" | "duplicateSelection" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyAsPng" | "group" | "ungroup" | "gridMode" | "zenMode" | "objectsSnapMode" | "stats" | "addToLibrary" | "viewMode" | "flipHorizontal" | "flipVertical" | "hyperlink" | "toggleElementLock" | "resetZoom" | "zoomOut" | "zoomIn" | "zoomToFit" | "zoomToFitSelectionInViewport" | "zoomToFitSelection" | "saveFileToDisk" | "saveToActiveFile" | "toggleShortcuts" | "wrapSelectionInFrame" | "toggleWrap"> | "saveScene" | "imageExport" | "commandPalette" | "searchMenu" | "toolLock";
 export declare const getShortcutFromShortcutName: (name: ShortcutName, idx?: number) => string;

package/dist/types/excalidraw/actions/types.d.ts

@@ -14,7 +14,7 @@ export type ActionResult = {
 type ActionFn<TData = any> = (elements: readonly OrderedExcalidrawElement[], appState: Readonly<AppState>, formData: TData | undefined, app: AppClassProperties) => ActionResult | Promise<ActionResult>;
 export type UpdaterFn = (res: ActionResult) => void;
 export type ActionFilterFn = (action: Action) => void;
-export type ActionName = "copy" | "cut" | "paste" | "copyAsPng" | "copyAsSvg" | "copyText" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyStyles" | "selectAll" | "pasteStyles" | "gridMode" | "zenMode" | "objectsSnapMode" | "arrowBinding" | "midpointSnapping" | "showHints" | "stats" | "changeStrokeColor" | "changeBackgroundColor" | "changeBucketFillBackgroundColor" | "changeFillStyle" | "changeStrokeWidth" | "changeSloppiness" | "changeFreedrawMode" | "changeStrokeStyle" | "changeArrowhead" | "changeArrowType" | "changeArrowProperties" | "changeOpacity" | "changeFontSize" | "undo" | "redo" | "finalize" | "changeProjectName" | "changeExportBackground" | "changeExportEmbedScene" | "changeExportScale" | "saveToActiveFile" | "saveFileToDisk" | "loadScene" | "duplicateSelection" | "deleteSelectedElements" | "changeViewBackgroundColor" | "clearCanvas" | "zoomIn" | "zoomOut" | "resetZoom" | "zoomToFit" | "zoomToFitSelection" | "zoomToFitSelectionInViewport" | "changeFontFamily" | "changeTextAlign" | "changeVerticalAlign" | "toggleFullScreen" | "toggleShortcuts" | "group" | "ungroup" | "goToCollaborator" | "addToLibrary" | "changeRoundness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "deselect" | "viewMode" | "exportWithDarkMode" | "toggleTheme" | "increaseFontSize" | "decreaseFontSize" | "unbindText" | "hyperlink" | "bindText" | "unlockAllElements" | "toggleElementLock" | "toggleLinearEditor" | "selectAllElementsInFrame" | "removeAllElementsFromFrame" | "updateFrameRendering" | "createContainerFromText" | "wrapTextInContainer" | "commandPalette" | "autoResize" | "elementStats" | "searchMenu" | "copyElementLink" | "linkToElement" | "cropEditor" | "wrapSelectionInFrame" | "toggleShapeSwitch" | "togglePolygon";
+export type ActionName = "copy" | "cut" | "paste" | "copyAsPng" | "copyAsSvg" | "copyText" | "sendBackward" | "bringForward" | "sendToBack" | "bringToFront" | "copyStyles" | "selectAll" | "pasteStyles" | "gridMode" | "zenMode" | "objectsSnapMode" | "arrowBinding" | "midpointSnapping" | "showHints" | "stats" | "changeStrokeColor" | "changeBackgroundColor" | "changeBucketFillBackgroundColor" | "changeFillStyle" | "changeStrokeWidth" | "changeSloppiness" | "changeFreedrawMode" | "changeStrokeStyle" | "changeArrowhead" | "changeArrowType" | "changeArrowProperties" | "changeOpacity" | "changeFontSize" | "undo" | "redo" | "finalize" | "changeProjectName" | "changeExportBackground" | "changeExportEmbedScene" | "changeExportScale" | "saveToActiveFile" | "saveFileToDisk" | "loadScene" | "duplicateSelection" | "deleteSelectedElements" | "changeViewBackgroundColor" | "clearCanvas" | "zoomIn" | "zoomOut" | "resetZoom" | "zoomToFit" | "zoomToFitSelection" | "zoomToFitSelectionInViewport" | "changeFontFamily" | "changeTextAlign" | "changeVerticalAlign" | "toggleFullScreen" | "toggleShortcuts" | "group" | "ungroup" | "goToCollaborator" | "addToLibrary" | "changeRoundness" | "alignTop" | "alignBottom" | "alignLeft" | "alignRight" | "alignVerticallyCentered" | "alignHorizontallyCentered" | "distributeHorizontally" | "distributeVertically" | "flipHorizontal" | "flipVertical" | "deselect" | "viewMode" | "exportWithDarkMode" | "toggleTheme" | "increaseFontSize" | "decreaseFontSize" | "unbindText" | "hyperlink" | "bindText" | "unlockAllElements" | "toggleElementLock" | "toggleLinearEditor" | "selectAllElementsInFrame" | "removeAllElementsFromFrame" | "updateFrameRendering" | "createContainerFromText" | "wrapTextInContainer" | "commandPalette" | "autoResize" | "elementStats" | "searchMenu" | "copyElementLink" | "linkToElement" | "cropEditor" | "wrapSelectionInFrame" | "toggleWrap" | "toggleShapeSwitch" | "togglePolygon";
 export type PanelComponentProps = {
     elements: readonly ExcalidrawElement[];
     appState: UIAppState;

package/dist/types/excalidraw/appState.d.ts

@@ -7,12 +7,14 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     zoom?: Readonly<{
         value: NormalizedZoomValue;
     }> | undefined;
-    scrollX?: number | undefined;
-    scrollY?: number | undefined;
-    editingGroupId?: string | null | undefined;
+    isBindingEnabled?: boolean | undefined;
+    isMidpointSnappingEnabled?: boolean | undefined;
     selectedElementIds?: Readonly<{
         [id: string]: true;
     }> | undefined;
+    scrollX?: number | undefined;
+    scrollY?: number | undefined;
+    editingGroupId?: string | null | undefined;
     activeTool?: ({
         lastActiveTool: import("./types").ActiveTool | null;
         locked: boolean;
@@ -22,15 +24,11 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
         [groupId: string]: boolean;
     } | undefined;
     selectedLinearElement?: import("@excalidraw/element").LinearElementEditor | null | undefined;
-    isBindingEnabled?: boolean | undefined;
-    isMidpointSnappingEnabled?: boolean | undefined;
     gridModeEnabled?: boolean | undefined;
     zenModeEnabled?: boolean | undefined;
     shouldCacheIgnoreZoom?: boolean | undefined;
     exportScale?: number | undefined;
     currentItemArrowType?: "round" | "sharp" | "elbow" | undefined;
-    gridSize?: number | undefined;
-    bindMode?: import("@excalidraw/element/types").BindMode | undefined;
     showWelcomeScreen?: boolean | undefined;
     boxSelectionMode?: import("./types").BoxSelectionMode | undefined;
     bindingPreference?: "enabled" | "disabled" | undefined;
@@ -73,6 +71,7 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     previousSelectedElementIds?: {
         [id: string]: true;
     } | undefined;
+    gridSize?: number | undefined;
     gridStep?: number | undefined;
     stats?: {
         open: boolean;
@@ -82,6 +81,7 @@ export declare const clearAppStateForLocalStorage: (appState: Partial<AppState>)
     lockedMultiSelections?: {
         [groupId: string]: true;
     } | undefined;
+    bindMode?: import("@excalidraw/element/types").BindMode | undefined;
     colorTopPicks?: {
         elementStroke: readonly string[] | null;
         elementBackground: readonly string[] | null;

package/dist/types/excalidraw/charts/charts.bar.d.ts

@@ -1,2 +1,3 @@
+import type { RenderEnvironment } from "@excalidraw/element";
 import type { ChartElements, Spreadsheet } from "./charts.types";
-export declare const renderBarChart: (spreadsheet: Spreadsheet, x: number, y: number, colorSeed?: number) => ChartElements;
+export declare const renderBarChart: (spreadsheet: Spreadsheet, x: number, y: number, colorSeed?: number, renderEnvironment?: RenderEnvironment) => ChartElements;

package/dist/types/excalidraw/charts/charts.helpers.d.ts

@@ -1,4 +1,5 @@
 import { getFontString } from "@excalidraw/common";
+import type { RenderEnvironment } from "@excalidraw/element";
 import type { ChartType } from "@excalidraw/element/types";
 import type { NonDeletedExcalidrawElement } from "@excalidraw/element/types";
 import { type CartesianChartLayout, type CartesianChartType } from "./charts.constants";
@@ -20,13 +21,13 @@ export declare const getRadarValueScale: (series: SpreadsheetSeries[], _labelsLe
     renderSteps: boolean;
     normalize: (value: number, _axisIndex: number) => number;
 };
-export declare const getRadarDisplayText: (text: string, fontString: ReturnType<typeof getFontString>, maxWidth: number) => string;
-export declare const createRadarAxisLabels: (labels: readonly string[], angles: readonly number[], centerX: number, centerY: number, radius: number, backgroundColor: string) => {
+export declare const getRadarDisplayText: (text: string, fontString: ReturnType<typeof getFontString>, maxWidth: number, renderEnvironment?: RenderEnvironment) => string;
+export declare const createRadarAxisLabels: (labels: readonly string[], angles: readonly number[], centerX: number, centerY: number, radius: number, backgroundColor: string, renderEnvironment?: RenderEnvironment) => {
     axisLabels: ChartElements;
     axisLabelTopY: number;
     axisLabelBottomY: number;
 };
-export declare const createSeriesLegend: (series: SpreadsheetSeries[], seriesColors: readonly string[], centerX: number, minLegendTopY: number, fallbackLegendY: number, backgroundColor: string) => ChartElements;
+export declare const createSeriesLegend: (series: SpreadsheetSeries[], seriesColors: readonly string[], centerX: number, minLegendTopY: number, fallbackLegendY: number, backgroundColor: string, renderEnvironment?: RenderEnvironment) => ChartElements;
 export declare const getRotatedTextElementBottom: (element: NonDeletedExcalidrawElement) => number;
-export declare const chartXLabels: (spreadsheet: Spreadsheet, x: number, y: number, backgroundColor: string, layout: CartesianChartLayout) => ChartElements;
-export declare const chartBaseElements: (spreadsheet: Spreadsheet, x: number, y: number, backgroundColor: string, layout: CartesianChartLayout, maxValue?: number, debug?: boolean) => ChartElements;
+export declare const chartXLabels: (spreadsheet: Spreadsheet, x: number, y: number, backgroundColor: string, layout: CartesianChartLayout, renderEnvironment?: RenderEnvironment) => ChartElements;
+export declare const chartBaseElements: (spreadsheet: Spreadsheet, x: number, y: number, backgroundColor: string, layout: CartesianChartLayout, maxValue?: number, debug?: boolean, renderEnvironment?: RenderEnvironment) => ChartElements;

package/dist/types/excalidraw/charts/charts.line.d.ts

@@ -1,2 +1,3 @@
+import type { RenderEnvironment } from "@excalidraw/element";
 import type { ChartElements, Spreadsheet } from "./charts.types";
-export declare const renderLineChart: (spreadsheet: Spreadsheet, x: number, y: number, colorSeed?: number) => ChartElements;
+export declare const renderLineChart: (spreadsheet: Spreadsheet, x: number, y: number, colorSeed?: number, renderEnvironment?: RenderEnvironment) => ChartElements;

package/dist/types/excalidraw/charts/charts.radar.d.ts

@@ -1,2 +1,3 @@
+import type { RenderEnvironment } from "@excalidraw/element";
 import type { ChartElements, Spreadsheet } from "./charts.types";
-export declare const renderRadarChart: (spreadsheet: Spreadsheet, x: number, y: number, colorSeed?: number) => ChartElements | null;
+export declare const renderRadarChart: (spreadsheet: Spreadsheet, x: number, y: number, colorSeed?: number, renderEnvironment?: RenderEnvironment) => ChartElements | null;

package/dist/types/excalidraw/charts/index.d.ts

@@ -1,7 +1,8 @@
 import type { ChartType } from "@excalidraw/element/types";
+import type { RenderEnvironment } from "@excalidraw/element";
 import { tryParseCells, tryParseNumber, tryParseSpreadsheet } from "./charts.parse";
 import type { ChartElements, Spreadsheet } from "./charts.types";
 export { type ParseSpreadsheetResult, type Spreadsheet, type SpreadsheetSeries, type ChartElements, } from "./charts.types";
 export { isSpreadsheetValidForChartType } from "./charts.helpers";
 export { tryParseCells, tryParseNumber, tryParseSpreadsheet };
-export declare const renderSpreadsheet: (chartType: ChartType, spreadsheet: Spreadsheet, x: number, y: number, colorSeed?: number) => ChartElements | null;
+export declare const renderSpreadsheet: (chartType: ChartType, spreadsheet: Spreadsheet, x: number, y: number, colorSeed?: number, renderEnvironment?: RenderEnvironment) => ChartElements | null;

package/dist/types/excalidraw/components/App.d.ts

@@ -2,7 +2,7 @@ import React from "react";
 import { AppEventBus, type EXPORT_IMAGE_TYPES, Emitter, type EditorInterface, type StylesPanelMode } from "@excalidraw/common";
 import { LinearElementEditor, Scene, Store, type ElementUpdate, StoreDelta, type ApplyToOptions } from "@excalidraw/element";
 import type { ExcalidrawElement, NonDeleted, NonDeletedExcalidrawElement, ExcalidrawFrameLikeElement, ExcalidrawIframeElement, ExcalidrawEmbeddableElement, Ordered, SceneElementsMap } from "@excalidraw/element/types";
-import type { TransformHandleDirection } from "@excalidraw/element";
+import type { RenderEnvironment, TransformHandleDirection } from "@excalidraw/element";
 import type { Mutable } from "@excalidraw/common/utility-types";
 import { ActionManager } from "../actions/manager";
 import { History } from "../history";
@@ -24,9 +24,14 @@ import { AppCursor } from "./App.cursor";
 import { AppDrawShape } from "./App.drawshape";
 import { AppDuplicate } from "./App.duplicate";
 import { AppFlowchart } from "./App.flowchart";
+import { AppModifiers } from "./App.modifiers";
 import { AppPan } from "./App.pan";
 import { AppViewport } from "./App.viewport";
 import { AppWheel } from "./App.wheel";
+import { AppSelection } from "./App.selection";
+import { AppSelectionTool } from "./App.selectionTool";
+import { AppWrap } from "./App.wrap";
+import { AppHost } from "./App.host";
 import { CursorHints } from "./CursorHint";
 import { type OnStateChange } from "./AppStateObserver";
 import type { ExportedElements } from "../data";
@@ -92,6 +97,14 @@ declare class App extends React.Component<AppProps, AppState> {
     private zenModeTransitionTimer;
     get ownerDocument(): Document;
     get ownerWindow(): Window & typeof globalThis;
+    /**
+     * Everything binding this editor to the document/window it renders into
+     * (render environment, hyperlink tooltip ownership). Delegated to so the
+     * cross-document ownership rules live in one place.
+     */
+    host: AppHost;
+    /** @see AppHost.renderEnvironment */
+    get renderEnvironment(): RenderEnvironment;
     scene: Scene;
     fonts: Fonts;
     renderer: Renderer;
@@ -140,6 +153,9 @@ declare class App extends React.Component<AppProps, AppState> {
     text: AppText;
     viewport: AppViewport;
     wheel: AppWheel;
+    selection: AppSelection;
+    selectionTool: AppSelectionTool;
+    wrap: AppWrap;
     bindModeHandler: ReturnType<typeof setTimeout> | null;
     hitLinkElement?: NonDeletedExcalidrawElement;
     lastPointerDownEvent: React.PointerEvent<HTMLElement> | null;
@@ -159,11 +175,6 @@ declare class App extends React.Component<AppProps, AppState> {
         y: number;
     } | null;
     private lastCompletedCanvasClicks;
-    /** previous frame pointer coords */
-    previousPointerMoveCoords: {
-        x: number;
-        y: number;
-    } | null;
     drawShape: AppDrawShape;
     laserTrails: LaserTrails;
     eraserTrail: EraserTrail;
@@ -206,6 +217,7 @@ declare class App extends React.Component<AppProps, AppState> {
             element: NonDeleted<ExcalidrawElement> | null;
             allHitElements: NonDeleted<ExcalidrawElement>[];
             wasAddedToSelection: boolean;
+            cycleTarget: NonDeleted<ExcalidrawElement> | null;
             hasBeenDuplicated: boolean;
             advancedListMarkers: readonly import("@excalidraw/element").ListMarkerAdvance[];
             editedTextId: import("@excalidraw/element/types").ExcalidrawTextElement["id"] | null;
@@ -223,6 +235,10 @@ declare class App extends React.Component<AppProps, AppState> {
                 x: number;
                 y: number;
             };
+            lastOffset: {
+                x: number;
+                y: number;
+            };
             blockDragging: boolean;
         };
         eventListeners: {
@@ -271,6 +287,7 @@ declare class App extends React.Component<AppProps, AppState> {
             element: NonDeleted<ExcalidrawElement> | null;
             allHitElements: NonDeleted<ExcalidrawElement>[];
             wasAddedToSelection: boolean;
+            cycleTarget: NonDeleted<ExcalidrawElement> | null;
             hasBeenDuplicated: boolean;
             advancedListMarkers: readonly import("@excalidraw/element").ListMarkerAdvance[];
             editedTextId: import("@excalidraw/element/types").ExcalidrawTextElement["id"] | null;
@@ -288,6 +305,10 @@ declare class App extends React.Component<AppProps, AppState> {
                 x: number;
                 y: number;
             };
+            lastOffset: {
+                x: number;
+                y: number;
+            };
             blockDragging: boolean;
         };
         eventListeners: {
@@ -306,6 +327,7 @@ declare class App extends React.Component<AppProps, AppState> {
     }>]>;
     missingPointerEventCleanupEmitter: Emitter<[event: PointerEvent | null]>;
     onRemoveEventListenersEmitter: Emitter<[]>;
+    modifiers: AppModifiers;
     api: ExcalidrawImperativeAPI;
     private elementRenderOverrides;
     /** offsets of `elementRenderOverrides`; keeps its identity while they don't change */
@@ -604,7 +626,6 @@ declare class App extends React.Component<AppProps, AppState> {
     private onGestureStart;
     private onGestureChange;
     private onGestureEnd;
-    deselectElements(): void;
     getElementAtPosition(x: number, y: number, opts?: ({
         includeBoundTextElement?: boolean;
         includeLockedElements?: boolean;
@@ -625,11 +646,14 @@ declare class App extends React.Component<AppProps, AppState> {
     getElementHitThreshold(element: ExcalidrawElement): number;
     hitElement(x: number, y: number, element: NonDeletedExcalidrawElement, considerBoundingBox?: boolean): boolean;
     private startImageCropping;
-    private finishImageCropping;
+    finishImageCropping: () => void;
     private shouldHandleBrowserCanvasDoubleClick;
     private handleCanvasDoubleClick;
     private handleCanvasClick;
-    private getElementLinkAtPosition;
+    getElementLinkAtPosition: (scenePointer: Readonly<{
+        x: number;
+        y: number;
+    }>, hitElementMightBeLocked: NonDeletedExcalidrawElement | null) => NonDeletedExcalidrawElement | undefined;
     private handleElementLinkClick;
     /**
      * Applies (or clears) the element-link hover affordances — pointer cursor
@@ -669,7 +693,7 @@ declare class App extends React.Component<AppProps, AppState> {
         excludeElementIds?: AppState["selectedElementIds"];
         currentFrameId?: ExcalidrawElement["frameId"];
     }) => NonDeleted<ExcalidrawFrameLikeElement> | null;
-    private updateFrameToHighlight;
+    updateFrameToHighlight: (frameToHighlight: AppState["frameToHighlight"]) => void;
     private maybeUpdateFrameToHighlightOnPointerMove;
     insertNewElements: (elements: readonly ExcalidrawElement[]) => void;
     insertNewElement: (element: ExcalidrawElement) => void;
@@ -706,13 +730,6 @@ declare class App extends React.Component<AppProps, AppState> {
     private updateMultiTouchGesture;
     private initialPointerDownState;
     private handleDraggingScrollBar;
-    private clearSelectionIfNotUsingSelection;
-    /**
-     * @returns whether the pointer event has been completely handled
-     */
-    private handleSelectionOnPointerDown;
-    private isASelectedElement;
-    private isHittingCommonBoundingBoxOfSelectedElements;
     private handleFreeDrawElementOnPointerDown;
     insertIframeElement: ({ sceneX, sceneY, width, height, }: {
         sceneX: number;
@@ -759,7 +776,6 @@ declare class App extends React.Component<AppProps, AppState> {
     /** generally you should use `addNewImagesToImageCache()` directly if you need
      *  to render new images. This is just a failsafe  */
     private scheduleImageRefresh;
-    private clearSelection;
     private handleInteractiveCanvasRef;
     insertImages: (imageFiles: File[], sceneX: number, sceneY: number) => Promise<void>;
     private handleAppOnDrop;
@@ -777,8 +793,6 @@ declare class App extends React.Component<AppProps, AppState> {
         pointerType?: string;
     }) => void;
     maybeDragNewGenericElement: (pointerDownState: PointerDownState, event: MouseEvent | KeyboardEvent, informMutation?: boolean) => void;
-    private maybeHandleCrop;
-    private maybeHandleResize;
     private getContextMenuItems;
     savePointer: (x: number, y: number, button: "up" | "down") => void;
     resetShouldCacheIgnoreZoomDebounced: {

package/dist/types/excalidraw/components/App.host.d.ts

@@ -0,0 +1,102 @@
+import type { RenderEnvironment } from "@excalidraw/element";
+import { type EyeDropperProperties } from "./EyeDropper";
+import { type HyperlinkTooltipOwner } from "./hyperlink/Hyperlink";
+import type { AppProps } from "../types";
+import type App from "./App";
+/**
+ * Owns everything that ties this editor to the document/window it renders
+ * into (cross-document runtime ownership): the render environment the
+ * canvases, images and paths are minted from, and the state that has to be
+ * re-primed whenever that environment is swapped.
+ */
+export declare class AppHost {
+    private app;
+    constructor(app: App);
+    /**
+     * Identity token for the hyperlink tooltip, which is a module-level
+     * singleton shared by every editor in the process — the owner tells it
+     * which editor the currently shown tooltip belongs to, so one editor never
+     * hides (or leaks a timer into) another's tooltip.
+     */
+    readonly hyperlinkTooltipOwner: HyperlinkTooltipOwner;
+    /**
+     * The process-wide interaction slots this editor currently owns: the
+     * pointerup handler of the interaction in flight, and the eye dropper (one
+     * atom in the editor-wide store). Both hold closures over this editor, so a
+     * teardown that leaves one set retains the editor -- and with it its owner
+     * window and document, e.g. a closed popout.
+     *
+     * @see releaseOwnedInteractionState
+     */
+    private ownedPointerUp;
+    private ownedEyeDropper;
+    /** Takes over the pointerup slot (or clears it, on `null`). */
+    setPointerUp(handler: (() => void) | null): void;
+    /**
+     * Runs the pending pointerup, whoever owns it -- pointerup does not always
+     * fire (the user tabs away), so interactions are settled manually.
+     */
+    runPendingPointerUp(): void;
+    /** Opens the eye dropper (or closes it, on `null`), taking ownership. */
+    setActiveEyeDropper(eyeDropper: EyeDropperProperties | null): void;
+    /**
+     * Drops the ownership token without touching the atom -- for callers that
+     * have just closed the eye dropper themselves.
+     */
+    releaseEyeDropperOwnership(): void;
+    /**
+     * Releases the process-wide slots this editor owns, so nothing outside it
+     * keeps it alive once it is torn down. Ownership-checked: a sibling
+     * editor's in-flight interaction must survive our teardown.
+     */
+    private releaseOwnedInteractionState;
+    /**
+     * Render environment scoped to this editor's owner window, so that the
+     * canvases, images and paths created during rendering live in the owner
+     * document. Memoized keyed on the resolved document because render caches
+     * are keyed by environment identity: the identity must not survive a
+     * document switch, or caches would mix canvases and images from two realms
+     * under one bucket.
+     */
+    private _renderEnvironment;
+    private _renderEnvironmentDocument;
+    get renderEnvironment(): RenderEnvironment;
+    /**
+     * Re-primes whatever the render environment owns. Called on mount and on
+     * every update, so an environment swap is picked up wherever it happens.
+     */
+    sync(prevProps?: AppProps): void;
+    /**
+     * Releases what this editor owns outside itself, so we don't retain the
+     * (soon detached) document/window, or leave a pending tooltip timer around.
+     */
+    destroy(): void;
+    private _destroyed;
+    /**
+     * Link icons decode asynchronously and the static scene skips an icon that
+     * is not decoded yet, so start the decode on mount rather than on the
+     * first render that happens to have a link, so the decode is settled long
+     * before there is a link element to draw an icon for.
+     *
+     * Re-run on an environment swap: the images are keyed by env identity, so
+     * a new environment starts with none.
+     *
+     * The decode landing only flips a status, which invalidates nothing, so the
+     * scene is nudged once when an icon becomes drawable -- otherwise a scene
+     * that paints before the decode settles and is then left alone (an initial
+     * scene with links, never scrolled or edited) keeps its icons missing until
+     * something unrelated repaints. Same shape as a font or an image file
+     * landing: repaint only when there is something new to draw.
+     */
+    private _linkImgDecodingEnvironment;
+    private ensureLinkImgDecoding;
+    /**
+     * Every render cache is keyed by environment identity, so a host passing an
+     * inline `renderEnvironment` literal re-mints the identity on each render
+     * and re-rasterizes everything, with no visible symptom other than being
+     * slow. Detected by the factories' source being unchanged across the swap:
+     * a genuine environment switch (e.g. a document change) reads differently.
+     */
+    private _warnedUnstableRenderEnvironment;
+    private warnOnUnstableRenderEnvironment;
+}

package/dist/types/excalidraw/components/App.modifiers.d.ts

@@ -0,0 +1,38 @@
+import { Emitter } from "@excalidraw/common";
+export type HeldModifiers = Readonly<{
+    alt: boolean;
+    shift: boolean;
+    /** Ctrl, or Cmd on macOS */
+    ctrlOrCmd: boolean;
+}>;
+/**
+ * The modifier keys held over the editor, synced from the flags of its
+ * keyboard and pointer events. Kept out of appState so that pressing one
+ * re-renders only its subscribers (e.g. the hint).
+ */
+export declare class AppModifiers {
+    private held;
+    /** fires with a new snapshot whenever a modifier is pressed or released */
+    readonly onChange: Emitter<[held: Readonly<{
+        alt: boolean;
+        shift: boolean;
+        /** Ctrl, or Cmd on macOS */
+        ctrlOrCmd: boolean;
+    }>]>;
+    get: () => HeldModifiers;
+    /**
+     * A hook re-rendering on the held modifiers: all of them, or with
+     * `modifier`, only on that one being pressed or released.
+     */
+    useHeld(): HeldModifiers;
+    useHeld(modifier: keyof HeldModifiers): boolean;
+    sync: (event: {
+        altKey: boolean;
+        shiftKey: boolean;
+        ctrlKey: boolean;
+        metaKey: boolean;
+    }) => void;
+    /** releases them all — e.g. on blur, as Alt+Tab never delivers the keyup */
+    reset: () => void;
+    private set;
+}