ext/hyperframes

Fork 0

mirror of https://github.com/heygen-com/hyperframes.git synced 2026-11-15 13:58:20 +00:00

Files

T

History

ad11de698c feat(producer): auto-fallback screenshot capture for raf and iframes (#331 )

* fix(core): drive adapter seeks when composition has no GSAP timeline

renderSeek returned early when deps.getTimeline() was null, skipping the
onDeterministicSeek call that drives all frame adapters (CSS, WAAPI,
Lottie, Three.js). That meant compositions using any non-GSAP animation
primitive froze on their initial frame during capture.

Now we still quantize the seek time and fire onDeterministicSeek even
without a timeline, so each adapter gets a chance to advance.

GSAP compositions are unaffected — timeline-driven seek still takes the
same path it did before.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(producer): auto-fallback screenshot capture for raf and iframes

Co-Authored-By: Codex <codex@openai.com>

* test(producer): add render compatibility regression fixtures

Co-Authored-By: Codex <codex@openai.com>

* fix(core): scrub CSS animations via WAAPI currentTime

Co-Authored-By: Codex <codex@openai.com>

* test(producer): cover css keyframe renders

Co-Authored-By: Codex <codex@openai.com>

* fix(producer): propagate virtual time into iframe documents

Co-Authored-By: Codex <codex@openai.com>

* test(producer): refresh iframe docker golden

Co-Authored-By: Codex <codex@openai.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-authored-by: Codex <codex@openai.com>

2026-04-18 15:08:52 -07:00

adapters

feat(producer): auto-fallback screenshot capture for raf and iframes (#331 )

2026-04-18 15:08:52 -07:00

analytics.test.ts

initial code (#2 )

2026-03-21 22:43:56 -07:00

analytics.ts

initial code (#2 )

2026-03-21 22:43:56 -07:00

bridge.test.ts

fix(player): single-owner audio to prevent double voice in preview (#298 )

2026-04-17 04:46:22 +02:00

bridge.ts

fix(player): single-owner audio to prevent double voice in preview (#298 )

2026-04-17 04:46:22 +02:00

captionOverrides.ts

feat(skills): add marker-highlight skill for animated text highlighting (#190 )

2026-04-02 13:48:24 -07:00

compositionLoader.test.ts

feat(core): support inline template compositions (#146 )

2026-03-31 03:46:23 +02:00

compositionLoader.ts

fix(core): load head styles/scripts from non-template sub-compositions (#219 )

2026-04-07 17:17:25 +02:00

entry.ts

feat(core): add fitTextFontSize utility for pixel-accurate text measurement (#152 )

2026-03-30 20:14:13 -07:00

init.ts

feat(producer): auto-fallback screenshot capture for raf and iframes (#331 )

2026-04-18 15:08:52 -07:00

media.test.ts

fix(player): address #298 review — tighter drift, dynamic proxies, ownership event (#307 )

2026-04-18 00:49:57 +02:00

media.ts

fix(player): address #298 review — tighter drift, dynamic proxies, ownership event (#307 )

2026-04-18 00:49:57 +02:00

picker.test.ts

style: apply oxfmt baseline formatting across all source files (#25 )

2026-03-23 17:15:14 -07:00

picker.ts

style: apply oxfmt baseline formatting across all source files (#25 )

2026-03-23 17:15:14 -07:00

player.test.ts

style: apply oxfmt baseline formatting across all source files (#25 )

2026-03-23 17:15:14 -07:00

player.ts

feat(producer): auto-fallback screenshot capture for raf and iframes (#331 )

2026-04-18 15:08:52 -07:00

README.md

fix(ci): update publish workflow to use bun install (#36 )

2026-03-24 08:46:58 -07:00

startResolver.test.ts

style: apply oxfmt baseline formatting across all source files (#25 )

2026-03-23 17:15:14 -07:00

startResolver.ts

fix: composition issues in runtime code + producer parity

2026-03-23 23:56:42 -04:00

state.test.ts

initial code (#2 )

2026-03-21 22:43:56 -07:00

state.ts

fix(player): single-owner audio to prevent double voice in preview (#298 )

2026-04-17 04:46:22 +02:00

timeline.test.ts

fix(core): filter decorative elements from timeline clip collection (#92 )

2026-03-27 18:31:46 +01:00

timeline.ts

fix(core): filter decorative elements from timeline clip collection (#92 )

2026-03-27 18:31:46 +01:00

types.ts

fix(player): single-owner audio to prevent double voice in preview (#298 )

2026-04-17 04:46:22 +02:00

window.d.ts

initial code (#2 )

2026-03-21 22:43:56 -07: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"

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.