mirror of https://github.com/heygen-com/hyperframes.git synced 2026-09-05 00:56:23 +00:00

Files

T

Miguel Ángel 735128a61a fix(core): install runtime bridge after transport setup (#2558 )

## Summary

The Studio preview now installs the runtime bridge only after its transport is ready, preventing initialization-order gaps without changing the bridge contract.

## Stack

Part 1 of 20. Parent: `main`. Next: heygen-com/hyperframes#2559. The golden reference, heygen-com/hyperframes#2387, remains open and unchanged.

## Test plan

- [x] Integrated Studio suite: 2,800 tests passed
- [x] Integrated parser suite: 853 tests passed
- [x] Studio and parser typechecks passed
- [x] Studio and parser production builds passed
- [ ] Per-PR CI completes on the submitted stack

## Post-Deploy Monitoring & Validation

Validation window: first 24 hours after the stack merges. Owner: Studio maintainers. Watch browser console and support reports for `[Timeline]`, `gsap-parser`, failed keyframe mutations, or preview/render easing mismatches. Healthy means edits persist and preview/render agree; revert the first failing layer if authored animation data changes unexpectedly.

---

[![Compound Engineering](https://img.shields.io/badge/Built_with-Compound_Engineering-6366f1)](https://github.com/EveryInc/compound-engineering-plugin)
![Codex](https://img.shields.io/badge/GPT--5-000000)

2026-07-19 21:49:02 -04:00

adapters

fix(core): enforce strict runtime safety

2026-07-11 21:31:30 -07:00

analytics.test.ts

refactor(core): simplify packages/core — dead code, dedup, type safety (#1413 )

2026-06-13 18:23:36 -04:00

analytics.ts

fix(runtime): tolerate registry timelines without pause() in interactive transport

2026-07-16 01:58:39 -07:00

applyVariableBindings.test.ts

feat(core): declarative variable bindings — data-var-src, data-var-text, css custom props

2026-07-09 13:31:03 -07:00

applyVariableBindings.ts

fix(core): enforce strict runtime safety

2026-07-11 21:31:30 -07:00

bridge.test.ts

fix(player): version runtime protocol

2026-07-13 13:28:11 -04:00

bridge.ts

fix(player): version runtime protocol

2026-07-13 13:28:11 -04:00

captionOverrides.test.ts

…

captionOverrides.ts

refactor(core): own edit protocol contract

2026-07-18 13:24:57 -04:00

clipTree.test.ts

feat(studio): instant, flicker-free manual editing (#1605 )

2026-06-22 01:21:18 -04:00

clipTree.ts

feat(studio): instant, flicker-free manual editing (#1605 )

2026-06-22 01:21:18 -04:00

clock-drift.test.ts

…

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

colorGrading.test.ts

fix(studio): address review findings on graded-element editing

2026-07-11 15:18:49 -04:00

colorGrading.ts

fix(core): enforce strict runtime safety

2026-07-11 21:31:30 -07:00

compositionLoader.test.ts

fix(core): stop composition variables from shadowing authored CSS custom properties (#2553 )

2026-07-16 18:20:13 -04:00

compositionLoader.ts

fix(core): stop composition variables from shadowing authored CSS custom properties (#2553 )

2026-07-16 18:20:13 -04:00

diagnostics.test.ts

…

diagnostics.ts

refactor(core): simplify packages/core — dead code, dedup, type safety (#1413 )

2026-06-13 18:23:36 -04:00

entry.ts

fix(core): capture authored inline opacity at parse time and follow source geometry

2026-07-11 03:33:32 -04:00

flattenedRoot.ts

fix(core,cli,lint): close the figma brand-token loop — runtime CSS variables, --name, snippet lint

2026-07-08 00:47:13 -07:00

getVariables.test.ts

fix(core,cli,lint): close the figma brand-token loop — runtime CSS variables, --name, snippet lint

2026-07-08 00:47:13 -07:00

getVariables.ts

fix(core): stop composition variables from shadowing authored CSS custom properties (#2553 )

2026-07-16 18:20:13 -04:00

globals.ts

refactor(core): simplify packages/core — dead code, dedup, type safety (#1413 )

2026-06-13 18:23:36 -04:00

init.positionEdits.test.ts

fix(core): preserve position edit fold detection during seeks

2026-07-09 17:38:31 -07:00

init.test.ts

fix(core): install runtime bridge after transport setup (#2558 )

2026-07-19 21:49:02 -04:00

init.ts

fix(core): install runtime bridge after transport setup (#2558 )

2026-07-19 21:49:02 -04:00

media.test.ts

fix(video): hold final frame through composition

2026-07-16 02:15:01 +00:00

media.ts

fix(studio): harden composition timeline reliability (#2615 )

2026-07-17 14:15:30 -04:00

mediaProxy.test.ts

fix(studio): preserve alpha proxy playback (#2625 )

2026-07-17 21:56:27 -04:00

mediaProxy.ts

fix(studio): preserve alpha proxy playback (#2625 )

2026-07-17 21:56:27 -04:00

mediaVolumeEnvelope.test.ts

fix(core): preserve playhead during volume probing (#2143 )

2026-07-10 17:18:16 -04:00

mediaVolumeEnvelope.ts

fix(core): enforce strict runtime safety

2026-07-11 21:31:30 -07:00

picker.test.ts

fix(fallow): suppress line-shifted pre-existing findings + simplify CSS.escape polyfill

2026-07-17 02:53:07 +00:00

picker.ts

fix(studio,runtime): CSS.escape ids so digit-leading selectors don't crash

2026-07-16 18:07:58 +00:00

playbackRate.ts

fix(studio): harden composition timeline reliability (#2615 )

2026-07-17 14:15:30 -04:00

player.test.ts

fix(core): preserve runtime transport contract

2026-07-13 14:08:52 -04:00

player.ts

fix(core): preserve runtime transport contract

2026-07-13 14:08:52 -04:00

positionEdits.test.ts

feat(core): applyPositionEdits gains force option and undo reset path

2026-07-15 14:50:46 -07:00

positionEdits.ts

fix(core): guard undefined NodeList index in applyPositionEdits loops

2026-07-15 18:30:55 -07:00

protocol.test.ts

fix(player): version runtime protocol

2026-07-13 13:28:11 -04:00

protocol.ts

refactor(core): unify composition contract (#2157 )

2026-07-16 02:44:22 -04:00

README.md

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

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

stackingContext.ts

feat(studio): mirror canvas z-order actions into timeline lanes (track order = default paint order) (#2380 )

2026-07-14 14:31:58 -04:00

startExpression.ts

refactor(core): unify composition contract (#2157 )

2026-07-16 02:44:22 -04:00

startResolver.test.ts

feat(core): export runtime start resolver with documentRef parameter

2026-07-16 11:01:27 -07:00

startResolver.ts

feat(core): export runtime start resolver with documentRef parameter

2026-07-16 11:01:27 -07:00

state.test.ts

fix(core): consolidate external asset and dependency preservation (#2410 )

2026-07-14 21:55:51 -04:00

state.ts

fix(core): consolidate external asset and dependency preservation (#2410 )

2026-07-14 21:55:51 -04:00

timeline.test.ts

fix(studio): harden composition timeline reliability (#2615 )

2026-07-17 14:15:30 -04:00

timeline.ts

fix(studio): harden composition timeline reliability (#2615 )

2026-07-17 14:15:30 -04:00

timelineRebindPolicy.test.ts

fix(core): enforce strict runtime safety

2026-07-11 21:31:30 -07:00

timelineRebindPolicy.ts

fix(core): enforce strict runtime safety

2026-07-11 21:31:30 -07:00

types.ts

fix(studio): harden composition timeline reliability (#2615 )

2026-07-17 14:15:30 -04:00

validateVariables.test.ts

fix(sdk): code-review follow-ups (WS-B/C/3.C, #1569/#1570/#1572) (#1588 )

2026-06-19 00:07:53 -07:00

validateVariables.ts

fix(sdk): code-review follow-ups (WS-B/C/3.C, #1569/#1570/#1572) (#1588 )

2026-06-19 00:07:53 -07:00

variableScope.ts

feat(core): declarative variable bindings — data-var-src, data-var-text, css custom props

2026-07-09 13:31:03 -07:00

webAudioTransport.test.ts

fix(core): mute preview audio per-element so a slow-decoding track isn't silenced (#1602 )

2026-06-19 20:16:19 -04:00

webAudioTransport.ts

fix(core): mute preview audio per-element so a slow-decoding track isn't silenced (#1602 )

2026-06-19 20:16:19 -04:00

window.d.ts

fix(producer): suppress GSAP call side effects during render seeks (#2037 )

2026-07-07 21:06:59 -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.