@displayxr/inline3d 1.33.1 → 1.35.0

package/CHANGELOG.md

@@ -5,6 +5,38 @@ 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.35.0 — 2026-10-06
+
+Touches the **preview tier** (`./camera`, `./call`) additively. The core is unchanged (one new
+unit test pins its existing behaviour).
+
+### `./call` + `./camera` — the self view never shows a squeezed pair (web#131)
+
+- **The self view follows its tile's `firstWoven`.** Seen once in the DisplayXR Browser: a
+  call's self view showed the whole packed L|R pair in each eye under a `You · 3D` badge, the
+  look of a canvas the browser is not weaving. `addCameraView` now watches `handle.firstWoven`
+  the way a remote tile does: on `woven: false` (`'layer-failed'`, `'session-ended'`) the view
+  drops to `'flat-left'` (one eye, mirrored), re-registers a refused layer up to 4 times with
+  backoff, and re-weaves on `_reroute(true, wall)` when a wall comes back.
+- **The self badge is honest**: `3D` only while the view is on the woven route.
+- **`CameraView` additions**: `fallbackReason`, `weaveState()` and the `onRouteChange` option
+  (types: `CameraViewWeaveState` in `camera.d.ts`).
+- **`call.diagnostics().self`** = `{ route, woven, reason, firstWoven, layerRetries }`, so the
+  next occurrence can be diagnosed from devtools.
+- Hardening, not a root-cause fix: `firstWoven` is the SDK's hold timer, so a layer the browser
+  silently never joins still reads as woven.
+
+## 1.34.0 — 2026-10-06
+
+### `./model` — the PlayCanvas drag is a turntable again
+
+- `addModel` on PlayCanvas (the default) had inherited `addSplat`'s photo-splat drag: a tilt capped
+  at ±15° from the press that relaxes back to centre on release. On a mesh that reads as "the
+  movement is too small and it snaps back". It now uses the three path's turntable: cumulative, a
+  full drag across the tile is a half turn, and the model stays where you leave it. New option
+  **`orbitStyle: 'turntable' | 'tilt'`** (PlayCanvas only; default `'turntable'` for addModel).
+  `'tilt'` restores the photo mapping. `addSplat` is unchanged.
+
 ## 1.33.1 — 2026-10-06
 
 ### Fixed — woven `addModel` tiles drew nothing (1.28.0–1.32.0)

package/camera.d.ts

@@ -193,6 +193,24 @@ export interface CameraViewOptions {
   depth?: number;
   /** The tile's aspect (w/h) = the woven buffer's per-eye aspect. Default 16/9. */
   aspect?: number;
+  /**
+   * Called when the view's route changes — including when the wall says the tile will not weave
+   * and the view drops to its flat left eye by itself — and when its `firstWoven` settles. Keep a
+   * "3D" badge on `view.woven`, not on the wall.
+   */
+  onRouteChange?: (route: CameraView['route'], state: CameraViewWeaveState) => void;
+}
+
+/** What a {@link CameraView} actually shows (`view.weaveState()`), for diagnostics. */
+export interface CameraViewWeaveState {
+  route: 'woven-sbs' | 'flat-left' | 'flat' | null;
+  woven: boolean;
+  /** Why a pair on a 3D wall is flat: the tile's `firstWoven` reason (`'layer-failed'`, `'session-ended'`), else null. */
+  reason: string | null;
+  /** The current registration's settled `firstWoven`, `'pending'`, or null off the woven route. */
+  firstWoven: { woven: boolean; confirmed: boolean; reason: string | null; ms: number } | 'pending' | null;
+  /** Layer re-registrations attempted after a `'layer-failed'` (bounded; reset by a woven result). */
+  layerRetries: number;
 }
 
 /** A self view from {@link addCameraView}. */
@@ -200,7 +218,12 @@ export interface CameraView {
   readonly canvas: HTMLCanvasElement;
   /** `'woven-sbs'`: 3D on the panel; `'flat-left'`: a pair shown as its left eye; `'flat'`: mono. */
   readonly route: 'woven-sbs' | 'flat-left' | 'flat' | null;
+  /** On the woven route. A tile the wall will not weave drops the view flat, so this goes false with it. */
   readonly woven: boolean;
+  /** Why a pair on a 3D wall is shown flat (`'layer-failed'`, `'session-ended'`), else null. */
+  readonly fallbackReason: string | null;
+  /** What the view actually shows, for diagnostics. */
+  weaveState(): CameraViewWeaveState;
   /** The wall's tile handle while woven (its `firstWoven` settles when the tile is safe to reveal), else null. */
   readonly handle: TileHandle | null;
   readonly mirror: boolean;