@displayxr/inline3d 1.47.2 → 1.47.4

package/CHANGELOG.md

@@ -5,6 +5,52 @@ 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.
 
+## Unreleased
+
+## 1.47.4 — 2026-10-31
+
+### Fixed — a declared 3D camera with portrait eyes was dropped for a plain one (`./camera`, `./call`)
+
+- `openCamera` kept a device as a pair only if it was wider than 2.5:1. A phone's front pair with
+  portrait eyes (720x1280 each, so a 1440x1280 frame) failed that test: the SDK stopped the
+  "3D Camera (DisplayXR)" track and fell back to the plain default camera. A track whose settings
+  say `displayxrStereo.layout === 'side-by-side'` is now a pair whatever its aspect, so the SDK no
+  longer falls back once the browser offers a stereo track. Shape is still the guess for devices
+  that say nothing (USB pairs).
+
+### Fixed — before camera permission, `openCamera` opened a phone's front (head-tracker) lens (`./camera`, `./call`)
+
+Touches `./camera` (`openCamera`'s `auto` / `stereo` probe) and so `./call`'s camera. With camera
+permission already granted, nothing changes.
+
+- Without permission the device labels are empty, so the probe used to open the platform default
+  camera just to get them: on a phone that is the front lens the head tracker holds, and opening
+  it coincided with every camera dropping out for about 2.4 s. It now primes permission on an
+  environment-facing camera (`facingMode: { ideal: 'environment' }`), reads the list again, and
+  opens a camera that names itself stereo **by id before the default**. A desktop webcam that
+  reports no facing is opened once and kept as the mono fallback (no extra camera start); a phone
+  with no pair still falls back to the default (front) camera for a self view.
+- `camera-busy` now reads "camera unavailable: in use by another app (e.g. eye tracking) or unable
+  to deliver a picture". A 3D camera that is listed but cannot deliver also fails with
+  `NotReadableError`, so "every camera is in use" was wrong for it.
+
+## 1.47.3 — 2026-10-31
+
+### Fixed — a rear 3D camera's view was mirrored (`./camera`, `./call`)
+
+Touches `./camera` (`addCameraView`, new read-only `StereoCamera.facing`) and `./call` (its self
+tile). Front cameras and webcams behave exactly as before.
+
+- `addCameraView`'s `mirror` now defaults to true **unless the track faces the environment**
+  (`getSettings().facingMode === 'environment'`, a rear camera). Mirroring is right for a self view
+  and wrong for a camera pointed at the world: on a tablet's rear 3D camera the scene came out
+  mirrored (each half flipped and the eyes swapped). An unknown facing (most desktop webcams) still
+  mirrors; an explicit `mirror` still wins.
+- `StereoCamera.facing`: the track's `facingMode` (`'user'`, `'environment'`, `'left'`, `'right'`)
+  or null when the browser does not say.
+- `./call`'s self tile uses the same default (it passed `mirror: true`), and `samples/camera`
+  initialises its Mirror checkbox from the view.
+
 ## 1.47.2 — 2026-10-30
 
 ### Docs only — two more panel findings in the shipped guide

package/camera.d.ts

@@ -157,6 +157,8 @@ export interface StereoCamera {
   readonly eyeWidth: number;
   readonly deviceId: string | null;
   readonly label: string;
+  /** The track's `facingMode`: 'user', 'environment', 'left', 'right', or null when the browser does not say. */
+  readonly facing: 'user' | 'environment' | 'left' | 'right' | (string & {}) | null;
   /** True when this module opened the device (and `close()` stops it); false for a page-supplied stream. */
   readonly owned: boolean;
   /** Devices tried and not used (busy, denied, not a pair) — the clue a `'camera-busy'` report carries. */
@@ -203,7 +205,10 @@ export interface PairCursorOptions {
 }
 
 export interface CameraViewOptions {
-  /** Selfie mirroring, done right for a pair (each half mirrored AND swapped). Default true. */
+  /**
+   * Selfie mirroring, done right for a pair (each half mirrored AND swapped). Default: true unless
+   * the camera faces the environment ({@link StereoCamera.facing} `'environment'`, a rear camera).
+   */
   mirror?: boolean;
   /** Measure the face's disparity ~5×/s and converge on it (the face at the display plane). Default false. */
   autoConverge?: boolean;