@displayxr/inline3d 1.21.0 → 1.21.1

package/CHANGELOG.md

@@ -5,6 +5,15 @@ 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.21.1 — 2026-09-24
+
+Touches the **preview tier** (`./splat`, `engine: 'playcanvas'` only). No API change; nothing changes at rest.
+
+- **A gated `reveal` no longer shows its start state frozen.** The splat is hidden until the reveal's clock
+  starts, so its first visible frame is the first frame of motion; previously the start state (e.g.
+  `assemble`'s scatter) sat still for up to the rest of the `firstWoven` hold, then jumped. On a cached
+  asset the tile is empty for the rest of the hold instead.
+
 ## 1.21.0 — 2026-09-24
 
 Touches the **preview tier** (`./splat`, `engine: 'playcanvas'` only). Minor: a new `setSource`

package/js/inline3d-splat-playcanvas.js

@@ -3630,7 +3630,22 @@ export function attachPlayCanvasSplat(out, wall, canvas, src, opts, pending = []
     // tile is woven (handle.firstWoven — which is immediate in 2D) and the first frames are built.
     if (revealSpec) {
       const gate = Promise.resolve(out.firstWoven).then(() => afterTicks(2));
+      // The splat stays HIDDEN until the gate opens, so the first frame anyone sees is the first
+      // frame of motion. The gate is `firstWoven`, a worst-case hold of up to 1.2 s past the
+      // layer's birth (docs/woven-canvas-rules.md §5), and the browser usually joins the canvas
+      // well before it ends. Drawn meanwhile, the start state (a particle reveal's scatter) sat
+      // frozen on the woven panel for the rest of the hold and then jumped into motion. Hidden,
+      // the tile is empty for that span, which also keeps stereo pixels off a canvas that may
+      // not be joined yet (rule 5). Registered after fx.play's own `.then`, so it lands in the
+      // same microtask that releases the effect: the clock starts on the frame it first shows.
+      entity.enabled = false;
       fx.play(revealSpec.type, revealSpec.raw, { gate });
+      gate.then(() => {
+        if (removed || current?.entity !== entity) return;
+        // setVideo took the splat off screen meanwhile: its exit restores what it saved.
+        if (vid?.saved?.entity === entity) vid.saved.splatEnabled = true;
+        else entity.enabled = true;
+      });
     }
     for (const [what, name, arg] of fxPending.splice(0)) {
       if (what === 'set') fx.set(name, arg);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@displayxr/inline3d",
-  "version": "1.21.0",
+  "version": "1.21.1",
   "description": "Turn any HTML <canvas> into a glasses-free-3D window on a DisplayXR display, inside an ordinary web page. Dependency-free; progressive enhancement (falls back to plain 2D everywhere else).",
   "type": "module",
   "types": "./index.d.ts",