fix(shapes): add shape parameter to ShapeUtil base class methods (tldraw#8521)

Closes tldraw#8456

In order to fix the TypeScript signature mismatch where `ShapeUtil` base
class methods declare a `shape` parameter that overrides omit, this PR
cleans up both sides: the base class param names are tidied (removing
unnecessary underscore prefixes on `canBind` and
`canReceiveNewChildrenOfType`), and override implementations that had
unused `_shape` params from an earlier pass now omit them entirely —
TypeScript allows omitting trailing parameters in overrides, so they
only need to appear in implementations that actually reference the
shape.

### Change type

- [x] `bugfix`

### Test plan

1. Create image, video, note, text, geo, arrow, frame, embed, and line
shapes
2. Verify resize, crop, and other interactions work as before

- [ ] Unit tests
- [ ] End to end tests

### Release notes

- Fixed ShapeUtil method signatures so overrides that need the `shape`
parameter can declare it without TypeScript errors.

### API changes

Changes to `packages/editor/api-report.api.md`:
- `ShapeUtil.canBind(_opts)` → `ShapeUtil.canBind(opts)` — removed
underscore prefix
- `ShapeUtil.canReceiveNewChildrenOfType(shape, _type)` →
`ShapeUtil.canReceiveNewChildrenOfType(shape, type)` — removed
underscore prefix

### Code changes

| Section         | LOC change |
| --------------- | ---------- |
| Core code       | +2 / -2   |
| Automated files | +2 / -2   |
| Documentation   | +4 / -4   |
| Templates       | +3 / -3   |

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: steveruizok

apps/examples/src/examples/configuration/reduced-motion/ReducedMotionExample.tsx

@@ -56,7 +56,7 @@ export class PulseShapeUtil extends ShapeUtil<PulseShape> {
 		return { w: 200, h: 200 }
 	}
 
-	override canEdit() {
+	override canEdit(shape: PulseShape) {
 		return false
 	}
 

apps/examples/src/examples/shapes/tools/bounds-snapping-shape/PlayingCardShape/playing-card-util.tsx

@@ -36,7 +36,7 @@ export class PlayingCardUtil extends BaseBoxShapeUtil<IPlayingCard> {
 	}
 
 	// [4]
-	override isAspectRatioLocked(_shape: IPlayingCard) {
+	override isAspectRatioLocked(shape: IPlayingCard) {
 		return true
 	}
 

apps/examples/src/examples/shapes/tools/custom-config/CardShape/CardShapeUtil.tsx

@@ -33,10 +33,10 @@ export class CardShapeUtil extends ShapeUtil<ICardShape> {
 	static override migrations = cardShapeMigrations
 
 	// [3]
-	override isAspectRatioLocked(_shape: ICardShape) {
+	override isAspectRatioLocked(shape: ICardShape) {
 		return false
 	}
-	override canResize(_shape: ICardShape) {
+	override canResize(shape: ICardShape) {
 		return true
 	}
 

apps/examples/src/examples/shapes/tools/custom-shape/CustomShapeExample.tsx

@@ -46,13 +46,13 @@ export class MyShapeUtil extends ShapeUtil<ICustomShape> {
 	}
 
 	// [c]
-	override canEdit() {
+	override canEdit(shape: ICustomShape) {
 		return false
 	}
-	override canResize() {
+	override canResize(shape: ICustomShape) {
 		return true
 	}
-	override isAspectRatioLocked() {
+	override isAspectRatioLocked(shape: ICustomShape) {
 		return false
 	}
 

apps/examples/src/examples/shapes/tools/drag-and-drop/DragAndDropExample.tsx

@@ -30,10 +30,10 @@ const SLOT_SIZE = 100
 class MyCounterShapeUtil extends ShapeUtil<MyCounterShape> {
 	static override type = MY_COUNTER_SHAPE_TYPE
 
-	override canResize() {
+	override canResize(shape: MyCounterShape) {
 		return false
 	}
-	override hideResizeHandles() {
+	override hideResizeHandles(shape: MyCounterShape) {
 		return true
 	}
 
@@ -78,10 +78,10 @@ class MyGridShapeUtil extends ShapeUtil<MyGridShape> {
 		})
 	}
 
-	override canResize() {
+	override canResize(shape: MyGridShape) {
 		return false
 	}
-	override hideResizeHandles() {
+	override hideResizeHandles(shape: MyGridShape) {
 		return true
 	}
 

apps/examples/src/examples/shapes/tools/editable-shape/EditableShapeUtil.tsx

@@ -27,12 +27,12 @@ export class EditableShapeUtil extends BaseBoxShapeUtil<IMyEditableShape> {
 	}
 
 	// [1]
-	override canEdit() {
+	override canEdit(shape: IMyEditableShape) {
 		return true
 	}
 
 	// [1b]
-	override canEditWhileLocked() {
+	override canEditWhileLocked(shape: IMyEditableShape) {
 		return true
 	}
 

apps/examples/src/examples/shapes/tools/globs-editor/GlobShapeUtil.tsx

@@ -224,23 +224,23 @@ export class GlobShapeUtil extends ShapeUtil<GlobShape> {
 		}
 	}
 
-	override hideSelectionBoundsBg(_shape: GlobShape): boolean {
+	override hideSelectionBoundsBg(shape: GlobShape): boolean {
 		return true
 	}
 
-	override hideResizeHandles(_shape: GlobShape): boolean {
+	override hideResizeHandles(shape: GlobShape): boolean {
 		return true
 	}
 
-	override hideRotateHandle(_shape: GlobShape): boolean {
+	override hideRotateHandle(shape: GlobShape): boolean {
 		return true
 	}
 
-	override hideSelectionBoundsFg(_shape: GlobShape): boolean {
+	override hideSelectionBoundsFg(shape: GlobShape): boolean {
 		return true
 	}
 
-	override onResize(_shape: GlobShape, info: TLResizeInfo<GlobShape>) {
+	override onResize(shape: GlobShape, info: TLResizeInfo<GlobShape>) {
 		const { scaleX, scaleY, initialShape } = info
 
 		const scaledEdgeA_d = {

apps/examples/src/examples/shapes/tools/globs-editor/NodeShapeUtil.tsx

@@ -45,19 +45,19 @@ export class NodeShapeUtil extends ShapeUtil<NodeShape> {
 		}
 	}
 
-	override hideResizeHandles(_shape: NodeShape): boolean {
+	override hideResizeHandles(shape: NodeShape): boolean {
 		return true
 	}
 
-	override hideRotateHandle(_shape: NodeShape): boolean {
+	override hideRotateHandle(shape: NodeShape): boolean {
 		return true
 	}
 
-	override hideSelectionBoundsBg(_shape: NodeShape): boolean {
+	override hideSelectionBoundsBg(shape: NodeShape): boolean {
 		return true
 	}
 
-	override hideSelectionBoundsFg(_shape: NodeShape): boolean {
+	override hideSelectionBoundsFg(shape: NodeShape): boolean {
 		return true
 	}
 
@@ -70,7 +70,7 @@ export class NodeShapeUtil extends ShapeUtil<NodeShape> {
 		})
 	}
 
-	override onResize(_shape: NodeShape, info: TLResizeInfo<NodeShape>) {
+	override onResize(shape: NodeShape, info: TLResizeInfo<NodeShape>) {
 		const { scaleX, scaleY, initialShape } = info
 		const avgScale = (Math.abs(scaleX) + Math.abs(scaleY)) / 2
 

apps/examples/src/examples/shapes/tools/layout-bindings/LayoutExample.tsx

@@ -54,16 +54,16 @@ class ContainerShapeUtil extends ShapeUtil<ContainerShape> {
 			fromShape.type === 'container' && toShape.type === 'element' && bindingType === LAYOUT_TYPE
 		)
 	}
-	override canEdit() {
+	override canEdit(shape: ContainerShape) {
 		return false
 	}
-	override canResize() {
+	override canResize(shape: ContainerShape) {
 		return false
 	}
-	override hideRotateHandle() {
+	override hideRotateHandle(shape: ContainerShape) {
 		return true
 	}
-	override isAspectRatioLocked() {
+	override isAspectRatioLocked(shape: ContainerShape) {
 		return true
 	}
 
@@ -113,16 +113,16 @@ class ElementShapeUtil extends ShapeUtil<ElementShape> {
 			fromShape.type === 'container' && toShape.type === 'element' && bindingType === LAYOUT_TYPE
 		)
 	}
-	override canEdit() {
+	override canEdit(shape: ElementShape) {
 		return false
 	}
-	override canResize() {
+	override canResize(shape: ElementShape) {
 		return false
 	}
-	override hideRotateHandle() {
+	override hideRotateHandle(shape: ElementShape) {
 		return true
 	}
-	override isAspectRatioLocked() {
+	override isAspectRatioLocked(shape: ElementShape) {
 		return true
 	}
 

apps/examples/src/examples/shapes/tools/pin-bindings/PinExample.tsx

@@ -59,13 +59,13 @@ class PinShapeUtil extends ShapeUtil<PinShape> {
 		// Allow pins to participate in other bindings, e.g. arrows
 		return true
 	}
-	override canEdit() {
+	override canEdit(shape: PinShape) {
 		return false
 	}
-	override canResize() {
+	override canResize(shape: PinShape) {
 		return false
 	}
-	override hideRotateHandle() {
+	override hideRotateHandle(shape: PinShape) {
 		return true
 	}
 	override isAspectRatioLocked() {