@tldraw/editor 4.4.0-canary.4e4f05b278df → 4.4.0-canary.52ddccb88729

package/dist-cjs/index.d.ts

@@ -909,6 +909,7 @@ export declare const defaultTldrawOptions: {
     readonly maxShapesPerPage: 4000;
     readonly multiClickDurationMs: 200;
     readonly nonce: undefined;
+    readonly quickZoomPreservesScreenBounds: true;
     readonly snapThreshold: 8;
     readonly spacebarPanning: true;
     readonly temporaryAssetPreviewLifetimeMs: 180000;
@@ -2259,10 +2260,10 @@ export declare class Editor extends EventEmitter<TLEventMap> {
      */
     stopFollowingUser(): this;
     /* Excluded from this release type: getUnorderedRenderingShapes */
-    private _cameraState;
     private _cameraStateTimeoutRemaining;
     private _decayCameraStateTimeout;
     private _tickCameraState;
+    private _setCameraState;
     /**
      * Whether the camera is moving or idle.
      *
@@ -2761,7 +2762,24 @@ export declare class Editor extends EventEmitter<TLEventMap> {
         hitInside?: boolean;
         margin?: number;
     }): TLShape[];
-    /* Excluded from this release type: getShapeIdsInsideBounds */
+    /**
+     * Get shape IDs within the given bounds.
+     *
+     * Note: Uses shape page bounds only. Frames with labels outside their bounds
+     * may not be included even if the label is within the search bounds.
+     *
+     * Note: Results are unordered. If you need z-order, combine with sorted shapes:
+     * ```ts
+     * const candidates = editor.getShapeIdsInsideBounds(bounds)
+     * const sorted = editor.getCurrentPageShapesSorted().filter(s => candidates.has(s.id))
+     * ```
+     *
+     * @param bounds - The bounds to search within.
+     * @returns Unordered set of shape IDs within the given bounds.
+     *
+     * @public
+     */
+    getShapeIdsInsideBounds(bounds: Box): Set<TLShapeId>;
     /**
      * Test whether a point (in the current page space) will will a shape. This method takes into account masks,
      * such as when a shape is the child of a frame and is partially clipped by the frame.
@@ -7022,13 +7040,13 @@ export declare interface TldrawOptions {
     readonly branding?: string;
     /**
      * Whether to use debounced zoom level for certain rendering optimizations. When true,
-     * `editor.getDebouncedZoomLevel()` returns a cached zoom value while the camera is moving,
+     * `editor.getEfficientZoomLevel()` returns a cached zoom value while the camera is moving,
      * reducing re-renders. When false, it always returns the current zoom level.
      */
     readonly debouncedZoom: boolean;
     /**
      * The number of shapes that must be on the page for the debounced zoom level to be used.
-     * Defaults to 300 shapes.
+     * Defaults to 500 shapes.
      */
     readonly debouncedZoomThreshold: number;
     /**
@@ -7047,6 +7065,13 @@ export declare interface TldrawOptions {
      * The distance (in screen pixels) at which shapes snap to guides and other shapes.
      */
     readonly snapThreshold: number;
+    /**
+     * Whether the quick-zoom brush preserves its screen-pixel size when the user
+     * zooms the overview. When true, zooming in shrinks the target viewport (higher
+     * return zoom); zooming out expands it. When false, the brush keeps the original
+     * viewport's page dimensions regardless of overview zoom changes.
+     */
+    readonly quickZoomPreservesScreenBounds: boolean;
 }
 
 /** @public */
@@ -8002,17 +8027,35 @@ export declare interface TLShapeUtilCanBeLaidOutOpts {
 
 /**
  * Options passed to {@link ShapeUtil.canBind}. A binding that could be made. At least one of
- * `fromShapeType` or `toShapeType` will belong to this shape util.
+ * `fromShape` or `toShape` will belong to this shape util.
+ *
+ * The shapes may be full {@link @tldraw/tlschema#TLShape} objects when available, or just
+ * `{ type }` stubs when the shape hasn't been created yet (e.g. during arrow creation). Use
+ * `'id' in shape` to check whether the full shape is available.
  *
  * @public
  */
 export declare interface TLShapeUtilCanBindOpts<Shape extends TLShape = TLShape> {
-    /** The type of shape referenced by the `fromId` of the binding. */
-    fromShapeType: TLShape['type'];
-    /** The type of shape referenced by the `toId` of the binding. */
-    toShapeType: TLShape['type'];
+    /** The shape referenced by the `fromId` of the binding, or a `{ type }` stub if unavailable. */
+    fromShape: {
+        type: TLShape['type'];
+    } | TLShape;
+    /** The shape referenced by the `toId` of the binding, or a `{ type }` stub if unavailable. */
+    toShape: {
+        type: TLShape['type'];
+    } | TLShape;
     /** The type of binding. */
     bindingType: string;
+    /**
+     * The type of shape referenced by the `fromId` of the binding.
+     * @deprecated Use `fromShape.type` instead.
+     */
+    fromShapeType: TLShape['type'];
+    /**
+     * The type of shape referenced by the `toId` of the binding.
+     * @deprecated Use `toShape.type` instead.
+     */
+    toShapeType: TLShape['type'];
 }
 
 /** @public */

package/dist-cjs/index.js

@@ -372,7 +372,7 @@ var import_uniq = require("./lib/utils/uniq");
 var import_window_open = require("./lib/utils/window-open");
 (0, import_utils.registerTldrawLibraryVersion)(
   "@tldraw/editor",
-  "4.4.0-canary.4e4f05b278df",
+  "4.4.0-canary.52ddccb88729",
   "cjs"
 );
 //# sourceMappingURL=index.js.map

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

@@ -298,7 +298,6 @@ class Editor extends (_a = import_eventemitter3.default, _getIsShapeHiddenCache_
     // unmount / remount in the DOM, which is expensive; and computing visibility is
     // also expensive in large projects. For this reason, we use a second bounding
     // box just for rendering, and we only update after the camera stops moving.
-    __publicField(this, "_cameraState", (0, import_state.atom)("camera state", "idle"));
     __publicField(this, "_cameraStateTimeoutRemaining", 0);
     /* @internal */
     __publicField(this, "_currentPageShapeIds");
@@ -3088,15 +3087,18 @@ class Editor extends (_a = import_eventemitter3.default, _getIsShapeHiddenCache_
     this._cameraStateTimeoutRemaining -= elapsed;
     if (this._cameraStateTimeoutRemaining > 0) return;
     this.off("tick", this._decayCameraStateTimeout);
-    this._cameraState.set("idle");
+    this._setCameraState("idle");
   }
   _tickCameraState() {
     this._cameraStateTimeoutRemaining = this.options.cameraMovingTimeoutMs;
-    if (this._cameraState.__unsafe__getWithoutCapture() !== "idle") return;
-    this._cameraState.set("moving");
+    if (this.getInstanceState().cameraState !== "idle") return;
+    this._setCameraState("moving");
     this._debouncedZoomLevel.set((0, import_state.unsafe__withoutCapture)(() => this.getCamera().z));
     this.on("tick", this._decayCameraStateTimeout);
   }
+  _setCameraState(cameraState) {
+    this.updateInstanceState({ cameraState }, { history: "ignore" });
+  }
   /**
    * Whether the camera is moving or idle.
    *
@@ -3108,7 +3110,7 @@ class Editor extends (_a = import_eventemitter3.default, _getIsShapeHiddenCache_
    * @public
    */
   getCameraState() {
-    return this._cameraState.get();
+    return this.getInstanceState().cameraState;
   }
   getRenderingShapes() {
     const renderingShapes = this.getUnorderedRenderingShapes(true);
@@ -4053,7 +4055,7 @@ class Editor extends (_a = import_eventemitter3.default, _getIsShapeHiddenCache_
    * @param bounds - The bounds to search within.
    * @returns Unordered set of shape IDs within the given bounds.
    *
-   * @internal
+   * @public
    */
   getShapeIdsInsideBounds(bounds) {
     return this._spatialIndex.getShapeIdsInsideBounds(bounds);
@@ -4596,7 +4598,13 @@ class Editor extends (_a = import_eventemitter3.default, _getIsShapeHiddenCache_
     const fromShapeType = typeof fromShape === "string" ? fromShape : fromShape.type;
     const toShapeType = typeof toShape === "string" ? toShape : toShape.type;
     const bindingType = typeof binding === "string" ? binding : binding.type;
-    const canBindOpts = { fromShapeType, toShapeType, bindingType };
+    const canBindOpts = {
+      fromShape: typeof fromShape === "string" ? { type: fromShape } : fromShape,
+      toShape: typeof toShape === "string" ? { type: toShape } : toShape,
+      bindingType,
+      fromShapeType,
+      toShapeType
+    };
     if (fromShapeType === toShapeType) {
       return this.getShapeUtil(fromShapeType).canBind(canBindOpts);
     }
@@ -5736,7 +5744,8 @@ class Editor extends (_a = import_eventemitter3.default, _getIsShapeHiddenCache_
     this.resizeShape(id, shapeScale, {
       initialShape: options.initialShape,
       initialBounds: options.initialBounds,
-      isAspectRatioLocked: options.isAspectRatioLocked
+      isAspectRatioLocked: options.isAspectRatioLocked,
+      initialPageTransform: options.initialPageTransform
     });
     if (Math.sign(scale.x) * Math.sign(scale.y) < 0) {
       const parentRotation = this.getShapeParentTransform(id).rotation();