Skip to content

Commit 1f8298c

Browse files
committed
fix(core): preserve held scene dependencies and root timing
2 parents 2ff895a + 7e00f37 commit 1f8298c

188 files changed

Lines changed: 4409 additions & 1026 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.claude-plugin/plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "hyperframes",
33
"description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
4-
"version": "0.8.166",
4+
"version": "0.8.169",
55
"author": {
66
"name": "HeyGen",
77
"email": "[email protected]",

‎.codex-plugin/plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "hyperframes",
33
"description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
4-
"version": "0.8.166",
4+
"version": "0.8.169",
55
"author": {
66
"name": "HeyGen",
77
"email": "[email protected]",

‎.cursor-plugin/plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
"name": "hyperframes",
44
"displayName": "HyperFrames by HeyGen",
55
"description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
6-
"version": "0.8.166",
6+
"version": "0.8.169",
77
"author": {
88
"name": "HeyGen",
99
"email": "[email protected]"

‎docs/changelog.mdx‎

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,88 @@ Recent HyperFrames releases, including user-facing features, fixes, and migratio
88

99
{/* New release entries are prepended by `bun run changelog:draft <version> --write`. */}
1010

11+
<Update
12+
label="HyperFrames v0.8.169"
13+
description="Released - 2026-10-17"
14+
tags={["Release", "CLI", "Gcp Cloud Run", "Studio"]}
15+
>
16+
Rendering from inside an agent's macOS sandbox now works, because Chrome starts as one process instead of several that the sandbox blocks.
17+
18+
## Fixes
19+
20+
- **CLI:** Chrome starts inside an agent's macOS sandbox as one process over a pipe ([5e7ba0be944](https://github.com/heygen-com/hyperframes/commit/5e7ba0be944b076d514fc082c25a0b7e35eeb42f), [#5781](https://github.com/heygen-com/hyperframes/pull/5781)).
21+
- **Gcp Cloud Run:** The BeginFrame contract image resolves the engine's core import ([b18b3e958aa](https://github.com/heygen-com/hyperframes/commit/b18b3e958aa199529fa5fa06728e81b97d520021), [#5785](https://github.com/heygen-com/hyperframes/pull/5785)).
22+
23+
## Internal
24+
25+
- **Studio:** The edit accuracy bench starts one server when node is a Volta shim ([c7151399769](https://github.com/heygen-com/hyperframes/commit/c71513997694f6f56e230d768b6f5c9ed7a73fab), [#5779](https://github.com/heygen-com/hyperframes/pull/5779)).
26+
27+
[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.8.168...v0.8.169).
28+
</Update>
29+
30+
<Update
31+
label="HyperFrames v0.8.168"
32+
description="Released - 2026-10-17"
33+
tags={["Release", "Core", "Engine", "Producer"]}
34+
>
35+
Scrubbing back across a scene in the preview now shows its content instead of an empty frame. Cloud renders size their chunks to the worker limit and assemble in one pass, so long videos finish faster.
36+
37+
## Features
38+
39+
- **Producer:** Distributed renders accept 25 fps ([cc9e1bb33a4](https://github.com/heygen-com/hyperframes/commit/cc9e1bb33a430b878af6dcb257ce5c9a70f9f180), [#5423](https://github.com/heygen-com/hyperframes/pull/5423)).
40+
- **Producer:** Render at 720p and 480p from a larger composition ([09c0307c3fd](https://github.com/heygen-com/hyperframes/commit/09c0307c3fd0318a7ea77e6b41df4e5d30a1902b), [#5724](https://github.com/heygen-com/hyperframes/pull/5724)).
41+
42+
## Fixes
43+
44+
- **Core:** Scrubbing back across a scene no longer leaves its content hidden ([4cf0e3a0e59](https://github.com/heygen-com/hyperframes/commit/4cf0e3a0e599c73a9a96efcee8f62099323a08cf), [#5766](https://github.com/heygen-com/hyperframes/pull/5766)).
45+
- **Engine:** Local renders lay out width-only videos like the browser ([fc41fa277a5](https://github.com/heygen-com/hyperframes/commit/fc41fa277a5649eb4879b524192dd6bee39d7465), [#5771](https://github.com/heygen-com/hyperframes/pull/5771)).
46+
- **CLI:** A browser a sandbox refuses says to rerun the command with escalation ([fa936691562](https://github.com/heygen-com/hyperframes/commit/fa9366915620ea9baa1d03b0eb44caaca013dc21), [#5734](https://github.com/heygen-com/hyperframes/pull/5734)).
47+
- **CLI:** Check's dense overlap pass takes at most 240 samples, at clip windows first ([caea3863b07](https://github.com/heygen-com/hyperframes/commit/caea3863b075f5f79d1c77dd084d05ea05aa0529), [#5764](https://github.com/heygen-com/hyperframes/pull/5764)).
48+
- **Lint:** Stop flagging dir on \<html\>; a render test now guards RTL export ([e6ce7337962](https://github.com/heygen-com/hyperframes/commit/e6ce73379620fb2abf73e0ab681e85fd7f938725), [#5744](https://github.com/heygen-com/hyperframes/pull/5744)).
49+
- **Skills:** Regenerate manifest after HyperFrames guidance update ([40c64255e8c](https://github.com/heygen-com/hyperframes/commit/40c64255e8c0a3d11a0d6e8229b7a88877c84401), [#5747](https://github.com/heygen-com/hyperframes/pull/5747)).
50+
- **CLI:** Honour HYPERFRAMES_SKIP_SKILLS in skills update and bare skills ([6dba67a0c3a](https://github.com/heygen-com/hyperframes/commit/6dba67a0c3a0a51247ab85bbc245f1cf3effa0dc), [#5743](https://github.com/heygen-com/hyperframes/pull/5743)).
51+
- **CLI:** Timeline lists clips nested in a timed element and lint flags ones that never show ([eab6ca15b1a](https://github.com/heygen-com/hyperframes/commit/eab6ca15b1af7ec7bca0bbeb4cd0330e677467a5), [#5732](https://github.com/heygen-com/hyperframes/pull/5732)).
52+
- **Engine:** A WebGPU block mounted as a sub-composition gets WebGPU like a root one ([4e6ee6d2300](https://github.com/heygen-com/hyperframes/commit/4e6ee6d2300290b638042ec88ef5afb7a0c27408), [#5735](https://github.com/heygen-com/hyperframes/pull/5735)).
53+
- **Core:** A composition mounted twice keeps each mount's own timeline ([c38e9f350b4](https://github.com/heygen-com/hyperframes/commit/c38e9f350b4dbe6b09a6a35d5db0d437b9464220), [#5729](https://github.com/heygen-com/hyperframes/pull/5729)).
54+
55+
## Performance
56+
57+
- **Producer:** Assemble in one pass and keep its disk use under one output copy ([a498cf2032c](https://github.com/heygen-com/hyperframes/commit/a498cf2032c6b22492dedb475ad6196a8d6c6797), [#5768](https://github.com/heygen-com/hyperframes/pull/5768)).
58+
- **Producer:** Size distributed chunks to the worker limit and concurrency ([c69fd2c6eca](https://github.com/heygen-com/hyperframes/commit/c69fd2c6ecadedff88cdc09d37854a658bffb733), [#5765](https://github.com/heygen-com/hyperframes/pull/5765)).
59+
60+
## Internal
61+
62+
- **Core:** One owner for the distributed fps set ([d5162beb50a](https://github.com/heygen-com/hyperframes/commit/d5162beb50a402a69423df106647347bd0f8763e), [#5756](https://github.com/heygen-com/hyperframes/pull/5756)).
63+
64+
[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.8.167...v0.8.168).
65+
</Update>
66+
67+
<Update
68+
label="HyperFrames v0.8.167"
69+
description="Released - 2026-10-16"
70+
tags={["Release", "Core", "CLI", "Lint"]}
71+
>
72+
Long projects preview more smoothly: the preview's work now follows what is playing, not the total clip count. Bundling a project also stops freezing the app that runs it.
73+
74+
## Fixes
75+
76+
- **Core:** Bundling a project no longer blocks the host's thread on esbuild ([b1cf6e3c517](https://github.com/heygen-com/hyperframes/commit/b1cf6e3c517e227d1dca1b212e7637c19e502a64), [#5714](https://github.com/heygen-com/hyperframes/pull/5714)).
77+
- **CLI:** Page loads stop timing out while a busy machine's Chrome warms up ([41486b9725a](https://github.com/heygen-com/hyperframes/commit/41486b9725ab2aae4f457d75dcd625931d103bb3), [#5705](https://github.com/heygen-com/hyperframes/pull/5705)).
78+
79+
## Performance
80+
81+
- **Core:** Hold a clip at 0 inside a later scene until it is due ([13ea8349597](https://github.com/heygen-com/hyperframes/commit/13ea8349597bbcb874402d1771aea65766fd7ffc), [#5716](https://github.com/heygen-com/hyperframes/pull/5716)).
82+
- **Core:** A preview's composition scripts give the page a turn every 50 ms, not one long task ([12d8df37f4d](https://github.com/heygen-com/hyperframes/commit/12d8df37f4db8ccf019da32c97cc1352f8db9652), [#5713](https://github.com/heygen-com/hyperframes/pull/5713)).
83+
- **Lint:** Strip stylesheet comments once per canvas zoom scan ([0bff8342c38](https://github.com/heygen-com/hyperframes/commit/0bff8342c389c1841d3b8d858168700f13627e48), [#5712](https://github.com/heygen-com/hyperframes/pull/5712)).
84+
- **Core:** Preview runtime scales with what plays, not with the film's clip count ([d05bc4215d5](https://github.com/heygen-com/hyperframes/commit/d05bc4215d5757da86956217f4a8a4b2ab11b1fd), [#5674](https://github.com/heygen-com/hyperframes/pull/5674)).
85+
86+
## Internal
87+
88+
- **CLI:** Caption image test checks the close itself, not a reusable file number ([eace3d28b6c](https://github.com/heygen-com/hyperframes/commit/eace3d28b6cb721ec1f9a96d7d2ea76bf215551a), [#5707](https://github.com/heygen-com/hyperframes/pull/5707)).
89+
90+
[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.8.166...v0.8.167).
91+
</Update>
92+
1193
<Update
1294
label="HyperFrames v0.8.166"
1395
description="Released - 2026-10-16"

‎docs/deploy/migrating-to-hyperframes-lambda.mdx‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -52,13 +52,13 @@ Most adopters' render config maps directly:
5252

5353
| Concept | HyperFrames equivalent | Where it lives |
5454
| ------------------------ | ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
55-
| `fps` | `--fps=30` (CLI) or `config.fps` (SDK) | 24, 30, 60 only — non-integer NTSC rationals are an in-process-only feature. |
55+
| `fps` | `--fps=30` (CLI) or `config.fps` (SDK) | 24, 25, 30, 60 only — non-integer NTSC rationals are an in-process-only feature. |
5656
| `width` / `height` | `--width` / `--height` flags, or `config.width` / `config.height` | Even integers ≤ 7680 (yuv420p parity). |
5757
| `codec: 'h264' / 'h265'` | `--codec=h264` or `--codec=h265` (mp4 only) | h265 uses libx265 with closed-GOP keyint params so chunked concat-copy round-trips losslessly. |
5858
| Output format | `--format=mp4 / mov / webm / png-sequence` | webm uses libvpx-vp9 + closed-GOP concat-copy. Distributed mode still refuses HDR mp4 at plan time. |
5959
| Quality preset | `--quality=draft / standard / high` | Maps onto ffmpeg encoder presets. |
60-
| Chunk size in frames | `--chunk-size=240` (default 240) | ~8s at 30 fps; sized to fit Lambda's 15-min cap with headroom. |
61-
| Max parallel chunks | `--max-parallel-chunks=16` (default 16) | Caps the Map state's fan-out. |
60+
| Chunk size in frames | `--chunk-size=240` (default: auto) | By default each chunk is sized to finish inside the Lambda timeout with headroom; a render that cannot fails at plan time with `CHUNK_EXCEEDS_WORKER_TIMEOUT`. |
61+
| Max parallel chunks | `--max-parallel-chunks=16` (default: auto) | By default one wave across the deploy's `--concurrency` (16 if unknown), widened when a chunk would outrun the Lambda timeout. |
6262
| Per-chunk frame ceiling | `--target-chunk-frames=N` (optional) | Caps frames per chunk so one chunk can't run past Lambda's 15-min cap on a long video: the planner adds chunks (up to `--max-parallel-chunks`) to keep each at or below `N`, and short videos still collapse to fewer chunks. A ceiling, not a fixed size; ignored when `--chunk-size` is set. |
6363
| Bitrate / CRF | `config.bitrate` or `config.crf` in the SDK | Mutually exclusive; the current Lambda CLI does not expose these two fields. |
6464

‎docs/packages/cli.mdx‎

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1648,6 +1648,10 @@ adds it. `check` and `update` both accept `--json`, plus `--dir` and `--source`
16481648
to point removed-detection at a different skills directory or source — those two
16491649
scope the prune, not the install.
16501650

1651+
Set `HYPERFRAMES_SKIP_SKILLS=1` when something else manages the skills (CI, tests,
1652+
or an install pinned to one commit). `skills update` and bare `skills` then exit 0
1653+
with a one-line notice and leave the installed skills unchanged.
1654+
16511655
The CLI installs from the current HyperFrames GitHub source and links the global
16521656
bundles into whichever compatible agents it finds. After scaffolding, `init`
16531657
also refreshes the core set plus any HyperFrames skills you already have.
@@ -1933,13 +1937,13 @@ And these drive `render` and `render-batch`:
19331937
| ----------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
19341938
| `--width`, `--height` | required | Render dimensions in pixels |
19351939
| `--site-id` | content hash | Reuse an uploaded site instead of uploading again |
1936-
| `--fps` | `30` | `24`, `30`, or `60` |
1940+
| `--fps` | `30` | `24`, `25`, `30`, or `60` |
19371941
| `--format` | `mp4` | `mp4`, `mov`, `webm`, or `png-sequence` |
19381942
| `--codec` | `h264` | `h264` or `h265`, MP4 only |
19391943
| `--quality` | `standard` | `draft`, `standard`, or `high` |
19401944
| `--output-resolution` | — | Supersample via Chrome `deviceScaleFactor` to a preset (`1080p`, `4k`, `uhd`, `hd`, `landscape-4k`, …) without changing layout |
1941-
| `--chunk-size` | `240` | Frames per chunk |
1942-
| `--max-parallel-chunks` | `16` | Concurrent chunks per render |
1945+
| `--chunk-size` | auto | Frames per chunk. By default each chunk is sized to finish inside the Lambda timeout |
1946+
| `--max-parallel-chunks` | auto | Chunks per render. By default one wave across the deploy's `--concurrency` (16 if unknown), widened when a chunk would outrun the Lambda timeout |
19431947
| `--target-chunk-frames` | — | Ceiling on frames per chunk. The planner adds chunks — up to `--max-parallel-chunks` — to stay under it, and short videos still collapse to fewer. Ignored when `--chunk-size` is set. |
19441948
| `--variables` | — | JSON object reaching every chunk worker as `window.__hfVariables` |
19451949
| `--variables-file` | — | Read those from a JSON file |

‎docs/reference/lint-rules.mdx‎

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,8 @@ Severities:
2020

2121
Source: `packages/lint/src/rules/structure.ts`.
2222

23-
The four codes marked **Warning or error** are warnings when the CLI lints a project, and errors when Studio lints the file it is editing.
23+
The five codes marked **Warning or error** are warnings when the CLI lints a project, and errors when Studio
24+
lints the file it is editing.
2425

2526
### `nested_structure_needs_subcomposition`
2627

@@ -52,6 +53,15 @@ The four codes marked **Warning or error** are warnings when the CLI lints a pro
5253

5354
**Fix:** Extend the root `data-duration`, or make the clip end at or before it.
5455

56+
### `nested_clip_never_visible`
57+
58+
**Warning or error.** A timed clip sits inside another timed element, and its time window never overlaps that
59+
element's, so it never appears. A nested clip's `data-start` counts from the composition's start, not from the
60+
element around it. Runs in sub-composition files too.
61+
62+
**Fix:** Give the clip a `data-start` inside its parent's window, in composition time, or move it out of the
63+
parent.
64+
5565
## Composition contract
5666

5767
Source: `packages/lint/src/rules/composition.ts`.
@@ -98,12 +108,6 @@ Source: `packages/lint/src/rules/composition.ts`.
98108

99109
**Fix:** Keep `data-composition-id` on exactly one element: the composition root. Remove it from metadata or duplicate hosts.
100110

101-
### `html_dir_attribute_breaks_render`
102-
103-
**Error.** `<html dir="rtl">` or `<html dir="auto">` renders correctly in preview and snapshot but produces a fully blank or black video from render — a confirmed, silent failure. `dir="ltr"` is not flagged.
104-
105-
**Fix:** Remove `dir` from `<html>`, keep `lang`, and scope the direction to individual text-containing elements instead — `direction: rtl` in CSS, or `dir="auto"` on the element.
106-
107111
### `invalid_parent_traversal_in_asset_path`
108112

109113
**Error.** Asset paths use `../` to traverse above the project root; render and preview clamp or misresolve them.

0 commit comments

Comments
 (0)