mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-19 19:36:04 +00:00
Chromium throttles requestAnimationFrame in deeply nested cross-origin iframes. In Claude desktop (Electron), the composition iframe's own rAF loop stalls, so GSAP is never seeked and animation freezes even when TransportClock.isPlaying() is true. The correct fix is to drive ticks from the widget-frame rAF, which lives one level up and is not subject to the same throttling. When play() takes the runtime bridge path (no direct timeline adapter), the player now starts a parent-frame rAF loop that sends "tick" postMessages to the composition iframe on every frame. The runtime's control bridge handles "tick" by calling seekTimelineAndAdapters(clock.now()) if the clock is playing — identical to what transportTick does on each rAF, just driven from outside. The composition iframe's own rAF loop is unchanged and keeps running normally in standard browsers. Seeking GSAP twice per frame is idempotent, so there is no regression on claude.ai or any other non-throttled environment. Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
120 lines
3.7 KiB
TypeScript
120 lines
3.7 KiB
TypeScript
import { swallow } from "./diagnostics";
|
|
import type { RuntimeBridgeControlMessage, RuntimeOutboundMessage } from "./types";
|
|
|
|
type BridgeDeps = {
|
|
onPlay: () => void;
|
|
onPause: () => void;
|
|
onSeek: (frame: number, seekMode: "drag" | "commit") => void;
|
|
onTick: () => void;
|
|
onSetMuted: (muted: boolean) => void;
|
|
onSetVolume: (volume: number) => void;
|
|
onSetMediaOutputMuted: (muted: boolean) => void;
|
|
onSetPlaybackRate: (rate: number) => void;
|
|
onEnablePickMode: () => void;
|
|
onDisablePickMode: () => void;
|
|
};
|
|
|
|
export function postRuntimeMessage(payload: RuntimeOutboundMessage): void {
|
|
try {
|
|
window.parent.postMessage(payload, "*");
|
|
} catch (err) {
|
|
// Cross-frame posting can throw if the parent is gone or origin-isolated.
|
|
swallow("bridge.postMessage", err);
|
|
}
|
|
}
|
|
|
|
export function installRuntimeControlBridge(deps: BridgeDeps): (event: MessageEvent) => void {
|
|
const handler = (event: MessageEvent) => {
|
|
const data = event.data as Partial<RuntimeBridgeControlMessage> | null;
|
|
if (!data || data.source !== "hf-parent" || data.type !== "control") return;
|
|
const action = data.action;
|
|
if (action === "play") {
|
|
deps.onPlay();
|
|
return;
|
|
}
|
|
if (action === "pause") {
|
|
deps.onPause();
|
|
return;
|
|
}
|
|
if (action === "seek") {
|
|
deps.onSeek(Number(data.frame ?? 0), data.seekMode ?? "commit");
|
|
return;
|
|
}
|
|
if (action === "tick") {
|
|
deps.onTick();
|
|
return;
|
|
}
|
|
if (action === "set-muted") {
|
|
deps.onSetMuted(Boolean(data.muted));
|
|
return;
|
|
}
|
|
if (action === "set-volume") {
|
|
deps.onSetVolume(Math.max(0, Math.min(1, Number(data.volume ?? 1))));
|
|
return;
|
|
}
|
|
if (action === "set-media-output-muted") {
|
|
deps.onSetMediaOutputMuted(Boolean(data.muted));
|
|
return;
|
|
}
|
|
if (action === "set-playback-rate") {
|
|
deps.onSetPlaybackRate(Number(data.playbackRate ?? 1));
|
|
return;
|
|
}
|
|
if (action === "enable-pick-mode") {
|
|
deps.onEnablePickMode();
|
|
return;
|
|
}
|
|
if (action === "disable-pick-mode") {
|
|
deps.onDisablePickMode();
|
|
return;
|
|
}
|
|
if (action === "flash-elements") {
|
|
// Briefly highlight elements — used by the chat-canvas bridge
|
|
// to show what changed after an agent edit
|
|
const selectors = (data as Record<string, unknown>).selectors as string[] | undefined;
|
|
const duration = ((data as Record<string, unknown>).duration as number) || 800;
|
|
if (selectors) {
|
|
flashElements(selectors, duration);
|
|
}
|
|
}
|
|
};
|
|
window.addEventListener("message", handler);
|
|
return handler;
|
|
}
|
|
|
|
/**
|
|
* Flash elements — briefly highlight them with a blue outline.
|
|
* Used by the chat-canvas bridge to show what changed after an agent edit.
|
|
*/
|
|
function flashElements(selectors: string[], duration: number): void {
|
|
if (!document.getElementById("__hf-flash-styles")) {
|
|
const style = document.createElement("style");
|
|
style.id = "__hf-flash-styles";
|
|
style.textContent = `
|
|
.__hf-flash {
|
|
outline: 2px solid rgba(59, 130, 246, 0.6) !important;
|
|
outline-offset: 2px !important;
|
|
animation: __hf-flash-pulse ${duration}ms ease-out forwards !important;
|
|
}
|
|
@keyframes __hf-flash-pulse {
|
|
0% { outline-color: rgba(59, 130, 246, 0.8); }
|
|
100% { outline-color: transparent; }
|
|
}
|
|
`;
|
|
document.head.appendChild(style);
|
|
}
|
|
|
|
for (const selector of selectors) {
|
|
try {
|
|
const els = document.querySelectorAll(selector);
|
|
els.forEach((el) => {
|
|
el.classList.add("__hf-flash");
|
|
setTimeout(() => el.classList.remove("__hf-flash"), duration);
|
|
});
|
|
} catch (err) {
|
|
// Invalid selector — skip
|
|
swallow("bridge.flashElements.querySelector", err);
|
|
}
|
|
}
|
|
}
|