v0.8.44

heygen-com/hyperframesv0.8.44Sep 16, 2026by github-actions[bot]

Upgrading?

AI Summary

This release addresses a false positive warning for sub-compositions and introduces an opt-in locked keyframe interval feature for the streaming encoder.

Key Highlights

  • Fixed `root_dimensions_mismatch` false positives for sub-compositions.
  • Streaming encoder gains `lockGopForChunkConcat` for keyframe locking.
  • Improved error messages for viewport-meta-only mismatches.
  • New feature defaults to off to maintain backward compatibility.

New Features

  • Streaming encoder accepts `lockGopForChunkConcat` and `gopSize` to force keyframes at fixed intervals for cut-and-join operations.

Full Release Notes

# HyperFrames v0.8.44

Released on 2026-09-16.

The `root_dimensions_mismatch` false positive from v0.8.43 is fixed, so `lint` and `check --strict` stop flagging sub-compositions. The streaming encoder gains an opt-in locked keyframe interval, which no existing render turns on.

## Features

- **Engine:** The streaming encoder accepts `lockGopForChunkConcat` and `gopSize`, which force a keyframe at a fixed interval so encoded output can be cut and joined without re-encoding. It already existed on the disk encoder and now emits identical arguments on both paths. The flag defaults to off and an existing render produces the same FFmpeg arguments as before ([b4f1929cf](https://github.com/heygen-com/hyperframes/commit/b4f1929cf0a7f7450185f36b29be69d2a952bc6f), [#3973](https://github.com/heygen-com/hyperframes/pull/3973)).

## Fixes

- **Lint:** `root_dimensions_mismatch` no longer fires for sub-compositions. A sub-composition's own `<meta viewport>` and `html, body` CSS never reach the live rendering document, because the runtime mounts only its matched subtree, so the warning was drift that could not clip anything. v0.8.43 shipped the warning with this known false positive and this is the promised follow-up. A top-level mismatch is still reported, and a viewport-meta-only mismatch now says so in its own words rather than warning about clipping ([2229d0d6a](https://github.com/heygen-com/hyperframes/commit/2229d0d6a6eaca5822cc5bfdfa0dc02812667db1), [#4012](https://github.com/heygen-com/hyperframes/pull/4012)).

## Full changelog

https://github.com/heygen-com/hyperframes/compare/v0.8.43...v0.8.44

Related Repositories