@tldraw/editor 3.16.0-canary.f55016ece635 → 3.16.0-canary.f56a36d13420

package/dist-cjs/index.d.ts

@@ -510,6 +510,7 @@ export declare class Box {
     static ExpandBy(A: Box, n: number): Box;
     static Collides(A: Box, B: Box): boolean;
     static Contains(A: Box, B: Box): boolean;
+    static ContainsApproximately(A: Box, B: Box, precision?: number): boolean;
     static Includes(A: Box, B: Box): boolean;
     static ContainsPoint(A: Box, B: VecLike, margin?: number): boolean;
     static Common(boxes: Box[]): Box;
@@ -5249,6 +5250,25 @@ export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknown
      */
     canBeLaidOut(_shape: Shape, _info: TLShapeUtilCanBeLaidOutOpts): boolean;
     /* Excluded from this release type: providesBackgroundForChildren */
+    /**
+     * Get the clip path to apply to this shape's children.
+     *
+     * @param shape - The shape to get the clip path for
+     * @returns Array of points defining the clipping polygon in local coordinates, or undefined if no clipping
+     * @public
+     */
+    getClipPath?(shape: Shape): undefined | Vec[];
+    /**
+     * Whether a specific child shape should be clipped by this shape.
+     * Only called if getClipPath returns a valid polygon.
+     *
+     * If not defined, the default behavior is to clip all children.
+     *
+     * @param child - The child shape to check
+     * @returns boolean indicating if this child should be clipped
+     * @public
+     */
+    shouldClipChild?(child: TLShape): boolean;
     /**
      * Whether the shape should hide its resize handles when selected.
      *
@@ -5279,6 +5299,17 @@ export declare abstract class ShapeUtil<Shape extends TLUnknownShape = TLUnknown
      * @public
      */
     isAspectRatioLocked(_shape: Shape): boolean;
+    /**
+     * By default, the bounds of an image export are the bounds of all the shapes it contains, plus
+     * some padding. If an export includes a shape where `isExportBoundsContainer` is true, then the
+     * padding is skipped _if the bounds of that shape contains all the other shapes_. This is
+     * useful in cases like annotating on top of an image, where you usually want to avoid extra
+     * padding around the image if you don't need it.
+     *
+     * @param _shape - The shape to check
+     * @returns True if this shape should be treated as an export bounds container
+     */
+    isExportBoundsContainer(_shape: Shape): boolean;
     /* Excluded from this release type: backgroundComponent */
     /**
      * Get the interpolated props for an animating shape. This is an optional method.

package/dist-cjs/index.js

@@ -371,7 +371,7 @@ function debugEnableLicensing() {
 }
 (0, import_utils.registerTldrawLibraryVersion)(
   "@tldraw/editor",
-  "3.16.0-canary.f55016ece635",
+  "3.16.0-canary.f56a36d13420",
   "cjs"
 );
 //# sourceMappingURL=index.js.map

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

@@ -3666,16 +3666,17 @@ class Editor extends (_a = import_eventemitter3.default, _getIsShapeHiddenCache_
   _getShapeMaskCache() {
     return this.store.createComputedCache("pageMaskCache", (shape) => {
       if ((0, import_tlschema.isPageId)(shape.parentId)) return void 0;
-      const frameAncestors = this.getShapeAncestors(shape.id).filter(
-        (shape2) => this.isShapeOfType(shape2, "frame")
-      );
-      if (frameAncestors.length === 0) return void 0;
-      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 clipPaths = [];
+      for (const ancestor of this.getShapeAncestors(shape.id)) {
+        const util = this.getShapeUtil(ancestor);
+        const clipPath = util.getClipPath?.(ancestor);
+        if (!clipPath) continue;
+        if (util.shouldClipChild?.(shape) === false) continue;
+        const pageTransform = this.getShapePageTransform(ancestor.id);
+        clipPaths.push(pageTransform.applyToPoints(clipPath));
+      }
+      if (clipPaths.length === 0) return void 0;
+      const pageMask = clipPaths.reduce((acc, b) => {
         const intersection = (0, import_intersect.intersectPolygonPolygon)(acc, b);
         if (intersection) {
           return intersection.map(import_Vec.Vec.Cast);