mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-18 07:50:13 +00:00
* fix(engine): headline a pending setup as a setup timeout, not zero duration When the runtime never reaches render-ready, __hf.duration reads 0 because the bridge masks it, so pollHfReady's timeout reported "Composition has zero duration" even for compositions with a declared data-duration whose window.__hf.buildReady promise was still pending. Headline that case as "Composition setup did not finish within <timeout>ms", skip the duration inference hint that cannot apply yet, and note that the render clock stays at 0 until the first frame. Keep its transient retry classification and give it its own CLI diagnostic code. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> * fix(engine): name animation frames in the setup-timeout hint Setup that awaits requestAnimationFrame hits the same render-clock rule as setup that waits on Date or performance.now: frames only fire on a seek, and the first seek waits for setup. Say so, and point at the waits that work. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> * fix(engine): stop suggesting scheduler.yield() for setup waits Chrome runs scheduler.yield() continuations ahead of ordinary tasks, so a setup loop that polls with it starves the setTimeout-driven work it waits on (Three's compileAsync polls with setTimeout(10)) and never finishes. Plain headless Chrome 152 hangs on a ten-line page that does exactly that. Point authors at setTimeout and say why yield-polling does not work. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> * fix(engine): point setup waits at the library's readiness promise HyperFrames guidance is no system timers, so the hint should not tell authors to wait with setTimeout. Point them at the library's own readiness promise (Three.js renderer.compileAsync) and keep the warning about scheduler.yield() polling loops. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> * fix(engine): keep the setup-timeout hint to what it can diagnose A scheduler.yield() polling loop starves the page, so the readiness poll never returns and the render reports a capture stall instead of this message. Drop that sentence; the hint covers animation-frame and clock waits only. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>