Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "hyperframes",
"description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
"version": "0.9.58",
"version": "0.9.59",
"author": {
"name": "HeyGen",
"email": "hyperframes@heygen.com",
Expand Down
2 changes: 1 addition & 1 deletion .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "hyperframes",
"description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
"version": "0.9.58",
"version": "0.9.59",
"author": {
"name": "HeyGen",
"email": "hyperframes@heygen.com",
Expand Down
2 changes: 1 addition & 1 deletion .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"name": "hyperframes",
"displayName": "HyperFrames by HeyGen",
"description": "Write HTML, render video. Compositions, Tailwind v4 styles, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
"version": "0.9.58",
"version": "0.9.59",
"author": {
"name": "HeyGen",
"email": "hyperframes@heygen.com"
Expand Down
46 changes: 46 additions & 0 deletions docs/changelog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,52 @@ Recent HyperFrames releases, including user-facing features, fixes, and migratio

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

<Update
label="HyperFrames v0.9.59"
description="Released - 2026-11-16"
tags={["Release", "Changelog", "Publish", "CLI"]}
>
The preview player gets a fullscreen button, and a failed render now says why. Renders, Studio and the CLI keep to the project's own files and to public media hosts.

## Features

- **Player:** Add a fullscreen button to the preview player ([5be6c1580](https://github.com/heygen-com/hyperframes/commit/5be6c1580f6e707966818ab15c349ea31814f69e), [#7726](https://github.com/heygen-com/hyperframes/pull/7726)).
- **Core:** Describe replies carry the picker's element label, and studio exports standInHandle ([51ae92510](https://github.com/heygen-com/hyperframes/commit/51ae92510502dae5255f997058e9a5dfa399ad77), [#7936](https://github.com/heygen-com/hyperframes/pull/7936)).

## Fixes

- **CLI:** Validate and keyframes print project text with control characters as visible escapes ([ce8d55d30](https://github.com/heygen-com/hyperframes/commit/ce8d55d302c3d9949d839cff7043feaf5fd56020), [#7958](https://github.com/heygen-com/hyperframes/pull/7958)).
- **Check:** A media source that failed to load is not reported as a timeout ([5e0c3db12](https://github.com/heygen-com/hyperframes/commit/5e0c3db12897039f197bc0e4e8ca183f5e4a20e8), [#7954](https://github.com/heygen-com/hyperframes/pull/7954)).
- **CLI:** Help shows each option's default once ([d7f8d77fb](https://github.com/heygen-com/hyperframes/commit/d7f8d77fb4a7b0c7096a069649e864ba133e4976), [#7953](https://github.com/heygen-com/hyperframes/pull/7953)).
- **CLI:** Render --json gives each missing tool, a held slot and an old Node its own code ([47d007e5b](https://github.com/heygen-com/hyperframes/commit/47d007e5b04c13d54d5617c2f02d06d91ffaf6fb), [#7842](https://github.com/heygen-com/hyperframes/pull/7842)).
- **Sdk Playground:** The Vite config loads on Node 22 before 22.18 ([c7876f333](https://github.com/heygen-com/hyperframes/commit/c7876f333073160fd73f0ed9931994d553dc53f6), [#7805](https://github.com/heygen-com/hyperframes/pull/7805)).
- **Check:** Mark a contrast finding by its severity and quote its text ([ec5a4e2a1](https://github.com/heygen-com/hyperframes/commit/ec5a4e2a103e28f5b3391de70b9eed8be33083f0), [#7752](https://github.com/heygen-com/hyperframes/pull/7752)).
- **Player:** Stop the preview freezing when many clips share one long recording ([42508c1ef](https://github.com/heygen-com/hyperframes/commit/42508c1ef1f013ac4a23c58160f2aabac20d879a), [#7795](https://github.com/heygen-com/hyperframes/pull/7795)).
- Snapshot skips private files, no text-art demuxers, escaped warning text ([8959deb00](https://github.com/heygen-com/hyperframes/commit/8959deb00f2c41f42bf0351a52982a9fd8d23b01), [#7943](https://github.com/heygen-com/hyperframes/pull/7943)).
- **CLI:** Capture names its local page server's port in the bypass entry ([a9b0371c8](https://github.com/heygen-com/hyperframes/commit/a9b0371c83656e7c911c041c9bb827c83af068c8), [#7965](https://github.com/heygen-com/hyperframes/pull/7965)).
- **CLI:** A render that fails says why, even on a crash or a silent exit ([2623ded13](https://github.com/heygen-com/hyperframes/commit/2623ded13684de4af7de4595cad1063eecb0a0a1), [#7957](https://github.com/heygen-com/hyperframes/pull/7957)).
- **Studio:** A long audio file from outside the project is never decoded for its waveform ([c77cd301c](https://github.com/heygen-com/hyperframes/commit/c77cd301c8ab8e5fbd5ffe887bdd36064f4f2fdf), [#7961](https://github.com/heygen-com/hyperframes/pull/7961)).
- **Publish:** Upload only what npm reads as checked; tags publish only main, next or alpha commits ([5f4637977](https://github.com/heygen-com/hyperframes/commit/5f46379775c35432bc4c2c115b2f341169ab96bc), [#7959](https://github.com/heygen-com/hyperframes/pull/7959)).
- **Engine:** Media URL reads reach only public hosts under a restricted page network ([994fbbde2](https://github.com/heygen-com/hyperframes/commit/994fbbde2a4ae879b747b687e3a7de13bdd437a5), [#7946](https://github.com/heygen-com/hyperframes/pull/7946)).
- **Cli,engine:** Pin the page server's direct host to an explicit port and the Studio's own origin ([dbc9c1826](https://github.com/heygen-com/hyperframes/commit/dbc9c18262fd9c773491990d04f2aef6b32cea1d), [#7945](https://github.com/heygen-com/hyperframes/pull/7945)).
- **Producer:** A render waiting on a long audio mix says it is processing audio ([df698a029](https://github.com/heygen-com/hyperframes/commit/df698a0290c71f3a2936f3591a8bdf14a56a7163), [#7952](https://github.com/heygen-com/hyperframes/pull/7952)).
- **Core:** A capture page loads a clip with no set length only when it is due ([9e5048772](https://github.com/heygen-com/hyperframes/commit/9e50487720346ef15a27294b9e969e3d7d09f2cd), [#7938](https://github.com/heygen-com/hyperframes/pull/7938)).
- **Studio:** Beat analysis never picks a recording longer than a song ([87955b890](https://github.com/heygen-com/hyperframes/commit/87955b890e92ec94bbf77f82b6fc567d16127e5e), [#7944](https://github.com/heygen-com/hyperframes/pull/7944)).
- **CLI:** Own render-slot lock dir; refuse cache files other accounts can write ([071a2da0b](https://github.com/heygen-com/hyperframes/commit/071a2da0b5b1f3d278650fb432da79b32726990d), [#7951](https://github.com/heygen-com/hyperframes/pull/7951)).
- **CLI:** Never write project records through symlinks under .hyperframes ([061ff5bbb](https://github.com/heygen-com/hyperframes/commit/061ff5bbb04f71432f0d97277f4140dc85b5d738), [#7950](https://github.com/heygen-com/hyperframes/pull/7950)).

## Docs & Examples

- **Changelog:** Weekly digest 2026-11-09-2026-11-16 ([af873924d](https://github.com/heygen-com/hyperframes/commit/af873924dbc8c3a5ac17cd2175214ee64adb90e1), [#7969](https://github.com/heygen-com/hyperframes/pull/7969)).
- **Publish:** Say publishing waits for no approval and only admins push prerelease tags ([a707e4737](https://github.com/heygen-com/hyperframes/commit/a707e473796f442d56bd5b3920a9c0bea159f585), [#7960](https://github.com/heygen-com/hyperframes/pull/7960)).

## Catalog

- **Ci:** A catalog publish run that main overtook ends clean instead of failing ([77e675574](https://github.com/heygen-com/hyperframes/commit/77e675574f5651e2c49ddde186033e58a9d9b72e), [#7816](https://github.com/heygen-com/hyperframes/pull/7816)).

[View the full commit range](https://github.com/heygen-com/hyperframes/compare/v0.9.58...v0.9.59).
</Update>

<Update
label="HyperFrames v0.9.58"
description="Released - 2026-11-16"
Expand Down
2 changes: 1 addition & 1 deletion gemini-extension.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"name": "hyperframes",
"version": "0.9.58",
"version": "0.9.59",
"description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames."
}
2 changes: 1 addition & 1 deletion packages/aws-lambda/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/aws-lambda",
"version": "0.9.58",
"version": "0.9.59",
"description": "AWS Lambda adapter for HyperFrames distributed rendering — handler, client-side SDK, and CDK construct.",
"repository": {
"type": "git",
Expand Down
2 changes: 1 addition & 1 deletion packages/cli/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/cli",
"version": "0.9.58",
"version": "0.9.59",
"description": "Make videos with code and AI agents: write HTML, render MP4. Open source.",
"keywords": [
"ai-agents",
Expand Down
2 changes: 1 addition & 1 deletion packages/core/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@hyperframes/core",
"version": "0.9.58",
"version": "0.9.59",
"description": "",
"repository": {
"type": "git",
Expand Down
101 changes: 51 additions & 50 deletions packages/core/src/runtime/entry.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,6 @@ import { mediaElementTime } from "./mediaClock";
import { HF_COLOR_GRADING_ATTR, serializeHfColorGrading } from "../colorGrading";
import {
PLAYER_FRAME_ATTR,
PLAYER_FRAME_NAME,
STUDIO_PREVIEW_LAZY_ATTR,
STUDIO_PREVIEW_CAPTURE_MODE,
STUDIO_PREVIEW_MARK_META,
Expand Down Expand Up @@ -77,7 +76,6 @@ function resetRuntimeGlobals(): void {
delete win.__hyperframeRuntimeBootstrapped;
delete win.__hfFirstPassHidden;
delete (document as { readyState?: unknown }).readyState;
window.name = "";
}

// The first evaluation transforms the whole runtime graph. Paying it while the file loads keeps
Expand Down Expand Up @@ -490,9 +488,9 @@ describe("runtime entry", () => {
srcWrites.observe(now, { attributeFilter: ["src"] });
window.__player?.seek(7.6);
expect(armed(now, soon, later)).toEqual([false, false, true]);
// The two that left are released: now by setting its src again, soon (no src) by reloading empty.
// The two that left are reloaded empty with src dropped for the reload, ending any fetch in flight.
expect([now.preload, soon.preload]).toEqual(["none", "none"]);
expect(loadsOf(now, soon, later)).toEqual([1, 2, 1]);
expect(loadsOf(now, soon, later)).toEqual([2, 2, 1]);
expect(srcWrites.takeRecords()).toHaveLength(2);
expect(now.getAttribute("src")).toBe("now.mp4");
});
Expand Down Expand Up @@ -550,45 +548,39 @@ describe("runtime entry", () => {
if (userAgent === "safari") asSafari();
};

// Chromium and Firefox keep a paused clip's request open with its unread bytes, and every
// request to one host shares one HTTP/2 or HTTP/3 window: with each take loaded, the window
// fills and the next take's request is never answered.
it.each(["safari", "chrome"] as const)(
"in the player on %s a file keeps the take on screen and the next one loading, and frees the rest",
async (userAgent) => {
spyLoad();
inPlayerFrame(userAgent);
const [first, second, third] = takesOfOneFile();

await evaluateRuntime();
expect([first, second, third].map((take) => armed(...take))).toEqual([
[true, true],
[true, true],
[false, false],
]);

window.__player?.seek(3.5);
const video = second![0]!;
Object.defineProperty(video, "readyState", { value: 4, configurable: true });
video.dispatchEvent(new Event("seeked"));
expect([first, second, third].map((take) => armed(...take))).toEqual([
[false, false],
[true, true],
[true, true],
]);
},
);
it("in the player on Safari a file keeps the take on screen and the next one loading, and frees the rest", async () => {
spyLoad();
inPlayerFrame("safari");
const [first, second, third] = takesOfOneFile();

await evaluateRuntime();
expect([first, second, third].map((take) => armed(...take))).toEqual([
[true, true],
[true, true],
[false, false],
]);

window.__player?.seek(3.5);
const video = second![0]!;
Object.defineProperty(video, "readyState", { value: 4, configurable: true });
video.dispatchEvent(new Event("seeked"));
expect([first, second, third].map((take) => armed(...take))).toEqual([
[false, false],
[true, true],
[true, true],
]);
});

it("holds back the takes after the next in a player frame the composition cannot read, as with an opaque sandbox", async () => {
it("in the player on Chromium every take of a file loads at parse", async () => {
spyLoad();
window.name = PLAYER_FRAME_NAME;
inPlayerFrame("chrome");
const takes = takesOfOneFile();

await evaluateRuntime();
expect(takes.map((take) => armed(...take))).toEqual([
[true, true],
[true, true],
[false, false],
[true, true],
]);
});

Expand Down Expand Up @@ -1123,21 +1115,30 @@ describe("runtime entry", () => {
expect([first.preload, later.preload, untrimmed.preload]).toEqual(["", "none", ""]);
});

it.each(["safari", "chrome"] as const)(
"gives each parsed clip preload none in the player's frame on %s, where no clip fetches ahead of the first take",
async (userAgent) => {
const frame = document.createElement("iframe");
frame.setAttribute(PLAYER_FRAME_ATTR, "");
vi.spyOn(window, "frameElement", "get").mockReturnValue(frame);
if (userAgent === "safari") asSafari();
const root = mountRoot();
timed(root, "div", "0");
await evaluateRuntime();
const [first, later] = videos(root, "0", "5");
await Promise.resolve();
expect([first.preload, later.preload]).toEqual(["", "none"]);
},
);
it("gives each parsed clip preload none in the player's frame, where no clip fetches ahead of the first take", async () => {
const frame = document.createElement("iframe");
frame.setAttribute(PLAYER_FRAME_ATTR, "");
vi.spyOn(window, "frameElement", "get").mockReturnValue(frame);
asSafari();
const root = mountRoot();
timed(root, "div", "0");
await evaluateRuntime();
const [first, later] = videos(root, "0", "5");
await Promise.resolve();
expect([first.preload, later.preload]).toEqual(["", "none"]);
});

it("leaves Chromium loading every clip at parse in the player's frame", async () => {
const frame = document.createElement("iframe");
frame.setAttribute(PLAYER_FRAME_ATTR, "");
vi.spyOn(window, "frameElement", "get").mockReturnValue(frame);
const root = mountRoot();
timed(root, "div", "0");
await evaluateRuntime();
const [first, later] = videos(root, "0", "5");
await Promise.resolve();
expect([first.preload, later.preload]).toEqual(["", ""]);
});

it("leaves a frame the player did not mark loading every clip at parse", async () => {
vi.spyOn(window, "frameElement", "get").mockReturnValue(document.createElement("iframe"));
Expand Down
21 changes: 0 additions & 21 deletions packages/core/src/runtime/init.previewSeek.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -994,27 +994,6 @@ it("keeps pending-seek Play synchronous in an unmarked Safari player frame", ()
expect(next.some(({ video }) => vi.mocked(video.play).mock.calls.length > 0)).toBe(true);
});

it.each([
[
"Chrome",
"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/157.0.0.0 Safari/537.36",
],
["Firefox", "Mozilla/5.0 (X11; Linux x86_64; rv:160.0) Gecko/20100101 Firefox/160.0"],
])(
"moves the playhead at once on a paused seek in a %s player frame, with no picture held",
(_, userAgent) => {
vi.spyOn(navigator, "userAgent", "get").mockReturnValue(userAgent);
const frame = document.createElement("iframe");
frame.setAttribute(PLAYER_FRAME_ATTR, "");
vi.spyOn(window, "frameElement", "get").mockReturnValue(frame);
const { main } = film(false, false);
void window.__player!.seek(6);
expect(main.time?.()).toBe(6);
expect(document.querySelectorAll("canvas")).toHaveLength(0);
expect(document.documentElement.hasAttribute(PREVIEW_SEEK_HOLD_ATTR)).toBe(false);
},
);

it("retains an explicit unmarked provider handoff before its first picture", async () => {
const { main, old, next } = safariPlayerFilm();
for (const video of old) video.metadataAt(0);
Expand Down
2 changes: 1 addition & 1 deletion packages/core/src/runtime/init.ts
Original file line number Diff line number Diff line change
Expand Up @@ -5173,7 +5173,7 @@ export function initSandboxRuntimeModular(): void {
nativePlayTime = undefined;
wallClearTimeout(nativeWarmTimer);
if (
!(studioPreview || (playerFrame && isWebKit())) ||
!mediaDeferred ||
state.nativeMediaSyncDisabled ||
isExportRenderDrivingFrames() ||
window.__HF_EXPORT_RENDER_SEEK_CONFIG ||
Expand Down
23 changes: 6 additions & 17 deletions packages/core/src/runtime/preloadMedia.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -108,21 +108,14 @@ describe("initial media preload", () => {
});

describe("releasing a clip's download", () => {
const srcWrites = (el: Element) => {
const observer = new MutationObserver(() => {});
observer.observe(el, { attributeFilter: ["src"] });
return () => observer.takeRecords().length;
};

it("reloads a src clip by setting its src again, not by load(), after which Firefox fetches metadata whatever the preload", () => {
it("reloads a src clip with its src dropped, then puts the src back", () => {
const video = document.createElement("video");
video.setAttribute("src", "a.mp4");
video.load = vi.fn();
const writes = srcWrites(video);
const atLoad: (string | null)[] = [];
video.load = () => atLoad.push(video.getAttribute("src"));

releaseMedia(video);
expect(writes()).toBeGreaterThan(0);
expect(video.load).not.toHaveBeenCalled();
expect(atLoad).toEqual([null]);
expect(video.getAttribute("src")).toBe("a.mp4");
});

Expand All @@ -134,11 +127,9 @@ describe("releasing a clip's download", () => {
value: { length: 1, start: () => 0, end: () => 6.67 },
});
video.load = vi.fn();
const writes = srcWrites(video);

releaseMedia(video);
expect(video.load).not.toHaveBeenCalled();
expect(writes()).toBe(0);
expect(video.getAttribute("src")).toBe("a.mp4");
});

Expand All @@ -150,10 +141,9 @@ describe("releasing a clip's download", () => {
value: { length: 1, start: () => 0, end: () => 6.67 },
});
video.load = vi.fn();
const writes = srcWrites(video);

releaseMedia(video, true);
expect(writes()).toBeGreaterThan(0);
expect(video.load).toHaveBeenCalledTimes(1);
expect(video.getAttribute("src")).toBe("a.mp4");
});

Expand All @@ -168,10 +158,9 @@ describe("releasing a clip's download", () => {
value: { length: 1, start: () => from, end: () => to },
});
video.load = vi.fn();
const writes = srcWrites(video);

releaseMedia(video);
expect(writes()).toBeGreaterThan(0);
expect(video.load).toHaveBeenCalledTimes(1);
});

it("leaves a clip on <source> children, their order and its markup untouched", () => {
Expand Down
6 changes: 2 additions & 4 deletions packages/core/src/runtime/preloadMedia.ts
Original file line number Diff line number Diff line change
Expand Up @@ -99,10 +99,8 @@ export function releaseMedia(media: HTMLMediaElement, whenBuffered = false): voi
if (media.querySelector("source") || (!whenBuffered && wholeFileBuffered(media))) return;
if (holdsWhenIdle(media)) return holdUntilDue(media);
const src = media.getAttribute("src");
if (src === null) return stopMediaDownload(media);
cancelPlaybackStart(media);
media.removeAttribute("src");
media.setAttribute("src", src);
stopMediaDownload(media);
if (src !== null) media.setAttribute("src", src);
}

export function lengthIsAuthored(media: Element): boolean {
Expand Down
9 changes: 3 additions & 6 deletions packages/core/src/studioPreviewMark.ts
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
import { isWebKit } from "./runtime/mediaClock.js";

export const STUDIO_PREVIEW_MARK_META = "hyperframes-studio-preview";
export const PREVIEW_SEEK_HOLD_ATTR = "data-hf-preview-seek-hold";
export const PREVIEW_VIDEO_FRAME_ATTR = "data-hf-preview-video-frame";
Expand All @@ -21,14 +23,9 @@ export function getLogicalOpacity(el: Element, computed: CSSStyleDeclaration): s
return computed.opacity;
}
export const PLAYER_FRAME_ATTR = "data-hf-player-frame";
export const PLAYER_FRAME_NAME = "hyperframes-player";

export function inPlayerFrame(doc: Document): boolean {
const frame = doc.defaultView;
return (
frame?.name === PLAYER_FRAME_NAME ||
frame?.frameElement?.hasAttribute(PLAYER_FRAME_ATTR) === true
);
return isWebKit() && doc.defaultView?.frameElement?.hasAttribute(PLAYER_FRAME_ATTR) === true;
}

export function defersMediaIn(doc: Document): boolean {
Expand Down
Loading
Loading