Releases: heygen-com/hyperframes
Release list
v0.7.53
HyperFrames v0.7.53
Released on 2026-07-11.
This release makes studio manual editing safe for color-graded compositions: edits no longer bake runtime opacity transients into tween bounds (the "element disappears after editing" bug), resize and rotate commit clean per-group values, selecting an element no longer rewrites or destroys its authored clip-path, and the crop tool draws in the element's rotated frame. The GSAP writers also stop accumulating duplicate keys in saved compositions.
Fixes
- Studio: Draw the crop UI in the element's rotated frame (39f33bd3a)
- Studio: Address review findings on graded-element editing (5d1cafff8)
- Studio: Crop restore value is owned by the lifted element's gesture (b7fddd548)
- Core: Make timing masks safe for source loaders (179c942cd)
- Lint: Anchor the opacity-zero probe so 0.98 stops matching (fe5296672)
- Parsers: Never emit duplicate vars keys in either writer (90d77d016)
- Studio: Route panel property commits to a group-owning set (066c3dae3)
- Studio: Crop tool stands down for clips it cannot edit (cbfb6ba94)
- Studio: Correct gesture commits for scaled and graded elements (3525c7ff5)
- Studio: Stop tween re-inits from baking runtime opacity transients (5cc14c222)
- Core: Capture authored inline opacity at parse time and follow source geometry (3147c8e06)
- Product Launch: Hoist approved frame videos during assembly (2aadf450e, #2226)
- Hooks: Scope pre-commit build check to target repo, fix stale symlinks (522d7c93b, #2175)
- Lint: Parse HTML structure without regex (05c3b5503, #2223)
- Telemetry: Expose stalled render stages (87618eef4, #2220)
- Lint: Flag digit-leading element ids (d51fa7eba, #2222)
- CLI: Correct strict warning hint (5f22209a8, #2221)
Internal
- Address review nits (67cfae258)
- Producer: Gate source tests by execution lane (9e7b11998)
- Repo: Forbid tracked generated artifacts (585aa9f6b)
Full changelog
v0.7.52
HyperFrames v0.7.52
Released on 2026-07-11.
The CLI now runs a free trial of the drawElement parallel router (HF_DE_PARALLEL_ROUTER) on eligible local renders — it stays on until a real failure fires the safety net, then turns off for that install — and every router/inversion failure path (OOM, blank frames, PSNR, capture errors) now reaches telemetry with a fallback reason, with OOM retries dropping to a single worker after killing stale workers. Also fixes keyframe shots ignoring direct entries, SDK template GSAP scripts missing from resolver parity, and hyperframes lint tripping on macOS AppleDouble files.
Features
- CLI: One-shot DE parallel-router trial per install for real telemetry (37b6a4e7e)
- Producer,cli: Full telemetry visibility for DE parallel-router/inversion failures (ec921e143)
Fixes
- CLI: Honor direct entries in keyframe shots (b95ddd74d, #2217)
- Skills: Align core contract with check (de4e85add, #2218)
- Sdk: Align template script traversal (a61f7de8d)
- Lint: Ignore macOS AppleDouble HTML files (0e7f40dfc, #2191)
- Cli,producer: Opt-in trial polarity + narrowed-fallback-flag docs (review) (b02703b7c)
- Sdk: Include template GSAP scripts in resolver parity (46602d75f)
- CLI: Atomic config writes, gated trial warning, and write-failure signal (6172d79dc)
- CLI: Stale-cache arm reads, retry double-count, and unwritable-config re-arm in DE trial (2542e9427)
- CLI: Fix concurrency race, none-vs-undefined bug, and 3 more DE trial gaps (dc6df93de)
- CLI: Fix batch re-entrancy, config race, exposure cap, and shouldTrack gap in DE trial (532dad7cc)
- CLI: Keep the DE parallel-router trial on until a real failure, not first engagement (19f90b0b9)
- Producer,engine,cli: Oom wrapping, cancellation, fallback-reason gaps (a355fb2f6)
- Engine: Recognize Bun/JavaScriptCore's OOM message in isMemoryExhaustionError (b3f244a7e)
- Producer: Drop to a single worker on OOM retry instead of the pre-pinned count (51353a7ed)
- Producer: Widen DE self-verify retry to generic failures on a pinned worker count (df57eb0fd)
Full changelog
v0.7.51
HyperFrames v0.7.51
Released on 2026-07-11.
media-use's HeyGen resolves now tag whether a call went through the free (OAuth) or paid (API-key) path and classify failures into stable reasons, with a test-isolation fix so local runs can't reach the production telemetry endpoint. hyperframes skills update now converges when a skill has been retired or renamed upstream — it no longer fails with Skill(s) still missing after install or loops on No matching skills found, and reconciles the orphaned skill away instead.
Features
Fixes
Full changelog
v0.7.50
HyperFrames v0.7.50
Released on 2026-07-10.
This release makes hyperframes check the canonical verification gate: one command, one browser session covering lint, runtime errors, layout, motion intent, and WCAG contrast, with agent-actionable findings (source anchors, contrast fix suggestions) and snapshot evidence via annotated frames and per-finding crops. validate, inspect, and layout are deprecated but fully functional; snapshot gains --zoom for high-density crops of any element or region.
Features
- CLI: --frame-check accepts a severity/seek/tol spec (659cb6a23)
- CLI: Persistence-tiered findings, frozen-sweep guard, occlusion coverage (94f6de8b8)
- CLI: Snapshot --zoom and per-finding crops on check --snapshots (f4cef54b8)
- CLI: Deprecate validate, inspect, layout in favor of check (58f45ef75)
- CLI: Run-ID telemetry correlation and check breakdown event (3a02942a0)
- CLI: Caption-zone and frame-check gates on check (7ab6c2b7a)
- CLI: Add check — single-session verification gate (7d6d41361)
Fixes
- CLI: Address review — clip-duration audit in check, failure classing, crop observability (67cdf0fdb)
- Core: Preserve playhead during volume probing (16ab8b293, #2143)
- Escape NUL bytes in HFMASK regex (Bun blank renders) + Windows junction for studio preview links (718c67b38, #2140)
- CLI: Page closures survive keepNames transpilation; format motion-blur (2ceb0683a)
- CLI: Contrast gate judges only readable content; examples pass check (4b03866c0)
Docs & Examples
- Cli,skills: Teach check as the canonical verification gate (cf7c1d760)
Internal
- CLI: Type the guard test's mock so the full typecheck passes (96cb5e39d)
- CLI: Import the page-function guard in its new unit test (c169dbaa5)
- CLI: Single-source-of-truth pass over the check branch (cea345801)
- Examples: Mark product-promo cursor and comment layering intentional (b218ee744)
- CLI: Unify seek/settle and Chrome launch across browser commands (feb256df8)
Full changelog
v0.7.49
HyperFrames v0.7.49
Released on 2026-07-10.
Hardens the Figma integration end to end — clearer 403/scope errors, 429 retry with backoff, batch asset fetch, and mapper fidelity fixes (dropped image fills, double-painted rasterized shapes) — plus a fix for creation-workflow skills bypassing the integration entirely. Also ships render-reapply hardening for SDK position edits and prompt-guide pipeline fixes.
Fixes
- Skills: Address PR #2110 review feedback (23c9d15b6)
- Skills: Pipeline fixes from prompt-guide validation (BGM, caption accent, voice, PR version) (c992a136b)
- Skills: Force figma.com sources through /figma, not raw MCP tools (d13c96d47)
- Core,cli: Figma IMAGE fills dropped, rasterize double-paint, tokens false-success (c8eff1a4b)
- Clear fallow and windows artifact checks (70ac80b08)
- Core: Make generated artifact formatting deterministic (960c31f66)
- Core: Narrow wrapped seek function type (d2f32c831)
- Core: Use execFileSync for generated-file format step (67a4fb6b7)
- Core,producer: Harden render reapply wiring (68ae4e516)
- Core: Preserve position edit fold detection during seeks (4e3d639e1)
- Core,producer: Render SDK position edits in producer pipeline (85bab88af)
- Core,cli: Address PR review — consistent 403 error shape, cap Retry-After, URL-safe ref split (87e2a70f9)
- Core,cli: Parse figma 403 body, batch asset fetch, fix NO_TOKEN box (4fc699fee)
- Core: Name missing figma scope in 403, retry 429 with backoff (1bb768834)
Docs & Examples
- Figma: Lead setup with "which credential do I need", not a token wall (ffac2ecbf)
- Figma: Remove stale duplicate RATE_LIMITED troubleshooting row (49a78a30e)
- Skills: Remove unused animation example assets (ac8ac34bd)
- Figma: Sync guide scopes + error table; gate batch line, regen index in finally (43af58253)
Internal
- Core: Refresh position edits render artifact (0971f3b2a)
- CLI: Add renderNodes to tokens.test figma client mock (1d18b3062)
Full changelog
v0.7.48
HyperFrames v0.7.48
Released on 2026-07-10.
Prevents slow Chrome downloads from losing their install lock and colliding with another HyperFrames process. Also restores hyperframes tts --text-file compatibility for existing skills and scripts.
Fixes
- CLI: Restore
tts --text-filecompatibility for file-based narration workflows (ef38321d5, #2117) - CLI: Keep slow browser installs serialized with an active lock heartbeat and visible wait progress (7bd8c0942, #2116)
Full changelog
v0.7.47
HyperFrames v0.7.47
Released on 2026-07-10.
Ships a lane-model Studio timeline (multi-select, marquee, group move/resize, magnetic snapping, NLE-style z-index stacking) and a declarative variables stack spanning core, SDK, and Studio (bindings, promote-to-variable, live preview injection). Also adds shared telemetry and free-usage onboarding to media-use.
Features
- Media Use: Usage visibility — shared telemetry identity, miss log, resolve --stats (16eb11367, #2113)
- Media Use: Fast heygen CLI onboarding — actionable diagnostics, --doctor, free-usage framing (cdb8d736f, #2065)
- Media Use: Use CLI free HeyGen usage (3b93f516b, #2027)
- Studio: Resize selected timeline clips together (36413da7f)
- Studio: Move selected timeline clips together (5d27af30b)
- Studio: Add timeline marquee selection (45d09047b)
- Studio: Batch timeline timing commits (1cf601202)
- Studio: Highlight timeline selection sets (1d858f004)
- Studio: Activate selected element set state (cca31feff)
- Core: Sub-composition variable render path (a9901cb66)
- Sdk,studio: Editable template sub-compositions + promote sub-comp element properties (8de80bf36)
- Studio: Promote to variable from the design panel (7c144ecc3)
- Studio: Bind selected element properties to variables (267b289bb)
- Core: Declarative variable bindings — data-var-src, data-var-text, css custom props (f7ee0768a)
- Studio: Render with preview variables + template handoff + docs (010d49327)
- Studio: Variables inspector panel with live preview values (b34ad8516)
- Studio Server: Preview variable injection + render variables forwarding (2e0b88452)
- Sdk: Variable usage scan + preview-values adapter seam (91831f3f8)
- Sdk: Variable declaration edit ops (declare/update/remove) (839881a98, #2047)
- Sdk: Variable declaration read apis + browser-safe variables entry (fcbd4cb0f, #2046)
- Studio: Fill the ruler with ticks across the full timeline width (6f0bf75b6)
- Studio: Lanes and ruler span the full timeline width at any zoom (eb31e86d4)
- Studio: Magnetic snapping to clip edges, playhead, and bounds (d7e7fca8e)
- Studio: Drag a clip past the video end to extend its duration (5e3ca6ae6)
- Studio: Lane-model timeline (non-overlapping clips share a row) (ed8bf475d)
- Studio: Timeline layer UI — context headers, audio lanes, drop affordances (bc5fc410e)
- Studio: Timeline track = stacking layer (NLE-style layering) (e5ed51252)
- Studio: Unify timeline vertical reorder with z-index stacking (dd980697a)
- Studio: Expose resolved z-index and stacking context on timeline clips (070ee9169)
Fixes
- CLI: Sample real pixels behind hidden text for contrast-audit (1614dd3e5)
- Studio: Drop stale timeline-select results to stop selection flicker (1265702ed)
- Studio: Fold GSAP timing rewrites into the recorded history entry (076c656d6)
- Studio: Make the player store the single source of truth for selection (9cf575c6f)
- Studio: Keep timeline selection authoritative in the preview sync (6673c3286)
- Studio: Harden group timeline edits (capabilities, rollback, snapping, marquee) (04ddd411e)
- Studio: Draw the timeline marquee in the theme accent color (95ded6c02)
- Studio: Keep the timeline multi-selection through a group edit (fa3848a33)
- Studio: Propagate z-index reorder save failures and drop dead targetTrack (6080f5ad3)
- Studio: Code-review and live-test fixes for the variables stack (bc0e0b314)
- Studio: Order the timing write after the z-index commit on a diagonal drag (51dd8a075)
- Studio: Keep a remounted clip marked active when it stays at the playhead (ffd513130)
- Studio: Make a timeline lane a z-band so a vertical restack moves the row (eb6a311d8)
- Studio: Stop horizontal drag from cancelling a vertical restack (db6ccb808)
- Studio: Keep Timeline under the 600-line cap and un-export postRootDurationToPreview (ce0ddbccf)
- Studio: Freeze timeline zoom during extend-drag so clips don't jump (580676bbf)
- Studio: Dropping an overlapping clip on a lane restacks it, not a no-op (6b4870246)
- Studio: Sub-composition child clips restack via self-contained intent (82fe779bd)
- Studio: Realm-safe isHTMLElement so timeline z-index commits land (eef500c89)
- Studio: Capture effective (computed) z-index for timeline ordering (03f8089e5)
Performance
- Studio: Grow composition duration live on extend, no preview remount (9f6c20e48)
Internal
- Studio: Single-source timeline selection id-resolution (0fe38e8cc)
- Studio: Single-source timeline id-resolution and resize-clamp math (3c6c1d3f2)
- Studio: Single-source the timeline stacking key + guard audio reorder ([5ce3622](5ce362299c72f7d188adca608ff...
v0.7.46
HyperFrames v0.7.46
Released on 2026-07-09.
Adds live-DOM sync and variable CRUD to @hyperframes/sdk, plus mechanical Figma motion translation with an objective fidelity gate. Also ships several render-pipeline and parser fixes (cross-realm position edits, static-frame dedup call-detection, GSAP position holds).
Features
- Sdk: AttachSync mirrors composition edits onto a live document (91ddf9e19)
- Sdk: Variable CRUD (declare/remove/get/list) + export gaps (19756faa5)
- Core,figma Skill: Mechanical motion translation + objective fidelity gate (a2243f758)
- Producer: Default-off router for verified parallel drawElement (0393ba5be)
Fixes
- Sdk: Address PR #2100 review feedback on attachSync (c94de6034)
- Sdk Playground: Implement PreviewAdapter.attachSync no-op stub (393eced90)
- Sdk: Address PR #2098 review feedback on variable CRUD (bcda11aa7)
- Studio Server: Address PR #2097 review feedback on relative-timing resolver (e4c4d2e15)
- Studio Server: PreviewAdapter getElementTimings ignores relative data-start refs (fbd21d570)
- Core: Reproduce figma's vertical text trim via text-box-trim (d6d0fccbf)
- CLI: Bump @puppeteer/browsers to ^3.0.6 to fix render hang on Node >=24.16 (#2103) (ccab6207c, #2104)
- Parsers: Emit global gsap.set position holds before the timeline declaration (e0b5d01c6)
- Producer: Stop router from mutating process.env for cross-render state (0045e8b3c)
- Core,figma Skill: Address PR feedback — regex key escaping, no-shell psnr probe (3d59dcc69)
- Core: Figma mapper prefixes digit-leading element ids (63ff046c3)
- Core,cli: Parent-relative figma child geometry; groups stop rejecting subcommand flags (dfe63af3a)
- Core: ApplyPositionEdits fails silently across iframe realms (5a4832172)
- Producer: Restore HF_DE_PARALLEL_STREAM on every render exit path (a23e63326)
- Engine: Descend into repeating nested timelines for call() detection (b9321b748)
- Engine: Disqualify static-frame dedup on any tl.call() (50c4a1023)
Docs & Examples
- Sdk: Document CompositionVariable, id/variable utilities, and attachSync in canvas guide (f169d5fad)
- Sdk: Document attachSync, variable CRUD, and getRootElements/getAllAnimationIds (91cc67a00)
- Figma Skill: Verbatim motion translation, wrap-marker decoding, export_video validation (44653e186)
Internal
- Sdk: Cover attachSync mirroring for setVariableValue and setTiming (fbb6a33c9)
- Sdk: Cover attachSync re-attach teardown and manual detach (9c691d243)
- Sdk: Cover attachSync against a detached iframe (0e0854356)
- Sdk: Cover script-patch skip and stylesheet-patch mirroring in attachSync (ed9df3f57)
Other Changes
- Figma Skill: Format verify-motion.mjs (666b84d7b)
Full changelog
v0.7.45
HyperFrames v0.7.45
Released on 2026-07-09.
SDK gains three exports (getRootElements, isNewHostBoundary, bareId) and a serialize({ stripRuntime }) option, plus a fix for data-start relative-timing references that used to silently resolve to 0. Studio's storyboard, crop tool, and color grading also land this release.
Features
- Sdk: Export getRootElements/isNewHostBoundary/bareId, fix relative data-start (c1b8815cb)
- Studio: Storyboard empty state with agent copy-prompt and skeleton preview (0ac000181, #2091)
- Studio: Always-on crop with reposition handle, drop crop mode (623f91d6a, #2090)
- Media Use: Color grading — grade/lut resolve, smart-grade, grade-compare + compare (57b3c7898, #2041)
Fixes
- Sdk: Address review feedback on getRootElements/serialize/getElementTimings PR (4fb6068fa)
- CLI: Map zh to espeak-ng's cmn for Kokoro TTS synthesis (995db68ad, #2094)
- Core: Scope sub-composition html/body styles to the composition box (6f0b57d60, #2089)
- CLI: Map ggml model stem to whisper.cpp dotted DTW preset (fixes large-v3) (8e04d0196, #2086)
Full changelog
v0.7.44
HyperFrames v0.7.44
Released on 2026-07-08.
Opt-in verified interleaved parallel drawElement streaming, plus fail-fast sub-composition timeline waits and Chrome-cache resolution fixes carried over from PR review.
Features
- Engine,producer: Verified interleaved parallel drawElement streaming (opt-in) (b3493a7b6)
Fixes
- Engine,producer: Fix quadratic dedup rescan, correct race justification (381887541)
- Engine,producer: Close review gaps in parallel drawElement streaming (2dbe958a4)
- CLI: Check buildId when resolving the managed Chrome cache (df1d20b76)
- Engine: Log composition-id attribution on script-failure bail too (8fee20a52)
- Engine,producer,cli: Close review gaps in sub-timeline fail-fast (8ba3c3391)
- Engine: Fail-fast the sub-composition timeline wait when a script 404s (54359f3d6)
Docs & Examples
- Producer: Disambiguate compositor frame scheduling from the beginframe capture mode (81a4f0436)