@displayxr/inline3d 1.41.0 → 1.42.1

package/CHANGELOG.md

@@ -5,6 +5,44 @@ entry points (`.`, `./three`) are frozen for 1.x, while the **scene subpaths** (
 `./splat`, `./model`) are a preview tier whose options may change in any release. Entries below say
 which tier they touch, because that is what tells you whether an upgrade can move your pixels.
 
+## 1.42.1 — 2026-10-12
+
+Touches the **preview tier** (`./call`, `./camera`) only: auto-convergence and the stereo-tile depth
+cursor are steadier on a wide-baseline camera. No API change.
+
+### Auto-convergence holds the face on a 120 mm-baseline camera
+
+- Found on the SR laptop's built-in stereo camera (120 mm baseline, grayscale): auto-convergence
+  flipped between the face and the background. On a dim frame the sparse block grid (1.5 blocks
+  apart) matched ~9 blocks, 3-4 on the face, too few to form the subject mode, so the background
+  won. The grid is now one block apart (~36 blocks: the face on every frame, ±1 px instead of ±4),
+  and a mode's bin widens with its disparity (10%), so a near face's own relief stays one group.
+- The convergence shift may now reach 20% of the eye width (was 12%): that camera sees a face at
+  0.6 m at ~22% of the eye width, ~11% per eye, which left no room to lean in.
+
+### Stereo-tile depth cursor: steady at foreground edges
+
+- The footprint was matched from the left eye's image only. At a foreground edge the left eye's
+  block can sit on the subject while the right eye's sits on the background, and the arrow jumped
+  out and back frame to frame. Each footprint point is now matched from BOTH eyes, every match must
+  pass a left-right consistency check (matched back, it lands within 1 px of where it started), and
+  the nearest value counts only when a second sample agrees; otherwise the arrow stays on the
+  glass. Over 20 live frames across a face edge: 200 → 35 large jumps.
+
+## 1.42.0 — 2026-10-11
+
+Touches the **core** `./three` (`DepthCursor`) and the **preview tier** (`./model`, `./splat`,
+`./call`, `./camera`: `cursor: 'depth'`), plus `./cursor-depth` (`CURSOR_DEFAULT_TUNING`). **One
+deliberate default change.**
+
+- **Depth-cursor margin 0.03 → 0.015 eye baselines (default change),** about 1 mm of crossed
+  on-screen disparity at a 63–65 mm IPD instead of about 2 mm. Runtime ADR-046 Amendment 2 A.2 was
+  halved after a Windows panel check, because 0.03 floated visibly off the content. The runtime
+  makes the same change (`U_CURSOR_DEPTH_DEFAULT_MARGIN`), so web and native cursors still agree.
+  Every depth cursor takes the default from `CURSOR_DEFAULT_TUNING`: `DepthCursor`,
+  `cursor: 'depth'` on both engines, and the stereo-tile pair cursor. `margin` still overrides it:
+  pass `margin: 0.03` for the 1.41.0 look.
+
 ## 1.41.0 — 2026-10-11
 
 Touches the **core** `./three` (`DepthCursor`'s look and two defaults) and the **preview tier**

package/cursor-depth.d.ts

@@ -3,7 +3,7 @@
 // same geometry, same defaults, same numbers. For three.js, ./three's `DepthCursor` wires it up.
 //
 // The policy (ADR-046 Amendment 2), the same for every DisplayXR depth cursor: never behind the
-// glass (`cursorTarget`), margin 0.03 eye baselines, drawn only past the draw threshold
+// glass (`cursorTarget`), margin 0.015 eye baselines, drawn only past the draw threshold
 // (`cursorShouldDraw`; otherwise the OS cursor is the cursor), the classic arrow at the OS cursor's
 // size (`CURSOR_ARROW`, `cursorArrowMesh`, `cursorDefaultHeight`).
 
@@ -24,7 +24,7 @@ export interface CursorTuning {
   stale: number;
 }
 
-/** The defaults: margin 0.03 (~2 mm at a 65 mm IPD), clamp [−0.6, 0], rise 30 ms, sink 250 ms, stale 0.5 s. */
+/** The defaults: margin 0.015 (~1 mm at a 63–65 mm IPD), clamp [−0.6, 0], rise 30 ms, sink 250 ms, stale 0.5 s. */
 export const CURSOR_DEFAULT_TUNING: Readonly<CursorTuning>;
 /** Fallback sprite height, as a fraction of the canvas height (0.03), when the canvas's on-page size is unknown. */
 export const CURSOR_DEFAULT_HEIGHT: number;
@@ -79,7 +79,7 @@ export const CURSOR_ANCHOR_MODES: readonly CursorAnchorMode[];
 export interface CursorOptions {
   /** Sprite height as a fraction of the canvas height (default: the OS arrow's 19 CSS px of the canvas). */
   height?: number;
-  /** How far in front of out-of-screen content it floats, in eye-baseline units (default 0.03). */
+  /** How far in front of out-of-screen content it floats, in eye-baseline units (default 0.015). */
   margin?: number;
   /** Default `'hybrid'`. */
   anchor?: CursorAnchorMode;