@displayxr/inline3d 1.37.1 → 1.39.0

package/model.d.ts

@@ -3,7 +3,7 @@
 
 import type { CursorOptions } from './cursor-depth.js';
 import type { SceneViewer, SubjectBounds, OrbitPose } from './viewer.js';
-import type { FirstWovenResult, ViewerEaseOption } from './index.js';
+import type { FirstWovenResult, RectCoverOption, ViewerEaseOption } from './index.js';
 import type { PlayCanvasSplatViewer, SplatCameraPose, SplatFrameInfo } from './splat.js';
 
 export interface ModelOptions {
@@ -164,6 +164,13 @@ export interface ModelOptions {
   observe?: Element;
   /** Forwarded to the core window: see `TileOptions.firstWovenHoldMs`. */
   firstWovenHoldMs?: number;
+  /**
+   * The SDK's cover across a move or resize of this canvas (see `TileOptions.rectCover`).
+   * **Default `'auto'` here** (the core default is `'off'`): a solid cover showing the last frame,
+   * raised when the canvas's size, dpr or page position changes and cut when `rewoven()` settles.
+   * Pass `'off'` if the page runs its own cover.
+   */
+  rectCover?: RectCoverOption;
 }
 
 /** What {@link addModel} returns — the same shape as addSplat's handle. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@displayxr/inline3d",
-  "version": "1.37.1",
+  "version": "1.39.0",
   "description": "Turn any HTML <canvas> into a 3D window on a spatial display, inside an ordinary web page, for the DisplayXR Browser. Dependency-free; progressive enhancement (falls back to plain 2D everywhere else).",
   "type": "module",
   "types": "./index.d.ts",
@@ -176,6 +176,7 @@
     "test:e2e": "node test/e2e/call-element.e2e.mjs",
     "test:e2e:camera": "node test/e2e/camera.e2e.mjs",
     "test:e2e:cursor": "node test/e2e/cursor-depth.e2e.mjs",
+    "test:e2e:samples-panel": "node test/e2e/samples-panel.e2e.mjs",
     "api:check": "node tools/api-surface.mjs --check",
     "api:update": "node tools/api-surface.mjs --update",
     "check:snippets": "node tools/check-snippets.mjs",

package/splat.d.ts

@@ -3,7 +3,7 @@
 
 import type { CursorOptions } from './cursor-depth.js';
 import type { SceneViewer, SubjectBounds, OrbitPose } from './viewer.js';
-import type { FirstWovenResult, ViewerEaseOption, DisplayMetrics } from './index.js';
+import type { FirstWovenResult, RectCoverOption, ViewerEaseOption, DisplayMetrics } from './index.js';
 
 /**
  * The knobs behind `SplatOptions.perf`. Every one is a Spark 2.1.0 setting except `alphaRadius`,
@@ -515,6 +515,13 @@ export interface SplatOptions {
   observe?: Element;
   /** Forwarded to the core window: see `TileOptions.firstWovenHoldMs`. */
   firstWovenHoldMs?: number;
+  /**
+   * The SDK's cover across a move or resize of this canvas (see `TileOptions.rectCover`).
+   * **Default `'auto'` here** (the core default is `'off'`): a solid cover showing the last frame,
+   * raised when the canvas's size, dpr or page position changes and cut when `rewoven()` settles.
+   * Pass `'off'` if the page runs its own cover.
+   */
+  rectCover?: RectCoverOption;
   /**
    * Who owns the camera. `'viewer'` (the default): the SDK's orbit, idle spin, auto-fit and focus
    * gestures. `'page'` (`engine: 'playcanvas'` only; throws on Spark): the page drives the camera
@@ -1045,6 +1052,10 @@ export interface SplatHandle {
    * finished; rejects if the new asset cannot be loaded (the current one stays on screen).
    */
   setSource(src: string | Blob | ArrayBuffer | Uint8Array | SplatPreparedSource, opts?: SplatSourceOptions): Promise<SplatHandle>;
+  /** End a running setSource transition now (its end state at once); no-op when none runs. PlayCanvas backend. */
+  finishSwap?(): SplatHandle;
+  /** The core tile's rewoven(): resolves once the canvas is woven again after a rect move. */
+  rewoven?(): Promise<{ woven: boolean; reason?: string }>;
   /**
    * PlayCanvas backend only — throws on Spark. Fetch, decode and upload `src` now, in the
    * background (the SDK's own passes in idle periods; the engine's end-of-load unpack runs when
@@ -1231,6 +1242,17 @@ export interface SplatHandle {
    * `{ woven: false, reason: 'unsupported' }` at once where there is no inline-3D session.
    */
   readonly firstWoven: Promise<FirstWovenResult>;
+  /**
+   * The core window's `TileHandle.rewoven()`: `firstWoven` measured from now. Cover the canvas
+   * across a rect change (moved into a box, fullscreen, a layout resize) and release when this
+   * settles. Same result shape; `{ woven: false, reason: 'unsupported' }` without a session.
+   */
+  rewoven(): Promise<FirstWovenResult>;
+  /**
+   * End a running `setSource` transition now (the new asset at its end state, in this task).
+   * No-op when none runs. For a page that leaves a scene mid-crossfade on a shared canvas.
+   */
+  finishSwap(): SplatHandle;
 }
 
 /**