@lark-apaas/coding-registry-buildless 0.1.6 → 0.1.7-alpha.20260718160432

package/components/animations.jsx

@@ -14,9 +14,13 @@
 // ←/→ seek, space, and 0-to-reset controls, and persists the playhead.
 // Set the optional `poster` prop (seconds) to the moment your opening scene is
 // fully composed — the product thumbnail freezes on that frame (default ~1s).
+// Stage also exposes window.__stage — seek(t) / pause() / play() / time() /
+// playing() / duration — the deterministic way to drive the playhead from
+// outside (tooling, self-checks); never synthesize key/scrubber events for that.
 // Inside <Stage>, any child can call useTime() to read the current
 // playhead (seconds). Or wrap content in <Sprite start={1} end={4}>...</Sprite>
-// to only render during that window -- children receive a `localTime` and
+// to only render during that window (outside it, children are unmounted from
+// the DOM — by design, not a bug) -- children receive a `localTime` and
 // `progress` via the useSprite() hook. Use Easing + interpolate()/animate()
 // for tweens; TextSprite / ImageSprite / RectSprite have built-in entry/exit.
 // Build YOUR scenes by composing Sprites inside a Stage.
@@ -435,6 +439,24 @@ function Stage({
     return () => window.removeEventListener('keydown', onKey);
   }, [duration]);
 
+  // Programmatic driver for tooling (preflight / screenshot-at-t): freezes the
+  // playhead on an exact frame, unlike synthesized key/scrubber events.
+  const timeRef = React.useRef(time);
+  timeRef.current = time;
+  const playingRef = React.useRef(playing);
+  playingRef.current = playing;
+  React.useEffect(() => {
+    window.__stage = {
+      duration,
+      seek: (t) => { setPlaying(false); setTime(clamp(t, 0, duration)); },
+      pause: () => setPlaying(false),
+      play: () => setPlaying(true),
+      time: () => timeRef.current,
+      playing: () => playingRef.current,
+    };
+    return () => { delete window.__stage; };
+  }, [duration]);
+
   const ctxValue = React.useMemo(
     () => ({ time, duration, playing, setTime, setPlaying }),
     [time, duration, playing]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-registry-buildless",
-  "version": "0.1.6",
+  "version": "0.1.7-alpha.20260718160432",
   "description": "Miaoda registry (buildless runtime) — shadcn-style copy-in SDKs (globals + CDN-pinned, browser Babel) for buildless static HTML stacks",
   "type": "module",
   "files": [