Skip to content

Commit ca8d5ab

Browse files
Merge remote-tracking branch 'origin/main' into miao/open-in-desktop-platforms
# Conflicts: # packages/cli/src/commands/open.ts # packages/cli/src/commands/render.ts # packages/cli/src/commands/render/execute.test.ts # packages/cli/src/help.ts # packages/cli/src/server/desktopRoutes.test.ts # packages/cli/src/server/desktopRoutes.ts # packages/cli/src/utils/desktopApp.test.ts # packages/cli/src/utils/desktopApp.ts # packages/studio/src/components/OpenInDesktopButton.dom.test.tsx # packages/studio/src/components/OpenInDesktopButton.tsx # scripts/studio-runtime-smoke.mjs
2 parents 4d63607 + 805cf60 commit ca8d5ab

121 files changed

Lines changed: 3170 additions & 454 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.120",
4+
"version": "0.8.122",
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.120",
4+
"version": "0.8.122",
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.120",
6+
"version": "0.8.122",
77
"author": {
88
"name": "HeyGen",
99
"email": "[email protected]"

‎.github/workflows/ci.yml‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -848,6 +848,8 @@ jobs:
848848
packages/studio/data/projects/studio-open
849849
cp -R packages/studio/tests/e2e/fixtures/fade-handles \
850850
packages/studio/data/projects/fade-handles
851+
cp -R packages/studio/tests/e2e/fixtures/timeline-trim-snap \
852+
packages/studio/data/projects/timeline-trim-snap
851853
cp -R packages/studio/tests/e2e/fixtures/inline-text-caret \
852854
packages/studio/data/projects/inline-text-caret
853855
cp -R packages/studio/tests/e2e/fixtures/undo-socket-pool \
@@ -960,7 +962,7 @@ jobs:
960962
node packages/studio/tests/e2e/perf-ratchet.mjs check \
961963
packages/studio/tests/e2e/perf-ceilings.json studio-open /tmp/studio-open-counts.json \
962964
/tmp/base-perf-ceilings.json
963-
- name: Check fade handles, render selects and thumbnail connection release
965+
- name: Check fade handles, render selects, thumbnail connection release and trim snapping
964966
if: success() || failure()
965967
run: |
966968
set -euo pipefail
@@ -983,6 +985,8 @@ jobs:
983985
node packages/studio/tests/e2e/render-selects.mjs || rc=1
984986
STUDIO_URL="http://localhost:5316/" \
985987
node packages/studio/tests/e2e/thumbnail-save.mjs || rc=1
988+
STUDIO_URL="http://localhost:5316/#project/timeline-trim-snap" \
989+
node packages/studio/tests/e2e/timeline-trim-snap.mjs || rc=1
986990
exit "$rc"
987991
- name: Measure the caret of a text edited in place
988992
if: success() || failure()

‎bun.lock‎

Lines changed: 13 additions & 13 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎docs/changelog.mdx‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,48 @@ 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.122"
13+
description="Released - 2026-10-04"
14+
tags={["Release", "Media Use", "Core", "Studio"]}
15+
>
16+
Studio trims keep the playhead still and clips snap to the ruler, and a host can show its own Split key. Renders wait for web fonts, so text-sized layouts repeat exactly. Media Use gives clearer credential errors and no longer leaves empty assets after a slow download.
17+
18+
## Fixes
19+
20+
- **Media Use:** Say to fix an unreadable credentials path, not to log in again ([981bcf455332](https://github.com/heygen-com/hyperframes/commit/981bcf455332a18e951e323c78395d30df32ea66), [#4998](https://github.com/heygen-com/hyperframes/pull/4998)).
21+
- **Core:** Composition scripts start after web fonts are ready, so renders repeat ([44b583625095](https://github.com/heygen-com/hyperframes/commit/44b5836250953fd34fa1d85b4843db34efd2232c), [#4980](https://github.com/heygen-com/hyperframes/pull/4980)).
22+
- **Studio:** Trimming keeps the playhead still; clips snap to the ruler grid ([7859c0f0037a](https://github.com/heygen-com/hyperframes/commit/7859c0f0037a1e07988e6f5fba31a2c8bc6f9456), [#4986](https://github.com/heygen-com/hyperframes/pull/4986)).
23+
- **Studio:** The host can name Split's key on the toolbar and bind the clip menu's link keys ([b04081b376a3](https://github.com/heygen-com/hyperframes/commit/b04081b376a3c2c549b7df71c8be0afb22001b03), [#4994](https://github.com/heygen-com/hyperframes/pull/4994)).
24+
- **Media Use:** A slow download no longer leaves an empty asset that undo brings back ([18a922f43342](https://github.com/heygen-com/hyperframes/commit/18a922f43342a3afb6e03e80ab7174d78552da95), [#4989](https://github.com/heygen-com/hyperframes/pull/4989)).
25+
26+
## Internal
27+
28+
- **Studio:** The edit bench render serves GSAP from the repo, never the CDN ([7f3464921c7d](https://github.com/heygen-com/hyperframes/commit/7f3464921c7dad4ed66930661147b12225f23440), [#4996](https://github.com/heygen-com/hyperframes/pull/4996)).
29+
- **Core:** Pin three composition-length rules that no test covered ([351d389c0bcc](https://github.com/heygen-com/hyperframes/commit/351d389c0bcc60dcabcd8e7aaf4592923efde179), [#5000](https://github.com/heygen-com/hyperframes/pull/5000)).
30+
31+
[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.8.121...v0.8.122).
32+
</Update>
33+
34+
<Update
35+
label="HyperFrames v0.8.121"
36+
description="Released - 2026-10-04"
37+
tags={["Release", "Core", "Media Use"]}
38+
>
39+
Media Use no longer crashes when a HeyGen credentials path is a folder. Video length and size now come from one place in the core runtime.
40+
41+
## Fixes
42+
43+
- **Media Use:** A credentials folder means no HeyGen credential, not a crash ([32d2bc6fe030](https://github.com/heygen-com/hyperframes/commit/32d2bc6fe03007c7c8417268522516e3db7a2e87), [#4995](https://github.com/heygen-com/hyperframes/pull/4995)).
44+
- **Media Use:** Skip a .env folder when loading HeyGen credentials ([5f3191bdc593](https://github.com/heygen-com/hyperframes/commit/5f3191bdc59312b6d6cba231e50207919e22b7cf), [#4988](https://github.com/heygen-com/hyperframes/pull/4988)).
45+
46+
## Internal
47+
48+
- **Core:** One pure owner for composition length and root size ([34ff5ca1dea1](https://github.com/heygen-com/hyperframes/commit/34ff5ca1dea155ad0a29b26b6cb456b12b18b1d5), [#4990](https://github.com/heygen-com/hyperframes/pull/4990)).
49+
50+
[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.8.120...v0.8.121).
51+
</Update>
52+
1153
<Update
1254
label="HyperFrames v0.8.120"
1355
description="Released - 2026-10-04"

‎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.8.120",
3+
"version": "0.8.122",
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.8.120",
3+
"version": "0.8.122",
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.8.120",
3+
"version": "0.8.122",
44
"description": "HyperFrames CLI — create, preview, and render HTML video compositions",
55
"license": "Apache-2.0",
66
"repository": {

‎packages/cli/src/capture/captureCompositionFrame.test.ts‎

Lines changed: 36 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
22
import { tmpdir } from "node:os";
3-
import { join } from "node:path";
3+
import { dirname, join } from "node:path";
4+
import { fileURLToPath } from "node:url";
45
import { afterEach, describe, expect, it, vi } from "vitest";
56
import {
67
AUDIT_SEEK_OPTIONS,
@@ -14,6 +15,7 @@ import {
1415
resolveCropRegion,
1516
runFfmpegOnce,
1617
seekCompositionTimeline,
18+
waitForRuntimeReady,
1719
type CompositionSeekPage,
1820
} from "./captureCompositionFrame.js";
1921

@@ -48,6 +50,39 @@ afterEach(() => {
4850
vi.unstubAllGlobals();
4951
});
5052

53+
describe("waitForRuntimeReady", () => {
54+
it("waits for the runtime's render-ready flag and reports a timeout as not ready", async () => {
55+
const { waitForFunction } = fakeSeekPage();
56+
57+
await expect(waitForRuntimeReady({ waitForFunction }, 123)).resolves.toBe(true);
58+
expect(waitForFunction).toHaveBeenCalledWith(expect.any(Function), { timeout: 123 });
59+
const ready = waitForFunction.mock.calls[0]![0];
60+
vi.stubGlobal("window", { __timelines: {} });
61+
expect(ready()).toBe(false);
62+
vi.stubGlobal("window", { __timelines: {}, __renderReady: true });
63+
expect(ready()).toBe(true);
64+
65+
waitForFunction.mockRejectedValueOnce(new Error("Waiting failed: 1ms exceeded"));
66+
await expect(waitForRuntimeReady({ waitForFunction }, 1)).resolves.toBe(false);
67+
});
68+
69+
it("is what layout, motion-shot and validate wait on before they sample the page", () => {
70+
const commands = join(dirname(fileURLToPath(import.meta.url)), "../commands");
71+
const firstSample = {
72+
layout: "getCompositionDuration(page)",
73+
motionShot: "installSeekHelper(page)",
74+
validate: "auditClipDurations(page,",
75+
};
76+
for (const [name, sample] of Object.entries(firstSample)) {
77+
const source = readFileSync(join(commands, `${name}.ts`), "utf8");
78+
const wait = source.indexOf("await waitForRuntimeReady(page, ");
79+
expect(wait, name).toBeGreaterThan(-1);
80+
expect(source.indexOf(sample), name).toBeGreaterThan(wait);
81+
expect(source, name).not.toContain("__timelines?: unknown }).__timelines");
82+
}
83+
});
84+
});
85+
5186
describe("seekCompositionTimeline", () => {
5287
it("keeps the raced double-frame settle and adds a bounded font wait by default", async () => {
5388
const { page, evaluate, waitForFunction } = fakeSeekPage();

0 commit comments

Comments
 (0)