@expofp/renderer 3.41.0 → 3.42.0

package/dist/types/events.d.ts

@@ -27,7 +27,11 @@ export interface PointerEventData<T extends RenderableDef = RenderableDef> {
      * A fresh instance per event, so keeping a reference to it is safe.
      */
     point: PlanPoint;
-    /** Keeps the event from reaching the ancestors of the layer whose handler is running. */
+    /**
+     * Ends the event's delivery: neither the ancestors of the layer whose handler is running nor any
+     * def farther along the ray receives it. A handler that wants only the nearest of several
+     * overlapping defs calls this.
+     */
     stopPropagation(): void;
     /** The DOM event this was dispatched from. */
     nativeEvent: MouseEvent;
@@ -59,10 +63,15 @@ export interface PointerMissedEventData {
  * with any is raycast together with its whole subtree; a layer that is off screen — hidden, or under
  * something hidden — is not picked at all.
  *
- * **Events travel upward.** The nearest layer's handler runs first, then each ancestor that declares
- * the same handler, until one calls {@link PointerEventData.stopPropagation}; `event.def` stays the
- * def that was hit. Overlapping defs deliver one event apiece — even within one layer — in the order
- * their slots were claimed (mount order), not paint order; `Pointer/Overlap` pins that.
+ * **Events travel upward and away.** The nearest def's layer handler runs first, then each ancestor
+ * that declares the same handler, then the next def along the ray, until one calls
+ * {@link PointerEventData.stopPropagation}; `event.def` stays the def that was hit. Overlapping defs
+ * deliver one event apiece, even within one layer. Defs at the same distance, such as coplanar flat
+ * defs, arrive in the order their slots were claimed (mount order), not paint order;
+ * `Pointer/Overlap` pins that.
+ *
+ * **Only interactive layers are hit.** A layer with no handlers is not raycast, so it never shields
+ * a def behind it: a booth behind a wall still receives the event.
  *
  * **Handlers return nothing.** One that mutates defs calls `update()` afterward, like any other code.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expofp/renderer",
-  "version": "3.41.0",
+  "version": "3.42.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/expofp/efp-app.git",
@@ -42,7 +42,7 @@
     "troika-three-text": "^0.52.5",
     "tslib": "^2.3.0",
     "webgl-memory": "^1.1.3",
-    "@expofp/geometry": "3.41.0"
+    "@expofp/geometry": "3.42.0"
   },
   "devDependencies": {
     "@react-three/test-renderer": "^9.1.0",