refactor(events)!: empty-space clicks via canvas event.object — removing *Missed

[bigmistqke]

Alternative to #75. Where #75 adds a positive onVoid* family, this removes the *Missed handlers and leans on a single canvas-level check: event.object.

Summary

To react to a gesture that hit nothing, put the handler on the <Canvas> and read event.object — the nearest hit object, or undefined when the ray hit empty space.

<Canvas onClick={event => { if (!event.object) deselect() }}>
  <T.Mesh onClick={() => select()}>…</T.Mesh>
</Canvas>

This drops onClickMissed / onDoubleClickMissed / onContextMenuMissed.

Semantics

• A canvas-level handler fires after the event has propagated through the scene, unless a handler called stopPropagation(). event.object is the nearest hit, or undefined on empty space.
• Uniform across every discrete gesture — onClick, onDoubleClick, onContextMenu, onPointerDown, onPointerUp, onPointerMove, onWheel — all sharing one dispatch path (propagate()). click() folds into that path; the bespoke missed-tracking phases it used are gone.
• onPointerEnter / onPointerLeave are unaffected: they mark the canvas boundary (enter on entry, leave on exit), not a per-event hit, so there's no empty-vs-hit distinction to read there.
• A consumed event — one whose handler called stopPropagation() — never reaches the canvas, so it's neither a hit nor an empty click at that level.

Removed: per-object *Missed

*Missed also fired on individual objects ("the gesture didn't reach me, specifically"), and a total miss fired both the canvas handler and onClickMissed for the same empty click. That per-object inversion is gone; the canvas event.object check covers empty space directly.

Types

Canvas-level handlers type event.object as Object3D | undefined, so if (!event.object) type-checks as the empty-space test. Object-level handlers keep object: Object3D, since they only fire on a hit.

Tests

The canvas handler is asserted to fire with event.object undefined on a miss and set to the hit object on a hit, across all seven gestures.

Docs

Tour chapter, events reference, Canvas props, and the CONTEXT.md glossary migrated to the event.object pattern; the demo snippet renamed accordingly.

[pkg-pr-new]

• solid-three-demo

  npm i https://pkg.pr.new/solid-three@76
  

commit: bf2ac35