mirror of https://github.com/heygen-com/hyperframes.git synced 2026-11-03 20:37:30 +00:00

Files

T

Miguel Ángel 861fcc4dd0 fix(core): a preview that is never seeked shows only the clips of its current time (#4422 )

The visibility pass ran only on seek, pause, play and during playback, and at init for video
and img alone, so a paused page published __renderReady with every caption and composition host
visible until someone seeked. Readiness now runs that pass for non-media timed elements; media
keeps its init pass and seeks, which own color grading and audio scheduling.

2026-09-24 14:18:53 -04:00

adapters

feat(registry): a Lottie character walk-in, and looping Lottie that keeps playing (#4316 )

2026-09-23 09:20:48 -04:00

fixtures

chore(registry): remove low-use catalog items and variant tails (#4274 )

2026-09-22 07:04:54 -04: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

feat(core): add deterministic keyframe ease runtime

2026-07-25 14:12:16 +02: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(preview): show the correct scene instead of every scene at once on some loads (#3848 )

2026-09-10 08:06:43 -07:00

audioAutomationVolume.test.ts

fix(audio): two things the envelopes needed to be heard at all (#3017 )

2026-08-12 16:07:57 -07:00

audioAutomationVolume.ts

feat(core): speed ramps as a rate lane in data-automation (#4129 )

2026-09-19 06:27:42 -04:00

audioFx.test.ts

feat: make creator media edits render-safe (#3322 )

2026-08-18 10:17:02 -04:00

audioFx.ts

fix(core): harden audio FX and group identity (#3444 )

2026-08-23 17:58:25 -07:00

authoredTiming.test.ts

fix(engine): preserve static dedup across caption runs (#3438 )

2026-08-23 13:18:18 -04:00

authoredTiming.ts

perf(player): scope preview readiness to first frame (#4239 )

2026-09-21 17:15:05 -04:00

bridge.test.ts

fix: restrict runtime and playground message dispatch (#3816 )

2026-09-09 13:56:58 -04:00

bridge.ts

fix: restrict runtime and playground message dispatch (#3816 )

2026-09-09 13:56:58 -04:00

captionOverrides.test.ts

chore(deps): update dependency vitest to v4 [security] (#3789 )

2026-09-10 13:55:52 -04:00

captionOverrides.ts

fix(preview): show the correct scene instead of every scene at once on some loads (#3848 )

2026-09-10 08:06:43 -07:00

clipTree.test.ts

feat(core): video, audio and image length come from one shared resolver (#4166 )

2026-09-19 08:01:28 -04:00

clipTree.ts

feat(core): video, audio and image length come from one shared resolver (#4166 )

2026-09-19 08:01:28 -04:00

clipWindow.test.ts

fix(runtime): a finished film rests on its last frame instead of a blank one (#4158 )

2026-09-19 10:35:26 -04:00

clipWindow.ts

fix(runtime): a finished film rests on its last frame instead of a blank one (#4158 )

2026-09-19 10:35:26 -04: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-stall.test.ts

fix(player): the interactive playback clock absorbs a main-thread stall instead of skipping past it (#4053 )

2026-09-18 01:50:05 -04:00

clock.test.ts

feat(core): speed ramps as a rate lane in data-automation (#4129 )

2026-09-19 06:27:42 -04:00

clock.ts

feat(core): speed ramps as a rate lane in data-automation (#4129 )

2026-09-19 06:27:42 -04:00

colorGrading.test.ts

fix(core): read CSS animation opacity through color grading's own hide (#3329 ) (#3507 )

2026-08-28 00:17:23 +00:00

colorGrading.ts

fix(studio): the preview stays paused, survives typing, and opens without a re-encode (#3910 )

2026-09-12 12:56:00 -04:00

compositionLoader.test.ts

fix(parsers): render bare fragment sub-compositions (#4335 )

2026-09-23 12:49:04 -04:00

compositionLoader.ts

fix(parsers): render bare fragment sub-compositions (#4335 )

2026-09-23 12:49:04 -04:00

customEase.test.ts

feat(core): add deterministic keyframe ease runtime

2026-07-25 14:12:16 +02:00

customEase.ts

feat(core): add deterministic keyframe ease runtime

2026-07-25 14:12:16 +02:00

deckAudio.test.ts

chore(registry): remove low-use catalog items and variant tails (#4274 )

2026-09-22 07:04:54 -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

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

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

domRealm.test.ts

fix(preview): show the correct scene instead of every scene at once on some loads (#3848 )

2026-09-10 08:06:43 -07:00

domRealm.ts

feat(runtime): data-vfx-chain — a seek-deterministic per-pixel effect element (#4306 )

2026-09-23 03:14:08 -07:00

entry.ts

feat(player): add retained runtime data channels (#3471 )

2026-08-26 07:48:00 +00: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

feat(registry): bring back the video-primitive moves (#3169 )

2026-08-10 18:46:03 -04:00

getVariables.ts

feat(registry): bring back the video-primitive moves (#3169 )

2026-08-10 18:46:03 -04:00

globals.ts

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

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

init.mediaClipIndex.test.ts

perf: sublinear Studio rebuilds and seeks (#3837 )

2026-09-10 03:55:28 +00: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): a preview that is never seeked shows only the clips of its current time (#4422 )

2026-09-24 14:18:53 -04:00

init.timingResolver.test.ts

perf(runtime): a paused preview stops burning CPU (#3845 )

2026-09-10 08:29:22 -07:00

init.ts

fix(core): a preview that is never seeked shows only the clips of its current time (#4422 )

2026-09-24 14:18:53 -04:00

levelTap.ts

feat(studio): audio level meters at the timeline's right edge (#4193 )

2026-09-21 16:19:30 -04:00

manualEditGestureWatch.test.ts

fix(runtime): the editor keeps waking during a drag on a preview it did not build (#3850 )

2026-09-10 16:29:32 +00:00

manualEditGestureWatch.ts

fix(runtime): the editor keeps waking during a drag on a preview it did not build (#3850 )

2026-09-10 16:29:32 +00:00

media.test.ts

fix(core): frame captures wait for a seeking video to land its frame (#4406 )

2026-09-24 07:07:59 -04:00

media.ts

fix(core): frame captures wait for a seeking video to land its frame (#4406 )

2026-09-24 07:07:59 -04:00

mediaProxy.test.ts

fix(runtime): a finished film rests on its last frame instead of a blank one (#4158 )

2026-09-19 10:35:26 -04:00

mediaProxy.ts

fix(preview): show the correct scene instead of every scene at once on some loads (#3848 )

2026-09-10 08:06:43 -07:00

mediaVolumeEnvelope.test.ts

fix(runtime): resolve media clip start once for playback, manifest, and audio (#3833 )

2026-09-10 02:30:16 +00:00

mediaVolumeEnvelope.ts

fix(preview): show the correct scene instead of every scene at once on some loads (#3848 )

2026-09-10 08:06:43 -07:00

pausedTransportInvariant.test.ts

fix(studio): the preview stays paused, survives typing, and opens without a re-encode (#3910 )

2026-09-12 12:56:00 -04:00

picker.test.ts

fix(core): a section whose root sets pointer-events:none stays pickable (#4399 )

2026-09-24 06:21:33 -04:00

picker.ts

fix(core): a section whose root sets pointer-events:none stays pickable (#4399 )

2026-09-24 06:21:33 -04:00

playbackRate.test.ts

feat(core): video, audio and image length come from one shared resolver (#4166 )

2026-09-19 08:01:28 -04:00

playbackRate.ts

feat(core): video, audio and image length come from one shared resolver (#4166 )

2026-09-19 08:01:28 -04:00

player.test.ts

feat(engine): sub-frame multi-sample motion blur, capture-level accumulation (#4019 )

2026-09-16 20:10:06 -04:00

player.ts

feat(engine): sub-frame multi-sample motion blur, capture-level accumulation (#4019 )

2026-09-16 20:10:06 -04:00

positionEdits.test.ts

fix(core): apply position edits to SVG elements, not just HTML (#2724 )

2026-07-21 16:48:33 -07:00

positionEdits.ts

fix(preview): show the correct scene instead of every scene at once on some loads (#3848 )

2026-09-10 08:06:43 -07:00

protocol.test.ts

fix(player): version runtime protocol

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

protocol.ts

feat(player): add retained runtime data channels (#3471 )

2026-08-26 07:48:00 +00:00

README.md

fix(player): wait for a cross-origin composition's assets before playing (#4103 )

2026-09-18 17:27:16 -04:00

renderFrameSibling.test.ts

fix(producer): give inlined media a document-unique render id (#3342 )

2026-08-19 00:24:07 -04:00

renderFrameSibling.ts

fix(preview): show the correct scene instead of every scene at once on some loads (#3848 )

2026-09-10 08:06:43 -07:00

runtimeData.test.ts

fix(player): report and fail closed on runtime delivery errors (#3472 )

2026-08-30 13:00:14 -07:00

runtimeData.ts

fix(player): report and fail closed on runtime delivery errors (#3472 )

2026-08-30 13:00:14 -07:00

runtimeSeekFixture.test-helpers.ts

perf: sublinear Studio rebuilds and seeks (#3837 )

2026-09-10 03:55:28 +00: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): video, audio and image length come from one shared resolver (#4166 )

2026-09-19 08:01:28 -04:00

startResolver.ts

feat(core): video, audio and image length come from one shared resolver (#4166 )

2026-09-19 08:01:28 -04: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(core): the runtime never reports a film's length as Infinity (#4372 )

2026-09-23 20:53:52 -04:00

timeline.ts

fix(core): the runtime never reports a film's length as Infinity (#4372 )

2026-09-23 20:53:52 -04:00

timelineRebindPolicy.test.ts

fix(core): enforce strict runtime safety

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

timelineRebindPolicy.ts

perf(runtime): a paused preview stops burning CPU (#3845 )

2026-09-10 08:29:22 -07:00

transportPark.test.ts

perf(player): scope preview readiness to first frame (#4239 )

2026-09-21 17:15:05 -04:00

types.ts

fix(player): wait for a cross-origin composition's assets before playing (#4103 )

2026-09-18 17:27:16 -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

vfx.test.ts

feat(runtime): data-vfx-chain backdrop capture and two-source kernels (luma-matte, noise) (#4330 )

2026-09-23 23:25:20 -07:00

vfx.ts

feat(runtime): data-vfx-chain backdrop capture and two-source kernels (luma-matte, noise) (#4330 )

2026-09-23 23:25:20 -07:00

webAudioRoute.test.ts

fix(core): tell an opaque document how to actually get its Web Audio back (#3940 )

2026-09-14 11:56:45 -07:00

webAudioRoute.ts

fix(core): tell an opaque document how to actually get its Web Audio back (#3940 )

2026-09-14 11:56:45 -07:00

webAudioTransport.test.ts

feat(studio): audio level meters at the timeline's right edge (#4193 )

2026-09-21 16:19:30 -04:00

webAudioTransport.ts

feat(studio): audio level meters at the timeline's right edge (#4193 )

2026-09-21 16:19:30 -04:00

wiggleEase.test.ts

feat(core): add deterministic keyframe ease runtime

2026-07-25 14:12:16 +02:00

wiggleEase.ts

feat(core): add deterministic keyframe ease runtime

2026-07-25 14:12:16 +02:00

window.d.ts

feat(studio): audio level meters at the timeline's right edge (#4193 )

2026-09-21 16:19:30 -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"; timeline carries assetsReady (whether the composition's media, images and fonts have settled) and the runtime then posts type: "assets-ready" once, so a parent that cannot read the iframe can gate playback
- 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.