@displayxr/inline3d 1.40.0 → 1.40.2

package/CHANGELOG.md

@@ -5,6 +5,36 @@ 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.40.2 — 2026-10-11
+
+Touches the **preview tier** (`./call`, `./camera`) only; no API change.
+
+### Stereo-tile depth cursor: the margin is 2 mm on the glass
+
+- The arrow now floats **2 mm** (of on-screen disparity) in front of content that comes out of the
+  screen, and hands back to the OS arrow under **0.3 mm** — the runtime's 0.03 / 0.005 of the eye
+  baseline, so a stereo tile's cursor and a lifted tile's (runtime #1908) sit identically. 1.40.1
+  used ~1–2 buffer px, which on a small tile was a fraction of a millimetre. Physical units come from
+  the tile's `displayMetrics()` (the panel's pixel pitch); before it answers, the CSS reference px.
+
+## 1.40.1 — 2026-10-11
+
+Touches the **preview tier** (`./call`, `./camera`) only: how `cursor: 'depth'` looks and moves. No
+API change.
+
+### Stereo-tile depth cursor: the normal arrow, and only ever in front of the screen
+
+- **It never goes inside the display.** 1.40.0 put the cursor at the depth of whatever was under
+  it, so over a background behind the glass it sank behind the glass too. Now the depth only moves
+  to keep content that comes OUT of the screen from overlapping it; over anything on or behind the
+  glass it stays on the screen plane.
+- **It is the normal arrow, not a crosshair.** On the plane nothing is drawn: it is the OS cursor,
+  untouched. Only while the person under it pops out is the arrow drawn into both halves, just in
+  front of them, at the OS arrow's size (19 CSS px; `height` still overrides it), with the OS
+  cursor hidden exactly then. The footprint now covers the arrow's body, not a ring round its tip.
+- Same filter as before: it comes forward fast and hands back to the OS arrow smoothly as the
+  content sinks. Matches the native lifted-content cursor (runtime #1908).
+
 ## 1.40.0 — 2026-10-10
 
 Touches the **preview tier** (`./call`, `./camera`) only: one new option, off by default. New type

package/call.d.ts

@@ -216,10 +216,11 @@ export interface CallOptions {
    */
   autoConverge?: boolean;
   /**
-   * `'depth'`: over a 3D (stereo) tile — a peer's or your self view — a crosshair just in front of
-   * the person under the pointer replaces the CSS cursor, instead of the flat cursor drawn on the
-   * glass behind them (runtime ADR-046; the depth is measured off each tile's two halves). Lifted
-   * (2D→3D) and flat tiles keep the normal cursor. Off by default (zero cost).
+   * `'depth'`: over a 3D (stereo) tile — a peer's or your self view — the cursor is never
+   * overlapped by what comes out of the screen: where the person under the pointer pops out, the
+   * normal arrow is drawn just in front of them (runtime ADR-046; the depth is measured off each
+   * tile's two halves). Everywhere else it is the plain OS arrow on the screen plane — it never goes
+   * inside the display. Lifted (2D→3D) and flat tiles keep the normal cursor. Off by default (zero cost).
    * `<dxr-call cursor="depth">`.
    */
   cursor?: 'depth' | PairCursorOptions;

package/camera.d.ts

@@ -189,7 +189,7 @@ export function isStereoCamera(x: unknown): x is StereoCamera;
  * depth under the pointer is MEASURED off its two halves, so there is no anchor mode or margin.
  */
 export interface PairCursorOptions {
-  /** Sprite height as a fraction of the tile height (default 0.06). */
+  /** Arrow height as a fraction of the tile height (default: the OS arrow's size, 19 CSS px). */
   height?: number;
   /** `'window'` (default): the cursor stays while the pointer is over DOM on the tile (a badge). `'canvas'`: only over the canvas itself. */
   pointerScope?: 'canvas' | 'window';
@@ -205,9 +205,10 @@ export interface CameraViewOptions {
   /** The tile's aspect (w/h) = the woven buffer's per-eye aspect. Default 16/9. */
   aspect?: number;
   /**
-   * `'depth'`: while the pointer is over the woven view, a crosshair just in front of whatever is
-   * under it (runtime ADR-046, measured off the pair's two halves) replaces the CSS cursor, so it
-   * is never drawn on the glass behind a face that sits in front of it. Off by default (zero cost).
+   * `'depth'`: while the pointer is over the woven view and what is under it comes out of the
+   * screen, the normal arrow is drawn just in front of it (runtime ADR-046, measured off the pair's
+   * two halves), so it is never drawn on the glass behind a face that pops out. Otherwise it is the
+   * plain OS arrow on the screen plane; it never goes inside the display. Off by default (zero cost).
    */
   cursor?: 'depth' | PairCursorOptions;
   /**