@tldraw/editor 3.14.0-canary.fd2ad122b803 → 3.14.0-canary.fe38dba85730

package/dist-esm/lib/editor/Editor.mjs

@@ -46,7 +46,7 @@ var __privateIn = (member, obj) => Object(obj) !== obj ? __typeError('Cannot use
 var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
 var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
 var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
-var __setMetaKeyTimeout_dec, __setCtrlKeyTimeout_dec, __setAltKeyTimeout_dec, __setShiftKeyTimeout_dec, _getIsReadonly_dec, _getIsFocused_dec, _getSharedOpacity_dec, _getSharedStyles_dec, __getSelectionSharedStyles_dec, __getBindingsIndexCache_dec, _getCurrentPageRenderingShapesSorted_dec, _getCurrentPageShapesSorted_dec, _getCurrentPageShapes_dec, _getCurrentPageBounds_dec, _getCulledShapes_dec, __notVisibleShapes_dec, __getShapeMaskedPageBoundsCache_dec, __getShapeMaskCache_dec, __getShapeClipPathCache_dec, __getShapePageBoundsCache_dec, __getShapePageTransformCache_dec, __getShapeHandlesCache_dec, __getAllAssetsQuery_dec, _getCurrentPageShapeIdsSorted_dec, _getCurrentPageId_dec, _getPages_dec, __getAllPagesQuery_dec, _getRenderingShapes_dec, _getCollaboratorsOnCurrentPage_dec, _getCollaborators_dec, __getCollaboratorsQuery_dec, _getViewportPageBounds_dec, _getViewportScreenCenter_dec, _getViewportScreenBounds_dec, _getZoomLevel_dec, _getCameraForFollowing_dec, _getViewportPageBoundsForFollowing_dec, _getCamera_dec, __unsafe_getCameraId_dec, _getErasingShapes_dec, _getErasingShapeIds_dec, _getHintingShape_dec, _getHintingShapeIds_dec, _getHoveredShape_dec, _getHoveredShapeId_dec, _getRichTextEditor_dec, _getEditingShape_dec, _getEditingShapeId_dec, _getFocusedGroup_dec, _getFocusedGroupId_dec, _getSelectionRotatedScreenBounds_dec, _getSelectionRotatedPageBounds_dec, _getSelectionRotation_dec, _getSelectionPageBounds_dec, _getOnlySelectedShape_dec, _getOnlySelectedShapeId_dec, _getCurrentPageShapesInReadingOrder_dec, _getSelectedShapes_dec, _getSelectedShapeIds_dec, __getCurrentPageStateId_dec, _getCurrentPageState_dec, __getPageStatesQuery_dec, _getPageStates_dec, _getIsMenuOpen_dec, _getOpenMenus_dec, _getInstanceState_dec, _getDocumentSettings_dec, _getCurrentToolId_dec, _getCurrentTool_dec, _getPath_dec, _getCanRedo_dec, _getCanUndo_dec, _getIsShapeHiddenCache_dec, _a, _init;
+var __setMetaKeyTimeout_dec, __setCtrlKeyTimeout_dec, __setAltKeyTimeout_dec, __setShiftKeyTimeout_dec, _getIsReadonly_dec, _getIsFocused_dec, _getSharedOpacity_dec, _getSharedStyles_dec, __getSelectionSharedStyles_dec, __getBindingsIndexCache_dec, _getCurrentPageRenderingShapesSorted_dec, _getCurrentPageShapesSorted_dec, _getCurrentPageShapes_dec, _getCurrentPageBounds_dec, _getCulledShapes_dec, _getNotVisibleShapes_dec, __getShapeMaskedPageBoundsCache_dec, __getShapeMaskCache_dec, __getShapeClipPathCache_dec, __getShapePageBoundsCache_dec, __getShapePageTransformCache_dec, __getShapeHandlesCache_dec, __getAllAssetsQuery_dec, _getCurrentPageShapeIdsSorted_dec, _getCurrentPageId_dec, _getPages_dec, __getAllPagesQuery_dec, _getRenderingShapes_dec, _getCollaboratorsOnCurrentPage_dec, _getCollaborators_dec, __getCollaboratorsQuery_dec, _getViewportPageBounds_dec, _getViewportScreenCenter_dec, _getViewportScreenBounds_dec, _getZoomLevel_dec, _getCameraForFollowing_dec, _getViewportPageBoundsForFollowing_dec, _getCamera_dec, __unsafe_getCameraId_dec, _getErasingShapes_dec, _getErasingShapeIds_dec, _getHintingShape_dec, _getHintingShapeIds_dec, _getHoveredShape_dec, _getHoveredShapeId_dec, _getRichTextEditor_dec, _getEditingShape_dec, _getEditingShapeId_dec, _getFocusedGroup_dec, _getFocusedGroupId_dec, _getSelectionRotatedScreenBounds_dec, _getSelectionRotatedPageBounds_dec, _getSelectionRotation_dec, _getSelectionPageBounds_dec, _getOnlySelectedShape_dec, _getOnlySelectedShapeId_dec, _getCurrentPageShapesInReadingOrder_dec, _getSelectedShapes_dec, _getSelectedShapeIds_dec, __getCurrentPageStateId_dec, _getCurrentPageState_dec, __getPageStatesQuery_dec, _getPageStates_dec, _getIsMenuOpen_dec, _getOpenMenus_dec, _getInstanceState_dec, _getDocumentSettings_dec, _getCurrentToolId_dec, _getCurrentTool_dec, _getPath_dec, _getCanRedo_dec, _getCanUndo_dec, _getIsShapeHiddenCache_dec, _a, _init;
 import {
   EMPTY_ARRAY,
   atom,
@@ -147,18 +147,18 @@ import { bindingsIndex } from "./derivations/bindingsIndex.mjs";
 import { notVisibleShapes } from "./derivations/notVisibleShapes.mjs";
 import { parentsToChildren } from "./derivations/parentsToChildren.mjs";
 import { deriveShapeIdsInCurrentPage } from "./derivations/shapeIdsInCurrentPage.mjs";
-import { ClickManager } from "./managers/ClickManager.mjs";
-import { EdgeScrollManager } from "./managers/EdgeScrollManager.mjs";
-import { FocusManager } from "./managers/FocusManager.mjs";
-import { FontManager } from "./managers/FontManager.mjs";
-import { HistoryManager } from "./managers/HistoryManager.mjs";
-import { ScribbleManager } from "./managers/ScribbleManager.mjs";
+import { ClickManager } from "./managers/ClickManager/ClickManager.mjs";
+import { EdgeScrollManager } from "./managers/EdgeScrollManager/EdgeScrollManager.mjs";
+import { FocusManager } from "./managers/FocusManager/FocusManager.mjs";
+import { FontManager } from "./managers/FontManager/FontManager.mjs";
+import { HistoryManager } from "./managers/HistoryManager/HistoryManager.mjs";
+import { ScribbleManager } from "./managers/ScribbleManager/ScribbleManager.mjs";
 import { SnapManager } from "./managers/SnapManager/SnapManager.mjs";
-import { TextManager } from "./managers/TextManager.mjs";
-import { TickManager } from "./managers/TickManager.mjs";
-import { UserPreferencesManager } from "./managers/UserPreferencesManager.mjs";
+import { TextManager } from "./managers/TextManager/TextManager.mjs";
+import { TickManager } from "./managers/TickManager/TickManager.mjs";
+import { UserPreferencesManager } from "./managers/UserPreferencesManager/UserPreferencesManager.mjs";
 import { RootState } from "./tools/RootState.mjs";
-class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed], _getCanUndo_dec = [computed], _getCanRedo_dec = [computed], _getPath_dec = [computed], _getCurrentTool_dec = [computed], _getCurrentToolId_dec = [computed], _getDocumentSettings_dec = [computed], _getInstanceState_dec = [computed], _getOpenMenus_dec = [computed], _getIsMenuOpen_dec = [computed], _getPageStates_dec = [computed], __getPageStatesQuery_dec = [computed], _getCurrentPageState_dec = [computed], __getCurrentPageStateId_dec = [computed], _getSelectedShapeIds_dec = [computed], _getSelectedShapes_dec = [computed], _getCurrentPageShapesInReadingOrder_dec = [computed], _getOnlySelectedShapeId_dec = [computed], _getOnlySelectedShape_dec = [computed], _getSelectionPageBounds_dec = [computed], _getSelectionRotation_dec = [computed], _getSelectionRotatedPageBounds_dec = [computed], _getSelectionRotatedScreenBounds_dec = [computed], _getFocusedGroupId_dec = [computed], _getFocusedGroup_dec = [computed], _getEditingShapeId_dec = [computed], _getEditingShape_dec = [computed], _getRichTextEditor_dec = [computed], _getHoveredShapeId_dec = [computed], _getHoveredShape_dec = [computed], _getHintingShapeIds_dec = [computed], _getHintingShape_dec = [computed], _getErasingShapeIds_dec = [computed], _getErasingShapes_dec = [computed], __unsafe_getCameraId_dec = [computed], _getCamera_dec = [computed], _getViewportPageBoundsForFollowing_dec = [computed], _getCameraForFollowing_dec = [computed], _getZoomLevel_dec = [computed], _getViewportScreenBounds_dec = [computed], _getViewportScreenCenter_dec = [computed], _getViewportPageBounds_dec = [computed], __getCollaboratorsQuery_dec = [computed], _getCollaborators_dec = [computed], _getCollaboratorsOnCurrentPage_dec = [computed], _getRenderingShapes_dec = [computed], __getAllPagesQuery_dec = [computed], _getPages_dec = [computed], _getCurrentPageId_dec = [computed], _getCurrentPageShapeIdsSorted_dec = [computed], __getAllAssetsQuery_dec = [computed], __getShapeHandlesCache_dec = [computed], __getShapePageTransformCache_dec = [computed], __getShapePageBoundsCache_dec = [computed], __getShapeClipPathCache_dec = [computed], __getShapeMaskCache_dec = [computed], __getShapeMaskedPageBoundsCache_dec = [computed], __notVisibleShapes_dec = [computed], _getCulledShapes_dec = [computed], _getCurrentPageBounds_dec = [computed], _getCurrentPageShapes_dec = [computed], _getCurrentPageShapesSorted_dec = [computed], _getCurrentPageRenderingShapesSorted_dec = [computed], __getBindingsIndexCache_dec = [computed], __getSelectionSharedStyles_dec = [computed], _getSharedStyles_dec = [computed({ isEqual: (a, b) => a.equals(b) })], _getSharedOpacity_dec = [computed], _getIsFocused_dec = [computed], _getIsReadonly_dec = [computed], __setShiftKeyTimeout_dec = [bind], __setAltKeyTimeout_dec = [bind], __setCtrlKeyTimeout_dec = [bind], __setMetaKeyTimeout_dec = [bind], _a) {
+class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed], _getCanUndo_dec = [computed], _getCanRedo_dec = [computed], _getPath_dec = [computed], _getCurrentTool_dec = [computed], _getCurrentToolId_dec = [computed], _getDocumentSettings_dec = [computed], _getInstanceState_dec = [computed], _getOpenMenus_dec = [computed], _getIsMenuOpen_dec = [computed], _getPageStates_dec = [computed], __getPageStatesQuery_dec = [computed], _getCurrentPageState_dec = [computed], __getCurrentPageStateId_dec = [computed], _getSelectedShapeIds_dec = [computed], _getSelectedShapes_dec = [computed], _getCurrentPageShapesInReadingOrder_dec = [computed], _getOnlySelectedShapeId_dec = [computed], _getOnlySelectedShape_dec = [computed], _getSelectionPageBounds_dec = [computed], _getSelectionRotation_dec = [computed], _getSelectionRotatedPageBounds_dec = [computed], _getSelectionRotatedScreenBounds_dec = [computed], _getFocusedGroupId_dec = [computed], _getFocusedGroup_dec = [computed], _getEditingShapeId_dec = [computed], _getEditingShape_dec = [computed], _getRichTextEditor_dec = [computed], _getHoveredShapeId_dec = [computed], _getHoveredShape_dec = [computed], _getHintingShapeIds_dec = [computed], _getHintingShape_dec = [computed], _getErasingShapeIds_dec = [computed], _getErasingShapes_dec = [computed], __unsafe_getCameraId_dec = [computed], _getCamera_dec = [computed], _getViewportPageBoundsForFollowing_dec = [computed], _getCameraForFollowing_dec = [computed], _getZoomLevel_dec = [computed], _getViewportScreenBounds_dec = [computed], _getViewportScreenCenter_dec = [computed], _getViewportPageBounds_dec = [computed], __getCollaboratorsQuery_dec = [computed], _getCollaborators_dec = [computed], _getCollaboratorsOnCurrentPage_dec = [computed], _getRenderingShapes_dec = [computed], __getAllPagesQuery_dec = [computed], _getPages_dec = [computed], _getCurrentPageId_dec = [computed], _getCurrentPageShapeIdsSorted_dec = [computed], __getAllAssetsQuery_dec = [computed], __getShapeHandlesCache_dec = [computed], __getShapePageTransformCache_dec = [computed], __getShapePageBoundsCache_dec = [computed], __getShapeClipPathCache_dec = [computed], __getShapeMaskCache_dec = [computed], __getShapeMaskedPageBoundsCache_dec = [computed], _getNotVisibleShapes_dec = [computed], _getCulledShapes_dec = [computed], _getCurrentPageBounds_dec = [computed], _getCurrentPageShapes_dec = [computed], _getCurrentPageShapesSorted_dec = [computed], _getCurrentPageRenderingShapesSorted_dec = [computed], __getBindingsIndexCache_dec = [computed], __getSelectionSharedStyles_dec = [computed], _getSharedStyles_dec = [computed({ isEqual: (a, b) => a.equals(b) })], _getSharedOpacity_dec = [computed], _getIsFocused_dec = [computed], _getIsReadonly_dec = [computed], __setShiftKeyTimeout_dec = [bind], __setAltKeyTimeout_dec = [bind], __setCtrlKeyTimeout_dec = [bind], __setMetaKeyTimeout_dec = [bind], _a) {
   constructor({
     store,
     user,
@@ -336,7 +336,7 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
     __publicField(this, "_currentPageShapeIds");
     /* --------------------- Shapes --------------------- */
     __publicField(this, "_shapeGeometryCaches", {});
-    __publicField(this, "_shapePageGeometryCaches", {});
+    __publicField(this, "_notVisibleShapes", notVisibleShapes(this));
     // Parents and children
     /**
      * A cache of parents to children.
@@ -357,6 +357,7 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
     __publicField(this, "externalContentHandlers", {
       text: null,
       files: null,
+      "file-replace": null,
       embed: null,
       "svg-text": null,
       url: null,
@@ -473,6 +474,7 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
     this.disposables.add(() => this.user.dispose());
     this.getContainer = getContainer;
     this.textMeasure = new TextManager(this);
+    this.disposables.add(() => this.textMeasure.dispose());
     this.fonts = new FontManager(this, fontAssetUrls);
     this._tickManager = new TickManager(this);
     class NewRoot extends RootState {
@@ -598,14 +600,16 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
                 this.getBindingUtil(binding).onAfterChangeFromShape?.({
                   binding,
                   shapeBefore,
-                  shapeAfter
+                  shapeAfter,
+                  reason: "self"
                 });
               }
               if (binding.toId === shapeAfter.id) {
                 this.getBindingUtil(binding).onAfterChangeToShape?.({
                   binding,
                   shapeBefore,
-                  shapeAfter
+                  shapeAfter,
+                  reason: "self"
                 });
               }
             }
@@ -619,14 +623,16 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
                     this.getBindingUtil(binding).onAfterChangeFromShape?.({
                       binding,
                       shapeBefore: descendantShape,
-                      shapeAfter: descendantShape
+                      shapeAfter: descendantShape,
+                      reason: "ancestry"
                     });
                   }
                   if (binding.toId === descendantShape.id) {
                     this.getBindingUtil(binding).onAfterChangeToShape?.({
                       binding,
                       shapeBefore: descendantShape,
-                      shapeAfter: descendantShape
+                      shapeAfter: descendantShape,
+                      reason: "ancestry"
                     });
                   }
                 }
@@ -1670,6 +1676,19 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
   getSelectionPageBounds() {
     return this.getShapesPageBounds(this.getSelectedShapeIds());
   }
+  /**
+   * The bounds of the selection bounding box in the current page space.
+   *
+   * @readonly
+   * @public
+   */
+  getSelectionScreenBounds() {
+    const bounds = this.getSelectionPageBounds();
+    if (!bounds) return void 0;
+    const { x, y } = this.pageToScreen(bounds.point);
+    const zoom = this.getZoomLevel();
+    return new Box(x, y, bounds.width * zoom, bounds.height * zoom);
+  }
   /**
    * @internal
    */
@@ -2853,10 +2872,7 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
   }
   getViewportScreenCenter() {
     const viewportScreenBounds = this.getViewportScreenBounds();
-    return new Vec(
-      viewportScreenBounds.midX - viewportScreenBounds.minX,
-      viewportScreenBounds.midY - viewportScreenBounds.minY
-    );
+    return new Vec(viewportScreenBounds.w / 2, viewportScreenBounds.h / 2);
   }
   getViewportPageBounds() {
     const { w, h } = this.getViewportScreenBounds();
@@ -3531,41 +3547,6 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
       typeof shape === "string" ? shape : shape.id
     );
   }
-  /**
-   * Get the geometry of a shape in page-space.
-   *
-   * @example
-   * ```ts
-   * editor.getShapePageGeometry(myShape)
-   * editor.getShapePageGeometry(myShapeId)
-   * editor.getShapePageGeometry(myShapeId, { context: "arrow" })
-   * ```
-   *
-   * @param shape - The shape (or shape id) to get the geometry for.
-   * @param opts - Additional options about the request for geometry. Passed to {@link ShapeUtil.getGeometry}.
-   *
-   * @public
-   */
-  getShapePageGeometry(shape, opts) {
-    const context = opts?.context ?? "none";
-    if (!this._shapePageGeometryCaches[context]) {
-      this._shapePageGeometryCaches[context] = this.store.createComputedCache(
-        "bounds",
-        (shape2) => {
-          const geometry = this.getShapeGeometry(shape2.id, opts);
-          const pageTransform = this.getShapePageTransform(shape2.id);
-          return geometry.transform(pageTransform);
-        },
-        {
-          // we only depend directly on the shape id, and changing geometry/transform will update us anyway
-          areRecordsEqual: () => true
-        }
-      );
-    }
-    return this._shapePageGeometryCaches[context].get(
-      typeof shape === "string" ? shape : shape.id
-    );
-  }
   _getShapeHandlesCache() {
     return this.store.createComputedCache(
       "handles",
@@ -3659,7 +3640,10 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
   }
   _getShapePageBoundsCache() {
     return this.store.createComputedCache("pageBoundsCache", (shape) => {
-      return this.getShapePageGeometry(shape).bounds;
+      const pageTransform = this.getShapePageTransform(shape);
+      if (!pageTransform) return void 0;
+      const geometry = this.getShapeGeometry(shape);
+      return Box.FromPoints(pageTransform.applyToPoints(geometry.vertices));
     });
   }
   /**
@@ -3716,12 +3700,11 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
         (shape2) => this.isShapeOfType(shape2, "frame")
       );
       if (frameAncestors.length === 0) return void 0;
-      const pageMask = frameAncestors.map(
-        (s) => (
-          // Apply the frame transform to the frame outline to get the frame outline in the current page space
-          (this.getShapePageGeometry(s.id).vertices)
-        )
-      ).reduce((acc, b) => {
+      const pageMask = frameAncestors.map((s) => {
+        const geometry = this.getShapeGeometry(s.id);
+        const pageTransform = this.getShapePageTransform(s.id);
+        return pageTransform.applyToPoints(geometry.vertices);
+      }).reduce((acc, b) => {
         if (!(b && acc)) return void 0;
         const intersection = intersectPolygonPolygon(acc, b);
         if (intersection) {
@@ -3885,17 +3868,24 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
     }
     return void 0;
   }
-  isShapeOrAncestorLocked(arg) {
-    const shape = typeof arg === "string" ? this.getShape(arg) : arg;
-    if (shape === void 0) return false;
-    if (shape.isLocked) return true;
-    return this.isShapeOrAncestorLocked(this.getShapeParent(shape));
+  /**
+   * Check whether a shape or its parent is locked.
+   *
+   * @param shape - The shape (or shape id) to check.
+   *
+   * @public
+   */
+  isShapeOrAncestorLocked(shape) {
+    const _shape = shape && this.getShape(shape);
+    if (_shape === void 0) return false;
+    if (_shape.isLocked) return true;
+    return this.isShapeOrAncestorLocked(this.getShapeParent(_shape));
   }
-  _notVisibleShapes() {
-    return notVisibleShapes(this);
+  getNotVisibleShapes() {
+    return this._notVisibleShapes.get();
   }
   getCulledShapes() {
-    const notVisibleShapes2 = this._notVisibleShapes().get();
+    const notVisibleShapes2 = this.getNotVisibleShapes();
     const selectedShapeIds = this.getSelectedShapeIds();
     const editingId = this.getEditingShapeId();
     const culledShapes = new Set(notVisibleShapes2);
@@ -4040,18 +4030,18 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
    * @example
    * ```ts
    * editor.getShapesAtPoint({ x: 100, y: 100 })
-   * editor.getShapesAtPoint({ x: 100, y: 100 }, { hitInside: true, exact: true })
+   * editor.getShapesAtPoint({ x: 100, y: 100 }, { hitInside: true, margin: 8 })
    * ```
    *
    * @param point - The page point to test.
    * @param opts - The options for the hit point testing.
    *
+   * @returns An array of shapes at the given point, sorted in reverse order of their absolute z-index (top-most shape first).
+   *
    * @public
    */
   getShapesAtPoint(point, opts = {}) {
-    return this.getCurrentPageShapes().filter(
-      (shape) => !this.isShapeHidden(shape) && this.isPointInShape(shape, point, opts)
-    );
+    return this.getCurrentPageShapesSorted().filter((shape) => !this.isShapeHidden(shape) && this.isPointInShape(shape, point, opts)).reverse();
   }
   /**
    * Test whether a point (in the current page space) will will a shape. This method takes into account masks,
@@ -4175,7 +4165,7 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
     if (!id) return void 0;
     const freshShape = this.getShape(id);
     if (freshShape === void 0 || !isShapeId(freshShape.parentId)) return void 0;
-    return this.store.get(freshShape.parentId);
+    return this.getShape(freshShape.parentId);
   }
   /**
    * If siblingShape and targetShape are siblings, this returns targetShape. If targetShape has an
@@ -4307,6 +4297,9 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
           if (!pagePoint) continue;
           const newPoint = invertedParentTransform.applyToPoint(pagePoint);
           const newRotation = pageTransform.rotation() - parentPageRotation;
+          if (shape.id === parentId) {
+            throw Error("Attempted to reparent a shape to itself!");
+          }
           changes.push({
             id: shape.id,
             type: shape.type,
@@ -4373,8 +4366,7 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
    * @public
    */
   visitDescendants(parent, visitor) {
-    const parentId = typeof parent === "string" ? parent : parent.id;
-    const children = this.getSortedChildIdsForParent(parentId);
+    const children = this.getSortedChildIdsForParent(parent);
     for (const id of children) {
       if (visitor(id) === false) continue;
       this.visitDescendants(id, visitor);
@@ -4400,6 +4392,10 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
     }
     return shapeIds;
   }
+  /** @deprecated Use {@link Editor.getDraggingOverShape} instead */
+  getDroppingOverShape(point, droppingShapes) {
+    return this.getDraggingOverShape(point, droppingShapes);
+  }
   /**
    * Get the shape that some shapes should be dropped on at a given point.
    *
@@ -4410,22 +4406,20 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
    *
    * @public
    */
-  getDroppingOverShape(point, droppingShapes = []) {
-    const currentPageShapesSorted = this.getCurrentPageShapesSorted();
-    for (let i = currentPageShapesSorted.length - 1; i >= 0; i--) {
-      const shape = currentPageShapesSorted[i];
-      if (
-        // ignore hidden shapes
-        this.isShapeHidden(shape) || // don't allow dropping on selected shapes
-        this.getSelectedShapeIds().includes(shape.id) || // only allow shapes that can receive children
-        !this.getShapeUtil(shape).canDropShapes(shape, droppingShapes) || // don't allow dropping a shape on itself or one of it's children
-        droppingShapes.find((s) => s.id === shape.id || this.hasAncestor(shape, s.id))
-      ) {
-        continue;
-      }
-      const maskedPageBounds = this.getShapeMaskedPageBounds(shape.id);
-      if (maskedPageBounds && maskedPageBounds.containsPoint(point) && this.getShapeGeometry(shape).hitTestPoint(this.getPointInShapeSpace(shape, point), 0, true)) {
-        return shape;
+  getDraggingOverShape(point, droppingShapes) {
+    const draggingShapes = compact(droppingShapes.map((s) => this.getShape(s))).filter(
+      (s) => !s.isLocked && !this.isShapeHidden(s)
+    );
+    const maybeDraggingOverShapes = this.getShapesAtPoint(point, {
+      hitInside: true,
+      margin: 0
+    }).filter(
+      (s) => !droppingShapes.includes(s) && !s.isLocked && !this.isShapeHidden(s) && !draggingShapes.includes(s)
+    );
+    for (const maybeDraggingOverShape of maybeDraggingOverShapes) {
+      const shapeUtil = this.getShapeUtil(maybeDraggingOverShape);
+      if (shapeUtil.onDragShapesOver || shapeUtil.onDragShapesIn || shapeUtil.onDragShapesOut || shapeUtil.onDropShapesOver) {
+        return maybeDraggingOverShape;
       }
     }
   }
@@ -4702,7 +4696,8 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
    */
   duplicateShapes(shapes, offset) {
     this.run(() => {
-      const ids = typeof shapes[0] === "string" ? shapes : shapes.map((s) => s.id);
+      const _ids = typeof shapes[0] === "string" ? shapes : shapes.map((s) => s.id);
+      const ids = this._shouldIgnoreShapeLock ? _ids : this._getUnlockedShapeIds(_ids);
       if (ids.length <= 0) return this;
       const initialIds = new Set(ids);
       const shapeIdSet = this.getShapeAndDescendantIds(ids);
@@ -4766,8 +4761,7 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
         shape.index = index;
       });
       const shapesToCreate = shapesToCreateWithOriginals.map(({ shape }) => shape);
-      const maxShapesReached = shapesToCreate.length + this.getCurrentPageShapeIds().size > this.options.maxShapesPerPage;
-      if (maxShapesReached) {
+      if (!this.canCreateShapes(shapesToCreate)) {
         alertMaxShapes(this);
         return;
       }
@@ -5782,6 +5776,26 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
   getInitialMetaForShape(_shape) {
     return {};
   }
+  /**
+   * Get whether the provided shape can be created.
+   *
+   * @param shape - The shape or shape IDs to check.
+   *
+   * @public
+   */
+  canCreateShape(shape) {
+    return this.canCreateShapes([shape]);
+  }
+  /**
+   * Get whether the provided shapes can be created.
+   *
+   * @param shapes - The shapes or shape IDs to create.
+   *
+   * @public
+   */
+  canCreateShapes(shapes) {
+    return shapes.length + this.getCurrentPageShapeIds().size <= this.options.maxShapesPerPage;
+  }
   /**
    * Create a single shape.
    *
@@ -5835,7 +5849,8 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
           let parentId = this.getFocusedGroupId();
           for (let i = currentPageShapesSorted.length - 1; i >= 0; i--) {
             const parent = currentPageShapesSorted[i];
-            if (!this.isShapeHidden(parent) && this.getShapeUtil(parent).canReceiveNewChildrenOfType(parent, partial.type) && this.isPointInShape(
+            const util = this.getShapeUtil(parent);
+            if (util.canReceiveNewChildrenOfType(parent, partial.type) && !this.isShapeHidden(parent) && this.isPointInShape(
               parent,
               // If no parent is provided, then we can treat the
               // shape's provided x/y as being in the page's space.
@@ -5910,6 +5925,8 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
           ...shape.meta
         };
       });
+      this.emit("created-shapes", shapeRecordsToCreate);
+      this.emit("edit");
       this.store.put(shapeRecordsToCreate);
     });
     return this;
@@ -6151,6 +6168,8 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
         updated = this.getShapeUtil(shape).onBeforeUpdate?.(shape, updated) ?? updated;
         updates.push(updated);
       }
+      this.emit("edited-shapes", updates);
+      this.emit("edit");
       this.store.put(updates);
     });
   }
@@ -6172,6 +6191,8 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
         allShapeIdsToDelete.add(childId);
       });
     }
+    this.emit("deleted-shapes", [...allShapeIdsToDelete]);
+    this.emit("edit");
     return this.run(() => this.store.remove([...allShapeIdsToDelete]));
   }
   deleteShape(_id) {
@@ -6515,6 +6536,14 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
   async putExternalContent(info) {
     return this.externalContentHandlers[info.type]?.(info);
   }
+  /**
+   * Handle replacing external content.
+   *
+   * @param info - Info about the external content.
+   */
+  async replaceExternalContent(info) {
+    return this.externalContentHandlers[info.type]?.(info);
+  }
   /**
    * Get content that can be exported for the given shape ids.
    *
@@ -6932,7 +6961,9 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
       previousScreenPoint,
       previousPagePoint,
       currentScreenPoint,
-      currentPagePoint
+      currentPagePoint,
+      originScreenPoint,
+      originPagePoint
     } = this.inputs;
     const { screenBounds } = this.store.unsafeGetWithoutCapture(TLINSTANCE_ID);
     const { x: cx, y: cy, z: cz } = unsafe__withoutCapture(() => this.getCamera());
@@ -6950,8 +6981,8 @@ class Editor extends (_a = EventEmitter, _getIsShapeHiddenCache_dec = [computed]
     this.inputs.isPen = info.type === "pointer" && info.isPen;
     if (info.name === "pointer_down" || this.inputs.isPinching) {
       pointerVelocity.set(0, 0);
-      this.inputs.originScreenPoint.setTo(currentScreenPoint);
-      this.inputs.originPagePoint.setTo(currentPagePoint);
+      originScreenPoint.setTo(currentScreenPoint);
+      originPagePoint.setTo(currentPagePoint);
     }
     this.run(
       () => {
@@ -7841,7 +7872,7 @@ __decorateElement(_init, 1, "_getShapePageBoundsCache", __getShapePageBoundsCach
 __decorateElement(_init, 1, "_getShapeClipPathCache", __getShapeClipPathCache_dec, Editor);
 __decorateElement(_init, 1, "_getShapeMaskCache", __getShapeMaskCache_dec, Editor);
 __decorateElement(_init, 1, "_getShapeMaskedPageBoundsCache", __getShapeMaskedPageBoundsCache_dec, Editor);
-__decorateElement(_init, 1, "_notVisibleShapes", __notVisibleShapes_dec, Editor);
+__decorateElement(_init, 1, "getNotVisibleShapes", _getNotVisibleShapes_dec, Editor);
 __decorateElement(_init, 1, "getCulledShapes", _getCulledShapes_dec, Editor);
 __decorateElement(_init, 1, "getCurrentPageBounds", _getCurrentPageBounds_dec, Editor);
 __decorateElement(_init, 1, "getCurrentPageShapes", _getCurrentPageShapes_dec, Editor);