* feat(core): describe replies carry the picker's element label, and studio exports standInHandle
* fix(core): label an element by its rendered text, and read a describe reply without a label
* style(core): format the rendered-text walk
* fix(studio): beat analysis never picks a recording longer than a song
* fix(studio): a long music track keeps its saved beats; the cap judges the file alone
* fix(studio): a music track's beat edits survive its file length arriving
* feat(studio): a sealed preview frame forwards Studio's playback keys
* fix(core): a key held while Studio re-sends its watch list still forwards its keyup
* fix(core): the key watch adds and removes its listeners by name, as the runtime typecheck needs
* chore(producer): raise the unpacked size budget for the runtime's key forwarding
* fix(core): a graded video's opacity animation reaches its export
* fix(core): a graded clip keeps its own clip-path, so it never renders black
* test(producer): golden render of graded video dissolve and wipe
* fix(core): a graded clip stays clickable in the preview, hidden by a filter not a clip
* chore(studio): drop an import the reader no longer uses, and format the graded fixture
* fix(studio): the preview picture takes a new box size in the same frame
The preview stage measured its box in a ResizeObserver and stored the size
in React state, which rendered a frame later. A box that grows at once (the
window going full screen) painted one frame with the old, small picture, and
macOS animated that frame for its whole full-screen transition.
* fix(studio): the preview picture takes a new box size in the same frame
* fix(studio): the preview picture is sized from its box's layout, not its on-screen rect
* style(studio): format the preview stage size test
* fix(studio): a host that shows a still gets a preview reload with one page at a time
A full reload kept the live page beside the reload's own until it was promoted, so a heavy project held two
whole pages at once. A host that can show the live frame as a still (holdPreviewStill) now has the live page
dropped behind it while the reload's page loads alone; the still goes once the new page shows the live time,
and a reload that gives up brings the live page back at its time. With no still, nothing changes.
* fix(studio): keep the reload hook's comment share at the base
* fix(studio): pause before the still so a held reload resumes from the frame it shows
* fix(studio): drop a give-up's still on the live page's own load, not a polled load event
* fix(studio): a host that throws while taking the still falls back to the two-page reload
* fix(studio): recovery drafts are kept by each project's own server, never the browser
* fix(studio): a restored draft stays offered when Studio settles which composition is open
* fix(studio): a draft read never waits on a pipe or loads an oversized record
* test(studio): the draft read's child fixture is an entry point, and its note sits in the test
* chore(studio-server): size budget covers the recovery-draft route
* chore(cli): unpacked size budget covers the recovery-draft route
* fix(cli): the CLI trusts a preview only once it proves this user started it
* test(cli): a listener that cannot prove it is the user's preview is never trusted
* test(cli): stand-in previews answer the challenge as the user's own do
* style(cli): format the preview proof changes
* fix(cli): a preview's proof names its own endpoint and config, and the token file must be private
* style(cli): format the proof changes
* test(studio): the fake request in the host check has a socket, as every real one does
* fix(studio): a Studio started by hand proves it is the user's, so the CLI still finds it
* fix(cli): the challenge travels in a header, so Studio's routes keep their exact paths
* style(studio): keep the config producer compact
A preview made opaque by its server (Content-Security-Policy: sandbox) under a
frame with no sandbox attribute posts as null. frameOrigins now accepts null
for such a frame, only from that frame's own window and only while its window
refuses reads.
* fix(studio): the preview reads hf-preview messages only from its own frame
The preview message router acted on a message with no sender window, and on
any message that arrived before the preview frame existed. It now takes an
hf-preview message only when the preview frame exists, the message comes from
that frame's window, and its origin is one the frame can have: the page's own
origin, or "null" for a sealed frame. The element picker checks the same.
* fix(cli): present sandboxes deck pages another site loads and refuses framing by other sites
present now applies the same another-site decision as play to its
/composition/* route: a load by another site gets a sandbox CSP, its
validators are dropped, and the document is marked so its runtime offers
that site no editing port. Every present response also sends
frame-ancestors 'self' and X-Frame-Options SAMEORIGIN, so only the
presenter page itself can frame the deck. The route setup moves into
buildPresentApp so tests exercise the server as run() builds it.
* chore: release v0.9.55
* chore: release v0.9.55 notes include #7830
* chore: release v0.9.55 notes include #7859 and #7867
* chore: release v0.9.55 notes name the docs change and cloud render
* chore: release v0.9.55 notes include #7866 and #7801
* chore: release v0.9.55 notes match the style bar
* feat(studio): hosts can seal the preview frames NLEPreview draws
* refactor(studio): Player builds its frame src in a helper, keeping its complexity at main's
* refactor(core): Studio's key combo and typing-target rules live in core
* chore(core): raise the packed size budget for the key-combo and typing-target subpaths
* fix(deps): bump @mcp-b/global to 6.1.0 to clear @modelcontextprotocol/server advisories
@mcp-b/global 5.x and 6.0.x pin @modelcontextprotocol/server 2.0.0, which is
affected by GHSA-f897-62hf-6gxq, GHSA-46jr-4wx8-v453, GHSA-jm63-cq47-j5jp and
GHSA-rvq5-wwqv-78pq (>=2.0.0 <2.3.0). 6.1.0 is the first release that pins
server 2.4.0.
6.x installs the W3C WebMCP polyfill and passes { signal } to execute; the
real-package tests now drive the 6.x surface (secure context, MCP tools/call).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* test(studio): close the WebMCP polyfill after the real-package suite
6.x's BrowserMcpServer sends a tools-changed event on a timer after the
last tool unregisters. Without cleanupWebModelContext() it fired after jsdom
teardown and vitest failed the run on an unhandled rejection. Also scope the
transport test's header to the MCP transports it actually checks.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* fix(studio): menu row highlight follows the menu's corner
* fix(studio): keep the menu row's comment share flat
* fix(studio): export the menu row class so hosts reuse it
* feat(studio): press ? to open the keyboard shortcuts panel
Adds a rebindable `shortcuts` action bound to `?` (Shift+/) that toggles
the shortcuts panel; Esc still closes it. The key is ignored while focus
is in an input, textarea or contenteditable, and the panel lists `?`
under Panels.
Refs heygen-com/hyperframes#5580
* docs(studio): document the ? shortcut for the shortcuts panel
* fix(studio): edit clips added to a project outside Studio
A clip written into a composition after its ids were last stamped (a hand
edit, an outside agent) has a data-hf-id only in the served preview. The
timeline's client-side patch looked that id up in the file's raw bytes, so
Hide, Mute, move, resize and attribute saves failed with "Unable to patch
timeline element ... (by hf-id; no file on the clip)".
Resolve the target against the file stamped in place the way the preview
stamps it, as the server's own saves and the GSAP save already do. The save
then persists that id.
* fix(studio): save volume on several clips added outside Studio
The multi-clip attribute save (gain or volume on a selection) patched each
clip in the file's raw bytes, so a clip with no ids on disk was skipped and
the save reported success with nothing written.
The by-target read and patch helpers now resolve a clip by the id the
preview served it with, so every caller finds it. The multi-clip save goes
through the same batch patch as the other timeline saves, which refuses a
clip the file does not hold; the error reaches the person instead of a
silent no-op. The preview picker finds the file holding an unstamped
element the same way.
* feat(cli): check warns when text leaves the 9:16 social safe areas
* feat(core): safe areas owned by core; check adds --safe-zone standard
* style(cli): format
* refactor(core): name the safe-area band fields
* fix(cli): defects outrank safe-zone warnings at the issue cap
* style(cli): format
* test: read the safe-box constants from core
* feat(studio): drag and resize on an opaque preview start from one gesture-start read
A gesture on a preview frame Studio cannot script read nothing from the
frame as it started. A drag snapped to nothing; a layer GSAP holds moved by
a CSS translate that its save then dropped; a resize grew from the overlay
rect, the layer's GSAP scale included; and the pointer reached the element
only through the canvas zoom.
The runtime answers a new `gesture-start` request. For each pressed element
it gives the overlay geometry, the transform-free layout size, how far the
centre moves per px of translate (probed the way a draft draws it, every
transform above it applied), and GSAP's x/y when GSAP owns its position,
with whether a tween moves it. It also lists the boxes of the page the
gesture can snap to, walked by the rule Studio's own snap collection now
takes from core.
On an opaque preview every press waits for that one read, on the existing
waiting-press path, and the gesture starts from it: the snap targets, the
move route and GSAP base (so the save writes GSAP's x plus the drag, not the
drag alone), the pointer-to-offset matrix, and the resize's base size. A
layer a tween moves is refused with a notice, since saving that move still
reads the frame.
Same-origin frames do not change: their presses start at once from the
element, and their snap collection walks the same elements by the same rule.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* chore(inspector): raise the packed size budget for the gesture-start runtime
The inspector bundles core's preview runtime. Main alone packs to 866206
bytes, 420 under the 1% tolerance on the old 858046 budget; the
gesture-start request adds 713 bytes (866919), which tipped the merge
queue's Build over. Set the budget to 880000 to leave room for the
remaining opaque-preview requests.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
oxfmt 0.41 pins tinypool 2.1.0 (GHSA-5gmw-xhrv-c9v3, GHSA-85c8-ppgw-ccpr).
Every oxfmt release before 0.67 pins 2.1.0, and 0.67+ reformats 66 files,
so override tinypool to the drop-in 2.1.2 patch instead of bumping oxfmt.
Also bump vite ^6.4.2 -> ^6.4.5 and vitest/@vitest/coverage-v8
^4.1.11 -> ^4.1.12 (pulls @vitest/mocker 4.1.12).
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>