@displayxr/inline3d 1.50.0 → 1.51.0

package/CHANGELOG.md

@@ -7,6 +7,21 @@ which tier they touch, because that is what tells you whether an upgrade can mov
 
 ## Unreleased
 
+## 1.51.0 — 2026-11-08
+
+### Added — `./call`: `openTabShare()`, share a browser tab in 3D
+
+Opens the browser's tab picker and returns a track for `shareContent`. In a DisplayXR Browser with
+stereo tab capture (1.9.4+), a picked tab comes back as a true side-by-side track, so receivers need
+nothing new; a window, a screen or any other browser comes back flat. Needs
+`MediaStreamTrackProcessor` for the stereo path.
+
+### Fixed — `./splat` (`engine: 'playcanvas'`): no false "footprint fix SKIPPED" warning on PlayCanvas 2.23
+
+Preview tier. PlayCanvas 2.23 fixed the side-by-side splat footprint upstream, so the SDK now
+leaves that shader chunk untouched there instead of warning that splats will draw at half height.
+2.22.3 is still patched as before, and remains the only version validated on a panel.
+
 ## 1.50.0 — 2026-11-04
 
 ### Fixed — `./camera`, `./call`: half-width side-by-side webcams keep their aspect ratio

package/README.md

@@ -69,7 +69,9 @@ The repo's splat sample (`samples/splat/`) renders with PlayCanvas and keeps `?e
 its A/B switch.
 Bundlers: the engine is reached through a named-import module (`js/inline3d-playcanvas-engine.js`,
 so the unused ~40% of the engine tree-shakes away); its sort workers are Blob URLs (CSP
-`worker-src blob:`), and esbuild needs `node:worker_threads` marked external.
+`worker-src blob:`), and esbuild needs `node:worker_threads` marked external. Pin the engine to
+exactly `playcanvas@2.22.3`, the version validated on a panel
+([why](docs/playcanvas-adapter.md)).
 
 **Splat effects (preview, `engine: 'playcanvas'`).** Shader effects on the splats themselves,
 keyed on world position and time so both eyes agree: `addSplat(…, { reveal: 'inflate' | 'sweep' |

package/call.d.ts

@@ -420,6 +420,22 @@ export function watchShareableApps(cb: (apps: ShareableApp[]) => void, opts?: {
  */
 export function openAppShare(deviceId: string, opts?: { width?: number; height?: number; frameRate?: number; mediaDevices?: MediaDevices }): Promise<AppShare>;
 
+/** An opened tab share (`openTabShare`): pass `stream` (+ `descriptor`) to `shareContent`. The track is yours to stop. */
+export interface TabShare {
+  stream: MediaStream;
+  track: MediaStreamTrack;
+  /** true: a side-by-side track. false: the user picked a window or screen, or the browser captures tabs flat. */
+  stereo: boolean;
+  descriptor: { kind: 'content'; format: CallFormat; width: number; height: number; convergence: { known: true; frac: number }; appName: null };
+}
+
+/**
+ * Let the user pick a browser tab to share, in 3D where the browser can (the browser's picker is
+ * the consent). Comes back flat (`stereo: false`) for a window, a screen, or a browser without stereo
+ * tab capture. Cancelling rejects with `code: 'share-denied'`, anything else with `'share-failed'`.
+ */
+export function openTabShare(opts?: { width?: number; frameRate?: number; mediaDevices?: MediaDevices }): Promise<TabShare>;
+
 /**
  * `error` codes — fatal for a feature, never for the widget. `'camera-busy'` (held by another
  * app: audio-only until `retryCamera()`), `'no-camera'`, `'permission-denied'`, `'unreachable'`