Skip to content

Commit 06d0bd3

Browse files
Merge remote-tracking branch 'origin/main' into hf-skill-run-beacon
# Conflicts: # skills-manifest.json
2 parents 320f8fa + 3d78ac0 commit 06d0bd3

94 files changed

Lines changed: 3545 additions & 359 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.9.12",
4+
"version": "0.9.13",
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.9.12",
4+
"version": "0.9.13",
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.9.12",
6+
"version": "0.9.13",
77
"author": {
88
"name": "HeyGen",
99
"email": "[email protected]"

‎docs/changelog.mdx‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,30 @@ 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.9.13"
13+
description="Released - 2026-11-04"
14+
tags={["Release", "Producer", "Lint", "Studio Server"]}
15+
>
16+
A render that stalls while its pages load now retries with fewer workers instead of hanging. A full disk now says so, and splitting a clip that follows another clip cuts where it plays.
17+
18+
## Fixes
19+
20+
- **Producer:** Retry with fewer workers when every page times out loading ([04bc4737ad1d3](https://github.com/heygen-com/hyperframes/commit/04bc4737ad1d300e45c8ad3ebb220ebec1b7ed2d), [#7171](https://github.com/heygen-com/hyperframes/pull/7171)).
21+
- **Lint:** Flag a data-automation or data-fx-chain the render cannot read ([cd7b7383cb19c](https://github.com/heygen-com/hyperframes/commit/cd7b7383cb19c36d63e6d7ad039221bcaccce34a), [#7169](https://github.com/heygen-com/hyperframes/pull/7169)).
22+
- **Studio Server:** Splitting a clip that starts after another clip cuts where it plays ([0bbc9b2943ad6](https://github.com/heygen-com/hyperframes/commit/0bbc9b2943ad6d97edd4acd9b50bb8d648e208d2), [#7172](https://github.com/heygen-com/hyperframes/pull/7172)).
23+
- **Producer:** A drive that refuses frame links gets a copy, whatever code it refuses with ([845bd638a7784](https://github.com/heygen-com/hyperframes/commit/845bd638a7784d0859df047e16c61b8790b9a8bb), [#7163](https://github.com/heygen-com/hyperframes/pull/7163)).
24+
- **Engine:** A full disk during frame extraction says so, not that the video is broken ([ac1948a88b89a](https://github.com/heygen-com/hyperframes/commit/ac1948a88b89a2ef08d02d748f107d55e50d3f9c), [#7161](https://github.com/heygen-com/hyperframes/pull/7161)).
25+
- **CLI:** Address skills install and update hints to the person ([604a25fbaaba5](https://github.com/heygen-com/hyperframes/commit/604a25fbaaba5c3b9dac5deab1d51859fee2516c), [#7160](https://github.com/heygen-com/hyperframes/pull/7160)).
26+
- **CLI:** A failed run exits 1 when its output pipe closes early ([b3b6a8116bb58](https://github.com/heygen-com/hyperframes/commit/b3b6a8116bb58afd100d6a16a79d03310ad486f8), [#7158](https://github.com/heygen-com/hyperframes/pull/7158)).
27+
28+
## Docs & Examples
29+
30+
- Discord in the top bar and footer, and each Discord link tagged by where it sits ([21f2119194ffd](https://github.com/heygen-com/hyperframes/commit/21f2119194ffdf525ff9f423d67cf09e788afa6c), [#7153](https://github.com/heygen-com/hyperframes/pull/7153)).
31+
32+
[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.9.12...v0.9.13).
33+
</Update>
34+
1135
<Update
1236
label="HyperFrames v0.9.12"
1337
description="Released - 2026-11-04"

‎docs/docs.json‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1012,8 +1012,7 @@
10121012
"socials": {
10131013
"github": "https://github.com/heygen-com/hyperframes",
10141014
"discord": "https://discord.gg/7uMDe3PwQn",
1015-
"x": "https://x.com/HeyGen",
1016-
"instagram": "https://www.instagram.com/heygen_official/"
1015+
"x": "https://x.com/HyperFrames_"
10171016
},
10181017
"links": [
10191018
{

‎docs/packages/cli.mdx‎

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -656,8 +656,9 @@ npx hyperframes media-use resolve --type bgm --reuse 06e052c0
656656
# Bring in a file you already have
657657
npx hyperframes media-use resolve --type image --from ./photo.jpg
658658

659-
# The voice clones on the account that makes the film
659+
# The voice clones and avatar looks on the account that makes the film
660660
npx hyperframes media-use voices
661+
npx hyperframes media-use avatars --limit 10
661662

662663
# Check the setup, and see what has been used
663664
npx hyperframes media-use doctor
@@ -676,6 +677,7 @@ file yourself.
676677
| `adopt` | Record the files already in `assets/` so later requests find them, with duration and size read by `ffprobe` |
677678
| `analyze` | Measure an image or video and print suggested exposure and color corrections, saving nothing. Needs `--type grade --for <file>` |
678679
| `voices` | List the voice clones on the HyperFrames account you are signed in with, for `--voice` in `generate`. Never lists the separate `heygen` CLI's account |
680+
| `avatars` | List the avatar looks on the HyperFrames account you are signed in with, as `{avatars: [{avatar_id, name, avatar_type, group_id, gender, status, default_voice_id, preview_image_url}]}`, for `--avatar` in `generate --type avatar`. `--limit` (default 20). Never lists the separate `heygen` CLI's account |
679681
| `doctor` | Check ffmpeg, ffprobe, Node.js, the bundled sound library, and the `heygen` CLI (installed, v0.3.0 or newer, signed in). Changes nothing |
680682
| `stats` | Count requests, misses, and reuse from the project's `.media/` and the global `~/.media/` |
681683

@@ -1209,7 +1211,9 @@ npx hyperframes check [dir] --at 1.5,4,7.25
12091211
npx hyperframes check [dir] --strict # warnings fail too
12101212
```
12111213

1212-
`check` runs the linter first and skips the browser entirely on a lint error.
1214+
`check` runs the linter first. A lint error fails the check but does not stop
1215+
it: the browser checks still run and both are reported, unless the lint error
1216+
leaves no composition to load (a root with no `data-composition-id`).
12131217
Then it loads the bundled composition once and sweeps a single seek grid,
12141218
running every audit at every sample: runtime console errors and failed requests,
12151219
layout defects (overflow, clipping, held overlaps, occlusion, coordinate-frame
@@ -1221,8 +1225,8 @@ a source with no audio track or that cannot be read as audio (error: render
12211225
stops), a clip that starts past the end of its file, a clip whose played part is
12221226
silent (warnings), and a film with no sound at all (info).
12231227

1224-
When the browser never ran (lint errors, a linter crash, or a browser launch
1225-
failure), `browserSkipped` is `true` and the `layout`, `motion` and `contrast`
1228+
When the browser never ran (no composition to load, a linter crash, or a
1229+
browser launch failure), `browserSkipped` is `true` and the `layout`, `motion` and `contrast`
12261230
sections are empty, not clean.
12271231

12281232
Scoped checks add `scope` to the JSON report with the requested range and
@@ -1820,13 +1824,23 @@ How it uses the machine, and when it gives up:
18201824
| `--frames-cache-dir` | `<tmpdir>/hyperframes-extract-cache-<uid>` | Where extracted source frames cache. `off`, `none`, `false`, or `0` disables it. `doctor` reports the live value. |
18211825
| `--max-concurrent-renders` | `2` | Concurrent jobs on the Producer server, 1–10 |
18221826
| `--best-effort` / `--no-best-effort` | on | Finish with capture-readiness warnings, or fail when media is missing or unready |
1827+
| `--wait` / `--no-wait` | on | One local render at a time per user account: wait while another runs, or fail at once. Env: `HYPERFRAMES_RENDER_LOCK=off` renders side by side. |
18231828
| `--strict` / `--strict-all` | off | Fail on lint errors, or on errors and warnings |
18241829
| `--strict-variables` | off | Fail rather than warn on an undeclared or mistyped variable key |
18251830
| `--batch-concurrency` / `--batch-fail-fast` | `1` / off | Batch rows at once, and whether the first failure stops the rest |
18261831
| `--debug` | off | Keep intermediates and write diagnostics under the Producer `.debug` directory |
18271832
| `--quiet` | off | Less output |
18281833
| `--skill` | — | Record which authoring workflow started this render, in usage telemetry |
18291834

1835+
Renders started side by side starve each other of CPU and GPU until frames stop
1836+
landing, so a second local or `--docker` render from the same user account waits
1837+
for the first and says which render it is waiting for (pid and project). The
1838+
slot is a lock file in that account's HyperFrames cache folder, so renders by
1839+
different user accounts do not queue behind each other; set
1840+
`HYPERFRAMES_CACHE_DIR` to a folder they share to give them one slot. A render
1841+
whose process died frees its slot on its own. `--workers` is unaffected: it sets
1842+
the parallelism inside the one render that runs.
1843+
18301844
Low-memory detection reads **host** RAM, not cgroup or container limits, so
18311845
containerised callers — including `--docker` — should set
18321846
`PRODUCER_LOW_MEMORY_MODE` explicitly.
@@ -2559,7 +2573,7 @@ Render parameters mirror local `hyperframes render` where they overlap:
25592573
| `--quality` | `standard` | `draft`, `standard`, or `high` |
25602574
| `--format` | `mp4` | `mp4`, `webm`, or `mov` |
25612575
| `--resolution` | `1080p` | `1080p` or `4k`. 4k bills at 1.5×. |
2562-
| `--aspect-ratio` | auto | `16:9`, `9:16`, or `1:1`. Auto-detected from a local project's `data-width` and `data-height`, so you rarely need it. The renderer cannot reshape a composition — a value that disagrees with the authored ratio is an error. With `--asset-id` or `--url` the server defaults to `16:9`. |
2576+
| `--aspect-ratio` | auto | Any `W:H`, auto-detected from a local project's `data-width` and `data-height`, so you rarely need it. At `1080p` the output keeps the composition's own size, whatever its ratio (a 1920×960 composition renders 1920×960). `4k` scales only `16:9`, `9:16` and `1:1` compositions and refuses any other ratio before upload. The renderer cannot reshape a composition — a value that disagrees with the authored ratio is an error. |
25632577
| `--composition` / `-c` | `index.html` | Entry HTML file inside the zip |
25642578
| `--variables` | — | Inline JSON overriding `data-composition-variables` |
25652579
| `--variables-file` | — | Read those overrides from a JSON file |

‎docs/reference/lint-rules.mdx‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -777,7 +777,13 @@ Source: `packages/lint/src/rules/fonts.ts`.
777777

778778
**Fix:** Declare each family with `@font-face` pointing at the captured `.woff2` files, or bundle the font under `capture/assets/fonts/`.
779779

780-
The declaration may use a quoted or unquoted family name. If `font-family` is the last descriptor in the block, its final semicolon is optional.
780+
The declaration may use a quoted or unquoted family name. If `font-family` is the last descriptor in the block, its final semicolon is optional. Families named in a `font` shorthand (`font: 500 16px/1 "PingFang SC", sans-serif`) count the same as `font-family`.
781+
782+
### `font_face_local_only`
783+
784+
**Warning.** An `@font-face` names only `local()` sources. A local render draws the font installed on this machine; a cloud render, or another machine without it, falls back to a different font.
785+
786+
**Fix:** Add a `url()` source pointing at a `.woff2` file inside the project, or use a Google Fonts family.
781787

782788
### `system_font_will_alias`
783789

‎gemini-extension.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
22
"name": "hyperframes",
3-
"version": "0.9.12",
3+
"version": "0.9.13",
44
"description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames."
55
}

‎packages/aws-lambda/package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@hyperframes/aws-lambda",
3-
"version": "0.9.12",
3+
"version": "0.9.13",
44
"description": "AWS Lambda adapter for HyperFrames distributed rendering — handler, client-side SDK, and CDK construct.",
55
"repository": {
66
"type": "git",

‎packages/cli/package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@hyperframes/cli",
3-
"version": "0.9.12",
3+
"version": "0.9.13",
44
"description": "Make videos with code and AI agents: write HTML, render MP4. Open source.",
55
"keywords": [
66
"ai-agents",

0 commit comments

Comments
 (0)