@tldraw/editor 5.3.0-canary.ec4b74d7eb64 → 5.3.0-canary.f8a4bdc003b1

package/dist-cjs/index.d.ts

@@ -1007,6 +1007,7 @@ export declare const defaultTldrawOptions: {
     readonly cameraSlideFriction: 0.09;
     readonly coarseDragDistanceSquared: 36;
     readonly coarseHandleRadius: 20;
+    readonly coarseHitTestMargin: 4;
     readonly coarsePointerWidth: 12;
     readonly collaboratorCheckIntervalMs: 1200;
     readonly collaboratorIdleTimeoutMs: 3000;
@@ -1046,7 +1047,7 @@ export declare const defaultTldrawOptions: {
         readonly step: 1;
     }];
     readonly handleRadius: 12;
-    readonly hitTestMargin: 8;
+    readonly hitTestMargin: 3;
     readonly laserDelayMs: 1200;
     readonly laserFadeoutMs: 500;
     readonly longPressDurationMs: 500;
@@ -3101,6 +3102,17 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      * @public
      */
     getCurrentPageBounds(): Box | undefined;
+    /**
+     * Get the hit-test margin in page space—the distance in page units within which a pointer is
+     * considered to be touching a shape. This resolves to {@link TldrawOptions.hitTestMargin} (or
+     * {@link TldrawOptions.coarseHitTestMargin} when using a coarse pointer) divided by the current
+     * zoom level, so it stays a constant distance in screen space.
+     *
+     * @returns The hit-test margin in page space.
+     *
+     * @public
+     */
+    getHitTestMargin(): number;
     /**
      * Get the top-most selected shape at the given point, ignoring groups.
      *
@@ -6781,6 +6793,29 @@ export declare abstract class ShapeUtil<Shape extends TLShape = TLShape> {
      * @public
      */
     onBeforeCreate?(next: Shape): Shape | void;
+    /**
+     * A callback called when a shape is reproduced from an existing shape, either by duplicating
+     * ({@link Editor.duplicateShapes}) or by pasting/putting content onto the page
+     * ({@link Editor.putContentOntoCurrentPage}). This provides a last chance to modify the copy
+     * before it's created — for example, to re-stamp attribution so the copy is credited to the
+     * current user rather than the original author. It is not called when content is put with
+     * `preserveIds` (e.g. {@link Editor.moveShapesToPage}), since the shape keeps its identity
+     * and no copy is made.
+     *
+     * @example
+     *
+     * ```ts
+     * onBeforeDuplicate = (source, duplicate) => {
+     * 	return { ...duplicate, props: { ...duplicate.props, editedBy: this.editor.getAttributionUserId() } }
+     * }
+     * ```
+     *
+     * @param source - The shape being copied from.
+     * @param duplicate - The new copy (with its own id), before it's created.
+     * @returns The next shape or void.
+     * @public
+     */
+    onBeforeDuplicate?(source: Shape, duplicate: Shape): Shape | void;
     /**
      * A callback called just before a shape is updated. This method provides a last chance to modify
      * the updated shape.
@@ -8047,6 +8082,7 @@ export declare interface TldrawOptions {
     readonly collaboratorCheckIntervalMs: number;
     readonly cameraMovingTimeoutMs: number;
     readonly hitTestMargin: number;
+    readonly coarseHitTestMargin: number;
     readonly edgeScrollDelay: number;
     readonly edgeScrollEaseDuration: number;
     readonly edgeScrollSpeed: number;

package/dist-cjs/index.js

@@ -379,7 +379,7 @@ var import_uniq = require("./lib/utils/uniq");
 var import_defaultThemes2 = require("./lib/editor/managers/ThemeManager/defaultThemes");
 (0, import_utils.registerTldrawLibraryVersion)(
   "@tldraw/editor",
-  "5.3.0-canary.ec4b74d7eb64",
+  "5.3.0-canary.f8a4bdc003b1",
   "cjs"
 );
 //# sourceMappingURL=index.js.map

package/dist-cjs/lib/editor/Editor.js

@@ -4243,6 +4243,11 @@ class Editor extends import_eventemitter3.default {
     });
     return commonBounds;
   }
+  getHitTestMargin() {
+    const { hitTestMargin, coarseHitTestMargin } = this.options;
+    const margin = this.getInstanceState().isCoarsePointer ? coarseHitTestMargin : hitTestMargin;
+    return margin / this.getZoomLevel();
+  }
   /**
    * Get the top-most selected shape at the given point, ignoring groups.
    *
@@ -4277,7 +4282,6 @@ class Editor extends import_eventemitter3.default {
    * @returns The shape at the given point, or undefined if there is no shape at the point.
    */
   getShapeAtPoint(point, opts = {}) {
-    const zoomLevel = this.getZoomLevel();
     const viewportPageBounds = this.getViewportPageBounds();
     const {
       filter,
@@ -4292,7 +4296,7 @@ class Editor extends import_eventemitter3.default {
     let inHollowSmallestAreaHit = null;
     let inMarginClosestToEdgeDistance = Infinity;
     let inMarginClosestToEdgeHit = null;
-    const searchMargin = Math.max(innerMargin, outerMargin, this.options.hitTestMargin / zoomLevel);
+    const searchMargin = Math.max(innerMargin, outerMargin, this.getHitTestMargin());
     const candidateIds = this._spatialIndex.getShapeIdsAtPoint(point, searchMargin);
     const shapesToCheck = (opts.renderingOnly ? this.getCurrentPageRenderingShapesSorted() : this.getCurrentPageShapesSorted()).filter((shape) => {
       if (!candidateIds.has(shape.id) && !this.isShapeFrameLike(shape)) return false;
@@ -4383,7 +4387,7 @@ class Editor extends import_eventemitter3.default {
           }
         }
       } else {
-        if (distance < this.options.hitTestMargin / zoomLevel) {
+        if (distance < this.getHitTestMargin()) {
           return shape;
         }
       }
@@ -5167,7 +5171,9 @@ class Editor extends import_eventemitter3.default {
         const index = (0, import_utils.getIndexBetween)(originalShape.index, siblingAbove?.index);
         shape.index = index;
       });
-      const shapesToCreate = shapesToCreateWithOriginals.map(({ shape }) => shape);
+      const shapesToCreate = shapesToCreateWithOriginals.map(({ shape, originalShape }) => {
+        return this.getShapeUtil(shape).onBeforeDuplicate?.(originalShape, shape) ?? shape;
+      });
       if (!this.canCreateShapes(shapesToCreate)) {
         alertMaxShapes(this);
         return;
@@ -7193,7 +7199,10 @@ class Editor extends import_eventemitter3.default {
     const rootShapes = [];
     const newShapes = shapes.map((oldShape) => {
       const newId = shapeIdMap.get(oldShape.id);
-      const newShape = { ...oldShape, id: newId };
+      let newShape = { ...oldShape, id: newId };
+      if (!preserveIds) {
+        newShape = this.getShapeUtil(newShape).onBeforeDuplicate?.(oldShape, newShape) ?? newShape;
+      }
       if (rootShapeIds.includes(oldShape.id)) {
         newShape.parentId = currentPageId;
         rootShapes.push(newShape);
@@ -8636,6 +8645,9 @@ __decorateClass([
 __decorateClass([
   import_state.computed
 ], Editor.prototype, "getCurrentPageBounds", 1);
+__decorateClass([
+  import_state.computed
+], Editor.prototype, "getHitTestMargin", 1);
 __decorateClass([
   import_state.computed
 ], Editor.prototype, "getCurrentPageShapes", 1);