@selvajs/visualization 1.6.0-beta.10 → 1.6.0-beta.11

package/dist/render.d.cts

@@ -376,12 +376,13 @@ interface LabelLayer {
   dispose(): void;
 }
 /**
- * Two-click distance measurement. Click a point, click a second, read the distance off a label on
- * the connecting line; a third click starts fresh.
+ * Point-to-point distance measurement. Click a start point; a rubber band and live readout follow
+ * the cursor until the second click commits it. Committed measurements stay until Escape (which
+ * first drops an unfinished start point) or until the tool is disabled.
  *
- * Picking snaps to the nearest vertex within {@link MeasureOptions.snapPixels} so measurements
- * land exactly on vertices rather than wherever the ray happened to hit — a cheap local snap
- * against the struck primitive's own vertices, no spatial index.
+ * Picking snaps to the nearest vertex of the struck triangle, segment or point within
+ * {@link MeasureOptions.snapPixels}; the hover marker turns solid when it has snapped. Meshes are
+ * picked through a BVH (`scene-pick.ts`), so hovering stays cheap on large models.
  *
  * Dormant until {@link MeasureTool.setEnabled}(true). While enabled it intercepts clicks (caller
  * forwards them and swallows the event when {@link MeasureTool.handleClick} returns true) so
@@ -392,8 +393,10 @@ interface MeasureTool {
   isEnabled(): boolean;
   /** Returns true if the tool consumed the click (caller should not also select). */
   handleClick(event: MouseEvent): boolean;
-  /** Preview the next snap point via a ghost marker. No-op when disabled; never consumes the event. */
+  /** Preview the next snap point and the rubber band. No-op when disabled; never consumes the event. */
   handleMove(event: MouseEvent): void;
+  /** Drops the unfinished start point, or every measurement when there is none. Bound to Escape. */
+  cancel(): void;
   clear(): void;
   dispose(): void;
 }

package/dist/render.d.ts

@@ -376,12 +376,13 @@ interface LabelLayer {
   dispose(): void;
 }
 /**
- * Two-click distance measurement. Click a point, click a second, read the distance off a label on
- * the connecting line; a third click starts fresh.
+ * Point-to-point distance measurement. Click a start point; a rubber band and live readout follow
+ * the cursor until the second click commits it. Committed measurements stay until Escape (which
+ * first drops an unfinished start point) or until the tool is disabled.
  *
- * Picking snaps to the nearest vertex within {@link MeasureOptions.snapPixels} so measurements
- * land exactly on vertices rather than wherever the ray happened to hit — a cheap local snap
- * against the struck primitive's own vertices, no spatial index.
+ * Picking snaps to the nearest vertex of the struck triangle, segment or point within
+ * {@link MeasureOptions.snapPixels}; the hover marker turns solid when it has snapped. Meshes are
+ * picked through a BVH (`scene-pick.ts`), so hovering stays cheap on large models.
  *
  * Dormant until {@link MeasureTool.setEnabled}(true). While enabled it intercepts clicks (caller
  * forwards them and swallows the event when {@link MeasureTool.handleClick} returns true) so
@@ -392,8 +393,10 @@ interface MeasureTool {
   isEnabled(): boolean;
   /** Returns true if the tool consumed the click (caller should not also select). */
   handleClick(event: MouseEvent): boolean;
-  /** Preview the next snap point via a ghost marker. No-op when disabled; never consumes the event. */
+  /** Preview the next snap point and the rubber band. No-op when disabled; never consumes the event. */
   handleMove(event: MouseEvent): void;
+  /** Drops the unfinished start point, or every measurement when there is none. Bound to Escape. */
+  cancel(): void;
   clear(): void;
   dispose(): void;
 }