@excalidraw/excalidraw 0.17.1-88812e0 → 0.17.1-96eeec5

package/dist/excalidraw/components/App.js

@@ -10,13 +10,14 @@ import { ActionManager } from "../actions/manager";
 import { actions } from "../actions/register";
 import { trackEvent } from "../analytics";
 import { getDefaultAppState, isEraserActive, isHandToolActive, } from "../appState";
-import { copyTextToSystemClipboard, parseClipboard, } from "../clipboard";
-import { APP_NAME, CURSOR_TYPE, DEFAULT_MAX_IMAGE_WIDTH_OR_HEIGHT, DEFAULT_VERTICAL_ALIGN, DRAGGING_THRESHOLD, ELEMENT_SHIFT_TRANSLATE_AMOUNT, ELEMENT_TRANSLATE_AMOUNT, ENV, EVENT, FRAME_STYLE, GRID_SIZE, IMAGE_MIME_TYPES, IMAGE_RENDER_TIMEOUT, isBrave, LINE_CONFIRM_THRESHOLD, MAX_ALLOWED_FILE_BYTES, MIME_TYPES, MQ_MAX_HEIGHT_LANDSCAPE, MQ_MAX_WIDTH_LANDSCAPE, MQ_MAX_WIDTH_PORTRAIT, MQ_RIGHT_SIDEBAR_MIN_WIDTH, POINTER_BUTTON, ROUNDNESS, SCROLL_TIMEOUT, TAP_TWICE_TIMEOUT, TEXT_TO_CENTER_SNAP_THRESHOLD, THEME, THEME_FILTER, TOUCH_CTX_MENU_TIMEOUT, VERTICAL_ALIGN, YOUTUBE_STATES, ZOOM_STEP, POINTER_EVENTS, TOOL_TYPE, EDITOR_LS_KEYS, isIOS, supportsResizeObserver, DEFAULT_COLLISION_THRESHOLD, } from "../constants";
+import { copyTextToSystemClipboard, parseClipboard } from "../clipboard";
+import { DEFAULT_FONT_SIZE } from "../constants";
+import { APP_NAME, CURSOR_TYPE, DEFAULT_MAX_IMAGE_WIDTH_OR_HEIGHT, DEFAULT_VERTICAL_ALIGN, DRAGGING_THRESHOLD, ELEMENT_SHIFT_TRANSLATE_AMOUNT, ELEMENT_TRANSLATE_AMOUNT, ENV, EVENT, FRAME_STYLE, GRID_SIZE, IMAGE_MIME_TYPES, IMAGE_RENDER_TIMEOUT, isBrave, LINE_CONFIRM_THRESHOLD, MAX_ALLOWED_FILE_BYTES, MIME_TYPES, MQ_MAX_HEIGHT_LANDSCAPE, MQ_MAX_WIDTH_LANDSCAPE, MQ_MAX_WIDTH_PORTRAIT, MQ_RIGHT_SIDEBAR_MIN_WIDTH, POINTER_BUTTON, ROUNDNESS, SCROLL_TIMEOUT, TAP_TWICE_TIMEOUT, TEXT_TO_CENTER_SNAP_THRESHOLD, THEME, THEME_FILTER, TOUCH_CTX_MENU_TIMEOUT, VERTICAL_ALIGN, YOUTUBE_STATES, ZOOM_STEP, POINTER_EVENTS, TOOL_TYPE, EDITOR_LS_KEYS, isIOS, supportsResizeObserver, DEFAULT_COLLISION_THRESHOLD, DEFAULT_TEXT_ALIGN, } from "../constants";
 import { exportCanvas, loadFromBlob } from "../data";
 import Library, { distributeLibraryItemsOnSquareGrid } from "../data/library";
 import { restore, restoreElements } from "../data/restore";
-import { dragNewElement, dragSelectedElements, duplicateElement, getCommonBounds, getCursorForResizingElement, getDragOffsetXY, getElementWithTransformHandleType, getNormalizedDimensions, getResizeArrowDirection, getResizeOffsetXY, getLockedLinearCursorAlignSize, getTransformHandleTypeFromCoords, isInvisiblySmallElement, isNonDeletedElement, isTextElement, newElement, newLinearElement, newTextElement, newImageElement, transformElements, updateTextElement, redrawTextBoundingBox, getElementAbsoluteCoords, } from "../element";
-import { bindOrUnbindLinearElement, bindOrUnbindSelectedElements, fixBindingsAfterDeletion, fixBindingsAfterDuplication, getEligibleElementsForBinding, getHoveredElementForBinding, isBindingEnabled, isLinearElementSimpleAndAlreadyBound, maybeBindLinearElement, shouldEnableBindingForPointerEvent, unbindLinearElements, updateBoundElements, } from "../element/binding";
+import { dragNewElement, dragSelectedElements, duplicateElement, getCommonBounds, getCursorForResizingElement, getDragOffsetXY, getElementWithTransformHandleType, getNormalizedDimensions, getResizeArrowDirection, getResizeOffsetXY, getLockedLinearCursorAlignSize, getTransformHandleTypeFromCoords, isInvisiblySmallElement, isNonDeletedElement, isTextElement, newElement, newLinearElement, newTextElement, newImageElement, transformElements, refreshTextDimensions, redrawTextBoundingBox, getElementAbsoluteCoords, } from "../element";
+import { bindOrUnbindLinearElement, bindOrUnbindLinearElements, fixBindingsAfterDeletion, fixBindingsAfterDuplication, getHoveredElementForBinding, isBindingEnabled, isLinearElementSimpleAndAlreadyBound, maybeBindLinearElement, shouldEnableBindingForPointerEvent, updateBoundElements, getSuggestedBindingsForArrows, } from "../element/binding";
 import { LinearElementEditor } from "../element/linearElementEditor";
 import { mutateElement, newElementWith } from "../element/mutateElement";
 import { deepCopyElement, duplicateElements, newFrameElement, newFreeDrawElement, newEmbeddableElement, newMagicFrameElement, newIframeElement, } from "../element/newElement";
@@ -31,12 +32,12 @@ import { distance2d, getCornerRadius, getGridPoint, isPathALoop, } from "../math
 import { calculateScrollCenter, getElementsWithinSelection, getNormalizedZoom, getSelectedElements, hasBackground, isSomeElementSelected, } from "../scene";
 import Scene from "../scene/Scene";
 import { getStateForZoom } from "../scene/zoom";
-import { findShapeByKey } from "../shapes";
-import { getClosedCurveShape, getCurveShape, getEllipseShape, getFreedrawShape, getPolygonShape, getSelectionBoxShape, } from "../../utils/geometry/shape";
+import { findShapeByKey, getElementShape } from "../shapes";
+import { getSelectionBoxShape } from "../../utils/geometry/shape";
 import { isPointInShape } from "../../utils/collision";
 import { debounce, distance, getFontString, getNearestScrollableContainer, isInputLike, isToolIcon, isWritableElement, sceneCoordsToViewportCoords, tupleToCoors, viewportCoordsToSceneCoords, wrapEvent, updateObject, updateActiveTool, getShortcutKey, isTransparent, easeToValuesRAF, muteFSAbortError, isTestEnv, easeOut, updateStable, addEventListener, normalizeEOL, getDateTime, isShallowEqual, arrayToMap, } from "../utils";
 import { createSrcDoc, embeddableURLValidator, maybeParseEmbedSrc, getEmbedLink, } from "../element/embeddable";
-import { ContextMenu, CONTEXT_MENU_SEPARATOR, } from "./ContextMenu";
+import { ContextMenu, CONTEXT_MENU_SEPARATOR } from "./ContextMenu";
 import LayerUI from "./LayerUI";
 import { Toast } from "./Toast";
 import { actionToggleViewMode } from "../actions/actionToggleViewMode";
@@ -44,7 +45,7 @@ import { dataURLToFile, generateIdFromFile, getDataURL, getFileFromEvent, ImageU
 import { getInitializedImageElements, loadHTMLImageElement, normalizeSVG, updateImageCache as _updateImageCache, } from "../element/image";
 import throttle from "lodash.throttle";
 import { fileOpen } from "../data/filesystem";
-import { bindTextToShapeAfterDuplication, getApproxMinLineHeight, getApproxMinLineWidth, getBoundTextElement, getContainerCenter, getContainerElement, getDefaultLineHeight, getLineHeightInPx, isMeasureTextSupported, isValidTextContainer, } from "../element/textElement";
+import { bindTextToShapeAfterDuplication, getApproxMinLineHeight, getApproxMinLineWidth, getBoundTextElement, getContainerCenter, getContainerElement, getDefaultLineHeight, getLineHeightInPx, getMinTextElementWidth, isMeasureTextSupported, isValidTextContainer, measureText, wrapText, } from "../element/textElement";
 import { showHyperlinkTooltip, hideHyperlinkToolip, Hyperlink, } from "../components/hyperlink/Hyperlink";
 import { isLocalLink, normalizeLink, toValidURL } from "../data/url";
 import { shouldShowBoundingBox } from "../element/transformHandles";
@@ -62,7 +63,7 @@ import { getSnapLinesAtPointer, snapDraggedElements, isActiveToolNonLinearSnappa
 import { actionWrapTextInContainer } from "../actions/actionBoundText";
 import BraveMeasureTextError from "./BraveMeasureTextError";
 import { activeEyeDropperAtom } from "./EyeDropper";
-import { convertToExcalidrawElements, } from "../data/transform";
+import { convertToExcalidrawElements } from "../data/transform";
 import { isSidebarDockedAtom } from "./Sidebar/Sidebar";
 import { StaticCanvas, InteractiveCanvas } from "./canvases";
 import { Renderer } from "../scene/Renderer";
@@ -84,12 +85,15 @@ import { AnimatedTrail } from "../animated-trail";
 import { LaserTrails } from "../laser-trails";
 import { withBatchedUpdates, withBatchedUpdatesThrottled } from "../reactUtils";
 import { getRenderOpacity } from "../renderer/renderElement";
-import { hitElementBoundText, hitElementBoundingBoxOnly, hitElementItself, shouldTestInside, } from "../element/collision";
+import { hitElementBoundText, hitElementBoundingBoxOnly, hitElementItself, } from "../element/collision";
 import { textWysiwyg } from "../element/textWysiwyg";
 import { isOverScrollBars } from "../scene/scrollbars";
 import { syncInvalidIndices, syncMovedIndices } from "../fractionalIndex";
 import { isPointHittingLink, isPointHittingLinkIcon, } from "./hyperlink/helpers";
 import { getShortcutFromShortcutName } from "../actions/shortcuts";
+import { actionTextAutoResize } from "../actions/actionTextAutoResize";
+import { getVisibleSceneBounds } from "../element/bounds";
+import { isMaybeMermaidDefinition } from "../mermaid";
 const AppContext = React.createContext(null);
 const AppPropsContext = React.createContext(null);
 const deviceContextInitialValue = {
@@ -286,10 +290,7 @@ class App extends React.Component {
             container: this.excalidrawContainerRef.current,
             id: this.id,
         };
-        this.fonts = new Fonts({
-            scene: this.scene,
-            onSceneUpdated: this.onSceneUpdated,
-        });
+        this.fonts = new Fonts({ scene: this.scene });
         this.history = new History();
         this.actionManager.registerAll(actions);
         this.actionManager.registerAction(createUndoAction(this.history, this.store));
@@ -444,7 +445,7 @@ class App extends React.Component {
             return false;
         });
         if (updated) {
-            this.scene.informMutation();
+            this.scene.triggerUpdate();
         }
         // GC
         this.iFrameRefs.forEach((ref, id) => {
@@ -803,9 +804,9 @@ class App extends React.Component {
     render() {
         const selectedElements = this.scene.getSelectedElements(this.state);
         const { renderTopRightUI, renderCustomStats } = this.props;
-        const versionNonce = this.scene.getVersionNonce();
+        const sceneNonce = this.scene.getSceneNonce();
         const { elementsMap, visibleElements } = this.renderer.getRenderableElements({
-            versionNonce,
+            sceneNonce,
             zoom: this.state.zoom,
             offsetLeft: this.state.offsetLeft,
             offsetTop: this.state.offsetTop,
@@ -874,14 +875,14 @@ class App extends React.Component {
                                                                 this.focusContainer();
                                                                 callback?.();
                                                             });
-                                                        } })), _jsx(StaticCanvas, { canvas: this.canvas, rc: this.rc, elementsMap: elementsMap, allElementsMap: allElementsMap, visibleElements: visibleElements, versionNonce: versionNonce, selectionNonce: this.state.selectionElement?.versionNonce, scale: window.devicePixelRatio, appState: this.state, renderConfig: {
+                                                        } })), _jsx(StaticCanvas, { canvas: this.canvas, rc: this.rc, elementsMap: elementsMap, allElementsMap: allElementsMap, visibleElements: visibleElements, sceneNonce: sceneNonce, selectionNonce: this.state.selectionElement?.versionNonce, scale: window.devicePixelRatio, appState: this.state, renderConfig: {
                                                             imageCache: this.imageCache,
                                                             isExporting: false,
                                                             renderGrid: true,
                                                             canvasBackgroundColor: this.state.viewBackgroundColor,
                                                             embedsValidationStatus: this.embedsValidationStatus,
                                                             elementsPendingErasure: this.elementsPendingErasure,
-                                                        } }), _jsx(InteractiveCanvas, { containerRef: this.excalidrawContainerRef, canvas: this.interactiveCanvas, elementsMap: elementsMap, visibleElements: visibleElements, selectedElements: selectedElements, versionNonce: versionNonce, selectionNonce: this.state.selectionElement?.versionNonce, scale: window.devicePixelRatio, appState: this.state, device: this.device, renderInteractiveSceneCallback: this.renderInteractiveSceneCallback, handleCanvasRef: this.handleInteractiveCanvasRef, onContextMenu: this.handleCanvasContextMenu, onPointerMove: this.handleCanvasPointerMove, onPointerUp: this.handleCanvasPointerUp, onPointerCancel: this.removePointer, onTouchMove: this.handleTouchMove, onPointerDown: this.handleCanvasPointerDown, onDoubleClick: this.handleCanvasDoubleClick }), this.state.userToFollow && (_jsx(FollowMode, { width: this.state.width, height: this.state.height, userToFollow: this.state.userToFollow, onDisconnect: this.maybeUnfollowRemoteUser })), this.renderFrameNames()] }), this.renderEmbeddables()] }) }) }) }) }) }) }) }));
+                                                        } }), _jsx(InteractiveCanvas, { containerRef: this.excalidrawContainerRef, canvas: this.interactiveCanvas, elementsMap: elementsMap, visibleElements: visibleElements, allElementsMap: allElementsMap, selectedElements: selectedElements, sceneNonce: sceneNonce, selectionNonce: this.state.selectionElement?.versionNonce, scale: window.devicePixelRatio, appState: this.state, device: this.device, renderInteractiveSceneCallback: this.renderInteractiveSceneCallback, handleCanvasRef: this.handleInteractiveCanvasRef, onContextMenu: this.handleCanvasContextMenu, onPointerMove: this.handleCanvasPointerMove, onPointerUp: this.handleCanvasPointerUp, onPointerCancel: this.removePointer, onTouchMove: this.handleTouchMove, onPointerDown: this.handleCanvasPointerDown, onDoubleClick: this.handleCanvasDoubleClick }), this.state.userToFollow && (_jsx(FollowMode, { width: this.state.width, height: this.state.height, userToFollow: this.state.userToFollow, onDisconnect: this.maybeUnfollowRemoteUser })), this.renderFrameNames()] }), this.renderEmbeddables()] }) }) }) }) }) }) }) }));
     }
     focusContainer = () => {
         this.excalidrawContainerRef.current?.focus();
@@ -931,7 +932,7 @@ class App extends React.Component {
             mutateElement(frameElement, { customData: { generationData: data } }, false);
         }
         this.magicGenerations.set(frameElement.id, data);
-        this.onSceneUpdated();
+        this.triggerRender();
     };
     getTextFromElements(elements) {
         const text = elements
@@ -1184,6 +1185,13 @@ class App extends React.Component {
         if (this.unmounted || actionResult === false) {
             return;
         }
+        if (actionResult.storeAction === StoreAction.UPDATE) {
+            this.store.shouldUpdateSnapshot();
+        }
+        else if (actionResult.storeAction === StoreAction.CAPTURE) {
+            this.store.shouldCaptureIncrement();
+        }
+        let didUpdate = false;
         let editingElement = null;
         if (actionResult.elements) {
             actionResult.elements.forEach((element) => {
@@ -1193,13 +1201,8 @@ class App extends React.Component {
                     editingElement = element;
                 }
             });
-            if (actionResult.storeAction === StoreAction.UPDATE) {
-                this.store.shouldUpdateSnapshot();
-            }
-            else if (actionResult.storeAction === StoreAction.CAPTURE) {
-                this.store.shouldCaptureIncrement();
-            }
             this.scene.replaceAllElements(actionResult.elements);
+            didUpdate = true;
         }
         if (actionResult.files) {
             this.files = actionResult.replaceFiles
@@ -1208,12 +1211,6 @@ class App extends React.Component {
             this.addNewImagesToImageCache();
         }
         if (actionResult.appState || editingElement || this.state.contextMenu) {
-            if (actionResult.storeAction === StoreAction.UPDATE) {
-                this.store.shouldUpdateSnapshot();
-            }
-            else if (actionResult.storeAction === StoreAction.CAPTURE) {
-                this.store.shouldCaptureIncrement();
-            }
             let viewModeEnabled = actionResult?.appState?.viewModeEnabled || false;
             let zenModeEnabled = actionResult?.appState?.zenModeEnabled || false;
             let gridSize = actionResult?.appState?.gridSize || null;
@@ -1252,6 +1249,10 @@ class App extends React.Component {
                     errorMessage,
                 });
             });
+            didUpdate = true;
+        }
+        if (!didUpdate && actionResult.storeAction !== StoreAction.NONE) {
+            this.scene.triggerUpdate();
         }
     });
     // Lifecycle
@@ -1304,7 +1305,12 @@ class App extends React.Component {
         }
         let initialData = null;
         try {
-            initialData = (await this.props.initialData) || null;
+            if (typeof this.props.initialData === "function") {
+                initialData = (await this.props.initialData()) || null;
+            }
+            else {
+                initialData = (await this.props.initialData) || null;
+            }
             if (initialData?.libraryItems) {
                 this.library
                     .updateLibrary({
@@ -1441,7 +1447,7 @@ class App extends React.Component {
         this.store.onStoreIncrementEmitter.on((increment) => {
             this.history.record(increment.elementsChange, increment.appStateChange);
         });
-        this.scene.addCallback(this.onSceneUpdated);
+        this.scene.onUpdate(this.triggerRender);
         this.addEventListeners();
         if (this.props.autoFocus && this.excalidrawContainerRef.current) {
             this.focusContainer();
@@ -1477,15 +1483,17 @@ class App extends React.Component {
         }
     }
     componentWillUnmount() {
+        window.launchQueue?.setConsumer(() => { });
         this.renderer.destroy();
+        this.scene.destroy();
         this.scene = new Scene();
+        this.fonts = new Fonts({ scene: this.scene });
         this.renderer = new Renderer(this.scene);
         this.files = {};
         this.imageCache.clear();
         this.resizeObserver?.disconnect();
         this.unmounted = true;
         this.removeEventListeners();
-        this.scene.destroy();
         this.library.destroy();
         this.laserTrails.stop();
         this.eraserTrail.stop();
@@ -1534,7 +1542,7 @@ class App extends React.Component {
             this.onRemoveEventListenersEmitter.once(addEventListener(document, EVENT.KEYDOWN, this.onKeyDown, false));
         }
         this.onRemoveEventListenersEmitter.once(addEventListener(this.excalidrawContainerRef.current, EVENT.WHEEL, this.onWheel, { passive: false }), addEventListener(window, EVENT.MESSAGE, this.onWindowMessage, false), addEventListener(document, EVENT.POINTER_UP, this.removePointer), // #3553
-        addEventListener(document, EVENT.COPY, this.onCopy), addEventListener(document, EVENT.KEYUP, this.onKeyUp, { passive: true }), addEventListener(document, EVENT.MOUSE_MOVE, this.updateCurrentCursorPosition), 
+        addEventListener(document, EVENT.COPY, this.onCopy), addEventListener(document, EVENT.KEYUP, this.onKeyUp, { passive: true }), addEventListener(document, EVENT.POINTER_MOVE, this.updateCurrentCursorPosition), 
         // rerender text elements on font load to fix #637 && #1553
         addEventListener(document.fonts, "loadingdone", (event) => {
             const loadedFontFaces = event.fontfaces;
@@ -1543,6 +1551,9 @@ class App extends React.Component {
         // Safari-only desktop pinch zoom
         addEventListener(document, EVENT.GESTURE_START, this.onGestureStart, false), addEventListener(document, EVENT.GESTURE_CHANGE, this.onGestureChange, false), addEventListener(document, EVENT.GESTURE_END, this.onGestureEnd, false), addEventListener(window, EVENT.FOCUS, () => {
             this.maybeCleanupAfterMissingPointerUp(null);
+            // browsers (chrome?) tend to free up memory a lot, which results
+            // in canvas context being cleared. Thus re-render on focus.
+            this.triggerRender(true);
         }));
         if (this.state.viewModeEnabled) {
             return;
@@ -1660,7 +1671,7 @@ class App extends React.Component {
             multiElement != null &&
             isBindingEnabled(this.state) &&
             isBindingElement(multiElement, false)) {
-            maybeBindLinearElement(multiElement, this.state, tupleToCoors(LinearElementEditor.getPointAtIndexGlobalCoordinates(multiElement, -1, nonDeletedElementsMap)), this);
+            maybeBindLinearElement(multiElement, this.state, tupleToCoors(LinearElementEditor.getPointAtIndexGlobalCoordinates(multiElement, -1, nonDeletedElementsMap)), this.scene.getNonDeletedElementsMap());
         }
         this.store.commit(elementsMap, this.state);
         // Do not notify consumers if we're still loading the scene. Among other
@@ -1849,6 +1860,26 @@ class App extends React.Component {
             });
         }
         else if (data.text) {
+            if (data.text && isMaybeMermaidDefinition(data.text)) {
+                const api = await import("@excalidraw/mermaid-to-excalidraw");
+                try {
+                    const { elements: skeletonElements, files } = await api.parseMermaidToExcalidraw(data.text, {
+                        fontSize: DEFAULT_FONT_SIZE,
+                    });
+                    const elements = convertToExcalidrawElements(skeletonElements, {
+                        regenerateIds: true,
+                    });
+                    this.addElementsFromPasteOrLibrary({
+                        elements,
+                        files,
+                        position: "cursor",
+                    });
+                    return;
+                }
+                catch (err) {
+                    console.warn(`parsing pasted text as mermaid definition failed: ${err.message}`);
+                }
+            }
             const nonEmptyLines = normalizeEOL(data.text)
                 .split(/\n+/)
                 .map((s) => s.trim())
@@ -2053,27 +2084,46 @@ class App extends React.Component {
             text,
             fontSize: this.state.currentItemFontSize,
             fontFamily: this.state.currentItemFontFamily,
-            textAlign: this.state.currentItemTextAlign,
+            textAlign: DEFAULT_TEXT_ALIGN,
             verticalAlign: DEFAULT_VERTICAL_ALIGN,
             locked: false,
         };
+        const fontString = getFontString({
+            fontSize: textElementProps.fontSize,
+            fontFamily: textElementProps.fontFamily,
+        });
+        const lineHeight = getDefaultLineHeight(textElementProps.fontFamily);
+        const [x1, , x2] = getVisibleSceneBounds(this.state);
+        // long texts should not go beyond 800 pixels in width nor should it go below 200 px
+        const maxTextWidth = Math.max(Math.min((x2 - x1) * 0.5, 800), 200);
         const LINE_GAP = 10;
         let currentY = y;
         const lines = isPlainPaste ? [text] : text.split("\n");
         const textElements = lines.reduce((acc, line, idx) => {
-            const text = line.trim();
-            const lineHeight = getDefaultLineHeight(textElementProps.fontFamily);
-            if (text.length) {
+            const originalText = line.trim();
+            if (originalText.length) {
                 const topLayerFrame = this.getTopLayerFrameAtSceneCoords({
                     x,
                     y: currentY,
                 });
+                let metrics = measureText(originalText, fontString, lineHeight);
+                const isTextWrapped = metrics.width > maxTextWidth;
+                const text = isTextWrapped
+                    ? wrapText(originalText, fontString, maxTextWidth)
+                    : originalText;
+                metrics = isTextWrapped
+                    ? measureText(text, fontString, lineHeight)
+                    : metrics;
+                const startX = x - metrics.width / 2;
+                const startY = currentY - metrics.height / 2;
                 const element = newTextElement({
                     ...textElementProps,
-                    x,
-                    y: currentY,
+                    x: startX,
+                    y: startY,
                     text,
+                    originalText,
                     lineHeight,
+                    autoResize: !isTextWrapped,
                     frameId: topLayerFrame ? topLayerFrame.id : null,
                 });
                 acc.push(element);
@@ -2292,7 +2342,7 @@ class App extends React.Component {
                 ShapeCache.delete(element);
             }
         });
-        this.scene.informMutation();
+        this.scene.triggerUpdate();
         this.addNewImagesToImageCache();
     });
     updateScene = withBatchedUpdates((sceneData) => {
@@ -2326,8 +2376,15 @@ class App extends React.Component {
             this.setState({ collaborators: sceneData.collaborators });
         }
     });
-    onSceneUpdated = () => {
-        this.setState({});
+    triggerRender = (
+    /** force always re-renders canvas even if no change */
+    force) => {
+        if (force === true) {
+            this.scene.triggerUpdate();
+        }
+        else {
+            this.setState({});
+        }
     };
     /**
      * @returns whether the menu was toggled on or off
@@ -2494,7 +2551,9 @@ class App extends React.Component {
                     simultaneouslyUpdated: selectedElements,
                 });
             });
-            this.maybeSuggestBindingForAll(selectedElements);
+            this.setState({
+                suggestedBindings: getSuggestedBindingsForArrows(selectedElements, this.scene.getNonDeletedElementsMap()),
+            });
             event.preventDefault();
         }
         else if (event.key === KEYS.ENTER) {
@@ -2632,11 +2691,7 @@ class App extends React.Component {
             this.setState({ isBindingEnabled: true });
         }
         if (isArrowKey(event.key)) {
-            const selectedElements = this.scene.getSelectedElements(this.state);
-            const elementsMap = this.scene.getNonDeletedElementsMap();
-            isBindingEnabled(this.state)
-                ? bindOrUnbindSelectedElements(selectedElements, this)
-                : unbindLinearElements(selectedElements, elementsMap);
+            bindOrUnbindLinearElements(this.scene.getSelectedElements(this.state).filter(isLinearElement), this.scene.getNonDeletedElementsMap(), isBindingEnabled(this.state), this.state.selectedLinearElement?.selectedPointsIndices ?? []);
             this.setState({ suggestedBindings: [] });
         }
     });
@@ -2774,15 +2829,16 @@ class App extends React.Component {
     });
     handleTextWysiwyg(element, { isExistingElement = false, }) {
         const elementsMap = this.scene.getElementsMapIncludingDeleted();
-        const updateElement = (text, originalText, isDeleted) => {
+        const updateElement = (nextOriginalText, isDeleted) => {
             this.scene.replaceAllElements([
                 // Not sure why we include deleted elements as well hence using deleted elements map
                 ...this.scene.getElementsIncludingDeleted().map((_element) => {
                     if (_element.id === element.id && isTextElement(_element)) {
-                        return updateTextElement(_element, getContainerElement(_element, elementsMap), elementsMap, {
-                            text,
-                            isDeleted,
-                            originalText,
+                        return newElementWith(_element, {
+                            originalText: nextOriginalText,
+                            isDeleted: isDeleted ?? _element.isDeleted,
+                            // returns (wrapped) text and new dimensions
+                            ...refreshTextDimensions(_element, getContainerElement(_element, elementsMap), elementsMap, nextOriginalText),
                         });
                     }
                     return _element;
@@ -2802,15 +2858,15 @@ class App extends React.Component {
                     viewportY - this.state.offsetTop,
                 ];
             },
-            onChange: withBatchedUpdates((text) => {
-                updateElement(text, text, false);
+            onChange: withBatchedUpdates((nextOriginalText) => {
+                updateElement(nextOriginalText, false);
                 if (isNonDeletedElement(element)) {
                     updateBoundElements(element, elementsMap);
                 }
             }),
-            onSubmit: withBatchedUpdates(({ text, viaKeyboard, originalText }) => {
-                const isDeleted = !text.trim();
-                updateElement(text, originalText, isDeleted);
+            onSubmit: withBatchedUpdates(({ viaKeyboard, nextOriginalText }) => {
+                const isDeleted = !nextOriginalText.trim();
+                updateElement(nextOriginalText, isDeleted);
                 // select the created text element only if submitting via keyboard
                 // (when submitting via click it should act as signal to deselect)
                 if (!isDeleted && viaKeyboard) {
@@ -2844,12 +2900,17 @@ class App extends React.Component {
             element,
             excalidrawContainer: this.excalidrawContainerRef.current,
             app: this,
+            // when text is selected, it's hard (at least on iOS) to re-position the
+            // caret (i.e. deselect). There's not much use for always selecting
+            // the text on edit anyway (and users can select-all from contextmenu
+            // if needed)
+            autoSelect: !this.device.isTouchScreen,
         });
         // deselect all other elements when inserting text
         this.deselectElements();
         // do an initial update to re-initialize element position since we were
         // modifying element's x/y for sake of editor (case: syncing to remote)
-        updateElement(element.text, element.originalText, false);
+        updateElement(element.originalText, false);
     }
     deselectElements() {
         this.setState({
@@ -2868,54 +2929,18 @@ class App extends React.Component {
         }
         return null;
     }
-    /**
-     * get the pure geometric shape of an excalidraw element
-     * which is then used for hit detection
-     */
-    getElementShape(element) {
-        switch (element.type) {
-            case "rectangle":
-            case "diamond":
-            case "frame":
-            case "magicframe":
-            case "embeddable":
-            case "image":
-            case "iframe":
-            case "text":
-            case "selection":
-                return getPolygonShape(element);
-            case "arrow":
-            case "line": {
-                const roughShape = ShapeCache.get(element)?.[0] ??
-                    ShapeCache.generateElementShape(element, null)[0];
-                const [, , , , cx, cy] = getElementAbsoluteCoords(element, this.scene.getNonDeletedElementsMap());
-                return shouldTestInside(element)
-                    ? getClosedCurveShape(element, roughShape, [element.x, element.y], element.angle, [cx, cy])
-                    : getCurveShape(roughShape, [element.x, element.y], element.angle, [
-                        cx,
-                        cy,
-                    ]);
-            }
-            case "ellipse":
-                return getEllipseShape(element);
-            case "freedraw": {
-                const [, , , , cx, cy] = getElementAbsoluteCoords(element, this.scene.getNonDeletedElementsMap());
-                return getFreedrawShape(element, [cx, cy], shouldTestInside(element));
-            }
-        }
-    }
     getBoundTextShape(element) {
         const boundTextElement = getBoundTextElement(element, this.scene.getNonDeletedElementsMap());
         if (boundTextElement) {
             if (element.type === "arrow") {
-                return this.getElementShape({
+                return getElementShape({
                     ...boundTextElement,
                     // arrow's bound text accurate position is not stored in the element's property
                     // but rather calculated and returned from the following static method
                     ...LinearElementEditor.getBoundTextElementPosition(element, boundTextElement, this.scene.getNonDeletedElementsMap()),
-                });
+                }, this.scene.getNonDeletedElementsMap());
             }
-            return this.getElementShape(boundTextElement);
+            return getElementShape(boundTextElement, this.scene.getNonDeletedElementsMap());
         }
         return null;
     }
@@ -2936,7 +2961,7 @@ class App extends React.Component {
                 x,
                 y,
                 element: elementWithHighestZIndex,
-                shape: this.getElementShape(elementWithHighestZIndex),
+                shape: getElementShape(elementWithHighestZIndex, this.scene.getNonDeletedElementsMap()),
                 // when overlapping, we would like to be more precise
                 // this also avoids the need to update past tests
                 threshold: this.getElementHitThreshold() / 2,
@@ -3006,7 +3031,7 @@ class App extends React.Component {
             x,
             y,
             element,
-            shape: this.getElementShape(element),
+            shape: getElementShape(element, this.scene.getNonDeletedElementsMap()),
             threshold: this.getElementHitThreshold(),
             frameNameBound: isFrameLikeElement(element)
                 ? this.frameNameBoundsCache.get(element)
@@ -3033,7 +3058,7 @@ class App extends React.Component {
                     x,
                     y,
                     element: elements[index],
-                    shape: this.getElementShape(elements[index]),
+                    shape: getElementShape(elements[index], this.scene.getNonDeletedElementsMap()),
                     threshold: this.getElementHitThreshold(),
                 })) {
                 hitElement = elements[index];
@@ -3046,7 +3071,7 @@ class App extends React.Component {
         }
         return isTextBindableContainer(hitElement, false) ? hitElement : null;
     }
-    startTextEditing = ({ sceneX, sceneY, insertAtParentCenter = true, container, }) => {
+    startTextEditing = ({ sceneX, sceneY, insertAtParentCenter = true, container, autoEdit = true, }) => {
         let shouldBindToContainer = false;
         let parentCenterPosition = insertAtParentCenter &&
             this.getTextWysiwygSnappedToCenterPosition(sceneX, sceneY, this.state, container);
@@ -3147,12 +3172,17 @@ class App extends React.Component {
                 this.scene.insertElement(element);
             }
         }
-        this.setState({
-            editingElement: element,
-        });
-        this.handleTextWysiwyg(element, {
-            isExistingElement: !!existingTextElement,
-        });
+        if (autoEdit || existingTextElement || container) {
+            this.handleTextWysiwyg(element, {
+                isExistingElement: !!existingTextElement,
+            });
+        }
+        else {
+            this.setState({
+                draggingElement: element,
+                multiElement: null,
+            });
+        }
     };
     handleCanvasDoubleClick = (event) => {
         // case: double-clicking with arrow/line tool selected would both create
@@ -3212,7 +3242,7 @@ class App extends React.Component {
                         x: sceneX,
                         y: sceneY,
                         element: container,
-                        shape: this.getElementShape(container),
+                        shape: getElementShape(container, this.scene.getNonDeletedElementsMap()),
                         threshold: this.getElementHitThreshold(),
                     })) {
                     const midPoint = getContainerCenter(container, this.state, this.scene.getNonDeletedElementsMap());
@@ -3319,8 +3349,11 @@ class App extends React.Component {
                 }, state);
                 this.translateCanvas({
                     zoom: zoomState.zoom,
-                    scrollX: zoomState.scrollX + deltaX / nextZoom,
-                    scrollY: zoomState.scrollY + deltaY / nextZoom,
+                    // 2x multiplier is just a magic number that makes this work correctly
+                    // on touchscreen devices (note: if we get report that panning is slower/faster
+                    // than actual movement, consider swapping with devicePixelRatio)
+                    scrollX: zoomState.scrollX + 2 * (deltaX / nextZoom),
+                    scrollY: zoomState.scrollY + 2 * (deltaY / nextZoom),
                     shouldCacheIgnoreZoom: true,
                 });
             });
@@ -3641,7 +3674,7 @@ class App extends React.Component {
                 }
             }
             this.elementsPendingErasure = new Set(this.elementsPendingErasure);
-            this.onSceneUpdated();
+            this.triggerRender();
         }
     };
     // set touch moving for mobile context menu
@@ -3661,7 +3694,7 @@ class App extends React.Component {
                 x: scenePointerX,
                 y: scenePointerY,
                 element,
-                shape: this.getElementShape(element),
+                shape: getElementShape(element, this.scene.getNonDeletedElementsMap()),
             })) {
                 hoverPointIndex = LinearElementEditor.getPointIndexUnderCursor(element, elementsMap, this.state.zoom, scenePointerX, scenePointerY);
                 segmentMidPointHoveredCoords =
@@ -3852,7 +3885,6 @@ class App extends React.Component {
         }
         if (this.state.activeTool.type === "text") {
             this.handleTextOnPointerDown(event, pointerDownState);
-            return;
         }
         else if (this.state.activeTool.type === "arrow" ||
             this.state.activeTool.type === "line") {
@@ -4400,6 +4432,7 @@ class App extends React.Component {
             sceneY,
             insertAtParentCenter: !event.altKey,
             container,
+            autoEdit: false,
         });
         resetCursor(this.interactiveCanvas);
         if (!this.state.activeTool.locked) {
@@ -4447,7 +4480,7 @@ class App extends React.Component {
             points: [[0, 0]],
             pressures,
         });
-        const boundElement = getHoveredElementForBinding(pointerDownState.origin, this);
+        const boundElement = getHoveredElementForBinding(pointerDownState.origin, this.scene.getNonDeletedElementsMap());
         this.scene.insertElement(element);
         this.setState({
             draggingElement: element,
@@ -4619,7 +4652,7 @@ class App extends React.Component {
             mutateElement(element, {
                 points: [...element.points, [0, 0]],
             });
-            const boundElement = getHoveredElementForBinding(pointerDownState.origin, this);
+            const boundElement = getHoveredElementForBinding(pointerDownState.origin, this.scene.getNonDeletedElementsMap());
             this.scene.insertElement(element);
             this.setState({
                 draggingElement: element,
@@ -4916,7 +4949,9 @@ class App extends React.Component {
                     // able to select and interact with the text input
                     !this.state.editingFrame &&
                         dragSelectedElements(pointerDownState, selectedElements, dragOffset, this.state, this.scene, snapOffset, event[KEYS.CTRL_OR_CMD] ? null : this.state.gridSize);
-                    this.maybeSuggestBindingForAll(selectedElements);
+                    this.setState({
+                        suggestedBindings: getSuggestedBindingsForArrows(selectedElements, this.scene.getNonDeletedElementsMap()),
+                    });
                     // We duplicate the selected element if alt is pressed on pointer move
                     if (event.altKey && !pointerDownState.hit.hasBeenDuplicated) {
                         // Move the currently selected elements to the top of the z index stack, and
@@ -5263,7 +5298,7 @@ class App extends React.Component {
                 else if (pointerDownState.drag.hasOccurred && !multiElement) {
                     if (isBindingEnabled(this.state) &&
                         isBindingElement(draggingElement, false)) {
-                        maybeBindLinearElement(draggingElement, this.state, pointerCoords, this);
+                        maybeBindLinearElement(draggingElement, this.state, pointerCoords, this.scene.getNonDeletedElementsMap());
                     }
                     this.setState({ suggestedBindings: [], startBoundElement: null });
                     if (!activeTool.locked) {
@@ -5288,6 +5323,21 @@ class App extends React.Component {
                 }
                 return;
             }
+            if (isTextElement(draggingElement)) {
+                const minWidth = getMinTextElementWidth(getFontString({
+                    fontSize: draggingElement.fontSize,
+                    fontFamily: draggingElement.fontFamily,
+                }), draggingElement.lineHeight);
+                if (draggingElement.width < minWidth) {
+                    mutateElement(draggingElement, {
+                        autoResize: true,
+                    });
+                }
+                this.resetCursor();
+                this.handleTextWysiwyg(draggingElement, {
+                    isExistingElement: true,
+                });
+            }
             if (activeTool.type !== "selection" &&
                 draggingElement &&
                 isInvisiblySmallElement(draggingElement)) {
@@ -5323,7 +5373,7 @@ class App extends React.Component {
                                         groupIds: [],
                                     });
                                     removeElementsFromFrame([linearElement], this.scene.getNonDeletedElementsMap());
-                                    this.scene.informMutation();
+                                    this.scene.triggerUpdate();
                                 }
                             }
                         }
@@ -5556,7 +5606,7 @@ class App extends React.Component {
                         x: pointerDownState.origin.x,
                         y: pointerDownState.origin.y,
                         element: hitElement,
-                        shape: this.getElementShape(hitElement),
+                        shape: getElementShape(hitElement, this.scene.getNonDeletedElementsMap()),
                         threshold: this.getElementHitThreshold(),
                         frameNameBound: isFrameLikeElement(hitElement)
                             ? this.frameNameBoundsCache.get(hitElement)
@@ -5600,9 +5650,12 @@ class App extends React.Component {
                 this.store.shouldCaptureIncrement();
             }
             if (pointerDownState.drag.hasOccurred || isResizing || isRotating) {
-                isBindingEnabled(this.state)
-                    ? bindOrUnbindSelectedElements(this.scene.getSelectedElements(this.state), this)
-                    : unbindLinearElements(this.scene.getSelectedElements(this.state), elementsMap);
+                // We only allow binding via linear elements, specifically via dragging
+                // the endpoints ("start" or "end").
+                const linearElements = this.scene
+                    .getSelectedElements(this.state)
+                    .filter(isLinearElement);
+                bindOrUnbindLinearElements(linearElements, this.scene.getNonDeletedElementsMap(), isBindingEnabled(this.state), this.state.selectedLinearElement?.selectedPointsIndices ?? []);
             }
             if (activeTool.type === "laser") {
                 this.laserTrails.endPath();
@@ -5637,7 +5690,7 @@ class App extends React.Component {
     }
     restoreReadyToEraseElements = () => {
         this.elementsPendingErasure = new Set();
-        this.onSceneUpdated();
+        this.triggerRender();
     };
     eraseElements = () => {
         let didChange = false;
@@ -5929,7 +5982,7 @@ class App extends React.Component {
         if (uncachedImageElements.length) {
             const { updatedFiles } = await this.updateImageCache(uncachedImageElements, files);
             if (updatedFiles.size) {
-                this.scene.informMutation();
+                this.scene.triggerUpdate();
             }
         }
     };
@@ -5945,7 +5998,7 @@ class App extends React.Component {
         }
     };
     maybeSuggestBindingAtCursor = (pointerCoords) => {
-        const hoveredBindableElement = getHoveredElementForBinding(pointerCoords, this);
+        const hoveredBindableElement = getHoveredElementForBinding(pointerCoords, this.scene.getNonDeletedElementsMap());
         this.setState({
             suggestedBindings: hoveredBindableElement != null ? [hoveredBindableElement] : [],
         });
@@ -5960,7 +6013,7 @@ class App extends React.Component {
             return;
         }
         const suggestedBindings = pointerCoords.reduce((acc, coords) => {
-            const hoveredBindableElement = getHoveredElementForBinding(coords, this);
+            const hoveredBindableElement = getHoveredElementForBinding(coords, this.scene.getNonDeletedElementsMap());
             if (hoveredBindableElement != null &&
                 !isLinearElementSimpleAndAlreadyBound(linearElement, oppositeBindingBoundElement?.id, hoveredBindableElement)) {
                 acc.push(hoveredBindableElement);
@@ -5969,13 +6022,6 @@ class App extends React.Component {
         }, []);
         this.setState({ suggestedBindings });
     };
-    maybeSuggestBindingForAll(selectedElements) {
-        if (selectedElements.length > 50) {
-            return;
-        }
-        const suggestedBindings = getEligibleElementsForBinding(selectedElements, this);
-        this.setState({ suggestedBindings });
-    }
     clearSelection(hitElement) {
         this.setState((prevState) => ({
             selectedElementIds: makeNextSelectedElementIds({}, prevState),
@@ -6215,7 +6261,7 @@ class App extends React.Component {
         }
         if (draggingElement.type === "selection" &&
             this.state.activeTool.type !== "eraser") {
-            dragNewElement(draggingElement, this.state.activeTool.type, pointerDownState.origin.x, pointerDownState.origin.y, pointerCoords.x, pointerCoords.y, distance(pointerDownState.origin.x, pointerCoords.x), distance(pointerDownState.origin.y, pointerCoords.y), shouldMaintainAspectRatio(event), shouldResizeFromCenter(event));
+            dragNewElement(draggingElement, this.state.activeTool.type, pointerDownState.origin.x, pointerDownState.origin.y, pointerCoords.x, pointerCoords.y, distance(pointerDownState.origin.x, pointerCoords.x), distance(pointerDownState.origin.y, pointerCoords.y), shouldMaintainAspectRatio(event), shouldResizeFromCenter(event), this.state.zoom.value);
         }
         else {
             let [gridX, gridY] = getGridPoint(pointerCoords.x, pointerCoords.y, event[KEYS.CTRL_OR_CMD] ? null : this.state.gridSize);
@@ -6241,8 +6287,7 @@ class App extends React.Component {
             });
             dragNewElement(draggingElement, this.state.activeTool.type, pointerDownState.originInGrid.x, pointerDownState.originInGrid.y, gridX, gridY, distance(pointerDownState.originInGrid.x, gridX), distance(pointerDownState.originInGrid.y, gridY), isImageElement(draggingElement)
                 ? !shouldMaintainAspectRatio(event)
-                : shouldMaintainAspectRatio(event), shouldResizeFromCenter(event), aspectRatio, this.state.originSnapOffset);
-            this.maybeSuggestBindingForAll([draggingElement]);
+                : shouldMaintainAspectRatio(event), shouldResizeFromCenter(event), this.state.zoom.value, aspectRatio, this.state.originSnapOffset);
             // highlight elements that are to be added to frames on frames creation
             if (this.state.activeTool.type === TOOL_TYPE.frame ||
                 this.state.activeTool.type === TOOL_TYPE.magicframe) {
@@ -6299,13 +6344,14 @@ class App extends React.Component {
         if (transformElements(pointerDownState.originalElements, transformHandleType, selectedElements, this.scene.getElementsMapIncludingDeleted(), shouldRotateWithDiscreteAngle(event), shouldResizeFromCenter(event), selectedElements.some((element) => isImageElement(element))
             ? !shouldMaintainAspectRatio(event)
             : shouldMaintainAspectRatio(event), resizeX, resizeY, pointerDownState.resize.center.x, pointerDownState.resize.center.y)) {
-            this.maybeSuggestBindingForAll(selectedElements);
+            const suggestedBindings = getSuggestedBindingsForArrows(selectedElements, this.scene.getNonDeletedElementsMap());
             const elementsToHighlight = new Set();
             selectedFrames.forEach((frame) => {
                 getElementsInResizingFrame(this.scene.getNonDeletedElements(), frame, this.state, this.scene.getNonDeletedElementsMap()).forEach((element) => elementsToHighlight.add(element));
             });
             this.setState({
                 elementsToHighlight: [...elementsToHighlight],
+                suggestedBindings,
             });
             return true;
         }
@@ -6350,6 +6396,7 @@ class App extends React.Component {
             return [actionCopy, ...options];
         }
         return [
+            CONTEXT_MENU_SEPARATOR,
             actionCut,
             actionCopy,
             actionPaste,
@@ -6362,6 +6409,7 @@ class App extends React.Component {
             actionPasteStyles,
             CONTEXT_MENU_SEPARATOR,
             actionGroup,
+            actionTextAutoResize,
             actionUnbindText,
             actionBindText,
             actionWrapTextInContainer,