mirror of https://github.com/heygen-com/hyperframes.git synced 2026-09-03 04:38:33 +00:00

Files

T

Manu PareekandCursor 7fa3696101 fix(runtime): respect hidden ancestor clips in Studio preview (#1387 ) (#1395 )

* fix(runtime): respect hidden ancestor clips in Studio preview (#1387)

Studio-stamped GSAP tween targets inside timed clips were getting
visibility:visible for the full composition, overriding hidden parent
panels. Skip stamping descendants of authored clips and suppress
visibility on children when an ancestor timed clip is hidden.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(runtime): scope ancestor visibility walk to Studio iframe only

Address review feedback: the hierarchical visibility guard now runs only
when window.parent !== window, matching the Studio-only stamping fix.
Render mode keeps prior per-element visibility semantics. Adds a render-mode
regression test and documents the null rootComp case in findTimedClipAncestor.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-06-12 20:28:31 -04:00

adapters

feat(core): spring physics solver + runtime fixes [2/6] (#1168 )

2026-06-05 11:51:25 -04:00

analytics.test.ts

feat(core): add emitPerformanceMetric bridge for runtime telemetry (#393 )

2026-04-22 15:08:14 -07:00

analytics.ts

feat(runtime): swallow() helper replaces empty catches in inlined runtime

2026-05-06 23:53:21 +00:00

bridge.test.ts

fix(runtime,player): replay bridge state on iframe ready to repair race

2026-06-09 12:22:27 -07:00

bridge.ts

fix(runtime,player): replay bridge state on iframe ready to repair race

2026-06-09 12:22:27 -07:00

captionOverrides.test.ts

fix: make caption overrides refresh-safe (#609 )

2026-05-03 23:29:16 -07:00

captionOverrides.ts

fix: make caption overrides refresh-safe (#609 )

2026-05-03 23:29:16 -07:00

clock-drift.test.ts

feat(runtime): single-clock transport — eliminate pause/play audio drift (#671 )

2026-05-08 07:53:46 +02:00

clock.test.ts

fix(player): correct playback rate for direct-timeline and audio-clock paths (#849 )

2026-05-14 16:34:38 -07:00

clock.ts

fix(player): correct playback rate for direct-timeline and audio-clock paths (#849 )

2026-05-14 16:34:38 -07:00

compositionLoader.test.ts

fix(core): align sub-composition scoping across runtime and bundler (#897 )

2026-05-16 18:25:24 +02:00

compositionLoader.ts

fix(core): set explicit dimensions on data-hf-inner-root wrapper

2026-05-23 14:53:16 -04:00

diagnostics.test.ts

feat(runtime): swallow() helper replaces empty catches in inlined runtime

2026-05-06 23:53:21 +00:00

diagnostics.ts

feat(runtime): swallow() helper replaces empty catches in inlined runtime

2026-05-06 23:53:21 +00:00

entry.ts

feat(core,cli,engine,producer): add getVariables() helper and --variables render flag

2026-05-03 00:18:13 +00:00

getVariables.test.ts

test(core): add T8 override-set merge semantics suite for getVariables (#1241 )

2026-06-06 18:04:44 -07:00

getVariables.ts

feat(core): scope getVariables() per sub-comp instance

2026-05-04 19:41:26 +00:00

init.test.ts

fix(runtime): respect hidden ancestor clips in Studio preview (#1387 ) (#1395 )

2026-06-12 20:28:31 -04:00

init.ts

fix(runtime): respect hidden ancestor clips in Studio preview (#1387 ) (#1395 )

2026-06-12 20:28:31 -04:00

media.test.ts

fix(core): apply playbackRate to all media duration resolution sites (#1288 )

2026-06-08 21:29:04 -04:00

media.ts

fix(core): apply playbackRate to all media duration resolution sites (#1288 )

2026-06-08 21:29:04 -04:00

mediaPreloader.test.ts

chore: address remaining review nits

2026-05-19 21:06:22 -04:00

mediaPreloader.ts

fix(studio): enable timeline resize for all elements, improve perf and UX

2026-05-19 20:40:39 -04:00

mediaVolumeEnvelope.ts

fix(core): apply renderer volume-automation solution to preview (#1118 )

2026-05-29 10:10:12 -04:00

picker.test.ts

feat: cache shader transition preview frames (#634 )

2026-05-06 01:25:09 -07:00

picker.ts

refactor(studio): contexts, PropertyPanel split, duration fix, perf (#748 )

2026-05-12 20:18:52 +02:00

player.test.ts

fix(core): guard timeline method calls for non-conformant objects (#1098 )

2026-05-27 20:16:38 -04:00

player.ts

fix(core): guard timeline method calls for non-conformant objects (#1098 )

2026-05-27 20:16:38 -04:00

README.md

fix(runtime,player): replay bridge state on iframe ready to repair race

2026-06-09 12:22:27 -07:00

startResolver.test.ts

fix: stabilize apple master timeline and playback (#419 )

2026-04-23 04:05:11 +02:00

startResolver.ts

fix(core): apply playbackRate to all media duration resolution sites (#1288 )

2026-06-08 21:29:04 -04:00

state.test.ts

fix(core): remove 1800s hard cap on timeline duration that silently truncated long compositions (#1114 )

2026-05-28 16:26:40 -04:00

state.ts

fix(core): remove 1800s hard cap on timeline duration that silently truncated long compositions (#1114 )

2026-05-28 16:26:40 -04:00

timeline.test.ts

fix(core): remove 1800s hard cap on timeline duration that silently truncated long compositions (#1114 )

2026-05-28 16:26:40 -04:00

timeline.ts

fix(core): apply playbackRate to all media duration resolution sites (#1288 )

2026-06-08 21:29:04 -04:00

types.ts

fix(runtime,player): replay bridge state on iframe ready to repair race

2026-06-09 12:22:27 -07:00

validateVariables.test.ts

feat(core,cli): variable schema validation + lint rules

2026-05-04 20:05:33 +00:00

validateVariables.ts

feat(core,cli): variable schema validation + lint rules

2026-05-04 20:05:33 +00:00

webAudioTransport.test.ts

fix(runtime): preserve authored muted attr; clean up WebAudio on end (#1319 )

2026-06-10 19:09:13 -04:00

webAudioTransport.ts

fix(runtime): preserve authored muted attr; clean up WebAudio on end (#1319 )

2026-06-10 19:09:13 -04:00

window.d.ts

fix: batch GSAP timeline construction to prevent main-thread hang (#1231 ) (#1249 )

2026-06-07 09:31:13 -04:00

README.md

Hyperframe Runtime Engine

This folder owns the runtime that powers preview and producer parity.

Current Direction

Runtime source of truth is converging on hyperframe.ts.
Build produces:
- dist/hyperframe.runtime.iife.js (browser bootstrap)
- dist/hyperframe.runtime.mjs (tooling/tests)
- dist/hyperframe.manifest.json (version + sha256 + artifact map)
FE owns iframe runtime injection.
BE persists raw generated HTML without injecting runtime scripts.
Producer validates pinned runtime checksum from manifest before render.

Runtime Contract (Stable Surface)

Globals:

window.__player
window.__playerReady
window.__renderReady
window.__timelines
window.__clipManifest

postMessage:

parent -> runtime control:
- source: "hf-parent"
- type: "control"
- actions: play, pause, seek, set-muted, set-playback-rate, enable-pick-mode, disable-pick-mode
runtime -> parent events:
- source: "hf-preview"
- type: "state" and type: "timeline"
- type: "ready" — emitted once when installRuntimeControlBridge registers the control-message listener. The parent uses it to replay current playback state (set-muted, set-volume, set-playback-rate) so any control message sent before the listener was installed isn't lost. Emitted again on every iframe reload because the new runtime instance starts with no state.

Determinism baseline:

renderSeek is the producer-canonical seek path.
30fps quantization and readiness gates are correctness requirements.

Build

bun run --filter @hyperframes/core build:hyperframes-runtime

Security Expectations

Runtime bootstrap URL must be version-pinned and host-allowlisted.
Iframe bridge payloads must be schema-validated.
Unsafe URL schemes (javascript: and unapproved data:) are rejected.
Fail closed if runtime bootstrap/handshake is not healthy.

Product Editing Model

Primary mode: prompt + element picking.
Secondary mode: manual precision controls.
Avoid timeline-first manual workflows as default product path.